Management Group Diagnostic Settings - Create Or Update

Referencia

Service:: Monitor

API Version:: 2020-01-01-preview

Crea o actualiza la configuración de diagnóstico del grupo de administración para el 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 identificador URI

Nombre	En	Requerido	Tipo	Description
managementGroupId	path	True	string	Identificador del grupo de administración.
name	path	True	string	Nombre de la configuración de diagnóstico.
api-version	query	True	string	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
location	string	Ubicación del recurso
properties.eventHubAuthorizationRuleId	string	Identificador de recurso de la regla de autorización del centro de eventos.
properties.eventHubName	string	El nombre del centro de eventos. Si no se especifica ninguno, se seleccionará el centro de eventos predeterminado.
properties.logs	ManagementGroupLogSettings[]	Lista de la configuración de registros.
properties.serviceBusRuleId	string	Identificador de la regla de Service Bus de la configuración de diagnóstico. Esto está aquí para mantener la compatibilidad con versiones anteriores.
properties.storageAccountId	string	Identificador de recurso de la cuenta de almacenamiento a la que desea enviar registros de diagnóstico.
properties.workspaceId	string	El identificador de recurso arm completo del área de trabajo de Log Analytics a la que desea enviar registros de diagnóstico. Ejemplo: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Respuestas

Nombre	Tipo	Description
200 OK	ManagementGroupDiagnosticSettingsResource	Solicitud correcta para crear una configuración de diagnóstico de grupo de administración
Other Status Codes	ErrorResponse	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

Nombre	Description
ErrorResponse	Describe el formato de respuesta de error.
ManagementGroupDiagnosticSettingsResource	Recurso de configuración de diagnóstico del grupo de administración.
ManagementGroupLogSettings	Parte de la configuración de diagnóstico del grupo de administración. Especifica la configuración de un registro determinado.

ErrorResponse

Describe el formato de respuesta de error.

Nombre	Tipo	Description
code	string	Código de error
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

ManagementGroupDiagnosticSettingsResource

Recurso de configuración de diagnóstico del grupo de administración.

Nombre	Tipo	Description
id	string	Identificador de recurso de Azure
location	string	Ubicación del recurso
name	string	Nombre de recurso de Azure
properties.eventHubAuthorizationRuleId	string	Identificador de recurso de la regla de autorización del centro de eventos.
properties.eventHubName	string	El nombre del centro de eventos. Si no se especifica ninguno, se seleccionará el centro de eventos predeterminado.
properties.logs	ManagementGroupLogSettings[]	Lista de la configuración de registros.
properties.serviceBusRuleId	string	Identificador de la regla de Service Bus de la configuración de diagnóstico. Esto está aquí para mantener la compatibilidad con versiones anteriores.
properties.storageAccountId	string	Identificador de recurso de la cuenta de almacenamiento a la que desea enviar registros de diagnóstico.
properties.workspaceId	string	El identificador de recurso arm completo del área de trabajo de Log Analytics a la que desea enviar registros de diagnóstico. Ejemplo: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Tipo de recurso de Azure

ManagementGroupLogSettings

Parte de la configuración de diagnóstico del grupo de administración. Especifica la configuración de un registro determinado.

Nombre	Tipo	Description
category	string	Nombre de una categoría registro de diagnóstico de grupo de administración para un tipo de recurso al que se aplica esta configuración.
enabled	boolean	un valor que indica si este registro está habilitado.