Udostępnij za pośrednictwem

Powiadomienia dotyczące zasobów platformy Azure — zdarzenia zarządzania zasobami w usłudze Azure Event Grid

  • Artykuł

Temat system zarządzania zasobami platformy Azure zawiera szczegółowe informacje na temat cyklu życia różnych zasobów platformy Azure.

Tematy dotyczące systemu usługi Event Grid dla subskrypcji platformy Azure i grup zasobów platformy Azure zawierają zdarzenia cyklu życia zasobów przy użyciu szerszego zakresu typów zdarzeń, w tym akcji, zapisu i usuwania zdarzeń dla scenariuszy obejmujących powodzenie, niepowodzenie i anulowanie. Warto jednak zauważyć, że nie zawierają ładunku zasobu. Aby uzyskać szczegółowe informacje na temat tych zdarzeń, zobacz Temat systemowy usługi Event Grid dla subskrypcji platformy Azure i tematu systemu usługi Event Grid dla grup zasobów platformy Azure.

Natomiast temat dotyczący systemu azure Resource Notifications (ARN) obsługiwanego przez usługę Azure Resource Management oferuje bardziej ukierunkowany wybór typów zdarzeń, w szczególności CreatedOrUpdated (odpowiadający ResourceWriteSuccess w temacie systemu subskrypcji platformy Azure usługi Event Grid) i Deleted (odpowiadający ResourceDeleteSuccess tematowi w temacie systemu subskrypcji platformy Azure usługi Event Grid). Te zdarzenia zawierają kompleksowe informacje o ładunku, dzięki czemu klienci mogą łatwiej stosować filtrowanie i uściślić strumień powiadomień.

Aby uzyskać listę uwidocznionych typów zasobów, zobacz Zasoby usługi Azure Resource Graph lub skorzystaj z następującego zapytania usługi Azure Resource Graph.

resources
| distinct ['type']

Uwaga

Temat systemu zarządzania zasobami platformy Azure nie obsługuje jeszcze wszystkich typów zasobów z tabeli zasobów usługi Azure Resource Graph. Pracujemy nad ulepszeniem tego środowiska.

Typy zdarzeń

Temat systemowy zasobów usługi ARN oferuje dwa typy zdarzeń do użycia:

Typ zdarzenia opis
Microsoft.ResourceNotifications.Resources.CreatedOrUpdated Zgłaszane, gdy zasób został pomyślnie utworzony lub zaktualizowany.
Microsoft.ResourceNotifications.Resources.Deleted Zgłaszane, gdy zasób zostanie usunięty.

Kontrola dostępu oparta na rolach

Obecnie te zdarzenia są emitowane wyłącznie w zakresie subskrypcji platformy Azure. Oznacza to, że jednostka tworząca subskrypcję zdarzeń dla tego typu tematu otrzymuje powiadomienia w całej subskrypcji platformy Azure. Ze względów bezpieczeństwa konieczne jest ograniczenie możliwości tworzenia subskrypcji zdarzeń w tym temacie do podmiotów zabezpieczeń z dostępem do odczytu w całej subskrypcji platformy Azure. Aby uzyskać dostęp do danych za pośrednictwem tego tematu systemowego, oprócz ogólnych uprawnień wymaganych przez usługę Event Grid, niezbędne jest następujące uprawnienie specyficzne dla usługi Azure Resource Notifications: Microsoft.ResourceNotifications/systemTopics/subscribeToResources/action.

Schematy zdarzeń

Ta sekcja zawiera schematy dla zdarzeń CreatedOrUpdated i Deleted .

Schemat zdarzenia dla zdarzenia CreatedOrUpdated

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

Schemat zdarzeń dla usuniętego zdarzenia

Oto schemat:

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

Zdarzenie w formacie schematu zdarzeń usługi Event Grid ma następujące właściwości najwyższego poziomu:

Właściwość Type opis
id String Unikatowy identyfikator zdarzenia
topic String Subskrypcja platformy Azure, dla której jest tworzony ten temat systemowy
subject String Ścieżka zdefiniowana przez program Publisher do zasobu podstawowego, na którym jest emitowane to zdarzenie.
data Objekt Zawiera dane zdarzenia specyficzne dla dostawcy zasobów. Aby uzyskać więcej informacji, zobacz następną tabelę.
eventType String Typ zarejestrowanego zdarzenia tego typu tematu systemowego
dataVersion String Wersja schematu obiektu danych
metadataVersion String Wersja schematu metadanych zdarzenia
eventTime Struna
Format: 2022-11-07T18:43:09.2894075Z		 Czas generowania zdarzenia na podstawie czasu UTC dostawcy

Zdarzenie w formacie schematu zdarzeń w chmurze ma następujące właściwości najwyższego poziomu:

Właściwość Type opis
id String Unikatowy identyfikator zdarzenia
source String Subskrypcja platformy Azure, dla której jest tworzony ten temat systemowy.
subject String Ścieżka zdefiniowana przez program Publisher do zasobu podstawowego, na którym jest emitowane to zdarzenie.
type String Typ zarejestrowanego zdarzenia tego typu tematu systemowego
time Struna
Format: 2022-11-07T18:43:09.2894075Z		 Czas generowania zdarzenia na podstawie czasu UTC dostawcy
data Objekt Zawiera dane zdarzenia specyficzne dla dostawcy zasobów. Aby uzyskać więcej informacji, zobacz następną tabelę.
specversion String Wersja specyfikacji schematu CloudEvents.

Obiekt data ma następujące właściwości:

Właściwość Type Opis
resourceInfo Objekt Dane specyficzne dla zasobu. Aby uzyskać więcej informacji, zobacz następną tabelę.
apiVersion String Wersja interfejsu API właściwości zasobu.
operationalInfo Objekt Szczegóły informacji operacyjnych dotyczących zasobu.

Obiekt resourceInfo ma następujące typowe właściwości między zdarzeniami CreatedOrUpdated i Deleted :

Właściwość Type opis
id String Zdefiniowana ścieżka wydawcy do tematu zdarzenia
name String To pole wskazuje identyfikator zdarzenia. Zawsze przyjmuje wartość ostatniej sekcji id pola.
type String Typ emitowanego zdarzenia. W tym kontekście jest to wartość Microsoft.ResourceNotifications.Resources.CreatedOrUpdated lub Microsoft.ResourceNotifications.Resources.Deleted.

Obiekt resourceInfo zdarzenia CreatedOrUpdated ma następujące dodatkowe właściwości:

Właściwość Type opis
location String Lokalizacja lub region, w którym znajduje się zasób.
tags String Tagi zasobu.
properties Objekt Ładunek zasobu.

CreatedOrUpdated Tylko zdarzenie zawiera properties obiekt . Schemat tego properties obiektu jest unikatowy dla każdego wydawcy. Aby odnaleźć schemat, zobacz dokumentację interfejsu API REST dla określonego zasobu platformy Azure. Przykład można znaleźć w sekcji Przykłady zdarzeń w tym artykule.

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

Obiekt operationalInfo ma następujące właściwości:

Właściwość Type Opis
resourceEventTime DateTime Data i godzina utworzenia lub zaktualizowania zasobu (dla CreatedOrUpdated zdarzenia) lub usunięcia (dla Deleted zdarzenia).

Przykładowe zdarzenia

Zdarzenie CreatedOrUpdated

W tej sekcji przedstawiono CreatedOrUpdated zdarzenie wygenerowane podczas tworzenia konta usługi Azure Storage w subskrypcji platformy Azure, w której jest tworzony temat systemowy.

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

Zdarzenie usunięte

W tej sekcji przedstawiono zdarzenie wygenerowane po usunięciu Deleted konta usługi Azure Storage w subskrypcji platformy Azure, w której jest tworzony temat systemowy.

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

Kontakt z nami

Jeśli masz jakiekolwiek pytania lub opinie dotyczące tej funkcji, nie wahaj się skontaktować się z nami pod adresem arnsupport@microsoft.com.

Aby lepiej pomóc w konkretnej opinii na temat określonego zdarzenia, podaj następujące informacje:

W przypadku brakujących zdarzeń:

  • Nazwa typu tematu systemowego
  • Przybliżony znacznik czasu w formacie UTC podczas wykonywania operacji
  • Identyfikator zasobu podstawowego, dla którego zostało wygenerowane powiadomienie
  • Przejdź do zasobu w witrynie Azure Portal i wybierz widok JSON w prawym górnym rogu. Identyfikator zasobu to pierwsze pole na stronie widoku JSON.
  • Oczekiwany typ zdarzenia
  • Wykonano operację (na przykład uruchomiono lub zatrzymano maszynę wirtualną, utworzono konto magazynu itp.)
  • Opis napotkanego problemu (na przykład maszyna wirtualna została uruchomiona i nie wygenerowano zdarzenia Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
  • Jeśli to możliwe, podaj identyfikator korelacji wykonanej operacji

W przypadku zdarzenia, które zostało opóźnione lub ma nieoczekiwaną zawartość

  • Nazwa typu tematu systemowego
  • Cała zawartość powiadomienia z wyłączeniem właściwości data.resourceInfo.properties
  • Opis napotkanego problemu i wartości pól, których dotyczy problem

Upewnij się, że podczas udostępniania tych danych nie udostępniasz żadnych informacji możliwych do zidentyfikowania przez użytkownika końcowego.

Następne kroki

Zobacz Subskrybowanie powiadomień o zasobach platformy Azure — zdarzenia zarządzania zasobami.