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

Имя	В	Обязательно	Тип	Описание
managementGroupId	path	True	string	Идентификатор группы управления.
name	path	True	string	Имя параметра диагностики.
api-version	query	True	string minLength: 1	Версия API, используемая для этой операции.

Текст запроса

Имя	Тип	Описание
location	string	Расположение ресурса
properties.eventHubAuthorizationRuleId	string	Идентификатор ресурса для правила авторизации концентратора событий.
properties.eventHubName	string	Имя концентратора событий. Если ни один из них не указан, будет выбран концентратор событий по умолчанию.
properties.logs	ManagementGroupLogSettings[]	Список параметров журналов.
properties.serviceBusRuleId	string	Идентификатор правила служебной шины параметра диагностики. Здесь для обеспечения обратной совместимости.
properties.storageAccountId	string	Идентификатор ресурса учетной записи хранения, в которую вы хотите отправить журналы диагностики.
properties.workspaceId	string	Полный идентификатор ресурса ARM рабочей области Log Analytics, в которую вы хотите отправить журналы диагностики. Пример: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Ответы

Имя	Тип	Описание
200 OK	ManagementGroupDiagnosticSettingsResource	Успешный запрос на создание параметра диагностики группы управления
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
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
      }
    ]
  }
}

Определения

Имя	Описание
ErrorResponse	Описывает формат ответа на ошибку.
ManagementGroupDiagnosticSettingsResource	Ресурс параметра диагностики группы управления.
ManagementGroupLogSettings	Часть параметра диагностики группы управления. Задает параметры для определенного журнала.

ErrorResponse

Object

Описывает формат ответа на ошибку.

Имя	Тип	Описание
code	string	Код ошибки
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

ManagementGroupDiagnosticSettingsResource

Object

Ресурс параметра диагностики группы управления.

Имя	Тип	Описание
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	Полный идентификатор ресурса ARM рабочей области Log Analytics, в которую вы хотите отправить журналы диагностики. Пример: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Тип ресурса Azure

ManagementGroupLogSettings

Object

Часть параметра диагностики группы управления. Задает параметры для определенного журнала.

Имя	Тип	Описание
category	string	Имя категории журнала диагностики группы управления для типа ресурса применяется к этому параметру.
enabled	boolean	значение, указывающее, включен ли этот журнал.