Поделиться через

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

Образец запроса

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

значение, указывающее, включен ли этот журнал.