Settings - Update

Service:

Defender for Cloud

API Version:

2021-06-01

更新雲端 Microsoft Defender 中不同組態的設定

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/settings/{settingName}?api-version=2021-06-01

URI 參數

名稱	位於	必要	類型	Description
settingName	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 版本

要求本文

要求主體可以是下列其中一項：

名稱	Description
AlertSyncSettings	代表警示同步設定
DataExportSettings	表示數據匯出設定

AlertSyncSettings

代表警示同步設定

名稱	必要	類型	Description
kind	True	string: AlertSyncSettings	設定字串的種類
properties.enabled	True	boolean	是否已啟用警示同步設定

DataExportSettings

表示數據匯出設定

名稱	必要	類型	Description
kind	True	string: DataExportSettings	設定字串的種類
properties.enabled	True	boolean	是否已啟用數據匯出設定

回應

名稱	類型	Description
200 OK	Setting: DataExportSettings AlertSyncSettings	確定
Other Status Codes	CloudError	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Update a setting for subscription

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/settings/WDATP?api-version=2021-06-01

{
  "kind": "DataExportSettings",
  "properties": {
    "enabled": true
  }
}

Sample Response

Status code:

200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/settings/WDATP",
  "name": "WDATP",
  "kind": "DataExportSettings",
  "type": "Microsoft.Security/settings",
  "properties": {
    "enabled": true
  }
}

定義

名稱	Description
AlertSyncSettings	代表警示同步設定
CloudError	所有 Azure Resource Manager API 的常見錯誤回應，可傳回失敗作業的錯誤詳細數據。 (這也會遵循 OData 錯誤回應格式。) 。
CloudErrorBody	錯誤詳細數據。
DataExportSettings	表示數據匯出設定
ErrorAdditionalInfo	資源管理錯誤其他資訊。

AlertSyncSettings

代表警示同步設定

名稱	類型	Description
id	string	資源標識碼
kind	string: AlertSyncSettings	設定字串的種類
name	string	資源名稱
properties.enabled	boolean	是否已啟用警示同步設定
type	string	資源類型

CloudError

所有 Azure Resource Manager API 的常見錯誤回應，可傳回失敗作業的錯誤詳細數據。 (這也會遵循 OData 錯誤回應格式。) 。

名稱	類型	Description
error.additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
error.code	string	錯誤碼。
error.details	CloudErrorBody[]	錯誤詳細資料。
error.message	string	錯誤訊息。
error.target	string	錯誤目標。

CloudErrorBody

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	CloudErrorBody[]	錯誤詳細資料。
message	string	錯誤訊息。
target	string	錯誤目標。

DataExportSettings

表示數據匯出設定

名稱	類型	Description
id	string	資源標識碼
kind	string: DataExportSettings	設定字串的種類
name	string	資源名稱
properties.enabled	boolean	是否已啟用數據匯出設定
type	string	資源類型

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。