Partager via


Management Group Diagnostic Settings - Create Or Update

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

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

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