你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Security Contacts - Get

获取订阅的默认安全联系人配置

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

URI 参数

Name In Required Type Description
securityContactName
path True
  • string

安全联系人对象的名称

subscriptionId
path True
  • string

Azure 订阅 ID

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True
  • string

操作的 API 版本

响应

Name Type Description
200 OK

OK

Other Status Codes

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

Get a security contact

Sample Request

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

Sample Response

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default",
  "name": "default",
  "type": "Microsoft.Security/securityContacts",
  "properties": {
    "notificationsByRole": {
      "state": "On",
      "roles": [
        "Owner"
      ]
    },
    "emails": "john@contoso.com;jane@contoso.com",
    "phone": "(214)275-4038",
    "alertNotifications": {
      "state": "On",
      "minimalSeverity": "Low"
    }
  }
}

定义

AlertNotifications

定义是否发送有关新安全警报的电子邮件通知

CloudError

所有 Azure 资源管理器 API 的常见错误响应,以返回失败操作的错误详细信息。 (这还遵循 OData 错误响应格式。) 。

CloudErrorBody

错误详细信息。

ErrorAdditionalInfo

资源管理错误附加信息。

minimalSeverity

定义将作为电子邮件通知发送的最小警报严重性

NotificationsByRole

定义是否将电子邮件通知从 Microsoft Defender for Cloud 发送给订阅中具有特定 RBAC 角色的人员。

SecurityContact

有关来自 Microsoft Defender for Cloud 的通知的联系人详细信息和配置。

state

定义是否发送有关新安全警报的电子邮件通知

AlertNotifications

定义是否发送有关新安全警报的电子邮件通知

Name Type Description
minimalSeverity

定义将作为电子邮件通知发送的最小警报严重性

state

定义是否发送有关新安全警报的电子邮件通知

CloudError

所有 Azure 资源管理器 API 的常见错误响应,以返回失败操作的错误详细信息。 (这还遵循 OData 错误响应格式。) 。

Name Type Description
error.additionalInfo

错误附加信息。

error.code
  • string

错误代码。

error.details

错误详细信息。

error.message
  • string

错误消息。

error.target
  • string

错误目标。

CloudErrorBody

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

minimalSeverity

定义将作为电子邮件通知发送的最小警报严重性

Name Type Description
High
  • string

获取有关具有高严重性的新警报的通知

Low
  • string

不要收到针对低、中或高严重性的新警报的通知

Medium
  • string

获取有关具有中等或较高严重性的新警报的通知

NotificationsByRole

定义是否将电子邮件通知从 Microsoft Defender for Cloud 发送给订阅中具有特定 RBAC 角色的人员。

Name Type Description
roles
  • string[]

定义哪些 RBAC 角色将从 Microsoft Defender for Cloud 获取电子邮件通知。 允许的 RBAC 角色列表:

state

定义是否将电子邮件通知从 AMicrosoft Defender for Cloud 发送给订阅中具有特定 RBAC 角色的人员。

SecurityContact

有关来自 Microsoft Defender for Cloud 的通知的联系人详细信息和配置。

Name Type Description
id
  • string

资源 ID

name
  • string

资源名称

properties.alertNotifications

定义是否发送有关新安全警报的电子邮件通知

properties.emails
  • string

电子邮件地址列表,这些电子邮件地址将通过此安全联系人中定义的配置从 Microsoft Defender for Cloud 获取通知。

properties.notificationsByRole

定义是否将电子邮件通知从 Microsoft Defender for Cloud 发送给订阅中具有特定 RBAC 角色的人员。

properties.phone
  • string

安全联系人的电话号码

type
  • string

资源类型

state

定义是否发送有关新安全警报的电子邮件通知

Name Type Description
Off
  • string

不要收到有关新警报的通知

On
  • string

获取有关新警报的通知