Partilhar via


Microsoft.Security securityContatos 2023-12-01-preview

Definição de recursos do bíceps

O tipo de recurso securityContacts pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Security/securityContacts, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Security/securityContacts@2023-12-01-preview' = {
  name: 'string'
  properties: {
    emails: 'string'
    isEnabled: bool
    notificationsByRole: {
      roles: [
        'string'
      ]
      state: 'string'
    }
    notificationsSources: [
      {
        sourceType: 'string'
        // For remaining properties, see NotificationsSource objects
      }
    ]
    phone: 'string'
  }
}

Objetos NotificationsSource

Defina a propriedade sourceType para especificar o tipo de objeto.

Para de Alerta, utilize:

{
  minimalSeverity: 'string'
  sourceType: 'Alert'
}

Para AttackPath, use:

{
  minimalRiskLevel: 'string'
  sourceType: 'AttackPath'
}

Valores de propriedade

Microsoft.Security/securityContactos

Designação Descrição Valor
Designação O nome do recurso 'default' (obrigatório)
propriedades Dados de contacto de segurança SecurityContactProperties

NotificaçõesOrigem

Designação Descrição Valor
Tipo de fonte Defina como 'Alert' para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. 'Alerta'
'AttackPath' (obrigatório)

NotificationsSourceAlert

Designação Descrição Valor
gravidade mínima Define a severidade mínima do alerta que será enviada como notificações por e-mail 'Alta'
'Baixa'
'Médio'
Tipo de fonte O tipo de fonte que acionará a notificação 'Alerta' (obrigatório)

NotificationsSourceAttackPath

Designação Descrição Valor
MinimalRiskLevel Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por e-mail 'Crítica'
'Alta'
'Baixa'
'Médio'
Tipo de fonte O tipo de fonte que acionará a notificação 'AttackPath' (obrigatório)

SecurityContactProperties

Designação Descrição Valor
E-mails Lista de endereços de e-mail que receberão notificações do Microsoft Defender for Cloud pelas configurações definidas neste contato de segurança. string
isEnabled Indica se o contato de segurança está habilitado. Bool
notificaçõesPorFunção Define se as notificações por email do Microsoft Defender for Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura. SecurityContactPropertiesNotificationsByRole
notificaçõesFontes Uma coleção de tipos de fontes que avaliam a notificação por e-mail. NotificaçõesFonte[]
Telefone O número de telefone do contacto de segurança string

SecurityContactPropertiesNotificationsByRole

Designação Descrição Valor
funções Define quais funções RBAC receberão notificações por email do Microsoft Defender for Cloud. Lista de funções RBAC permitidas: Matriz de cadeia de caracteres contendo qualquer uma das:
'AccountAdmin'
'Contribuidor'
'Proprietário'
'ServiceAdmin'
Estado Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender for Cloud para pessoas com funções RBAC específicas na assinatura. 'Desligado'
'Ligado'

Definição de recurso de modelo ARM

O tipo de recurso securityContacts pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Security/securityContacts, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Security/securityContacts",
  "apiVersion": "2023-12-01-preview",
  "name": "string",
  "properties": {
    "emails": "string",
    "isEnabled": "bool",
    "notificationsByRole": {
      "roles": [ "string" ],
      "state": "string"
    },
    "notificationsSources": [ {
      "sourceType": "string"
      // For remaining properties, see NotificationsSource objects
    } ],
    "phone": "string"
  }
}

Objetos NotificationsSource

Defina a propriedade sourceType para especificar o tipo de objeto.

Para de Alerta, utilize:

{
  "minimalSeverity": "string",
  "sourceType": "Alert"
}

Para AttackPath, use:

{
  "minimalRiskLevel": "string",
  "sourceType": "AttackPath"
}

Valores de propriedade

Microsoft.Security/securityContactos

Designação Descrição Valor
apiVersion A versão api '2023-12-01-pré-visualização'
Designação O nome do recurso 'default' (obrigatório)
propriedades Dados de contacto de segurança SecurityContactProperties
tipo O tipo de recurso 'Microsoft.Security/securityContacts'

NotificaçõesOrigem

Designação Descrição Valor
Tipo de fonte Defina como 'Alert' para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. 'Alerta'
'AttackPath' (obrigatório)

NotificationsSourceAlert

Designação Descrição Valor
gravidade mínima Define a severidade mínima do alerta que será enviada como notificações por e-mail 'Alta'
'Baixa'
'Médio'
Tipo de fonte O tipo de fonte que acionará a notificação 'Alerta' (obrigatório)

NotificationsSourceAttackPath

Designação Descrição Valor
MinimalRiskLevel Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por e-mail 'Crítica'
'Alta'
'Baixa'
'Médio'
Tipo de fonte O tipo de fonte que acionará a notificação 'AttackPath' (obrigatório)

SecurityContactProperties

Designação Descrição Valor
E-mails Lista de endereços de e-mail que receberão notificações do Microsoft Defender for Cloud pelas configurações definidas neste contato de segurança. string
isEnabled Indica se o contato de segurança está habilitado. Bool
notificaçõesPorFunção Define se as notificações por email do Microsoft Defender for Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura. SecurityContactPropertiesNotificationsByRole
notificaçõesFontes Uma coleção de tipos de fontes que avaliam a notificação por e-mail. NotificaçõesFonte[]
Telefone O número de telefone do contacto de segurança string

SecurityContactPropertiesNotificationsByRole

Designação Descrição Valor
funções Define quais funções RBAC receberão notificações por email do Microsoft Defender for Cloud. Lista de funções RBAC permitidas: Matriz de cadeia de caracteres contendo qualquer uma das:
'AccountAdmin'
'Contribuidor'
'Proprietário'
'ServiceAdmin'
Estado Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender for Cloud para pessoas com funções RBAC específicas na assinatura. 'Desligado'
'Ligado'

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso securityContacts pode ser implantado com operações que visam:

  • Subscrição

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Security/securityContacts, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Security/securityContacts@2023-12-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      emails = "string"
      isEnabled = bool
      notificationsByRole = {
        roles = [
          "string"
        ]
        state = "string"
      }
      notificationsSources = [
        {
          sourceType = "string"
          // For remaining properties, see NotificationsSource objects
        }
      ]
      phone = "string"
    }
  })
}

Objetos NotificationsSource

Defina a propriedade sourceType para especificar o tipo de objeto.

Para de Alerta, utilize:

{
  minimalSeverity = "string"
  sourceType = "Alert"
}

Para AttackPath, use:

{
  minimalRiskLevel = "string"
  sourceType = "AttackPath"
}

Valores de propriedade

Microsoft.Security/securityContactos

Designação Descrição Valor
Designação O nome do recurso 'default' (obrigatório)
propriedades Dados de contacto de segurança SecurityContactProperties
tipo O tipo de recurso "Microsoft.Security/securityContacts@2023-12-01-preview"

NotificaçõesOrigem

Designação Descrição Valor
Tipo de fonte Defina como 'Alert' para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. 'Alerta'
'AttackPath' (obrigatório)

NotificationsSourceAlert

Designação Descrição Valor
gravidade mínima Define a severidade mínima do alerta que será enviada como notificações por e-mail 'Alta'
'Baixa'
'Médio'
Tipo de fonte O tipo de fonte que acionará a notificação 'Alerta' (obrigatório)

NotificationsSourceAttackPath

Designação Descrição Valor
MinimalRiskLevel Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por e-mail 'Crítica'
'Alta'
'Baixa'
'Médio'
Tipo de fonte O tipo de fonte que acionará a notificação 'AttackPath' (obrigatório)

SecurityContactProperties

Designação Descrição Valor
E-mails Lista de endereços de e-mail que receberão notificações do Microsoft Defender for Cloud pelas configurações definidas neste contato de segurança. string
isEnabled Indica se o contato de segurança está habilitado. Bool
notificaçõesPorFunção Define se as notificações por email do Microsoft Defender for Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura. SecurityContactPropertiesNotificationsByRole
notificaçõesFontes Uma coleção de tipos de fontes que avaliam a notificação por e-mail. NotificaçõesFonte[]
Telefone O número de telefone do contacto de segurança string

SecurityContactPropertiesNotificationsByRole

Designação Descrição Valor
funções Define quais funções RBAC receberão notificações por email do Microsoft Defender for Cloud. Lista de funções RBAC permitidas: Matriz de cadeia de caracteres contendo qualquer uma das:
'AccountAdmin'
'Contribuidor'
'Proprietário'
'ServiceAdmin'
Estado Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender for Cloud para pessoas com funções RBAC específicas na assinatura. 'Desligado'
'Ligado'