Partilhar via


Management Group Diagnostic Settings - Create Or Update

Cria ou atualiza as definições de diagnóstico do grupo de gestão 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 do URI

Name Em Necessário Tipo Description
managementGroupId
path True

string

O ID do grupo de gestão.

name
path True

string

O nome da definição de diagnóstico.

api-version
query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Tipo Description
location

string

Localização do recurso

properties.eventHubAuthorizationRuleId

string

O ID do recurso da regra de autorização do hub de eventos.

properties.eventHubName

string

O nome do hub de eventos. Se não for especificado nenhum, o hub de eventos predefinido será selecionado.

properties.logs

ManagementGroupLogSettings[]

A lista de definições de registos.

properties.serviceBusRuleId

string

O ID da regra do service bus da definição de diagnóstico. Isto está aqui para manter a retrocompatibilidade.

properties.storageAccountId

string

O ID de recurso da conta de armazenamento para a qual pretende enviar Registos de Diagnóstico.

properties.workspaceId

string

O ID de recurso do ARM completo da área de trabalho do Log Analytics para a qual gostaria de enviar Registos de Diagnóstico. Exemplo: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Respostas

Name Tipo Description
200 OK

ManagementGroupDiagnosticSettingsResource

Pedido com êxito para criar uma definição de diagnóstico do grupo de gestão

Other Status Codes

ErrorResponse

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Creates or Updates the management group diagnostic setting

Pedido de amostra

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

Resposta da amostra

{
  "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

Name Description
ErrorResponse

Descreve o formato de Resposta a erros.

ManagementGroupDiagnosticSettingsResource

O recurso de definição de diagnóstico do grupo de gestão.

ManagementGroupLogSettings

Parte da definição de diagnóstico do Grupo de Gestão. Especifica as definições de um registo específico.

ErrorResponse

Descreve o formato de Resposta a erros.

Name Tipo Description
code

string

Código de erro

message

string

Mensagem de erro a indicar por que motivo a operação falhou.

ManagementGroupDiagnosticSettingsResource

O recurso de definição de diagnóstico do grupo de gestão.

Name Tipo Description
id

string

ID do recurso do Azure

location

string

Localização do recurso

name

string

Nome do recurso do Azure

properties.eventHubAuthorizationRuleId

string

O ID do recurso da regra de autorização do hub de eventos.

properties.eventHubName

string

O nome do hub de eventos. Se não for especificado nenhum, o hub de eventos predefinido será selecionado.

properties.logs

ManagementGroupLogSettings[]

A lista de definições de registos.

properties.serviceBusRuleId

string

O ID da regra do service bus da definição de diagnóstico. Isto está aqui para manter a retrocompatibilidade.

properties.storageAccountId

string

O ID de recurso da conta de armazenamento para a qual pretende enviar Registos de Diagnóstico.

properties.workspaceId

string

O ID de recurso do ARM completo da área de trabalho do Log Analytics para a qual gostaria de enviar Registos 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 definição de diagnóstico do Grupo de Gestão. Especifica as definições de um registo específico.

Name Tipo Description
category

string

Nome de uma categoria de Registo de Diagnóstico de Grupo de Gestão para um tipo de recurso a que esta definição é aplicada.

enabled

boolean

um valor que indica se este registo está ativado.