Freigeben über

Management Group Diagnostic Settings - Create Or Update

Dienst:
Monitor
API-Version:
2020-01-01-preview

Erstellt oder aktualisiert die 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

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Typ Beschreibung
location

string

Speicherort der Ressource
properties.eventHubAuthorizationRuleId

string

Die Ressourcen-ID für die Ereignishub-Autorisierungsregel.
properties.eventHubName

string

Der Name des Event Hubs. Wenn keine angegeben ist, wird der Standardereignishub ausgewählt.
properties.logs

ManagementGroupLogSettings[]

Die Liste der Protokolleinstellungen.
properties.serviceBusRuleId

string

Die Dienstbusregel-ID der Diagnoseeinstellung. Dies ist hier, um die Abwärtskompatibilität aufrechtzuerhalten.
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 Diagnoseeinstellung für Verwaltungsgruppen
Other Status Codes

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Statuscode:
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

Objekt

Beschreibt das Format der Fehlerantwort.

Name Typ Beschreibung
code

string

Fehlercode
message

string

Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ManagementGroupDiagnosticSettingsResource

Objekt

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 Ereignishub-Autorisierungsregel.
properties.eventHubName

string

Der Name des Event Hubs. Wenn keine angegeben ist, wird der Standardereignishub ausgewählt.
properties.logs

ManagementGroupLogSettings[]

Die Liste der Protokolleinstellungen.
properties.serviceBusRuleId

string

Die Dienstbusregel-ID der Diagnoseeinstellung. Dies ist hier, um die Abwärtskompatibilität aufrechtzuerhalten.
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

Objekt

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

Name Typ Beschreibung
category

string

Name einer Diagnoseprotokollkategorie für Verwaltungsgruppen für einen Ressourcentyp, auf den diese Einstellung angewendet wird.
enabled

boolean

ein Wert, der angibt, ob dieses Protokoll aktiviert ist.