Security Contacts - List

Listar todas as configurações de contato de segurança para a assinatura

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/securityContacts?api-version=2023-12-01-preview

Parâmetros do URI

Nome Em Obrigatório Tipo Descrição
subscriptionId
path True

string (uuid)

O ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Nome Tipo Descrição
200 OK

SecurityContactList

Operação do Azure concluída com sucesso.

Other Status Codes

Common.CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

List security contact data

Pedido de amostra

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts?api-version=2023-12-01-preview

Resposta da amostra

{
  "value": [
    {
      "name": "default",
      "type": "Microsoft.Security/securityContact",
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContact/default",
      "properties": {
        "emails": "john@contoso.com;Jane@contoso.com",
        "isEnabled": true,
        "notificationsByRole": {
          "roles": [
            "Owner",
            "Admin"
          ],
          "state": "On"
        },
        "notificationsSources": [
          {
            "minimalRiskLevel": "Critical",
            "sourceType": "AttackPath"
          },
          {
            "minimalSeverity": "Medium",
            "sourceType": "Alert"
          }
        ],
        "phone": "(214)275-4038"
      }
    }
  ]
}

Definições

Nome Descrição
Common.CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

Common.CloudErrorBody

O detalhe do erro.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

MinimalRiskLevel

Define o nível mínimo de risco do caminho de ataque que será enviado como notificações por email

MinimalSeverity

Define a severidade mínima do alerta que será enviada como notificações por e-mail

NotificationsSourceAlert

Fonte de notificação de alerta

NotificationsSourceAttackPath

Origem da notificação do caminho de ataque

SecurityContact

Detalhes de contato e configurações para notificações provenientes do Microsoft Defender para a Cloud.

SecurityContactList

Lista de resposta de contatos de segurança

SecurityContactPropertiesNotificationsByRole

Define se as notificações por email do Microsoft Defender para a Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura.

SecurityContactRole

Um possível papel para configurar o envio de alertas de notificação de segurança a

SourceType

O tipo de fonte que acionará a notificação

State

Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender para a Cloud para pessoas com funções RBAC específicas na assinatura.

systemData

Metadados referentes à criação e última modificação do recurso.

Common.CloudError

Resposta de erro comum para todas as APIs do Azure Resource Manager para retornar detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.)

Nome Tipo Descrição
error.additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

error.code

string

O código de erro.

error.details

Common.CloudErrorBody[]

Os detalhes do erro.

error.message

string

A mensagem de erro.

error.target

string

O destino do erro.

Common.CloudErrorBody

O detalhe do erro.

Nome Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

Common.CloudErrorBody[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Nome Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

MinimalRiskLevel

Define o nível mínimo de risco do caminho de ataque que será enviado como notificações por email

Valor Descrição
Critical

Receba notificações sobre novos caminhos de ataque com nível de risco crítico

High

Receba notificações sobre novos caminhos de ataque com nível de risco Alto ou Crítico

Medium

Receba notificações sobre novos caminhos anexados com nível de risco Médio, Alto ou Crítico

Low

Receba notificações sobre novos caminhos anexados com nível de risco Baixo, Médio, Alto ou Crítico

MinimalSeverity

Define a severidade mínima do alerta que será enviada como notificações por e-mail

Valor Descrição
High

Receba notificações sobre novos alertas com alta severidade

Medium

Receba notificações sobre novos alertas com gravidade Média ou Alta

Low

Receba notificações sobre novos alertas com gravidade Baixa, Média ou Alta

NotificationsSourceAlert

Fonte de notificação de alerta

Nome Tipo Descrição
minimalSeverity

MinimalSeverity

Define a severidade mínima do alerta que será enviada como notificações por e-mail

sourceType string:

Alert

O tipo de fonte que acionará a notificação

NotificationsSourceAttackPath

Origem da notificação do caminho de ataque

Nome Tipo Descrição
minimalRiskLevel

MinimalRiskLevel

Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por e-mail

sourceType string:

AttackPath

O tipo de fonte que acionará a notificação

SecurityContact

Detalhes de contato e configurações para notificações provenientes do Microsoft Defender para a Cloud.

Nome Tipo Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.emails

string

Lista de endereços de e-mail que receberão notificações do Microsoft Defender para a Cloud pelas configurações definidas neste contato de segurança.

properties.isEnabled

boolean

Indica se o contato de segurança está habilitado.

properties.notificationsByRole

SecurityContactPropertiesNotificationsByRole

Define se as notificações por email do Microsoft Defender para a Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura.

properties.notificationsSources NotificationsSource[]:

Uma coleção de tipos de fontes que avaliam a notificação por e-mail.

properties.phone

string

O número de telefone do contacto de segurança

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

SecurityContactList

Lista de resposta de contatos de segurança

Nome Tipo Descrição
nextLink

string (uri)

O link para a página seguinte dos itens

value

SecurityContact[]

Os itens do SecurityContact nesta página

SecurityContactPropertiesNotificationsByRole

Define se as notificações por email do Microsoft Defender para a Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura.

Nome Tipo Descrição
roles

SecurityContactRole[]

Define quais funções RBAC receberão notificações por email do Microsoft Defender para a Cloud. Lista de funções RBAC permitidas:

state

State

Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender para a Cloud para pessoas com funções RBAC específicas na assinatura.

SecurityContactRole

Um possível papel para configurar o envio de alertas de notificação de segurança a

Valor Descrição
AccountAdmin

Se habilitado, envie notificações sobre novos alertas para os administradores da conta

ServiceAdmin

Se habilitado, envie uma notificação sobre novos alertas para os administradores do serviço

Owner

Se habilitado, envie notificações sobre novos alertas para os proprietários da assinatura

Contributor

Se habilitado, envie uma notificação sobre novos alertas para os colaboradores da assinatura

SourceType

O tipo de fonte que acionará a notificação

Valor Descrição
Alert

Alert

AttackPath

AttackPath

State

Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender para a Cloud para pessoas com funções RBAC específicas na assinatura.

Valor Descrição
Passed

Todos os controlos de conformidade regulatória suportados na determinada norma têm um estado aprovado

Failed

Pelo menos um controlo de conformidade regulatória suportado na determinada norma encontra-se em estado de falha

Skipped

Todos os controlos de conformidade regulatória suportados na determinada norma têm um estado de ignorado

Unsupported

Não há dados de conformidade regulatória suportados para a norma em questão

On

Enviar notificação sobre novos alertas aos administradores da subscrição

Off

Não envie notificações sobre novos alertas aos administradores da subscrição

systemData

Metadados referentes à criação e última modificação do recurso.

Nome Tipo Descrição
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.