Freigeben über


Publish Cloud Event Events - Publish Cloud Event Events

Veröffentlicht einen Batch von Ereignissen in einem Azure Event Grid-Thema.

POST https://{topicHostname}?overload=cloudEvent&api-version=2018-01-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
topicHostname
path True

string

Hostname des Themas, z. B. topic1.westus2-1.eventgrid.azure.net

api-version
query True

string

Version der API, die mit der Clientanforderung verwendet werden soll.

Anforderungsheader

Media Types: "application/cloudevents-batch+json; charset=utf-8"

Name Erforderlich Typ Beschreibung
aeg-channel-name

string

Nur erforderlich, wenn die Veröffentlichung in Partnernamespaces mit dem ChannelNameHeader-Modus für partnerthemaweiterleitung erforderlich ist.

Anforderungstext

Media Types: "application/cloudevents-batch+json; charset=utf-8"

Name Typ Beschreibung
events

CloudEventEvent[]

Ein Array von Ereignissen, die im Event Grid veröffentlicht werden sollen.

Antworten

Name Typ Beschreibung
200 OK

OKAY

Other Status Codes

Fehlerantworten: ***

  • 400 Ungültige Anfrage.

  • 500 Interner Serverfehler.

  • 429 zu viele Ereignisse

  • 404 nicht gefunden.

Beispiele

PublishEventsToEventGridTopicAsCloudEvents

Beispielanforderung

POST https://mytopic.westcentralus-1.eventgrid.azure.net?overload=cloudEvent&api-version=2018-01-01

[
  {
    "id": "b3ccc7e3-c1cb-49bf-b7c8-0d4e60980616",
    "source": "/microsoft/autorest/examples/eventgrid/cloud-events/publish",
    "specversion": "1.0",
    "data": {
      "Property1": "Value1",
      "Property2": "Value2"
    },
    "type": "Microsoft.Contoso.TestEvent",
    "time": "2017-12-04T22:06:09.147165Z"
  }
]

Beispiel für eine Antwort

Definitionen

CloudEventEvent

Eigenschaften eines Ereignisses, das in einem Ereignisrasterthema mit dem CloudEvent 1.0-Schema veröffentlicht wurde

Name Typ Beschreibung
data

object

Ereignisdaten, die für den Ereignistyp spezifisch sind.

data_base64

string (byte)

Ereignisdaten, die für den Ereignistyp spezifisch sind, codiert als base64-Zeichenfolge.

datacontenttype

string

Inhaltstyp des Datenwerts.

dataschema

string

Identifiziert das Schema, dem Daten entsprechen.

id

string

Ein Bezeichner für das Ereignis. Die Kombination aus ID und Quelle muss für jedes unterschiedliche Ereignis eindeutig sein.

source

string

Gibt den Kontext an, in dem ein Ereignis aufgetreten ist. Die Kombination aus ID und Quelle muss für jedes unterschiedliche Ereignis eindeutig sein.

specversion

string

Die Version der CloudEvents-Spezifikation, die das Ereignis verwendet.

subject

string

Dies beschreibt den Betreff des Ereignisses im Kontext des Ereignisherstellers (identifiziert durch Quelle).

time

string (date-time)

Die Zeit (in UTC) des Ereignisses wurde im RFC3339 Format generiert.

type

string

Typ des Ereignisses im Zusammenhang mit dem ursprünglichen Vorkommen.