Dela via

Azure Resource Notifications – Resource Management-händelser i Azure Event Grid

  • Artikel

Azure Resource Management-systemavsnittet ger insikter om livscykeln för olika Azure-resurser.

Event Grid-systemämnena för Azure-prenumerationer och Azure-resursgrupper tillhandahåller händelser för resurslivscykeln med hjälp av ett bredare utbud av händelsetyper, inklusive åtgärds-, skriv- och borttagningshändelser för scenarier som rör lyckade, misslyckade och annulleringar. Det är dock värt att notera att de inte innehåller resursnyttolasten. Mer information om dessa händelser finns i Event Grid-systemavsnittet för Azure-prenumerationer och Event Grid-systemavsnittet för Azure-resursgrupper.

Däremot erbjuder Azure Resource Notifications (ARN) azure resource management system topic ett mer målinriktat urval av händelsetyper, särskilt CreatedOrUpdated (som motsvarar ResourceWriteSuccess i event grid Azure-prenumerationssystemavsnittet) och Deleted (som motsvarar ResourceDeleteSuccess i avsnittet Event Grid Azure-prenumerationssystem). Dessa händelser kommer med omfattande nyttolastinformation, vilket gör det enklare för kunder att tillämpa filtrering och förfina sin meddelandeström.

Listan över tillgängliga resurstyper finns i Azure Resource Graph-resurser eller använd följande Azure Resource Graph-fråga.

resources
| distinct ['type']

Kommentar

Azure Resource Management-systemavsnittet stöder ännu inte alla resurstyper från resurstabellen i Azure Resource Graph. Vi arbetar med att förbättra den här upplevelsen.

Händelsetyper

ARN-resurssystemavsnittet erbjuder två händelsetyper för förbrukning:

Händelsetyp beskrivning
Microsoft.ResourceNotifications.Resources.CreatedOrUpdated Utlöses när en resurs har skapats eller uppdaterats.
Microsoft.ResourceNotifications.Resources.Deleted Utlöses när en resurs tas bort.

Rollbaserad åtkomstkontroll

För närvarande genereras dessa händelser exklusivt i Azure-prenumerationsomfånget. Det innebär att entiteten som skapar händelseprenumerationen för den här ämnestypen tar emot meddelanden i hela den här Azure-prenumerationen. Av säkerhetsskäl är det absolut nödvändigt att begränsa möjligheten att skapa händelseprenumerationer i det här avsnittet till huvudkonton med läsåtkomst över hela Azure-prenumerationen. För att få åtkomst till data via det här systemavsnittet, utöver de allmänna behörigheter som krävs av Event Grid, krävs följande specifika behörighet för Azure Resource Notifications: Microsoft.ResourceNotifications/systemTopics/subscribeToResources/action.

Händelsescheman

Det här avsnittet innehåller scheman CreatedOrUpdated för händelserna och Deleted .

Händelseschema för CreatedOrUpdated-händelse

Här är schemat:

{
    "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"
}

Händelseschema för borttagen händelse

Här är schemat:

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

En händelse i Event Grid-händelseschemaformatet har följande egenskaper på den översta nivån:

Property Type Description
id String Unik identifierare för händelsen
topic String Den Azure-prenumeration som det här systemämnet skapas för
subject String Den utgivardefinierade sökvägen till den basresurs som händelsen genereras på.
data Objekt Innehåller händelsedata som är specifika för resursprovidern. Mer information finns i nästa tabell.
eventType String Registrerad händelsetyp av den här systemämnestypen
dataVersion String Schemaversionen av dataobjektet
metadataVersion String Schemaversionen av händelsemetadata
eventTime Sträng
Format: 2022-11-07T18:43:09.2894075Z		 Den tid då händelsen genereras baserat på leverantörens UTC-tid

En händelse i molnhändelseschemaformatet har följande egenskaper på den översta nivån:

Property Type Description
id String Unik identifierare för händelsen
source String Den Azure-prenumeration som det här systemämnet skapas för.
subject String Den utgivardefinierade sökvägen till den basresurs som händelsen genereras på.
type String Registrerad händelsetyp av den här systemämnestypen
time Sträng
Format: 2022-11-07T18:43:09.2894075Z		 Den tid då händelsen genereras baserat på leverantörens UTC-tid
data Objekt Innehåller händelsedata som är specifika för resursprovidern. Mer information finns i nästa tabell.
specversion String CloudEvents schemaspecifikationsversion.

Objektet data har följande egenskaper:

Property Type Beskrivning
resourceInfo Objekt Data som är specifika för resursen. Mer information finns i nästa tabell.
apiVersion String API-versionen av resursegenskaperna.
operationalInfo Objekt Information om driftinformation som rör resursen.

Objektet resourceInfo har följande vanliga egenskaper för och CreatedOrUpdated Deleted händelser:

Property Type Description
id String Publisher-definierad sökväg till händelseämnet
name String Det här fältet anger händelse-ID. Det tar alltid värdet för det sista avsnittet i id fältet.
type String Den typ av händelse som genereras. I det här sammanhanget är det antingen Microsoft.ResourceNotifications.Resources.CreatedOrUpdated eller Microsoft.ResourceNotifications.Resources.Deleted.

Objektet resourceInfo för CreatedOrUpdated händelsen har följande extra egenskaper:

Property Type Description
location String Plats eller region där resursen finns.
tags String Taggar för resursen.
properties Objekt Nyttolasten för resursen.

Endast händelsen CreatedOrUpdated innehåller objektet properties . Schemat för det här properties objektet är unikt för varje utgivare. Information om schemat finns i REST API-dokumentationen för den specifika Azure-resursen. Du hittar ett exempel i avsnittet Exempelhändelser i den här artikeln.

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

Objektet operationalInfo har följande egenskaper:

Property Type Beskrivning
resourceEventTime Datum/tid Datum och tid då resursen skapades eller uppdaterades (för CreatedOrUpdated händelse) eller togs bort (för Deleted händelse).

Exempelhändelser

CreatedOrUpdated-händelse

Det här avsnittet visar händelsen CreatedOrUpdated som genereras när ett Azure Storage-konto skapas i Den Azure-prenumeration där systemämnet skapas.

{
  "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/{subcription-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"
}

Borttagen händelse

Det här avsnittet visar händelsen Deleted som genereras när ett Azure Storage-konto tas bort i Den Azure-prenumeration där systemämnet skapas.

{
  "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"
}

Kontakta oss

Om du har frågor eller feedback om den här funktionen kan du kontakta oss på arnsupport@microsoft.com.

Ange följande information för att bättre hjälpa dig med specifik feedback om en viss händelse:

För saknade händelser:

  • Namn på systemämnestyp
  • Ungefärlig tidsstämpel i UTC när åtgärden kördes
  • Basresurs-ID som meddelandet genererades för
  • Gå till resursen i Azure-portalen och välj JSON-vy längst till höger. Resurs-ID är det första fältet på JSON-vysidan.
  • Förväntad händelsetyp
  • Åtgärden utfördes (till exempel startad eller stoppad virtuell dator, lagringskonto som skapats osv.)
  • Beskrivning av påträffade problem (till exempel startad virtuell dator och ingen Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged-händelse genererad)
  • Ange om möjligt korrelations-ID för den utförda åtgärden

För händelse som har fördröjts eller har oväntat innehåll

  • Namn på systemämnestyp
  • Hela innehållet i meddelandet exklusive data.resourceInfo.properties
  • Beskrivning av problem som påträffas och påverkade fältvärden

Se till att du inte tillhandahåller någon identifierbar information för slutanvändare när du delar dessa data.

Nästa steg

Se Prenumerera på Azure Resource Notifications – Resource Management-händelser.