Microsoft.Security securityContacts

• Latest
• 2020-01-01-preview
• 2017-08-01-preview

Bicep resource definition

The securityContacts resource type can be deployed to:

• Subscriptions - See subscription deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Security/securityContacts resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Security/securityContacts@2020-01-01-preview' = {
  name: 'string'
  properties: {
    alertNotifications: {
      minimalSeverity: 'string'
      state: 'string'
    }
    emails: 'string'
    notificationsByRole: {
      roles: [
        'string'
      ]
      state: 'string'
    }
    phone: 'string'
  }
}

Property values

securityContacts

Name	Description	Value
name	The resource name	string (required) Character limit: 1-260 Valid characters: Alphanumerics, underscores, and hyphens.
properties	Security contact data	SecurityContactProperties

SecurityContactProperties

Name	Description	Value
alertNotifications	Defines whether to send email notifications about new security alerts	SecurityContactPropertiesAlertNotifications
emails	List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.	string
notificationsByRole	Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.	SecurityContactPropertiesNotificationsByRole
phone	The security contact's phone number	string

SecurityContactPropertiesAlertNotifications

Name	Description	Value
minimalSeverity	Defines the minimal alert severity which will be sent as email notifications	'High' 'Low' 'Medium'
state	Defines if email notifications will be sent about new security alerts	'Off' 'On'

SecurityContactPropertiesNotificationsByRole

Name	Description	Value
roles	Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:	String array containing any of: 'AccountAdmin' 'Contributor' 'Owner' 'ServiceAdmin'
state	Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.	'Off' 'On'

ARM template resource definition

The securityContacts resource type can be deployed to:

• Subscriptions - See subscription deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Security/securityContacts resource, add the following JSON to your template.

{
  "type": "Microsoft.Security/securityContacts",
  "apiVersion": "2020-01-01-preview",
  "name": "string",
  "properties": {
    "alertNotifications": {
      "minimalSeverity": "string",
      "state": "string"
    },
    "emails": "string",
    "notificationsByRole": {
      "roles": [ "string" ],
      "state": "string"
    },
    "phone": "string"
  }
}

Property values

securityContacts

Name	Description	Value
type	The resource type	'Microsoft.Security/securityContacts'
apiVersion	The resource api version	'2020-01-01-preview'
name	The resource name	string (required) Character limit: 1-260 Valid characters: Alphanumerics, underscores, and hyphens.
properties	Security contact data	SecurityContactProperties

SecurityContactProperties

Name	Description	Value
alertNotifications	Defines whether to send email notifications about new security alerts	SecurityContactPropertiesAlertNotifications
emails	List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.	string
notificationsByRole	Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.	SecurityContactPropertiesNotificationsByRole
phone	The security contact's phone number	string

SecurityContactPropertiesAlertNotifications

Name	Description	Value
minimalSeverity	Defines the minimal alert severity which will be sent as email notifications	'High' 'Low' 'Medium'
state	Defines if email notifications will be sent about new security alerts	'Off' 'On'

SecurityContactPropertiesNotificationsByRole

Name	Description	Value
roles	Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:	String array containing any of: 'AccountAdmin' 'Contributor' 'Owner' 'ServiceAdmin'
state	Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.	'Off' 'On'

Terraform (AzAPI provider) resource definition

The securityContacts resource type can be deployed to:

• Subscriptions

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Security/securityContacts resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Security/securityContacts@2020-01-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      alertNotifications = {
        minimalSeverity = "string"
        state = "string"
      }
      emails = "string"
      notificationsByRole = {
        roles = [
          "string"
        ]
        state = "string"
      }
      phone = "string"
    }
  })
}

Property values

securityContacts

Name	Description	Value
type	The resource type	"Microsoft.Security/securityContacts@2020-01-01-preview"
name	The resource name	string (required) Character limit: 1-260 Valid characters: Alphanumerics, underscores, and hyphens.
parent_id	To deploy to a subscription, use the ID of that subscription.	string (required)
properties	Security contact data	SecurityContactProperties

SecurityContactProperties

Name	Description	Value
alertNotifications	Defines whether to send email notifications about new security alerts	SecurityContactPropertiesAlertNotifications
emails	List of email addresses which will get notifications from Microsoft Defender for Cloud by the configurations defined in this security contact.	string
notificationsByRole	Defines whether to send email notifications from Microsoft Defender for Cloud to persons with specific RBAC roles on the subscription.	SecurityContactPropertiesNotificationsByRole
phone	The security contact's phone number	string

SecurityContactPropertiesAlertNotifications

Name	Description	Value
minimalSeverity	Defines the minimal alert severity which will be sent as email notifications	"High" "Low" "Medium"
state	Defines if email notifications will be sent about new security alerts	"Off" "On"

SecurityContactPropertiesNotificationsByRole

Name	Description	Value
roles	Defines which RBAC roles will get email notifications from Microsoft Defender for Cloud. List of allowed RBAC roles:	String array containing any of: "AccountAdmin" "Contributor" "Owner" "ServiceAdmin"
state	Defines whether to send email notifications from AMicrosoft Defender for Cloud to persons with specific RBAC roles on the subscription.	"Off" "On"