Sdílet prostřednictvím

Oznámení o prostředcích Azure – Události správy prostředků ve službě Azure Event Grid

  • Článek

Téma systému Azure Resource Management poskytuje přehled o životním cyklu různých prostředků Azure.

Témata týkající se systému Event Gridu pro předplatná Azure a skupiny prostředků Azure poskytují události životního cyklu prostředků pomocí širšího rozsahu typů událostí, včetně akcí, zápisu a odstranění událostí pro scénáře, které zahrnují úspěch, selhání a zrušení. Stojí ale za zmínku, že nezahrnují datovou část prostředku. Podrobnosti o těchto událostech najdete v tématu systému Event Grid pro předplatná Azure a téma systému Event Gridu pro skupiny prostředků Azure.

Naproti tomu téma systému Azure Resource Management (ARN) využívající službu Azure Resource Management nabízí konkrétnější výběr typů událostí ( CreatedOrUpdated odpovídající ResourceWriteSuccess tématu systému odběru Azure Event Gridu) a Deleted (odpovídající ResourceDeleteSuccess tématu systému odběru Služby Event Grid). Tyto události mají komplexní informace o datové části, které zákazníkům usnadňují použití filtrování a upřesnění streamu oznámení.

Seznam vystavených typů prostředků najdete v tématu Prostředky Azure Resource Graphu nebo použijte následující dotaz Azure Resource Graphu.

resources
| distinct ['type']

Poznámka:

Téma systému Azure Resource Management zatím nepodporuje všechny typy prostředků z tabulky prostředků v Azure Resource Graphu. Na vylepšení tohoto prostředí pracujeme.

Typy událostí

Systémové téma ARN Resources nabízí dva typy událostí pro spotřebu:

Typ události Popis
Microsoft.ResourceNotifications.Resources.CreatedOrUpdated Vyvolá se při úspěšném vytvoření nebo aktualizaci prostředku.
Microsoft.ResourceNotifications.Resources.Deleted Vyvolá se při odstranění prostředku.

Řízení přístupu na základě role

V současné době se tyto události vygenerují výhradně v oboru předplatného Azure. Z toho vyplývá, že entita, která vytváří odběr událostí pro tento typ tématu, přijímá oznámení v celém tomto předplatném Azure. Z bezpečnostních důvodů je nezbytné omezit možnost vytvářet odběry událostí v tomto tématu na objekty zabezpečení s přístupem pro čtení pro celé předplatné Azure. Pro přístup k datům prostřednictvím tohoto systémového tématu je kromě obecných oprávnění vyžadovaných službou Event Grid potřeba následující oprávnění pro oznámení o prostředcích Azure: Microsoft.ResourceNotifications/systemTopics/subscribeToResources/action

Schéma událostí

Tato část obsahuje schémata pro události CreatedOrUpdated a Deleted události.

Schéma událostí pro událost CreatedOrUpdated

Toto je schéma:

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

Schéma událostí pro odstraněnou událost

Toto je schéma:

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

Událost ve formátu schématu událostí Event Gridu má následující vlastnosti nejvyšší úrovně:

Vlastnost Type Description
id String Jedinečný identifikátor události
topic String Předplatné Azure, pro které se toto téma systému vytváří
subject String Vydavatel definoval cestu k základnímu prostředku, na kterém je tato událost generována.
data Object Obsahuje data událostí specifická pro poskytovatele prostředků. Další informace najdete v další tabulce.
eventType String Registrovaný typ události tohoto systémového tématu
dataVersion String Verze schématu datového objektu
metadataVersion String Verze schématu metadat události
eventTime Řetězec
Formát: 2022-11-07T18:43:09.2894075Z		 Čas vygenerování události na základě času UTC poskytovatele

Událost ve formátu schématu cloudové události má následující vlastnosti nejvyšší úrovně:

Vlastnost Type Description
id String Jedinečný identifikátor události
source String Předplatné Azure, pro které se toto téma systému vytváří.
subject String Vydavatel definoval cestu k základnímu prostředku, na kterém je tato událost generována.
type String Registrovaný typ události tohoto systémového tématu
time Řetězec
Formát: 2022-11-07T18:43:09.2894075Z		 Čas vygenerování události na základě času UTC poskytovatele
data Object Obsahuje data událostí specifická pro poskytovatele prostředků. Další informace najdete v další tabulce.
specversion String Verze specifikace schématu CloudEvents

Objekt data má následující vlastnosti:

Vlastnost Type Popis
resourceInfo Object Data specifická pro daný prostředek. Další informace najdete v další tabulce.
apiVersion String Verze rozhraní API vlastností prostředku
operationalInfo Object Podrobnosti o provozních informacích týkajících se prostředku

Objekt resourceInfo má následující společné vlastnosti a CreatedOrUpdatedDeleted události:

Vlastnost Type Description
id String Vydavatel definoval cestu k předmětu události.
name String Toto pole označuje ID události. Vždy vezme hodnotu poslední části id pole.
type String Typ události, která se vysílá. V tomto kontextu je to buď Microsoft.ResourceNotifications.Resources.CreatedOrUpdated nebo Microsoft.ResourceNotifications.Resources.Deleted.

Objekt resourceInfo události CreatedOrUpdated má následující dodatečné vlastnosti:

Vlastnost Type Description
location String Umístění nebo oblast, kde se prostředek nachází.
tags String Značky prostředku
properties Object Datová část prostředku

CreatedOrUpdated Objekt zahrnuje properties pouze událost. Schéma tohoto properties objektu je jedinečné pro každého vydavatele. Pokud chcete zjistit schéma, přečtěte si dokumentaci k rozhraní REST API pro konkrétní prostředek Azure. Příklad najdete v části Příklady událostí tohoto článku.

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

Objekt operationalInfo má následující vlastnosti:

Vlastnost Type Popis
resourceEventTime DateTime Datum a čas vytvoření nebo aktualizace prostředku (pro CreatedOrUpdated událost) nebo odstranění (pro Deleted událost).

Příklady událostí

Událost CreatedOrUpdated

Tato část ukazuje CreatedOrUpdated událost vygenerovanou při vytvoření účtu Azure Storage v předplatném Azure, na kterém se vytvoří systémové téma.

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

Odstraněná událost

Tato část ukazuje Deleted událost vygenerovanou při odstranění účtu Azure Storage v předplatném Azure, na kterém se vytvoří systémové téma.

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

Kontaktujte nás

Pokud máte nějaké dotazy nebo zpětnou vazbu k této funkci, neváhejte nás kontaktovat na adrese arnsupport@microsoft.com.

Pokud chcete lépe pomoct s konkrétní zpětnou vazbou na určitou událost, poskytněte následující informace:

U chybějících událostí:

  • Název typu systémového tématu
  • Přibližné časové razítko ve standardu UTC při spuštění operace
  • ID základního prostředku, pro které se oznámení vygenerovalo
  • Přejděte na svůj prostředek na webu Azure Portal a vyberte zobrazení JSON v pravém rohu. ID prostředku je první pole na stránce zobrazení JSON.
  • Očekávaný typ události
  • Operace se spustila (například spuštěný nebo zastavený virtuální počítač, vytvořený účet úložiště atd.)
  • Popis problému (například spuštěný virtuální počítač a negenerovaná událost Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
  • Pokud je to možné, zadejte ID korelace provedené operace.

U události, která byla zpožděna nebo má neočekávaný obsah

  • Název typu systémového tématu
  • Celý obsah oznámení s výjimkou data.resourceInfo.properties
  • Popis zjištěného problému a ovlivněných hodnot polí

Ujistěte se, že při sdílení těchto dat nezadáte žádné identifikovatelné informace koncového uživatele.

Další kroky

Viz přihlášení k odběru oznámení o prostředcích Azure – události správy prostředků.