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 |
---|---|---|---|---|
management
|
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 |
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 |
Erfolgreiche Anforderung zum Erstellen einer Verwaltungsgruppendiagnoseeinstellung |
|
Other Status Codes |
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 |
---|---|
Error |
Beschreibt das Format der Fehlerantwort. |
Management |
Die Diagnoseeinstellungsressource der Verwaltungsgruppe. |
Management |
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 |
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. |