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

Management Group Diagnostic Settings - Create Or Update

参考

Service:: Monitor

API Version:: 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 参数

名称	在	必需	类型	说明
managementGroupId	path	True	string	管理组 ID。
name	path	True	string	诊断设置的名称。
api-version	query	True	string	要用于此操作的 API 版本。

请求正文

名称	类型	说明
location	string	资源的位置
properties.eventHubAuthorizationRuleId	string	事件中心授权规则的资源 ID。
properties.eventHubName	string	事件中心的名称。如果未指定任何内容，则将选择默认事件中心。
properties.logs	ManagementGroupLogSettings[]	日志设置的列表。
properties.serviceBusRuleId	string	诊断设置的服务总线规则 ID。这是为了保持向后兼容性。
properties.storageAccountId	string	要向其发送诊断日志的存储帐户的资源 ID。
properties.workspaceId	string	要向其发送诊断日志的 Log Analytics 工作区的完整 ARM 资源 ID。示例：/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

响应

名称	类型	说明
200 OK	ManagementGroupDiagnosticSettingsResource	成功请求创建管理组诊断设置
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Creates or Updates the management group diagnostic setting

Sample Request

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
      }
    ]
  }
}

Sample Response

Status code:: 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
      }
    ]
  }
}

定义

名称	说明
ErrorResponse	描述错误响应的格式。
ManagementGroupDiagnosticSettingsResource	管理组诊断设置资源。
ManagementGroupLogSettings	管理组诊断设置的一部分。指定特定日志的设置。

ErrorResponse

描述错误响应的格式。

名称	类型	说明
code	string	错误代码
message	string	指示操作失败原因的错误消息。

ManagementGroupDiagnosticSettingsResource

管理组诊断设置资源。

名称	类型	说明
id	string	Azure 资源 ID
location	string	资源的位置
name	string	Azure 资源名称
properties.eventHubAuthorizationRuleId	string	事件中心授权规则的资源 ID。
properties.eventHubName	string	事件中心的名称。如果未指定任何内容，则将选择默认事件中心。
properties.logs	ManagementGroupLogSettings[]	日志设置的列表。
properties.serviceBusRuleId	string	诊断设置的服务总线规则 ID。这是为了保持向后兼容性。
properties.storageAccountId	string	要向其发送诊断日志的存储帐户的资源 ID。
properties.workspaceId	string	要向其发送诊断日志的 Log Analytics 工作区的完整 ARM 资源 ID。示例：/subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Azure 资源类型

ManagementGroupLogSettings

管理组诊断设置的一部分。指定特定日志的设置。

名称	类型	说明
category	string	应用此设置的资源类型的管理组诊断日志类别的名称。
enabled	boolean	一个值，该值指示是否启用此日志。