Megosztás a következőn keresztül:

Azure Resource Notifications – Erőforrás-kezelési események az Azure Event Gridben (előzetes verzió)

  • Cikk

Az Azure Resource Management rendszer témaköre betekintést nyújt a különböző Azure-erőforrások életciklusába.

Az Azure-előfizetésekhez és az Azure-erőforráscsoportokhoz készült Event Grid rendszertémakörök erőforrás-életciklus-eseményeket biztosítanak az eseménytípusok szélesebb körének használatával, beleértve a sikeres, sikertelen és lemondással járó forgatókönyvek eseményeit, írását és törlését. Érdemes azonban megjegyezni, hogy nem tartalmazzák az erőforrás hasznos adatait. Az eseményekkel kapcsolatos részletekért tekintse meg az Azure-előfizetések Event Grid rendszertémakörét és az Azure-erőforráscsoportokhoz tartozó Event Grid-rendszer témakört.

Ezzel szemben az Azure Resource Notifications (ARN) alapú Azure Resource Management-rendszer témaköre célzottabb eseménytípusokat kínál, különösen CreatedOrUpdated (az Event Grid Azure-előfizetési rendszer témakörének megfelelő ResourceWriteSuccess ) és Deleted (az Event Grid Azure-előfizetési rendszer témakörének megfelelő ResourceDeleteSuccess ) eseménytípusokat. Ezek az események átfogó hasznos adatokkal szolgálnak, így az ügyfelek könnyebben alkalmazhatják a szűrést, és finomíthatják az értesítési adatfolyamukat.

A közzétett erőforrástípusok listájáért tekintse meg az Azure Resource Graph-erőforrásokat , vagy használja az alábbi Azure Resource Graph-lekérdezést.

resources
| distinct ['type']

Feljegyzés

Az Azure Resource Management rendszer témaköre még nem támogatja az Azure Resource Graph erőforrástáblájából származó összes erőforrástípust. Dolgozunk a felhasználói élmény javításán.

Eseménytípusok

Az ARN-erőforrások rendszertémaköre két eseménytípust kínál használathoz:

Eseménytípus Leírás
Microsoft.ResourceNotifications.Resources.CreatedOrUpdated Az erőforrás sikeres létrehozásakor vagy frissítésekor merül fel.
Microsoft.ResourceNotifications.Resources.Deleted Erőforrás törlésekor aktiválódik.

Szerepköralapú hozzáférés-vezérlés

Ezek az események jelenleg kizárólag az Azure-előfizetés hatókörében lesznek kibocsátva. Ez azt jelenti, hogy az ehhez a témakörtípushoz tartozó esemény-előfizetést létrehozó entitás értesítéseket kap ebben az Azure-előfizetésben. Biztonsági okokból elengedhetetlen, hogy a jelen témakör esemény-előfizetéseit olyan egyszerű tagokra korlátozza, akik olvasási hozzáféréssel rendelkeznek a teljes Azure-előfizetéshez. Az adatok ezen a rendszertémakörön keresztüli eléréséhez az Event Grid által megkövetelt általános engedélyek mellett a következő Azure Resource Notifications-specifikus engedélyre van szükség: Microsoft.ResourceNotifications/systemTopics/subscribeToResources/action

Eseménysémák

Ez a szakasz sémákat biztosít az eseményekhez és Deleted az CreatedOrUpdated eseményekhez.

Eseményséma a CreatedOrUpdated eseményhez

A séma a következő:

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

Törölt esemény eseményséma

A séma a következő:

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

Az Event Grid eseménysémaformátumú eseményeinek legfelső szintű tulajdonságai a következők:

Tulajdonság Típus Leírás
id Sztring Az esemény egyedi azonosítója
topic Sztring Az Azure-előfizetés, amelyhez ez a rendszertémakör létrejön
subject Sztring A Publisher meghatározta annak az alaperőforrásnak az elérési útját, amelyen az esemény ki lesz bocsátva.
data Objektum Az erőforrás-szolgáltatóra vonatkozó eseményadatokat tartalmazza. További információkért lásd a következő táblázatot.
eventType Sztring A rendszer témakörtípusának regisztrált eseménytípusa
dataVersion Sztring Az adatobjektum sémaverziója
metadataVersion Sztring Az esemény metaadatainak sémaverziója
eventTime Karakterlánc
Formátum: 2022-11-07T18:43:09.2894075Z		 Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján

A felhőbeli eseményséma formátumú események a következő legfelső szintű tulajdonságokkal rendelkeznek:

Tulajdonság Típus Leírás
id Sztring Az esemény egyedi azonosítója
source Sztring Az Azure-előfizetés, amelyhez ez a rendszertémakör létrejön.
subject Sztring A Publisher meghatározta annak az alaperőforrásnak az elérési útját, amelyen az esemény ki lesz bocsátva.
type Sztring A rendszer témakörtípusának regisztrált eseménytípusa
time Karakterlánc
Formátum: 2022-11-07T18:43:09.2894075Z		 Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján
data Objektum Az erőforrás-szolgáltatóra vonatkozó eseményadatokat tartalmazza. További információkért lásd a következő táblázatot.
specversion Sztring A CloudEvents sémaspecifikációs verziója.

Az data objektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
resourceInfo Objektum Az erőforrásra vonatkozó adatok. További információkért lásd a következő táblázatot.
apiVersion Sztring Az erőforrás tulajdonságainak API-verziója.
operationalInfo Objektum Az erőforrásra vonatkozó üzemeltetési információk részletei.

Az resourceInfo objektum a következő gyakori tulajdonságokkal rendelkezik a teljes és Deleted az események közöttCreatedOrUpdated:

Tulajdonság Típus Leírás
id Sztring Közzétevő által definiált elérési út az esemény tárgyához
name Sztring Ez a mező az eseményazonosítót jelzi. Mindig a mező utolsó szakaszának id értékét veszi figyelembe.
type Sztring A kibocsátott esemény típusa. Ebben a kontextusban ez vagy Microsoft.ResourceNotifications.Resources.CreatedOrUpdatedMicrosoft.ResourceNotifications.Resources.Deleted.

Az resourceInfo esemény objektuma CreatedOrUpdated a következő további tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
location Sztring Hely vagy régió, ahol az erőforrás található.
tags Sztring Az erőforrás címkéi.
properties Objektum Az erőforrás hasznos adatai.

Csak az CreatedOrUpdated esemény tartalmazza az properties objektumot. Az objektum sémája properties minden közzétevő számára egyedi. A séma felderítéséhez tekintse meg az adott Azure-erőforrás REST API-dokumentációját. A cikk Példák események szakaszában talál egy példát.

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

Az operationalInfo objektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
resourceEventTime Dátum/idő Az erőforrás létrehozásának vagy frissítésének (eseményhez) vagy törlésének CreatedOrUpdated dátuma és időpontja (esemény esetén Deleted ).

Példaesemények

CreatedOrUpdated esemény

Ez a szakasz azt az CreatedOrUpdated eseményt mutatja be, amely egy Azure Storage-fiók létrehozásakor jön létre abban az Azure-előfizetésben, amelyen a rendszertémakör létrejön.

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

Törölt esemény

Ez a szakasz azt az Deleted eseményt mutatja be, amely akkor jön létre, amikor egy Azure Storage-fiók törlődik abban az Azure-előfizetésben, amelyen a rendszertémakör létrejött.

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

Kapcsolat

Ha bármilyen kérdése vagy visszajelzése van ezzel a funkcióval kapcsolatban, ne habozzon, hogy lépjen velünk arnsupport@microsoft.comkapcsolatba.

Egy adott eseményre vonatkozó konkrét visszajelzések jobb segítése érdekében adja meg a következő információkat:

Hiányzó események esetén:

  • Rendszertémakör típusa
  • Hozzávetőleges időbélyeg (UTC) a művelet végrehajtásakor
  • Alaperőforrás-azonosító, amelyhez az értesítést létrehozták
  • Keresse meg az erőforrást az Azure Portalon, és válassza a JSON nézetet a jobb felső sarokban. Az erőforrás-azonosító a JSON nézetlap első mezője.
  • Várt eseménytípus
  • Végrehajtott művelet (például elindított vagy leállított virtuális gép, létrehozott tárfiók stb.)
  • A tapasztalt probléma leírása (például a virtuális gép elindult, és nem jött létre a Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged esemény)
  • Ha lehetséges, adja meg a végrehajtott művelet korrelációs azonosítóját

Késleltetett vagy váratlan tartalmat tartalmazó esemény esetén

  • Rendszertémakör típusa
  • Az értesítés teljes tartalma a data.resourceInfo.properties kivételével
  • A probléma leírása és az érintett mezőértékek

Győződjön meg arról, hogy az adatok megosztása során nem ad meg végfelhasználói azonosításra alkalmas adatokat.

Következő lépések

Lásd: Feliratkozás az Azure-beli erőforrás-értesítésekre – Erőforrás-kezelési események.