Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Erstellen eines Ereignisschemas in Amazon EventBridge Sie erstellen Schemas, indem Sie JSON-Dateien mit der [OpenAPI-Spezifikation oder der [JSONSchema Draft4-Spezifikation](https://json-schema.org/specification-links.html#draft-4)](https://swagger.io/specification/) verwenden. [Sie können Ihre eigenen Schemas erstellen oder hochladen, EventBridge indem Sie eine Vorlage verwenden oder ein Schema generieren, das auf dem JSON eines Ereignisses basiert.](eb-events.md) Sie können das Schema auch aus Ereignissen in einem [Event Bus](eb-event-bus.md) ableiten. Verwenden Sie die API-Aktion, um mithilfe der EventBridge Schema Registry API ein Schema zu erstellen. [https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-registries-name-registryname-schemas-name-schemaname.html#v1-registries-nam](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-registries-name-registryname-schemas-name-schemaname.html#v1-registries-nam) Wenn Sie zwischen den Formaten OpenAPI 3 und JSONSchema Draft4 wählen, sollten Sie die folgenden Unterschiede berücksichtigen: + JSONSchema format unterstützt zusätzliche Schlüsselwörter, die in OpenAPI nicht unterstützt werden, wie `$schema, additionalItems` z. + Es gibt geringfügige Unterschiede in der Art und Weise, wie Schlüsselwörter behandelt werden, z. B. `type` und `format`. + OpenAPI unterstützt keine JSONSchema Hyperschema-Hyperlinks in JSON-Dokumenten. + Tools für OpenAPI konzentrieren sich in der Regel auf die Build-Time, wohingegen sich Tools für JSONSchema eher auf Laufzeitoperationen konzentrieren, wie z. B. Client-Tools für die Schemavalidierung. Wir empfehlen, JSONSchema das Format zu verwenden, um die clientseitige Validierung zu implementieren, sodass Ereignisse, die gesendet werden, dem Schema entsprechen. EventBridge Sie können JSONSchema es verwenden, um einen Vertrag für gültige JSON-Dokumente zu definieren und dann einen [JSON-Schemavalidator](https://json-schema.org/tools) zu verwenden, bevor Sie die zugehörigen Ereignisse senden. Nachdem Sie über ein neues Schema verfügen, können Sie [Codebindungen](eb-schema-code-bindings.md) herunterladen, um Anwendungen für Ereignisse mit diesem Schema zu erstellen. # Erstellen eines Schemas mithilfe einer Vorlage in Amazon EventBridge Sie können ein Schema aus einer heruntergeladenen Vorlagendatei erstellen oder indem Sie eine Vorlage direkt in der EventBridge Konsole bearbeiten. ## Erstellen Sie ein Schema aus einer Vorlagendatei Wenn Sie die Vorlage erhalten möchten, laden Sie sie von der Konsole herunter. Sie können die Vorlage so bearbeiten, dass das Schema Ihren Ereignissen entspricht. Laden Sie dann die neue Vorlage über die Konsole hoch. **So laden Sie die Schemavorlage herunter** 1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Wählen Sie im Navigationsbereich die Option **Schema registry (Schemaregistrierung)** aus. 1. Wählen Sie im Abschnitt **Getting started (Erste Schritte)** unter **Schema template (Schemavorlage)** die Option **Download (Herunterladen)** aus. Alternativ können Sie die JSON-Vorlage aus dem folgenden Codebeispiel kopieren. ``` { "openapi": "3.0.0", "info": { "version": "1.0.0", "title": "Event" }, "paths": {}, "components": { "schemas": { "Event": { "type": "object", "properties": { "ordinal": { "type": "number", "format": "int64" }, "name": { "type": "string" }, "price": { "type": "number", "format": "double" }, "address": { "type": "string" }, "comments": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string", "format": "date-time" } } } } } } ``` **So laden Sie eine Schemavorlage hoch** 1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Wählen Sie im Navigationsbereich **Schemata** und dann **Schema erstellen** aus. 1. (Optional) Wählen Sie eine Schemaregistrierung aus oder erstellen Sie sie. 1. Geben Sie unter **Schemadetails** einen Namen für das Schema ein. 1. (Optional) Geben Sie eine Beschreibung für das Schema ein. 1. Wählen Sie für **Schematyp** entweder **OpenAPI 3.0** oder **JSON Schema Draft 4** aus. 1. Ziehen Sie auf der Registerkarte **Erstellen** im Textfeld Ihre Schemadatei in das Textfeld oder fügen Sie die Schemaquelle ein. 1. Wählen Sie **Erstellen** aus. ## Bearbeiten einer Schemavorlage direkt in der Konsole Sie können ein Schema direkt in der EventBridge Konsole erstellen. **So bearbeiten Sie ein Schema in der Konsole** 1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Wählen Sie im Navigationsbereich **Schemata** und dann **Schema erstellen** aus. 1. (Optional) Wählen Sie eine Schemaregistrierung aus oder erstellen Sie sie. 1. Geben Sie unter **Schemadetails** einen Namen für das Schema ein. 1. Wählen Sie für **Schematyp** entweder **OpenAPI 3.0** oder **JSON Schema Draft 4** aus. 1. (Optional) Geben Sie eine Beschreibung für das zu erstellende Schema ein. 1. Wählen Sie auf der Registerkarte **Erstellen** die Option **Vorlage laden** aus. 1. Bearbeiten Sie die Vorlage im Textfeld so, dass das Schema Ihren [Ereignissen](eb-events.md) entspricht. 1. Wählen Sie **Erstellen** aus. # Erstellen eines Schemas aus Event-JSON in Amazon EventBridge Wenn Sie über die JSON-Datei eines Ereignisses verfügen, können Sie automatisch ein Schema für diesen Ereignistyp erstellen. **So erstellen Sie ein Schema basierend auf dem JSON eines Ereignisses** 1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Wählen Sie im Navigationsbereich **Schemata** und dann **Schema erstellen** aus. 1. (Optional) Wählen Sie eine Schemaregistrierung aus oder erstellen Sie sie. 1. Geben Sie unter **Schema details (Schemadetails)** einen Namen für Ihr Schema ein. 1. (Optional) Geben Sie eine Beschreibung für das erstellte Schema ein. 1. Wählen Sie für **Schematyp** die Option **OpenAPI 3.0** aus. Sie können es nicht verwenden JSONSchema , wenn Sie ein Schema aus dem JSON eines Ereignisses erstellen. 1. Wählen Sie **Discover from JSON (Aus JSON-Code erkennen)** aus. 1. Fügen Sie in das Textfeld unter **JSON**, die JSON-Quelle eines Ereignisses ein oder ziehen Sie sie dorthin. Sie könnten beispielsweise die Quelle aus diesem AWS Step Functions Ereignis für eine fehlgeschlagene Ausführung einfügen. ``` { "version": "0", "id": "315c1398-40ff-a850-213b-158f73e60175", "detail-type": "Step Functions Execution Status Change", "source": "aws.states", "account": "012345678912", "time": "2019-02-26T19:42:21Z", "region": "us-east-1", "resources": [ "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name" ], "detail": { "executionArn": "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name", "stateMachineArn": "arn:aws:states:us-east-1:012345678912:stateMachine:state-machine", "name": "execution-name", "status": "FAILED", "startDate": 1551225146847, "stopDate": 1551225151881, "input": "{}", "output": null } } ``` 1. Klicken Sie auf **Discover schema (Schema erkennen)**. 1. EventBridge generiert ein OpenAPI-Schema für das Ereignis. Beispielsweise wird das folgende Schema für das vorhergehende Step-Functions-Ereignis generiert. ``` { "openapi": "3.0.0", "info": { "version": "1.0.0", "title": "StepFunctionsExecutionStatusChange" }, "paths": {}, "components": { "schemas": { "AWSEvent": { "type": "object", "required": ["detail-type", "resources", "detail", "id", "source", "time", "region", "version", "account"], "x-amazon-events-detail-type": "Step Functions Execution Status Change", "x-amazon-events-source": "aws.states", "properties": { "detail": { "$ref": "#/components/schemas/StepFunctionsExecutionStatusChange" }, "account": { "type": "string" }, "detail-type": { "type": "string" }, "id": { "type": "string" }, "region": { "type": "string" }, "resources": { "type": "array", "items": { "type": "string" } }, "source": { "type": "string" }, "time": { "type": "string", "format": "date-time" }, "version": { "type": "string" } } }, "StepFunctionsExecutionStatusChange": { "type": "object", "required": ["output", "input", "executionArn", "name", "stateMachineArn", "startDate", "stopDate", "status"], "properties": { "executionArn": { "type": "string" }, "input": { "type": "string" }, "name": { "type": "string" }, "output": {}, "startDate": { "type": "integer", "format": "int64" }, "stateMachineArn": { "type": "string" }, "status": { "type": "string" }, "stopDate": { "type": "integer", "format": "int64" } } } } } } ``` 1. Nachdem das Schema generiert wurde, wählen Sie **Erstellen** aus. # Ableiten von Schemas aus Event-Bus-Ereignissen in EventBridge Amazon EventBridge kann Schemas ableiten, indem es Ereignisse entdeckt. Wenn Sie Schemata ableiten möchten, aktivieren Sie die Ereigniserkennung in einem Event Bus und jedes eindeutige Schema wird der Schemaregistrierung hinzugefügt, einschließlich der Schemata für kontoübergreifende Ereignisse. **Schemas, die von entdeckt wurden, EventBridge werden in der **Registrierung Entdeckte Schemas auf der Seite Schemas** angezeigt.** Wenn sich der Inhalt von Ereignissen auf dem Event-Bus ändert, werden neue Versionen des zugehörigen Schemas EventBridge erstellt. EventBridge ## Überlegungen beim Starten der Schemaerkennung auf einem Event-Bus Bevor Sie die Schemaerkennung auf einem Eventbus aktivieren, sollten Sie die folgenden Überlegungen berücksichtigen: + Bei Aktivierung der Ereigniserkennung in einem Event Bus können Kosten entstehen. Die ersten fünf Millionen verarbeiteten Ereignisse in jedem Monat sind kostenlos. + EventBridge leitet Schemas standardmäßig aus kontenübergreifenden Ereignissen ab. Sie können dies jedoch deaktivieren, indem Sie die Eigenschaft aktualisieren. `cross-account` Weitere Informationen finden Sie unter [Discoverers](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers.html) in der API-Referenz zur EventBridge Schemaregistrierung. **Anmerkung** Die Schemaerkennung wird für Event-Busse, die mit einem vom Kunden verwalteten Schlüssel verschlüsselt wurden, nicht unterstützt. Um die Schemaerkennung auf einem Event-Bus zu aktivieren, wählen Sie die Verwendung von AWS-eigener Schlüssel. Weitere Informationen finden Sie unter [KMS-Schlüsseloptionen](eb-encryption-at-rest-key-options.md). **Um die Schemaerkennung auf einem Event-Bus (Konsole) zu starten oder zu beenden** 1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). 1. Wählen Sie im Navigationsbereich die Option **Event Buses** aus. 1. Wählen Sie den Event-Bus aus, auf dem Sie die Schemaerkennung starten oder beenden möchten. 1. Führen Sie eine der folgenden Aktionen aus: + Um die Schemaerkennung zu starten, wählen Sie **Erkennung starten** aus. + Um die Schemaerkennung zu beenden, wählen Sie **Discovery löschen**. **Um die Schemaerkennung auf einem Event-Bus zu starten oder zu beenden (AWS CLI)** + Verwenden Sie [create-discoverer](https://docs.aws.amazon.com/cli/latest/reference/schemas/create-discoverer.html), um die Schemaerkennung zu starten. [Verwenden Sie delete-discoverer, um die Schemaerkennung zu beenden.](https://docs.aws.amazon.com/cli/latest/reference/schemas/delete-discoverer.html) **Anmerkung** Die Schemaerkennung unterstützt keine Ereignisse, die größer als 1000 KiB sind. Diese Ereignisse werden nicht erkannt und es wird keine Fehlerbenachrichtigung generiert. Um Schemas für größere Ereignisse nachzuverfolgen, müssen Sie Schemas mithilfe der Schemaregistrierung manuell erstellen.