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

Azure Resource Notifications – Állapoterőforrások eseményei az Azure Event Gridben (előzetes verzió)

  • Cikk

A HealthResources rendszertéma pontos, megbízható és átfogó állapotinformációkat biztosít, így mélyebben megismerheti az Azure-erőforrásokat érintő különféle szolgáltatási problémákat, nevezetesen az egypéldányos virtuális gépeket (VM-eket), a virtuálisgép-méretezési csoport virtuális gépeit és a virtuálisgép-méretezési csoportokat. Az Állapoterőforrások két eseménytípust kínál fogyasztásra: AvailabilityStatusChanged és ResourceAnnotated.

Ez a cikk az Azure Resource Notifications Health Resources eseményeinek tulajdonságait és sémáját ismerteti. Az eseménysémák általános bemutatása: Azure Event Grid eseményséma. Emellett a létrehozott események mintáit is megtalálhatja, valamint egy kapcsolódó cikkre mutató hivatkozást is, amely bemutatja, hogyan hozhat létre rendszertémakört ehhez a témakörtípushoz.

Eseménytípusok

Az Állapoterőforrások két eseménytípust kínál fogyasztásra:

Eseménytípus Leírás
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Akkor merül fel, ha egy virtuális gép, egy virtuálisgép-méretezési csoport vagy egy virtuálisgép-méretezési csoport virtuális gépének rendelkezésre állási állapota megváltozik.

Ez az információ bemutatja, hogy az egyes példányú virtuális gépek, a virtuálisgép-méretezési csoportokban lévő virtuális gépek vagy maguk a virtuálisgép-méretezési csoportok az Azure szolgáltatásproblémái miatt nem voltak elérhetők. A különböző állapotokról további információt az Azure Resource Health áttekintése – Azure Service Health című témakörben talál.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Ha egy virtuális gép, egy virtuálisgép-méretezési csoport vagy egy virtuálisgép-méretezési csoport virtuális gépének állapotát a rendelkezésre állás befolyásolja, az fennakadásokat okoz. A platform kontextust bocsát ki, hogy miért történt a fennakadás, hogy segítsen önnek a megfelelő válaszadásban.

Ezek az információk segítenek az erőforrások rendelkezésre állási állapotának feltárásában azáltal, hogy fontos információkat adnak a rendelkezésre állás változásainak okairól és okairól. Az adatok használatával gyorsabb és célzottabb kockázatcsökkentő intézkedéseket hozhat. A kibocsátott különféle széljegyzetekről további információt a Resource Health virtuális gép állapotjegyzetei című témakörben talál.

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/subscribeToHealthResources/action

Eseménysémák

A séma a következő:

{
    "id": string,
    "source": string,
    "subject": string,
    "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged | Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
    "time ": string, 
    "data": {
        "resourceInfo": {
            "id": string,
            "name": string,
            "type": string,
            "properties": { 
                <<Different for AvailabilityStatusChanged event and ResourceAnnotated event>>            
            }
        },
        "operationalInfo":{
			"resourceEventTime": date-time
		},
        "apiVersion": string 
    }, 
    "specversion": string
}

Egy esemény a következő legfelső szintű adatokkal rendelkezik:

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ő tulajdonságokkal rendelkezik:

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.ResourceHealth/AvailabilityStatusesMicrosoft.ResourceHealth/ResourceAnnotated.
properties Objektum Az erőforrás hasznos adatai. További információkért lásd a következő táblázatot.

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

Tulajdonság Típus Leírás
resourceEventTime Dátum/idő Az erőforrás frissítésének dátuma és időpontja.

Az properties objektumon belül data más a helyzet AvailabilityStatusChanged és ResourceAnnotated az események.

A AvailabilityStatusChanged esemény tulajdonságai

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "previousAvailabilityState": string,
                "availabilityState": string
            }

AvailabilityStatusChanged Az eseményhez az properties objektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
targetResourceId Sztring Az az alaperőforrás, amelynek rendelkezésre állási információi ki lesznek bocsátva.
targetResourceType Sztring Az alaperőforrás típusa.
occurredTime Sztring A tényleges esemény kibocsátásának időpontja.
previousAvailabilityState Sztring Korábbi rendelkezésre állási állapot.
availabilityState Sztring Jelenlegi rendelkezésre állási állapot. Az értékek listáját a rendelkezésre állási állapotok – Get By Resource – REST API (Azure Resource Health) című témakörben találja.

A ResourceAnnotated esemény tulajdonságai

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "annotationName": string,
                "reason": string,
                "summary": string,
                "context": string,
                "category": string,
            }

ResourceAnnotated Az eseményhez az properties objektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
targetResourceId Sztring Az az alaperőforrás, amelyhez a széljegyzetadatokat kibocsátják.
targetResourceType Sztring Az alaperőforrás típusa.
occurredTime Sztring Időbélyeg, amikor az Azure-platform a rendelkezésre állást befolyásoló eseményre válaszul kibocsátotta a jegyzetet.
annotationName Sztring A széljegyzet neve. A széljegyzetek és a hozzájuk tartozó leírások listáját a Resource Health virtuális gép állapotjegyzetei – Azure Service Health című témakörben találja.
reason Sztring Rövid nyilatkozat arról, hogy az erőforrások rendelkezésre állása miért változott vagy változott.
summary Sztring Az erőforrás-rendelkezésre állás változásának vagy befolyásolásának részletes leírása a tevékenységről és az erőforrás-rendelkezésre állás okáról.
context Sztring Meghatározza, hogy az erőforrások rendelkezésre állását befolyásolta-e az Azure vagy a felhasználó által okozott tevékenység.
category Sztring Meghatározza, hogy az erőforrások rendelkezésre állását a tervezett vagy nem tervezett tevékenység befolyásolta-e. Ez a tulajdonság csak eseményekre Platform-Initiated vonatkozik.

Példaesemények

AvailabilityStatusChanged esemény

Az alábbi példa egy kulcs-érték módosított esemény sémáját mutatja be:

{
  "id": "1fb6fa94-d965-4306-abeq-4810f0774e97",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/availabilityStatuses/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/availabilityStatuses",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "previousAvailabilityState": "Unavailable",
        "availabilityState": "Available"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2023-12-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

ResourceAnnotated esemény

Az alábbi példa egy kulcs-érték módosított esemény sémáját mutatja be:

{
  "id": "8945cf9b-e220-496e-ab4f-f3a239318995",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/resourceAnnotations/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/resourceAnnotations",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "annotationName": "VirtualMachineDeallocationInitiated",
        "reason": "Stopping and deallocating",
        "summary": "This virtual machine is stopped and deallocated as requested by an authorized user or process.",
        "context": "Customer Initiated",
        "category": "Not Applicable"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2022-08-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

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-erőforrásértesítések – Állapoterőforrások eseményeire.