Management Group Diagnostic Settings - Create Or Update

Referência

Service:: Monitor

API Version:: 2020-01-01-preview

Cria ou atualiza as configurações de diagnóstico do grupo de gerenciamento para o recurso especificado.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
managementGroupId	path	True	string	A ID do grupo de gerenciamento.
name	path	True	string	O nome da configuração de diagnóstico.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
location	string	Local do recurso
properties.eventHubAuthorizationRuleId	string	A ID do recurso para a regra de autorização do hub de eventos.
properties.eventHubName	string	O nome do hub de eventos. Se nenhum for especificado, o hub de eventos padrão será selecionado.
properties.logs	ManagementGroupLogSettings[]	A lista de configurações de logs.
properties.serviceBusRuleId	string	A ID da regra do barramento de serviço da configuração de diagnóstico. Isso ocorre para manter a compatibilidade com versões anteriores.
properties.storageAccountId	string	A ID do recurso da conta de armazenamento para a qual você deseja enviar logs de diagnóstico.
properties.workspaceId	string	A ID completa do recurso arm do workspace do Log Analytics para o qual você deseja enviar logs de diagnóstico. Exemplo: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Respostas

Nome	Tipo	Description
200 OK	ManagementGroupDiagnosticSettingsResource	Solicitação bem-sucedida para criar uma configuração de diagnóstico do grupo de gerenciamento
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Definições

Nome	Description
ErrorResponse	Descreve o formato da resposta de erro.
ManagementGroupDiagnosticSettingsResource	O recurso de configuração de diagnóstico do grupo de gerenciamento.
ManagementGroupLogSettings	Parte da configuração de diagnóstico do Grupo de Gerenciamento. Especifica as configurações de um log específico.

ErrorResponse

Descreve o formato da resposta de erro.

Nome	Tipo	Description
code	string	Código do erro
message	string	Mensagem de erro indicando por que a operação falhou.

ManagementGroupDiagnosticSettingsResource

O recurso de configuração de diagnóstico do grupo de gerenciamento.

Nome	Tipo	Description
id	string	ID do recurso do Azure
location	string	Local do recurso
name	string	Nome do recurso do Azure
properties.eventHubAuthorizationRuleId	string	A ID do recurso para a regra de autorização do hub de eventos.
properties.eventHubName	string	O nome do hub de eventos. Se nenhum for especificado, o hub de eventos padrão será selecionado.
properties.logs	ManagementGroupLogSettings[]	A lista de configurações de logs.
properties.serviceBusRuleId	string	A ID da regra do barramento de serviço da configuração de diagnóstico. Isso ocorre para manter a compatibilidade com versões anteriores.
properties.storageAccountId	string	A ID do recurso da conta de armazenamento para a qual você deseja enviar logs de diagnóstico.
properties.workspaceId	string	A ID completa do recurso arm do workspace do Log Analytics para o qual você deseja enviar logs de diagnóstico. Exemplo: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Tipo de recurso do Azure

ManagementGroupLogSettings

Parte da configuração de diagnóstico do Grupo de Gerenciamento. Especifica as configurações de um log específico.

Nome	Tipo	Description
category	string	Nome de uma categoria de Log de Diagnóstico do Grupo de Gerenciamento para um tipo de recurso ao qual essa configuração é aplicada.
enabled	boolean	um valor que indica se esse log está habilitado.