CloudEvents v1.0 séma az Azure Event Grid használatával

  • Cikk

Az Azure Event Grid natív módon támogatja a CloudEvents 1.0-s és HTTP-protokollkötés jSON-implementációjában lévő eseményeket. A CloudEvents egy nyílt specifikáció az eseményadatok leírásához.

A CloudEvents leegyszerűsíti az együttműködést azáltal, hogy egy gyakori eseménysémát biztosít a közzétételhez és a felhőalapú események felhasználásához. Ez a séma lehetővé teszi az egységes eszközkezelést, az események kezelésének szabványos útválasztási módjait és a külső eseményséma deszerializálásának univerzális módjait. Egy közös sémával egyszerűbben integrálhatja a munkát a platformok között.

A CloudEvents-t több közreműködő, köztük a Microsoft is a Cloud Native Computing Foundationen keresztül építi fel. Jelenleg 1.0-s verzióban érhető el.

Ez a cikk a CloudEvents-sémát és az Event Gridet ismerteti.

Mintaesemény a CloudEvents-sémával

Íme egy példa egy Azure Blob Storage-eseményre CloudEvents formátumban:

{
    "specversion": "1.0",
    "type": "Microsoft.Storage.BlobCreated",  
    "source": "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.Storage/storageAccounts/{storage-account}",
    "id": "9aeb0fdf-c01e-0131-0922-9eb54906e209",
    "time": "2019-11-18T15:13:39.4589254Z",
    "subject": "blobServices/default/containers/{storage-container}/blobs/{new-file}",    
    "data": {
        "api": "PutBlockList",
        "clientRequestId": "4c5dd7fb-2c48-4a27-bb30-5361b5de920a",
        "requestId": "9aeb0fdf-c01e-0131-0922-9eb549000000",
        "eTag": "0x8D76C39E4407333",
        "contentType": "image/png",
        "contentLength": 30699,
        "blobType": "BlockBlob",
        "url": "https://gridtesting.blob.core.windows.net/testcontainer/{new-file}",
        "sequencer": "000000000000000000000000000099240000000000c41c18",
        "storageDiagnostics": {
            "batchId": "681fe319-3006-00a8-0022-9e7cde000000"
        }
    }
}

A CloudEvents 1.0-s verziójában elérhető mezők, azok típusai és definíciói részletes leírása itt érhető el.

A CloudEvents sémában és az Event Grid-sémában szállított események fejlécértékei megegyeznek, kivéve a content-type. A CloudEvents-séma esetében ez a fejlécérték."content-type":"application/cloudevents+json; charset=utf-8" Event Grid-séma esetén ez a "content-type":"application/json; charset=utf-8"fejléc értéke.

Event Grid a CloudEventshez

Az Event Gridet a CloudEvents-sémában lévő események bemenetéhez és kimenetéhez is használhatja. A CloudEvents rendszereseményekhez, például Blob Storage-eseményekhez, IoT Hub-eseményekhez és egyéni eseményekhez használható. A CloudEvents támogatása mellett az Event Grid egy védett, nem kiterjeszthető, de teljesen működőképes Event Grid-eseményformátumot is támogat. Az alábbi táblázat a CloudEvents és az Event Grid formátumok beviteli sémaként történő használata esetén támogatott átalakítást ismerteti témakörökben és kimeneti sémaként az esemény-előfizetésekben. Az Event Grid kimeneti sémája nem használható a CloudEvents bemeneti sémaként való használatakor, mivel a CloudEvents támogatja az Event Grid-séma által nem támogatott bővítményattribútumokat .

Bemeneti séma Kimeneti séma
CloudEvents formátum CloudEvents formátum
Event Grid formátum CloudEvents formátum
Event Grid formátum Event Grid formátum

Minden eseményséma esetében az Event Grid érvényesítést igényel az Event Grid-témakörökben való közzétételkor és egy esemény-előfizetés létrehozásakor. További információkért tekintse meg az Event Grid biztonságát és hitelesítését.

További lépések

Lásd : A CloudEvents 1.0-s sémájának használata az Event Griddel.