Freigeben über


Management Group Diagnostic Settings - Create Or Update

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

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Creates or Updates the management group diagnostic setting

Beispielanforderung

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

Beispiel für eine Antwort

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