Management Group Diagnostic Settings - Create Or Update

服務:

Monitor

API 版本:

2020-01-01-preview

建立或更新指定資源的管理群組診斷設定。

PUT https://management.azure.com/providers/microsoft.management/managementGroups/{managementGroupId}/providers/microsoft.insights/diagnosticSettings/{name}?api-version=2020-01-01-preview

URI 參數

名稱	位於	必要	類型	Description
managementGroupId	path	True	string	管理群組標識碼。
name	path	True	string	診斷設定的名稱。
api-version	query	True	string	用於此作業的 API 版本。

要求本文

名稱	類型	Description
location	string	資源的位置
properties.eventHubAuthorizationRuleId	string	事件中樞授權規則的資源標識碼。
properties.eventHubName	string	事件中樞的名稱。 如果未指定任何專案，則會選取預設事件中樞。
properties.logs	ManagementGroupLogSettings[]	記錄設定的清單。
properties.serviceBusRuleId	string	診斷設定的服務總線規則標識碼。 這是為了維持回溯相容性。
properties.storageAccountId	string	您要傳送診斷記錄的記憶體帳戶資源識別碼。
properties.workspaceId	string	要傳送診斷記錄之Log Analytics工作區的完整ARM資源識別碼。 範例：/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

回應

名稱	類型	Description
200 OK	ManagementGroupDiagnosticSettingsResource	建立管理群組診斷設定的要求成功
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

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

範例

Creates or Updates the management group diagnostic setting

範例要求

HTTP

PUT https://management.azure.com/providers/microsoft.management/managementGroups/testChildMG7/providers/microsoft.insights/diagnosticSettings/setting1?api-version=2020-01-01-preview

{
  "properties": {
    "storageAccountId": "/subscriptions/bfaef57f-297e-4210-bfe5-27c18cc671f7/resourceGroups/FuncAppRunners/providers/Microsoft.Storage/storageAccounts/testpersonalb6a5",
    "workspaceId": "/subscriptions/9cf7cc0a-0ba1-4624-bc82-97e1ee25dc45/resourceGroups/mgTest/providers/Microsoft.OperationalInsights/workspaces/mgTestWorkspace",
    "eventHubAuthorizationRuleId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/montest/providers/microsoft.eventhub/namespaces/mynamespace/eventhubs/myeventhub/authorizationrules/myrule",
    "eventHubName": "myeventhub",
    "logs": [
      {
        "category": "Administrative",
        "enabled": true
      },
      {
        "category": "Policy",
        "enabled": true
      }
    ]
  }
}

範例回覆

狀態碼:

200

{
  "id": "providers/Microsoft.Management/managementGroups/testChildMG7/providers/microsoft.insights/diagnosticSettings/setting1",
  "type": "Microsoft.Insights/diagnosticSettings",
  "name": "setting1",
  "location": "global",
  "properties": {
    "storageAccountId": "/subscriptions/bfaef57f-297e-4210-bfe5-27c18cc671f7/resourceGroups/FuncAppRunners/providers/Microsoft.Storage/storageAccounts/testpersonalb6a5",
    "workspaceId": "/subscriptions/9cf7cc0a-0ba1-4624-bc82-97e1ee25dc45/resourceGroups/mgTest/providers/Microsoft.OperationalInsights/workspaces/mgTestWorkspace",
    "eventHubAuthorizationRuleId": "/subscriptions/fb9f25f9-5785-4510-a38f-a62f188eb9f8/resourceGroups/montest/providers/microsoft.eventhub/namespaces/mynamespace/eventhubs/myeventhub/authorizationrules/myrule",
    "logs": [
      {
        "category": "Administrative",
        "enabled": true
      },
      {
        "category": "Policy",
        "enabled": true
      }
    ]
  }
}

定義

名稱	Description
ErrorResponse	描述錯誤回應的格式。
ManagementGroupDiagnosticSettingsResource	管理群組診斷設定資源。
ManagementGroupLogSettings	管理群組診斷設定的一部分。 指定特定記錄檔的設定。

ErrorResponse

描述錯誤回應的格式。

名稱	類型	Description
code	string	錯誤碼
message	string	錯誤訊息，指出作業失敗的原因。

ManagementGroupDiagnosticSettingsResource

管理群組診斷設定資源。

名稱	類型	Description
id	string	Azure 資源標識碼
location	string	資源的位置
name	string	Azure 資源名稱
properties.eventHubAuthorizationRuleId	string	事件中樞授權規則的資源標識碼。
properties.eventHubName	string	事件中樞的名稱。 如果未指定任何專案，則會選取預設事件中樞。
properties.logs	ManagementGroupLogSettings[]	記錄設定的清單。
properties.serviceBusRuleId	string	診斷設定的服務總線規則標識碼。 這是為了維持回溯相容性。
properties.storageAccountId	string	您要傳送診斷記錄的記憶體帳戶資源識別碼。
properties.workspaceId	string	要傳送診斷記錄之Log Analytics工作區的完整ARM資源識別碼。 範例：/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Azure 資源類型

ManagementGroupLogSettings

管理群組診斷設定的一部分。 指定特定記錄檔的設定。

名稱	類型	Description
category	string	套用此設定的資源類型管理群組診斷記錄類別名稱。
enabled	boolean	值，指出是否啟用此記錄檔。