Delen via

Azure-resourcemeldingen - Resourcebeheergebeurtenissen in Azure Event Grid

  • Artikel

Het azure Resource Management-systeemonderwerp biedt inzicht in de levenscyclus van verschillende Azure-resources.

De Event Grid-systeemonderwerpen voor Azure-abonnementen en Azure-resourcegroepen bieden gebeurtenissen in de levenscyclus van resources met behulp van een breder scala aan gebeurtenistypen, waaronder actie, schrijven en verwijderen van gebeurtenissen voor scenario's met betrekking tot succes, fouten en annulering. Het is echter wel de moeite waard om te weten dat ze de nettolading van de resource niet bevatten. Zie event grid-systeemonderwerp voor Azure-abonnementen en Event Grid-systeemonderwerp voor Azure-resourcegroepen voor meer informatie over deze gebeurtenissen.

Het azure Resource Management-systeemonderwerp (ARN) biedt daarentegen een meer gerichte selectie van gebeurtenistypen, met name CreatedOrUpdated (corresponderend met ResourceWriteSuccess het Event Grid Azure-abonnementssysteemonderwerp) en Deleted (overeenkomstig ResourceDeleteSuccess in het Event Grid Azure-abonnementssysteemonderwerp). Deze gebeurtenissen worden geleverd met uitgebreide nettoladinginformatie, waardoor klanten gemakkelijker filters kunnen toepassen en hun meldingsstroom kunnen verfijnen.

Zie Azure Resource Graph-resources of gebruik de volgende Azure Resource Graph-query voor de lijst met weergegeven resourcetypen.

resources
| distinct ['type']

Notitie

Het azure Resource Management-systeemonderwerp biedt nog geen ondersteuning voor alle resourcetypen uit de resourcetabel van Azure Resource Graph. We werken aan het verbeteren van deze ervaring.

Gebeurtenistypen

Arn Resources-systeemonderwerp biedt twee gebeurtenistypen voor gebruik:

Gebeurtenistype Beschrijving
Microsoft.ResourceNotifications.Resources.CreatedOrUpdated Gegenereerd wanneer een resource is gemaakt of bijgewerkt.
Microsoft.ResourceNotifications.Resources.Deleted Wordt gegenereerd wanneer een resource wordt verwijderd.

Op rollen gebaseerd toegangsbeheer

Deze gebeurtenissen worden momenteel uitsluitend verzonden op het azure-abonnementsbereik. Het impliceert dat de entiteit die het gebeurtenisabonnement voor dit onderwerptype maakt, meldingen ontvangt in dit Azure-abonnement. Om veiligheidsredenen is het noodzakelijk om de mogelijkheid om gebeurtenisabonnementen op dit onderwerp te maken te beperken tot principals met leestoegang voor het hele Azure-abonnement. Als u toegang wilt krijgen tot gegevens via dit systeemonderwerp, is naast de algemene machtigingen die zijn vereist voor Event Grid, de volgende specifieke machtiging voor Azure-resourcemeldingen nodig: Microsoft.ResourceNotifications/systemTopics/subscribeToResources/action.

Gebeurtenisschema's

Deze sectie bevat schema's voor de CreatedOrUpdated en Deleted gebeurtenissen.

Gebeurtenisschema voor de gebeurtenis CreatedOrUpdated

Dit is het schema:

{
    "id": "string",
    "source": "string",
    "subject": "string",
    "data": {
        "resourceInfo": {
            "id": "string",
            "name": "string",
            "type": "string",
            "location": "string",
            "tags": "string",
            "properties": {
                "_comment": "object-unique-to-each-publisher"
            }
        },
        "apiVersion": "string",
        "operationalInfo": {
            "resourceEventTime": "datetime"
        }
    },
    "type": "string",
    "specversion": "string",
    "time": "string"
}

Gebeurtenisschema voor verwijderde gebeurtenis

Dit is het schema:

{
    "id": "string",
    "source": "string",
    "subject": "string",
    "data": {
        "resourceInfo": {
            "id": "string",
            "name": "string",
            "type": "string"
        },
        "operationalInfo": {
            "resourceEventTime": "datetime"
        }
    },
    "type": "string",
    "specversion": "string",
    "time": "string"
}

Een gebeurtenis in de Gebeurtenisschema-indeling van Event Grid heeft de volgende eigenschappen op het hoogste niveau:

Eigenschap Type Omschrijving
id String Unieke id van de gebeurtenis
topic String Het Azure-abonnement waarvoor dit systeemonderwerp wordt gemaakt
subject String Door Publisher gedefinieerd pad naar de basisresource waarop deze gebeurtenis wordt verzonden.
data Object Bevat gebeurtenisgegevens die specifiek zijn voor de resourceprovider. Zie de volgende tabel voor meer informatie.
eventType String Geregistreerd gebeurtenistype van dit type systeemonderwerp
dataVersion String De schemaversie van het gegevensobject
metadataVersion String De schemaversie van de metagegevens van de gebeurtenis
eventTime Snaar
Formatteren: 2022-11-07T18:43:09.2894075Z		 Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider

Een gebeurtenis in de indeling van het cloudgebeurtenisschema heeft de volgende eigenschappen op het hoogste niveau:

Eigenschap Type Omschrijving
id String Unieke id van de gebeurtenis
source String Het Azure-abonnement waarvoor dit systeemonderwerp wordt gemaakt.
subject String Door Publisher gedefinieerd pad naar de basisresource waarop deze gebeurtenis wordt verzonden.
type String Geregistreerd gebeurtenistype van dit type systeemonderwerp
time Snaar
Formatteren: 2022-11-07T18:43:09.2894075Z		 Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider
data Object Bevat gebeurtenisgegevens die specifiek zijn voor de resourceprovider. Zie de volgende tabel voor meer informatie.
specversion String CloudEvents schemaspecificatieversie.

Het data object heeft de volgende eigenschappen:

Eigenschap Type Description
resourceInfo Object Gegevens die specifiek zijn voor de resource. Zie de volgende tabel voor meer informatie.
apiVersion String API-versie van de resource-eigenschappen.
operationalInfo Object Details van operationele informatie met betrekking tot de resource.

Het resourceInfo object heeft de volgende algemene eigenschappen CreatedOrUpdated en Deleted gebeurtenissen:

Eigenschap Type Omschrijving
id String Door Publisher gedefinieerd pad naar het gebeurtenisonderwerp
name String Dit veld geeft de gebeurtenis-id aan. Hierbij wordt altijd de waarde van het laatste gedeelte van het id veld gebruikt.
type String Het type gebeurtenis dat wordt verzonden. In deze context is Microsoft.ResourceNotifications.Resources.CreatedOrUpdated het of Microsoft.ResourceNotifications.Resources.Deleted.

Het resourceInfo object voor de CreatedOrUpdated gebeurtenis heeft de volgende extra eigenschappen:

Eigenschap Type Omschrijving
location String Locatie of regio waar de resource zich bevindt.
tags String Tags voor de resource.
properties Object Nettolading van de resource.

Alleen de CreatedOrUpdated gebeurtenis bevat het properties object. Het schema van dit properties object is uniek voor elke uitgever. Raadpleeg de REST API-documentatie voor de specifieke Azure-resource om het schema te detecteren. U vindt een voorbeeld in de sectie Voorbeelden van gebeurtenissen van dit artikel.

            "properties": {
                "_comment": "<< object-unique-to-each-publisher >>"
            }

Het operationalInfo object heeft de volgende eigenschappen:

Eigenschap Type Description
resourceEventTime Datum en tijd Datum en tijd waarop de resource is gemaakt of bijgewerkt (voor CreatedOrUpdated gebeurtenis) of verwijderd (voor Deleted gebeurtenis).

Voorbeeld van gebeurtenissen

Gebeurtenis CreatedOrUpdated

In deze sectie ziet u de CreatedOrUpdated gebeurtenis die wordt gegenereerd wanneer een Azure Storage-account wordt gemaakt in het Azure-abonnement waarop het systeemonderwerp wordt gemaakt.

{
  "id": "4eef929a-a65c-47dd-93e2-46b8c17c6c17",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Storage/storageAccounts/{storageAccount-name}",
  "data": {
    "resourceInfo": {
      "tags": {},
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Storage/storageAccounts/{storageAccount-name}",
      "name": "StorageAccount-name",
      "type": "Microsoft.Storage/storageAccounts",
      "location": "eastus",
      "properties": {
        "privateEndpointConnections": [],
        "minimumTlsVersion": "TLS1_2",
        "allowBlobPublicAccess": 1,
        "allowSharedKeyAccess": 1,
        "networkAcls": {
          "bypass": "AzureServices",
          "virtualNetworkRules": [],
          "ipRules": [],
          "defaultAction": "Allow"
        },
        "supportsHttpsTrafficOnly": 1,
        "encryption": {
          "requireInfrastructureEncryption": 0,
          "services": {
            "file": {
              "keyType": "Account",
              "enabled": 1,
              "lastEnabledTime": "2023-07-28T20:12:50.6380308Z"
            },
            "blob": {
              "keyType": "Account",
              "enabled": 1,
              "lastEnabledTime": "2023-07-28T20:12:50.6380308Z"
            }
          },
          "keySource": "Microsoft.Storage"
        },
        "accessTier": "Hot",
        "provisioningState": "Succeeded",
        "creationTime": "2023-07-28T20:12:50.4661564Z",
        "primaryEndpoints": {
          "dfs": "https://{storageAccount-name}.dfs.core.windows.net/",
          "web": "https://{storageAccount-name}.z13.web.core.windows.net/",
          "blob": "https://{storageAccount-name}.blob.core.windows.net/",
          "queue": "https://{storageAccount-name}.queue.core.windows.net/",
          "table": "https://{storageAccount-name}.table.core.windows.net/",
          "file": "https://{storageAccount-name}.file.core.windows.net/"
        },
        "primaryLocation": "eastus",
        "statusOfPrimary": "available",
        "secondaryLocation": "westus",
        "statusOfSecondary": "available",
        "secondaryEndpoints": {
          "dfs": "https://{storageAccount-name} -secondary.dfs.core.windows.net/",
          "web": "https://{storageAccount-name}-secondary.z13.web.core.windows.net/",
          "blob": "https://{storageAccount-name}-secondary.blob.core.windows.net/",
          "queue": "https://{storageAccount-name}-secondary.queue.core.windows.net/",
          "table": "https://{storageAccount-name}-secondary.table.core.windows.net/"
        }
      }
    },
    "apiVersion": "2019-06-01",
    "operationalInfo": {
      "resourceEventTime": "2023-07-28T20:13:10.8418063Z"
    }
  },
  "type": "Microsoft.ResourceNotifications.Resources.CreatedOrUpdated",
  "specversion": "1.0",
  "time": "2023-07-28T20:13:10.8418063Z"
}

Verwijderde gebeurtenis

In deze sectie ziet u de Deleted gebeurtenis die wordt gegenereerd wanneer een Azure Storage-account wordt verwijderd in het Azure-abonnement waarop het systeemonderwerp wordt gemaakt.

{
  "id": "d4611260-d179-4f86-b196-3a9d4128be2d",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Storage/storageAccounts/{storageAccount-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Storage/storageAccounts/{storageAccount-name}",
      "name": "storageAccount-name",
      "type": "Microsoft.Storage/storageAccounts"
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-28T20:11:36.6347858Z"
    }
  },
  "type": "Microsoft.ResourceNotifications.Resources.Deleted",
  "specversion": "1.0",
  "time": "2023-07-28T20:11:36.6347858Z"
}

Contact opnemen

Als u vragen of feedback over deze functie hebt, aarzel dan niet om ons te bereiken op arnsupport@microsoft.com.

Geef de volgende informatie op om u beter te helpen met specifieke feedback over een bepaalde gebeurtenis:

Voor ontbrekende gebeurtenissen:

  • Naam van systeemonderwerptype
  • Geschatte tijdstempel in UTC toen de bewerking werd uitgevoerd
  • Basisresource-id waarvoor de melding is gegenereerd
  • Navigeer naar uw resource in Azure Portal en selecteer de JSON-weergave uiterst rechts. Resource-id is het eerste veld op de JSON-weergavepagina.
  • Verwacht gebeurtenistype
  • De bewerking is uitgevoerd (bijvoorbeeld vm gestart of gestopt, opslagaccount gemaakt, enzovoort)
  • Beschrijving van het probleem dat is opgetreden (bijvoorbeeld dat de VM is gestart en er geen gebeurtenis Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged is gegenereerd)
  • Geef indien mogelijk de correlatie-id op van de uitgevoerde bewerking

Voor gebeurtenissen die zijn vertraagd of onverwachte inhoud hebben

  • Naam van systeemonderwerptype
  • Volledige inhoud van de melding met uitzondering van data.resourceInfo.properties
  • Beschrijving van probleem opgetreden en beïnvloede veldwaarden

Zorg ervoor dat u geen identificeerbare informatie voor eindgebruikers opgeeft terwijl u deze gegevens deelt.

Volgende stappen

Zie Abonneren op Azure Resource Notifications - Resource Management-gebeurtenissen.