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 訂用帳戶識別碼

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

確定

Other Status Codes

描述作業為何失敗的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 流程

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 Resource Manager Api 的常見錯誤回應,可傳回失敗作業的錯誤詳細資料。 (這也會遵循 OData 錯誤回應格式。 ) 。

CloudErrorBody

錯誤詳細資料。

ErrorAdditionalInfo

資源管理錯誤的其他資訊。

minimalSeverity

定義將以電子郵件通知形式傳送的最基本警示嚴重性

NotificationsByRole

定義是否要將電子郵件通知從 Azure 資訊安全中心傳送給訂用帳戶上具有特定 RBAC 角色的人員。

SecurityContact

來自 Azure 資訊安全中心之通知的連絡人詳細資料和設定。

state

定義是否要傳送新安全性警示的電子郵件通知

AlertNotifications

定義是否要傳送新安全性警示的電子郵件通知

Name Type Description
minimalSeverity

定義將以電子郵件通知形式傳送的最基本警示嚴重性

state

定義是否要傳送新安全性警示的電子郵件通知

CloudError

所有 Azure Resource Manager 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

定義是否要將電子郵件通知從 Azure 資訊安全中心傳送給訂用帳戶上具有特定 RBAC 角色的人員。

Name Type Description
roles
  • string[]

定義哪些 RBAC 角色會從 Azure 資訊安全中心取得電子郵件通知。 允許的 RBAC 角色清單:

state

定義是否要將電子郵件通知從 Azure 資訊安全中心傳送給訂用帳戶上具有特定 RBAC 角色的人員。

SecurityContact

來自 Azure 資訊安全中心之通知的連絡人詳細資料和設定。

Name Type Description
id
  • string

資源識別碼

name
  • string

資源名稱

properties.alertNotifications

定義是否要傳送新安全性警示的電子郵件通知

properties.emails
  • string

電子郵件地址清單,此清單會根據此安全性連絡人中定義的設定,從 Azure 資訊安全中心取得通知。

properties.notificationsByRole

定義是否要將電子郵件通知從 Azure 資訊安全中心傳送給訂用帳戶上具有特定 RBAC 角色的人員。

properties.phone
  • string

安全性連絡人的電話號碼

type
  • string

資源類型

state

定義是否要傳送新安全性警示的電子郵件通知

Name Type Description
Off
  • string

不要收到新警示的通知

On
  • string

取得新警示的通知