Condividi tramite

Management Group Diagnostic Settings - Create Or Update

  • Riferimento
Servizio:
Monitor
Versione API:
2020-01-01-preview

Crea o aggiorna le impostazioni di diagnostica del gruppo di gestione per la risorsa specificata.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
managementGroupId
 path True

string

ID del gruppo di gestione.
name
 path True

string

Nome dell'impostazione di diagnostica.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Tipo Descrizione
location

string

Posizione della risorsa
properties.eventHubAuthorizationRuleId

string

ID risorsa per la regola di autorizzazione dell'hub eventi.
properties.eventHubName

string

Nome dell'hub eventi. Se non viene specificato alcun valore, verrà selezionato l'hub eventi predefinito.
properties.logs

ManagementGroupLogSettings[]

Elenco delle impostazioni dei log.
properties.serviceBusRuleId

string

ID regola del bus di servizio dell'impostazione di diagnostica. Questo è qui per mantenere la compatibilità con le versioni precedenti.
properties.storageAccountId

string

ID risorsa dell'account di archiviazione a cui inviare i log di diagnostica.
properties.workspaceId

string

ID risorsa ARM completo dell'area di lavoro Log Analytics a cui inviare i log di diagnostica. Esempio: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Risposte

Nome Tipo Descrizione
200 OK

ManagementGroupDiagnosticSettingsResource

Richiesta riuscita per creare un'impostazione di diagnostica del gruppo di gestione
Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Creates or Updates the management group diagnostic setting

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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
      }
    ]
  }
}

Definizioni

Nome Descrizione
ErrorResponse

Descrive il formato della risposta di errore.
ManagementGroupDiagnosticSettingsResource

Risorsa dell'impostazione di diagnostica del gruppo di gestione.
ManagementGroupLogSettings

Parte dell'impostazione di diagnostica del gruppo di gestione. Specifica le impostazioni per un particolare log.

ErrorResponse

Object

Descrive il formato della risposta di errore.

Nome Tipo Descrizione
code

string

Codice di errore
message

string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ManagementGroupDiagnosticSettingsResource

Object

Risorsa dell'impostazione di diagnostica del gruppo di gestione.

Nome Tipo Descrizione
id

string

ID risorsa di Azure
location

string

Posizione della risorsa
name

string

Nome risorsa di Azure
properties.eventHubAuthorizationRuleId

string

ID risorsa per la regola di autorizzazione dell'hub eventi.
properties.eventHubName

string

Nome dell'hub eventi. Se non viene specificato alcun valore, verrà selezionato l'hub eventi predefinito.
properties.logs

ManagementGroupLogSettings[]

Elenco delle impostazioni dei log.
properties.serviceBusRuleId

string

ID regola del bus di servizio dell'impostazione di diagnostica. Questo è qui per mantenere la compatibilità con le versioni precedenti.
properties.storageAccountId

string

ID risorsa dell'account di archiviazione a cui inviare i log di diagnostica.
properties.workspaceId

string

ID risorsa ARM completo dell'area di lavoro Log Analytics a cui inviare i log di diagnostica. Esempio: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type

string

Tipo di risorsa di Azure

ManagementGroupLogSettings

Object

Parte dell'impostazione di diagnostica del gruppo di gestione. Specifica le impostazioni per un particolare log.

Nome Tipo Descrizione
category

string

Nome di una categoria log di diagnostica del gruppo di gestione per un tipo di risorsa a cui viene applicata questa impostazione.
enabled

boolean

valore che indica se il log è abilitato.