1. Packages
  2. Packages
  3. Azure Native
  4. API Docs
  5. security
  6. getSecurityContact
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Viewing docs for Azure Native v3.23.0
published on Saturday, Jul 18, 2026 by Pulumi
azure-native logo
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Viewing docs for Azure Native v3.23.0
published on Saturday, Jul 18, 2026 by Pulumi

    Get Default Security contact configurations for the subscription

    Uses Azure REST API version 2023-12-01-preview.

    Other available API versions: 2017-08-01-preview, 2020-01-01-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native security [ApiVersion]. See the version guide for details.

    Using getSecurityContact

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getSecurityContact(args: GetSecurityContactArgs, opts?: InvokeOptions): Promise<GetSecurityContactResult>
    function getSecurityContactOutput(args: GetSecurityContactOutputArgs, opts?: InvokeOptions): Output<GetSecurityContactResult>
    def get_security_contact(security_contact_name: Optional[str] = None,
                             opts: Optional[InvokeOptions] = None) -> GetSecurityContactResult
    def get_security_contact_output(security_contact_name: pulumi.Input[Optional[str]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetSecurityContactResult]
    func LookupSecurityContact(ctx *Context, args *LookupSecurityContactArgs, opts ...InvokeOption) (*LookupSecurityContactResult, error)
    func LookupSecurityContactOutput(ctx *Context, args *LookupSecurityContactOutputArgs, opts ...InvokeOption) LookupSecurityContactResultOutput

    > Note: This function is named LookupSecurityContact in the Go SDK.

    public static class GetSecurityContact 
    {
        public static Task<GetSecurityContactResult> InvokeAsync(GetSecurityContactArgs args, InvokeOptions? opts = null)
        public static Output<GetSecurityContactResult> Invoke(GetSecurityContactInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetSecurityContactResult> getSecurityContact(GetSecurityContactArgs args, InvokeOptions options)
    public static Output<GetSecurityContactResult> getSecurityContact(GetSecurityContactArgs args, InvokeOptions options)
    
    fn::invoke:
      function: azure-native:security:getSecurityContact
      arguments:
        # arguments dictionary
    data "azure-native_security_get_security_contact" "name" {
        # arguments
    }

    The following arguments are supported:

    SecurityContactName string
    Name of the security contact object
    SecurityContactName string
    Name of the security contact object
    security_contact_name string
    Name of the security contact object
    securityContactName String
    Name of the security contact object
    securityContactName string
    Name of the security contact object
    security_contact_name str
    Name of the security contact object
    securityContactName String
    Name of the security contact object

    getSecurityContact Result

    The following output properties are available:

    AzureApiVersion string
    The Azure API version of the resource.
    Id string
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    Name string
    The name of the resource
    SystemData Pulumi.AzureNative.Security.Outputs.SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    Emails string
    List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
    IsEnabled bool
    Indicates whether the security contact is enabled.
    NotificationsByRole Pulumi.AzureNative.Security.Outputs.SecurityContactPropertiesNotificationsByRoleResponse
    Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    NotificationsSources List<Union<Pulumi.AzureNative.Security.Outputs.NotificationsSourceAlertResponse, Pulumi.AzureNative.Security.Outputs.NotificationsSourceAttackPathResponse>>
    A collection of sources types which evaluate the email notification.
    Phone string
    The security contact's phone number
    AzureApiVersion string
    The Azure API version of the resource.
    Id string
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    Name string
    The name of the resource
    SystemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    Emails string
    List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
    IsEnabled bool
    Indicates whether the security contact is enabled.
    NotificationsByRole SecurityContactPropertiesNotificationsByRoleResponse
    Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    NotificationsSources []interface{}
    A collection of sources types which evaluate the email notification.
    Phone string
    The security contact's phone number
    azure_api_version string
    The Azure API version of the resource.
    id string
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    name string
    The name of the resource
    system_data object
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    emails string
    List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
    is_enabled bool
    Indicates whether the security contact is enabled.
    notifications_by_role object
    Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    notifications_sources list(object | object)
    A collection of sources types which evaluate the email notification.
    phone string
    The security contact's phone number
    azureApiVersion String
    The Azure API version of the resource.
    id String
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    name String
    The name of the resource
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    emails String
    List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
    isEnabled Boolean
    Indicates whether the security contact is enabled.
    notificationsByRole SecurityContactPropertiesNotificationsByRoleResponse
    Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    notificationsSources List<Either<NotificationsSourceAlertResponse,NotificationsSourceAttackPathResponse>>
    A collection of sources types which evaluate the email notification.
    phone String
    The security contact's phone number
    azureApiVersion string
    The Azure API version of the resource.
    id string
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    name string
    The name of the resource
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    emails string
    List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
    isEnabled boolean
    Indicates whether the security contact is enabled.
    notificationsByRole SecurityContactPropertiesNotificationsByRoleResponse
    Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    notificationsSources (NotificationsSourceAlertResponse | NotificationsSourceAttackPathResponse)[]
    A collection of sources types which evaluate the email notification.
    phone string
    The security contact's phone number
    azure_api_version str
    The Azure API version of the resource.
    id str
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    name str
    The name of the resource
    system_data SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type str
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    emails str
    List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
    is_enabled bool
    Indicates whether the security contact is enabled.
    notifications_by_role SecurityContactPropertiesNotificationsByRoleResponse
    Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    notifications_sources Sequence[Any]
    A collection of sources types which evaluate the email notification.
    phone str
    The security contact's phone number
    azureApiVersion String
    The Azure API version of the resource.
    id String
    Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    name String
    The name of the resource
    systemData Property Map
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    emails String
    List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.
    isEnabled Boolean
    Indicates whether the security contact is enabled.
    notificationsByRole Property Map
    Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    notificationsSources List<Property Map | Property Map>
    A collection of sources types which evaluate the email notification.
    phone String
    The security contact's phone number

    Supporting Types

    NotificationsSourceAlertResponse

    MinimalSeverity string
    Defines the minimal alert severity which will be sent as email notifications
    MinimalSeverity string
    Defines the minimal alert severity which will be sent as email notifications
    minimal_severity string
    Defines the minimal alert severity which will be sent as email notifications
    minimalSeverity String
    Defines the minimal alert severity which will be sent as email notifications
    minimalSeverity string
    Defines the minimal alert severity which will be sent as email notifications
    minimal_severity str
    Defines the minimal alert severity which will be sent as email notifications
    minimalSeverity String
    Defines the minimal alert severity which will be sent as email notifications

    NotificationsSourceAttackPathResponse

    MinimalRiskLevel string
    Defines the minimal attach path risk level which will be sent as email notifications
    MinimalRiskLevel string
    Defines the minimal attach path risk level which will be sent as email notifications
    minimal_risk_level string
    Defines the minimal attach path risk level which will be sent as email notifications
    minimalRiskLevel String
    Defines the minimal attach path risk level which will be sent as email notifications
    minimalRiskLevel string
    Defines the minimal attach path risk level which will be sent as email notifications
    minimal_risk_level str
    Defines the minimal attach path risk level which will be sent as email notifications
    minimalRiskLevel String
    Defines the minimal attach path risk level which will be sent as email notifications

    SecurityContactPropertiesNotificationsByRoleResponse

    Roles List<string>
    Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
    State string
    Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    Roles []string
    Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
    State string
    Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    roles list(string)
    Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
    state string
    Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    roles List<String>
    Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
    state String
    Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    roles string[]
    Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
    state string
    Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    roles Sequence[str]
    Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
    state str
    Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.
    roles List<String>
    Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:
    state String
    Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.

    SystemDataResponse

    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    created_at string
    The timestamp of resource creation (UTC).
    created_by string
    The identity that created the resource.
    created_by_type string
    The type of identity that created the resource.
    last_modified_at string
    The timestamp of resource last modification (UTC)
    last_modified_by string
    The identity that last modified the resource.
    last_modified_by_type string
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.
    createdAt string
    The timestamp of resource creation (UTC).
    createdBy string
    The identity that created the resource.
    createdByType string
    The type of identity that created the resource.
    lastModifiedAt string
    The timestamp of resource last modification (UTC)
    lastModifiedBy string
    The identity that last modified the resource.
    lastModifiedByType string
    The type of identity that last modified the resource.
    created_at str
    The timestamp of resource creation (UTC).
    created_by str
    The identity that created the resource.
    created_by_type str
    The type of identity that created the resource.
    last_modified_at str
    The timestamp of resource last modification (UTC)
    last_modified_by str
    The identity that last modified the resource.
    last_modified_by_type str
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
    Viewing docs for Azure Native v3.23.0
    published on Saturday, Jul 18, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial