Az Azure Event Grid-esemény sémaAzure Event Grid event schema

Ez a cikk ismerteti a tulajdonságok és a sémát, amely az összes esemény találhatók.This article describes the properties and schema that are present for all events. Események állnak öt szükséges karakterlánc-tulajdonságok és a egy szükséges objektum. Events consist of a set of five required string properties and a required data object. A Tulajdonságok megegyeznek az összes eseményt, a bármely gyártótól.The properties are common to all events from any publisher. Az objektum tulajdonság tartozik, amely mindegyik közzétevő jellemző.The data object has properties that are specific to each publisher. A rendszer témaköröket ezek a Tulajdonságok konkrétan az erőforrás-szolgáltató, például az Azure Storage vagy az Azure Event Hubs a.For system topics, these properties are specific to the resource provider, such as Azure Storage or Azure Event Hubs.

Zdroje událostí események küldése az Azure Event Grid egy tömb, amely több esemény-objektumot.Event sources send events to Azure Event Grid in an array, which can have several event objects. Az eseményeket egy event grid-témakör az üzenetküldés, ha a tömb rendelkezhet egy teljes mérete legfeljebb 1 MB.When posting events to an event grid topic, the array can have a total size of up to 1 MB. A tömbben szereplő minden esemény korlátozódik 64 KB-os (nyilvánosan elérhetők) vagy 1 MB (előzetes verzió).Each event in the array is limited to 64 KB (General Availability) or 1 MB (preview). Ha egy esemény vagy a tömb nagyobb, mint a méretbeli korlátokat, a válasz érkezik 413 adattartalom túl nagy.If an event or the array is greater than the size limits, you receive the response 413 Payload Too Large.

Megjegyzés

Egy esemény mérete legfeljebb 64 KB-os által általánosan elérhető (GA) szolgáltatói szerződés (SLA) vonatkozik.An event of size up to 64 KB is covered by General Availability (GA) Service Level Agreement (SLA). Támogatást biztosít az esemény mérete legfeljebb 1 MB jelenleg előzetes verzióban érhető el.The support for an event of size up to 1 MB is currently in preview. Események több mint 64 KB-os 64 KB-os egységekben számoljuk.Events over 64 KB are charged in 64-KB increments.

Event Grid az eseményeket küld egy tömb, amely egy egyszeri esemény rendelkezik az előfizetőknek.Event Grid sends the events to subscribers in an array that has a single event. Ez a viselkedés a későbbiekben változhatnak.This behavior may change in the future.

A JSON-sémájában az Event Grid-esemény és az egyes Azure közzétevő adattartalom megtalálja a Eseménysémája store.You can find the JSON schema for the Event Grid event and each Azure publisher's data payload in the Event Schema store.

EseménysémaEvent schema

Az alábbi példa bemutatja az összes esemény-közzétevők által használt tulajdonságokat:The following example shows the properties that are used by all event publishers:

[
  {
    "topic": string,
    "subject": string,
    "id": string,
    "eventType": string,
    "eventTime": string,
    "data":{
      object-unique-to-each-publisher
    },
    "dataVersion": string,
    "metadataVersion": string
  }
]

Ha például egy Azure Blob storage esemény közzétett sémája:For example, the schema published for an Azure Blob storage event is:

[
  {
    "topic": "/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/xstoretestaccount",
    "subject": "/blobServices/default/containers/oc2d2817345i200097container/blobs/oc2d2817345i20002296blob",
    "eventType": "Microsoft.Storage.BlobCreated",
    "eventTime": "2017-06-26T18:41:00.9584103Z",
    "id": "831e1650-001e-001b-66ab-eeb76e069631",
    "data": {
      "api": "PutBlockList",
      "clientRequestId": "6d79dbfb-0e37-4fc4-981f-442c9ca65760",
      "requestId": "831e1650-001e-001b-66ab-eeb76e000000",
      "eTag": "0x8D4BCC2E4835CD0",
      "contentType": "application/octet-stream",
      "contentLength": 524288,
      "blobType": "BlockBlob",
      "url": "https://oc2d2817345i60006.blob.core.windows.net/oc2d2817345i200097container/oc2d2817345i20002296blob",
      "sequencer": "00000000000004420000000000028963",
      "storageDiagnostics": {
        "batchId": "b68529f3-68cd-4744-baa4-3c0498ec19f0"
      }
    },
    "dataVersion": "",
    "metadataVersion": "1"
  }
]

Esemény tulajdonságaiEvent properties

Az összes esemény rendelkezik ugyanazokat az alábbi felső szintű adatokat:All events have the same following top-level data:

TulajdonságProperty TípusType LeírásDescription
topictopic stringstring A forrás teljes erőforrás elérési útja.Full resource path to the event source. Ez a mező nem írható.This field isn't writeable. Event Grid biztosítja ezt az értéket.Event Grid provides this value.
subjectsubject stringstring Az esemény tárgya közzétevő által megadott elérési útja.Publisher-defined path to the event subject.
eventTypeeventType stringstring Ehhez eseményre adatforráshoz regisztrált esemény típusok egyikét.One of the registered event types for this event source.
eventTimeeventTime stringstring Az esemény akkor jön létre az idő alapján a szolgáltató UTC idő.The time the event is generated based on the provider's UTC time.
idid stringstring Az esemény egyedi azonosítója.Unique identifier for the event.
datadata objectobject Eseményadatok adott erőforrás-szolgáltatónál.Event data specific to the resource provider.
dataVersiondataVersion stringstring Az adatobjektum sémaverziója.The schema version of the data object. A közzétevő a sémaverziót határozza meg.The publisher defines the schema version.
metadataVersionmetadataVersion stringstring Az esemény-metaadatok sémaverziója.The schema version of the event metadata. Event Grid sémáját, a legfelső szintű tulajdonságait határozza meg.Event Grid defines the schema of the top-level properties. Event Grid biztosítja ezt az értéket.Event Grid provides this value.

Az az objektum tulajdonságainak kapcsolatos további információkért tekintse meg az eseményforrás:To learn about the properties in the data object, see the event source:

Egyéni témakörök az esemény-közzétevő határozza meg az objektum.For custom topics, the event publisher determines the data object. A legfelső szintű adatokat standard erőforrás által definiált események, ugyanazokat a mezőket kell rendelkeznie.The top-level data should have the same fields as standard resource-defined events.

Amikor eseményeket tesz közzé egyéni témaköröket, hozzon létre a tulajdonosok az eseményeket, amelyek megkönnyítik a tudja-e azok érdeklik az esemény-előfizetők számára.When publishing events to custom topics, create subjects for your events that make it easy for subscribers to know whether they're interested in the event. Előfizetők használhatják a tárgy események szűrése és útvonalat.Subscribers use the subject to filter and route events. Vegye figyelembe, hogy kezeléséről az elérési út, az esemény történt, így az elérési út szegmensei lehet szűrni az előfizetők számára.Consider providing the path for where the event happened, so subscribers can filter by segments of that path. Az elérési út révén széles körben vagy szűken események szűrése előfizetők.The path enables subscribers to narrowly or broadly filter events. Ha például három szegmens elérési utat, például adnia /A/B/C az e-mail tárgyát, az előfizetők az első szegmens szerint szűrheti /A különböző események beolvasásához.For example, if you provide a three segment path like /A/B/C in the subject, subscribers can filter by the first segment /A to get a broad set of events. Ezeket az előfizetőket témákat, mint például az események beolvasása /A/B/C vagy /A/D/E.Those subscribers get events with subjects like /A/B/C or /A/D/E. Más előfizetőkkel szerint szűrheti /A/B beolvasni a szűkebb események egy meghatározott készletének.Other subscribers can filter by /A/B to get a narrower set of events.

A tulajdonos néha történtekről további információkra van szüksége.Sometimes your subject needs more detail about what happened. Például a Tárfiókok közzétevő tárgyát /blobServices/default/containers/<container-name>/blobs/<file> egy fájl hozzáadásakor egy tárolóba.For example, the Storage Accounts publisher provides the subject /blobServices/default/containers/<container-name>/blobs/<file> when a file is added to a container. Az elérési út alapján szűrheti az előfizető /blobServices/default/containers/testcontainer az adott tárolóban, de nem más a tárfiókban lévő tárolók összes eseményének lekérdezése.A subscriber could filter by the path /blobServices/default/containers/testcontainer to get all events for that container but not other containers in the storage account. Az előfizető is szűrhetőek vagy útvonalat az utótagot .txt csak együttműködni az szöveges fájlok.A subscriber could also filter or route by the suffix .txt to only work with text files.

További lépésekNext steps