Management Group Diagnostic Settings - Create Or Update

Référence

Service:: Monitor

Version d'API:: 2020-01-01-preview

Crée ou met à jour les paramètres de diagnostic du groupe d’administration pour la ressource spécifiée.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
managementGroupId	path	True	string	ID du groupe d’administration.
name	path	True	string	Nom du paramètre de diagnostic.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
location	string	Emplacement de la ressource
properties.eventHubAuthorizationRuleId	string	ID de ressource pour la règle d’autorisation du hub d’événements.
properties.eventHubName	string	Nom du hub d’événements. Si aucun n’est spécifié, le hub d’événements par défaut est sélectionné.
properties.logs	ManagementGroupLogSettings[]	Liste des paramètres des journaux.
properties.serviceBusRuleId	string	ID de règle Service Bus du paramètre de diagnostic. Ceci est là pour maintenir la compatibilité descendante.
properties.storageAccountId	string	ID de ressource du compte de stockage auquel vous souhaitez envoyer les journaux de diagnostic.
properties.workspaceId	string	ID de ressource ARM complet de l’espace de travail Log Analytics auquel vous souhaitez envoyer les journaux de diagnostic. Exemple : /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2

Réponses

Nom	Type	Description
200 OK	ManagementGroupDiagnosticSettingsResource	Demande de création d’un paramètre de diagnostic de groupe d’administration réussie
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Creates or Updates the management group diagnostic setting

Exemple de requête

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

Exemple de réponse

Code d’état:: 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
      }
    ]
  }
}

Définitions

Nom	Description
ErrorResponse	Décrit le format de la réponse d’erreur.
ManagementGroupDiagnosticSettingsResource	Ressource de paramètre de diagnostic du groupe d’administration.
ManagementGroupLogSettings	Partie du paramètre de diagnostic du groupe d’administration. Spécifie les paramètres d’un journal particulier.

ErrorResponse

Décrit le format de la réponse d’erreur.

Nom	Type	Description
code	string	Code d'erreur
message	string	Message d’erreur indiquant la raison de l’échec de l’opération.

ManagementGroupDiagnosticSettingsResource

Ressource de paramètre de diagnostic du groupe d’administration.

Nom	Type	Description
id	string	ID de ressource Azure
location	string	Emplacement de la ressource
name	string	Nom de la ressource Azure
properties.eventHubAuthorizationRuleId	string	ID de ressource pour la règle d’autorisation du hub d’événements.
properties.eventHubName	string	Nom du hub d’événements. Si aucun n’est spécifié, le hub d’événements par défaut est sélectionné.
properties.logs	ManagementGroupLogSettings[]	Liste des paramètres des journaux.
properties.serviceBusRuleId	string	ID de règle Service Bus du paramètre de diagnostic. Ceci est là pour maintenir la compatibilité descendante.
properties.storageAccountId	string	ID de ressource du compte de stockage auquel vous souhaitez envoyer les journaux de diagnostic.
properties.workspaceId	string	ID de ressource ARM complet de l’espace de travail Log Analytics auquel vous souhaitez envoyer les journaux de diagnostic. Exemple : /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2
type	string	Type de ressource Azure

ManagementGroupLogSettings

Partie du paramètre de diagnostic du groupe d’administration. Spécifie les paramètres d’un journal particulier.

Nom	Type	Description
category	string	Nom d’une catégorie de journal de diagnostic de groupe d’administration pour un type de ressource auquel ce paramètre est appliqué.
enabled	boolean	valeur indiquant si ce journal est activé.

Partager via