Partilhar via

Management Group Diagnostic Settings - Create Or Update

Serviço:
Monitor
Versão da API:
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 do URI

Name Em Necessá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

minLength: 1

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

Corpo do Pedido

Name Tipo Description
location

string

Localização 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 está aqui para manter a compatibilidade com versões anteriores.
properties.storageAccountId

string

O ID do recurso da conta de armazenamento para a qual você deseja enviar Logs de Diagnóstico.
properties.workspaceId

string

O ID de recurso ARM completo do espaço de trabalho 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

Name Tipo Description
200 OK

ManagementGroupDiagnosticSettingsResource

Solicitação bem-sucedida para criar uma configuração de diagnóstico de grupo de gerenciamento
Other Status Codes

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name Description
user_impersonation personificar 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

Código de estado:
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

Name Description
ErrorResponse

Descreve o formato de 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 para um log específico.

ErrorResponse

Object

Descreve o formato de Resposta de erro.

Name Tipo Description
code

string

Código de erro
message

string

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

ManagementGroupDiagnosticSettingsResource

Object

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

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

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 está aqui para manter a compatibilidade com versões anteriores.
properties.storageAccountId

string

O ID do recurso da conta de armazenamento para a qual você deseja enviar Logs de Diagnóstico.
properties.workspaceId

string

O ID de recurso ARM completo do espaço de trabalho 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

Object

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

Name 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.