Management Group Diagnostic Settings - Create Or Update

Referens

Service:: Monitor

API Version:: 2020-01-01-preview

Skapar eller uppdaterar diagnostikinställningar för hanteringsgruppen för den angivna resursen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
managementGroupId	path	True	string	Hanteringsgruppens ID.
name	path	True	string	Namnet på diagnostikinställningen.
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
location	string	Platsen för resursen
properties.eventHubAuthorizationRuleId	string	Resurs-ID:t för händelsehubbens auktoriseringsregel.
properties.eventHubName	string	Namnet på händelsehubben. Om ingen anges väljs standardhändelsehubben.
properties.logs	ManagementGroupLogSettings[]	Listan över logginställningar.
properties.serviceBusRuleId	string	Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet.
properties.storageAccountId	string	Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till.
properties.workspaceId	string	Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Svar

Name	Typ	Description
200 OK	ManagementGroupDiagnosticSettingsResource	Lyckad begäran om att skapa en diagnostikinställning för hanteringsgrupp
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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

Definitioner

Name	Description
ErrorResponse	Beskriver formatet felsvar.
ManagementGroupDiagnosticSettingsResource	Diagnostikinställningsresursen för hanteringsgruppen.
ManagementGroupLogSettings	En del av diagnostikinställningen för hanteringsgrupp. Anger inställningarna för en viss logg.

ErrorResponse

Beskriver formatet felsvar.

Name	Typ	Description
code	string	Felkod
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ManagementGroupDiagnosticSettingsResource

Diagnostikinställningsresursen för hanteringsgruppen.

Name	Typ	Description
id	string	Azure-resurs-ID
location	string	Platsen för resursen
name	string	Azure-resursnamn
properties.eventHubAuthorizationRuleId	string	Resurs-ID:t för händelsehubbens auktoriseringsregel.
properties.eventHubName	string	Namnet på händelsehubben. Om ingen anges väljs standardhändelsehubben.
properties.logs	ManagementGroupLogSettings[]	Listan över logginställningar.
properties.serviceBusRuleId	string	Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet.
properties.storageAccountId	string	Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till.
properties.workspaceId	string	Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Azure-resurstyp

ManagementGroupLogSettings

En del av diagnostikinställningen för hanteringsgrupp. Anger inställningarna för en viss logg.

Name	Typ	Description
category	string	Namnet på en kategori för diagnostiklogg för hanteringsgrupp för en resurstyp som den här inställningen tillämpas på.
enabled	boolean	ett värde som anger om den här loggen är aktiverad.