Management Group Diagnostic Settings - Create Or Update

Referenz

Service:: Monitor

API Version:: 2020-01-01-preview

Erstellt oder aktualisiert Diagnoseeinstellungen der Verwaltungsgruppe für die angegebene Ressource.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
managementGroupId	path	True	string	Die Verwaltungsgruppen-ID.
name	path	True	string	Der Name der Diagnoseeinstellung.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
location	string	Speicherort der Ressource
properties.eventHubAuthorizationRuleId	string	Die Ressourcen-ID für die Event Hub-Autorisierungsregel.
properties.eventHubName	string	Der Name des Event Hubs. Wenn keine angegeben ist, wird der Standard-Event Hub ausgewählt.
properties.logs	ManagementGroupLogSettings[]	Die Liste der Protokolleinstellungen.
properties.serviceBusRuleId	string	Die Service Bus-Regel-ID der Diagnoseeinstellung. Dies ist hier, um die Abwärtskompatibilität zu gewährleisten.
properties.storageAccountId	string	Die Ressourcen-ID des Speicherkontos, an das Sie Diagnoseprotokolle senden möchten.
properties.workspaceId	string	Die vollständige ARM-Ressourcen-ID des Log Analytics-Arbeitsbereichs, an den Sie Diagnoseprotokolle senden möchten. Beispiel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Antworten

Name	Typ	Beschreibung
200 OK	ManagementGroupDiagnosticSettingsResource	Erfolgreiche Anforderung zum Erstellen einer Verwaltungsgruppendiagnoseeinstellung
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

Name	Beschreibung
ErrorResponse	Beschreibt das Format der Fehlerantwort.
ManagementGroupDiagnosticSettingsResource	Die Diagnoseeinstellungsressource der Verwaltungsgruppe.
ManagementGroupLogSettings	Teil der Diagnoseeinstellung "Verwaltungsgruppe". Gibt die Einstellungen für ein bestimmtes Protokoll an.

ErrorResponse

Beschreibt das Format der Fehlerantwort.

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ManagementGroupDiagnosticSettingsResource

Die Diagnoseeinstellungsressource der Verwaltungsgruppe.

Name	Typ	Beschreibung
id	string	Azure-Ressourcen-ID
location	string	Speicherort der Ressource
name	string	Name der Azure-Ressource
properties.eventHubAuthorizationRuleId	string	Die Ressourcen-ID für die Event Hub-Autorisierungsregel.
properties.eventHubName	string	Der Name des Event Hubs. Wenn keine angegeben ist, wird der Standard-Event Hub ausgewählt.
properties.logs	ManagementGroupLogSettings[]	Die Liste der Protokolleinstellungen.
properties.serviceBusRuleId	string	Die Service Bus-Regel-ID der Diagnoseeinstellung. Dies ist hier, um die Abwärtskompatibilität zu gewährleisten.
properties.storageAccountId	string	Die Ressourcen-ID des Speicherkontos, an das Sie Diagnoseprotokolle senden möchten.
properties.workspaceId	string	Die vollständige ARM-Ressourcen-ID des Log Analytics-Arbeitsbereichs, an den Sie Diagnoseprotokolle senden möchten. Beispiel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Azure-Ressourcentyp

ManagementGroupLogSettings

Teil der Diagnoseeinstellung "Verwaltungsgruppe". Gibt die Einstellungen für ein bestimmtes Protokoll an.

Name	Typ	Beschreibung
category	string	Name einer Verwaltungsgruppendiagnoseprotokollkategorie für einen Ressourcentyp, auf den diese Einstellung angewendet wird.
enabled	boolean	ein Wert, der angibt, ob dieses Protokoll aktiviert ist.