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.
# Veröffentlichen eines Produkts AWS Data Exchange in APIs
In den folgenden Themen wird beschrieben, wie Sie einen REST-API-Datensatz erstellen und ein neues Produkt veröffentlichen, das Folgendes enthält APIs AWS Data Exchange. Sie können den Vorgang entweder mit der AWS Data Exchange Konsole oder mit dem abschließen AWS Command Line Interface.
Nachdem Sie Ihre Amazon API Gateway Gateway-REST-API eingerichtet haben, können Sie einen neuen API-Datensatz in erstellen AWS Data Exchange. Anschließend können Sie eine Revision erstellen und API-Assets hinzufügen.
Durch das Erstellen und Veröffentlichen eines API-Assets können Abonnentenanfragen an einen AWS Data Exchange Endpunkt per Proxy an Ihre API-Gateway-API weitergeleitet werden. Anschließend können Sie diesen Datensatz zu einem Produkt hinzufügen und Preise hinzufügen. Anschließend können Abonnenten Ihr Produkt im Katalog und im AWS Marketplace Katalog ansehen und abonnieren. AWS Data Exchange
AWS Data Exchange Es sind Funktionen verfügbar, darunter revisionäre Zugriffsregeln, private Produkte, private Angebote und Abonnementverifizierung.
Sie können nur die vertragsbasierte Preisgestaltung, die Preisgestaltung nach Maß (bei der der Vertragspreis 0\$1 beträgt) oder eine Kombination aus gemessener und vertraglich festgelegter Preisgestaltung wählen.
Sie können zwischen standardmäßigen und nach der Berechnung berechneten Kosten wählen. Es stehen drei Arten von Standardkosten zur Verfügung:
+ Pro API-Anfrage
+ Pro erfolgreicher API-Anfrage
+ Pro übertragener Dateneinheit in Byte
**Anmerkung**
Die gemessenen Kosten gelten für alle API-Datensätze in einem Produkt. Wenn Sie also unterschiedliche Preise für dieselbe Dimension für verschiedene API-Datensätze berechnen möchten, empfehlen wir Ihnen, diese Datensätze in verschiedenen Produkten zu erstellen.
Der Prozess umfasst die folgenden Schritte:
**Topics**
+ [Voraussetzungen](#publish-api-prereq)
+ [Schritt 1: Aktualisieren Sie die API-Ressourcenrichtlinie](#update-API-resource-policy)
+ [Schritt 2: Erstellen Sie einen API-Datensatz](#create-api-data-set)
+ [Schritt 3: Erstellen Sie eine Revision](#create-api-revision)
+ [Schritt 4: Fügen Sie API-Assets zu einer Revision hinzu](#add-api-asset)
+ [Schritt 5: Veröffentlichen Sie ein neues Produkt mit APIs](#publish-api-data-product)
+ [Schritt 6: (Optional) Kopieren Sie ein Produkt](#copy-api-product)
## Voraussetzungen
Bevor Sie ein Produkt veröffentlichen können, das Folgendes enthält APIs, müssen Sie die folgenden Voraussetzungen erfüllen:
+ Bevor Sie eines AWS-Service, einschließlich, verwenden können AWS Data Exchange, müssen Sie sich für einen Administratorbenutzer registrieren AWS und diesen erstellen. Weitere Informationen finden Sie unter [Erste Schritte](https://docs.aws.amazon.com//singlesignon/latest/userguide/getting-started.html) im *AWS IAM Identity Center -Benutzerhandbuch*.
+ Um Produkte auf erstellen zu können AWS Data Exchange, müssen Sie sich AWS-Konto als AWS Marketplace Verkäufer registrieren. Verwenden Sie dieses Konto, um Ihre Datensätze zu erstellen. Das Konto mit der API Gateway Gateway-Ressource muss sich nicht in demselben Konto befinden, das die Datensätze erstellt.
+ Ihre REST-API muss sich auf Amazon API Gateway mit einer Integration befinden, die ein geeignetes Anfrage- und Antwortmodell für den Zugriff auf Ihre Daten verwendet, z. B. Amazon DynamoDB oder. AWS Lambda Weitere Informationen finden Sie unter [Entwickeln einer REST-API in API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/rest-api-develop.html) und [Arbeiten mit REST APIs](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-rest-api.html) im *Amazon API Gateway Developer Guide*.
**Anmerkung**
Es APIs werden nur öffentliche API Gateway unterstützt.
+ Ihre API-Gateway-REST-API muss in der Lage sein, Aufrufe vom AWS Data Exchange Service Principal zu authentifizieren und zu autorisieren. Jede Anfrage AWS Data Exchange an Ihre API verwendet das Signature Version 4 (Sigv4) -Protokoll, das mit Anmeldeinformationen signiert ist. AWS Data Exchange AWS Data Exchange funktioniert mit benutzerdefinierten Domänen und Domänenschlüsselzuordnungen.
**Anmerkung**
AWS Data Exchange unterstützt Amazon Cognito, No-Auth und Autorisierer nicht. AWS Lambda
+ Wenn Ihre API Gateway Gateway-REST-API ein benutzerdefiniertes Identitätssystem für die Authentifizierung und Autorisierung verwendet, konfigurieren Sie es für die Verwendung der IAM-Authentifizierung und importieren Sie ein OpenAPI-Schema, das Ihre API beschreibt. AWS Data Exchange ruft Ihre API-Gateway-REST-API mit ihren eigenen Dienstanmeldedaten auf und enthält Abonnenteninformationen wie die Konto-ID.
+ Ihre API-Gateway-REST-API ist für die Integration in Ihr Backend verantwortlich. Führen Sie dazu einen der folgenden Schritte aus:
+ Hängen Sie jeder Anfrage, die über Ihre API Gateway eingeht, ein langlebiges Authentifizierungstoken an, das das Backend überprüfen kann.
+ Verwenden Sie API Gateway, um eine Lambda-Funktion aufzurufen, die Anmeldeinformationen generieren und Ihre API aufrufen kann.
Ihre API wird gemäß der Spezifikation für die [API-Integrationsanfrage](#api-request-spec) aufgerufen.
Weitere Informationen finden Sie unter den folgenden Themen:
**Topics**
+ [Sicherheit von API-Datensätzen](#api-data-set-security)
+ [Spezifikation der API-Integrationsanfrage](#api-request-spec)
+ [Header-Weiterleitung](#header-forwarding)
### Sicherheit von API-Datensätzen
AWS Data Exchange verschlüsselt den Verkehr von Ende zu Ende mit Transport Layer Security (TLS) 1.2. Alle Metadaten werden im Ruhezustand verschlüsselt. AWS Data Exchange speichert keine Abonnentenanfragen oder Antworten von Ihrem Backend. Wir extrahieren nur Metering-Metadaten, die für die Abrechnung erforderlich sind.
### Spezifikation der API-Integrationsanfrage
Bei aktivierter API AWS Data Exchange werden alle Header (mit Ausnahme der unter aufgeführten Header[Header-Weiterleitung](#header-forwarding)), der Hauptteil, die HTTP-Methode, der Pfad und die Abfragezeichenfolgen unverändert aus der Kundenanfrage weitergeleitet und die folgenden Header angehängt.
```
// These headers help prevent Confused Deputy attacks. They enable the SourceAccount
// and SourceArn variables in IAM policies.
'x-amz-source-account': ACCOUNT_ID,
'x-amz-source-arn': `arn:aws:dataexchange:${REGION}:${OWNER_ACCOUNT_ID}:data-sets/${DATA_SET_ID}/revisions/${REVISION_ID}/assets/${ASSET_ID}`,
// These headers identify the API Asset in Data Exchange.
'x-amzn-dataexchange-asset-id': ASSET_ID,
'x-amzn-dataexchange-data-set-id': DATA_SET_ID,
'x-amzn-dataexchange-revision-id': REVISION_ID,
// This header identifies the Data Exchange Product.
'x-amzn-dataexchange-product-id': PRODUCT_ID,
// This header identifies the caller of Data Exchange. It will contain subscriber
// information.
'x-amzn-dataexchange-requester-account-id': REQUESTER_ACCOUNT_ID,
// Providers can attach custom metadata in the form of key/value pairs
// to a particular subscription. We will send these key/value pairs as stringified
// JSON.
'x-amz-dataexchange-subscription-metadata': STRINGIFIED_METADATA,
```
### Header-Weiterleitung
AWS Data Exchange entfernt alle Header im Zusammenhang mit der Authentifizierung oder dem Namespace für Amazon, bevor sie an ein Anbieter-Backend weitergeleitet werden. AWS Data Exchange Insbesondere entfernt es:
+ `Authentication`-Header
+ Alle Header, die beginnen mit `x-amz`
Der `host` Header wird als Folge des Proxyings überschrieben.
## Schritt 1: Aktualisieren Sie die API-Ressourcenrichtlinie
Wenn Sie über eine Amazon API Gateway Gateway-REST-API verfügen, die die [Voraussetzungen](#publish-api-prereq) erfüllt, müssen Sie Ihre API-Ressourcenrichtlinie aktualisieren, damit Sie Ihre API aufrufen können, wenn ein Abonnent eine Anfrage zum Abrufen des API-Schemas stellt. AWS Data Exchange
**Um Ihre API-Ressourcenrichtlinie zu aktualisieren**
1. Fügen Sie der Ressourcenrichtlinie Ihrer API die folgende Richtlinie hinzu:
```
{
"Effect": "Allow",
"Principal": {"Service": "dataexchange.amazonaws.com"},
"Action": "execute-api:Invoke",
"Resource": "*",
"Condition": {"StringEquals": {"aws:SourceAccount": ""}}
}
```
1. `account-id`Ersetzen Sie es durch das Konto, das den API-Datensatz erstellen wird.
Das Konto mit der API-Gateway-Ressource muss sich nicht in demselben Konto befinden, das den Datensatz erstellt.
Diese Richtlinie beschränkt diese Berechtigungen auf Aufrufe durch den AWS Data Exchange Service Principal und verlangt, dass nur Ihr Konto die Integration mit Ihrer API autorisieren AWS Data Exchange kann.
**Anmerkung**
Wenn Sie über eine Ressourcenrichtlinie verfügen, die diesen Aufruf ausdrücklich AWS Data Exchange ablehnt, müssen Sie diese Ablehnung entfernen oder einschränken.
Sie sind jetzt bereit, [einen API-Datensatz zu erstellen](#create-api-data-set).
## Schritt 2: Erstellen Sie einen API-Datensatz
Datensätze in AWS Data Exchange sind dynamisch und werden mithilfe von Revisionen versioniert, wobei jede Revision mindestens ein Asset enthält. Weitere Informationen finden Sie unter [Daten in AWS Data Exchange](data-sets.md).
Sie verwenden entweder die AWS Data Exchange Konsole oder die AWS Command Line Interface , um einen API-Datensatz zu erstellen:
+ [Einen API-Datensatz erstellen (Konsole)](#create-api-ds-console)
+ [Einen API-Datensatz erstellen (AWS CLI)](#create-api-ds-cli)
### Einen API-Datensatz erstellen (Konsole)
**Um einen API-Datensatz (Konsole) zu erstellen**
1. Öffnen Sie Ihren Webbrowser und melden Sie sich an der [AWS Data Exchange Konsole](https://console.aws.amazon.com/dataexchange) an.
1. Wählen Sie im linken Navigationsbereich unter **Meine Daten** die Option **Eigene Datensätze** aus.
1. Wählen Sie **unter Eigene Datensätze** die Option **Datensatz erstellen** aus, um den Assistenten für **Schritte zur Datensatzerstellung** zu öffnen.
1. **Wählen Sie unter Datensatztyp** auswählen die Option **Amazon API Gateway API** aus.
1. Geben **Sie unter Datensatz definieren** einen **Namen** und eine **Beschreibung** für Ihren Datensatz ein. Weitere Informationen finden Sie unter [Bewährte Verfahren für Datensätze](data-sets.md#data-set-best-practices).
1. (Optional) **Fügen Sie unter Tags hinzufügen — optional** Tags hinzu.
1. Wählen Sie **Erstellen** aus.
Sie sind jetzt bereit, eine Revision zu erstellen.
### Einen API-Datensatz erstellen (AWS CLI)
**So erstellen Sie einen API-Datensatz (CLI)**
1. Verwenden Sie den `create-data-set` Befehl, um einen API-Datensatz zu erstellen:
```
$ AWS dataexchange create-data-set \
--asset-type API_GATEWAY_API \
--description 'Data Set Description' \
--name 'Data Set Name'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID",
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:16:46.349000+00:00",
"Description": "Data Set Description",
"Id": "$DATA_SET_ID",
"Name": "Data Set Name",
"Origin": "OWNED",
"UpdatedAt": "2021-09-11T00:16:46.349000+00:00"
}
```
1. Beachten Sie den neuen Asset-Typ von`API_GATEWAY_API`.
Sie sind jetzt bereit, eine Revision zu erstellen.
## Schritt 3: Erstellen Sie eine Revision
Im folgenden Verfahren erstellen Sie eine Revision, nachdem Sie einen Datensatz erstellt haben. Weitere Informationen finden Sie unter [Überarbeitungen](data-sets.md#revisions).
Sie verwenden entweder die AWS Data Exchange Konsole oder die AWS Command Line Interface , um eine Revision zu erstellen:
+ [Eine Revision erstellen (Konsole)](#create-api-revision-console)
+ [Eine Revision erstellen (AWS CLI)](#create-api-revision-cli)
### Eine Revision erstellen (Konsole)
**Um eine Revision zu erstellen (Konsole)**
1. Gehen Sie auf der Seite mit den **Datensatz-Details im Abschnitt „Datensatzübersicht**“ wie folgt vor:
1. (Optional) Wählen Sie **„Name bearbeiten**“, um Informationen zu Ihrem Datensatz zu bearbeiten.
1. (Optional) Wählen Sie **Löschen**, um den Datensatz zu löschen.
1. Wählen Sie im Abschnitt **Revisionen** die Option **Revision erstellen** aus.
1. Geben **Sie unter Revision definieren** optional einen Kommentar zu Ihrer Revision ein, der den Zweck der Revision beschreibt.
1. (Optional) **Fügen Sie unter Tags hinzufügen — optional** Tags hinzu, die der Ressource zugeordnet sind.
1. Wählen Sie **Revision erstellen** aus.
1. Überprüfen, bearbeiten oder löschen Sie Ihre Änderungen aus dem vorherigen Schritt.
Sie sind jetzt bereit, [API-Assets zur Revision hinzuzufügen](#add-api-asset).
### Eine Revision erstellen (AWS CLI)
**Um eine Revision zu erstellen (AWS CLI)**
1. Verwenden Sie den `create-revision` Befehl, um eine Revision zu erstellen:
```
$ AWS dataexchange create-revision \
--data-set-id $DATA_SET_ID \
--comment 'First Atlas Revision'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID",
"Comment": "First Atlas Revision",
"CreatedAt": "2021-09-11T00:18:49.160000+00:00",
"DataSetId": "$DATA_SET_ID",
"Finalized": false,
"Id": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:18:49.160000+00:00"
}
```
1. [Fügen Sie die API-Assets zur Revision](#add-api-asset) hinzu.
**Anmerkung**
Sie müssen die ID der API-Gateway-REST-API, die Sie importieren möchten, sowie die Phase kennen.
## Schritt 4: Fügen Sie API-Assets zu einer Revision hinzu
API-Assets enthalten die Informationen, die Abonnenten benötigen, um Aufrufe an Ihre API zu tätigen. Weitere Informationen finden Sie unter [Objekte](data-sets.md#assets).
Im folgenden Verfahren importieren Sie Datenbestände und schließen dann die Revision ab.
Sie verwenden entweder die AWS Data Exchange Konsole oder die AWS CLI , um einer Revision Elemente hinzuzufügen:
+ [Hinzufügen von API-Assets zu einer Revision (Konsole)](#add-api-assets)
+ [Hinzufügen von API-Assets zu einer Revision (AWS CLI)](#add-api-assets-cli)
### Hinzufügen von API-Assets zu einer Revision (Konsole)
**Um der Revision Assets hinzuzufügen (Konsole)**
1. Wählen Sie auf der Seite mit den Datensatzdetails im Abschnitt **API-Assets** die Option **API-Stufe hinzufügen** aus.
1. Geben **Sie unter Phase „API auswählen“** für **Amazon API Gateway API** eine API in das Eingabefeld ein oder wählen Sie eine der folgenden Optionen aus der Drop-down-Liste aus:
+ **API in einer anderen AWS-Konto** — das ist eine kontoübergreifende API, für deren Zugriff Ihnen eine Zugriffsberechtigung erteilt wurde.
+ **In diesem AWS-Konto** Fall ist dies eine API in Ihrem AWS-Konto.
1. Wenn Sie **API in einem anderen** ausgewählt haben AWS-Konto, geben Sie die API-ID und den **Namen der API-Stufe** in die Eingabefelder ein.
1. Wenn Sie **Darin** ausgewählt haben AWS-Konto, wählen Sie den **Namen der API-Stufe** aus der Drop-down-Liste
**Anmerkung**
Sie können eine neue API-Phase **erstellen, indem Sie Create new** wählen und den Schritten im Modal **Create new API on Amazon API Gateway** folgen. Sobald die neue Phase erstellt wurde, wiederholen Sie Schritt 2.
1. Unter **Erweiterte Konfiguration — optional** können Sie den **bestehenden Amazon API Gateway Gateway-Nutzungsplan Connect** wählen, um die Drosselung und die Kontingentbeschränkungen zu verwenden, die im bestehenden Nutzungsplan definiert sind, und den **API-Schlüssel** eingeben.
1. Geben Sie unter **Dokument-API für Abonnenten** Einzelheiten zur API an, die den Abonnenten angezeigt wird, nachdem sie Ihr Produkt abonniert haben.
1. Geben Sie als **API-Name** einen Namen ein, anhand dessen Abonnenten das API-Asset identifizieren können.
**Anmerkung**
Wenn ein **In this** ausgewählt AWS-Konto wurde, wird der **API-Name** automatisch ausgefüllt, den Sie bei Bedarf ändern können.
Wenn eine **API in einer anderen** ausgewählt AWS-Konto wurde, wird der **API-Name** mit einem Standardnamen aufgefüllt, den Sie entsprechend ändern sollten, damit der Abonnent leicht verstehen kann, um was es sich handelt.
1. Für die **OpenAPI 3.0-Spezifikation** gilt entweder:
1. Geben Sie die OpenAPI 3.0-Spezifikationsdatei ein oder kopieren Sie sie und fügen Sie sie ein.
1. Wählen Sie **Aus .JSON-Datei importieren** und wählen Sie dann die zu importierende JSON-Datei von Ihrem lokalen Computer aus.
Die importierte Spezifikation wird im Feld angezeigt.
1. Wählen Sie **Aus Amazon API Gateway importieren** und wählen Sie dann eine Spezifikation für den Import aus.
Die importierte Spezifikation wird im Feld angezeigt.
1. Für **zusätzliche Dokumentation — optional —** geben Sie alle zusätzlichen Informationen ein, die für den Abonnenten nützlich sind, um mehr über Ihre API zu erfahren. Markdown wird unterstützt.
**Anmerkung**
Sie können die OpenAPI-Spezifikation und die zusätzliche Dokumentation nicht bearbeiten, nachdem Sie dieses Asset zu einer Revision hinzugefügt haben.
Wenn Sie diese Informationen aktualisieren möchten und die Revision noch nicht abgeschlossen ist, können Sie das Asset ersetzen.
Wenn Sie diese Informationen aktualisieren möchten und die Revision abgeschlossen ist, können Sie eine neue Version mit dem aktualisierten Objekt erstellen.
1. Wählen Sie „**API-Phase hinzufügen**“.
Es wird ein Job gestartet, um Ihr Asset (in diesem Fall die API) in Ihren Datensatz zu importieren.
**Anmerkung**
Wenn Sie keine API auf Amazon API Gateway haben, werden Sie aufgefordert, eine zu erstellen.
1. Nachdem der Job abgeschlossen ist, wird das Feld **Status** im Bereich **Jobs** auf **Abgeschlossen aktualisiert.**
1. Wenn Sie weitere hinzufügen APIs möchten, wiederholen Sie Schritt 2.
1. Sehen Sie sich unter **Revisionsübersicht** Ihre Revision und ihre Inhalte an.
1. Wählen Sie **Finalize** aus.
Sie haben eine Revision für einen Datensatz erfolgreich abgeschlossen.
Sie können [eine Revision bearbeiten](#edit-api-revision) oder [löschen](#delete-api-revision), bevor Sie sie einem Produkt hinzufügen.
Sie sind jetzt bereit, [ein neues API-Datenprodukt zu veröffentlichen](#publish-api-data-product).
### Hinzufügen von API-Assets zu einer Revision (AWS CLI)
Sie können API-Assets hinzufügen, indem Sie einen `IMPORT_ASSET_FROM_API_GATEWAY_API` Job ausführen.
**So fügen Sie API-Assets zu einer Revision hinzu (AWS CLI):**
1. Verwenden Sie den `create-job` Befehl, um API-Assets zur Revision hinzuzufügen:
```
$ AWS dataexchange create-job \
--type IMPORT_ASSET_FROM_API_GATEWAY_API \
--details '{"ImportAssetFromApiGatewayApi":{"DataSetId":"$DATA_SET_ID","RevisionId":"$REVISION_ID","ApiId":"$API_ID","Stage":"$API_STAGE","ProtocolType":"REST"}}'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/$JOB_ID",
"CreatedAt": "2021-09-11T00:38:19.875000+00:00",
"Details": {
"ImportAssetFromApiGatewayApi": {
"ApiId": "$API_ID",
"DataSetId": "$DATA_SET_ID",
"ProtocolType": "REST",
"RevisionId": "$REVISION_ID",
"Stage": "$API_STAGE"
}
},
"Id": "$JOB_ID",
"State": "WAITING",
"Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
"UpdatedAt": "2021-09-11T00:38:19.875000+00:00"
}
$ AWS dataexchange start-job --job-id $JOB_ID
$ AWS dataexchange get-job --job-id $JOB_ID
{
"Arn": "arn:aws:dataexchange:us-east-1:0123456789012:jobs/$JOB_ID",
"CreatedAt": "2021-09-11T00:38:19.875000+00:00",
"Details": {
"ImportAssetFromApiGatewayApi": {
"ApiId": "$API_ID",
"DataSetId": "$DATA_SET_ID",
"ProtocolType": "REST",
"RevisionId": "$REVISION_ID",
"Stage": "$API_STAGE"
"ApiEndpoint": "string",
"ApiKey": "string",
"ApiName": "string",
"ApiDescription": "string",
"ApiSpecificationDownloadUrl": "string",
"ApiSpecificationDownloadUrlExpiresAt": "string"
}
},
"Id": "$JOB_ID",
"State": "COMPLETED",
"Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
"UpdatedAt": "2021-09-11T00:38:52.538000+00:00"
}
```
1. Verwenden Sie den `list-revision-assets` Befehl, um zu bestätigen, dass das neue Asset ordnungsgemäß erstellt wurde:
```
$ AWS dataexchange list-revision-assets \
--data-set-id $DATA_SET_ID \
--revision-id $REVISION_ID
{
"Assets": [
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID/assets/$ASSET_ID",
"AssetDetails": {
"ApiGatewayApiAsset": {
"ApiEndpoint": "https://$API_ID.execute-api.us-east-1.amazonaws.com/$API_STAGE",
"ApiId": "$API_ID",
"ProtocolType": "REST",
"Stage": "$API_STAGE"
}
},
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:38:52.457000+00:00",
"DataSetId": "$DATA_SET_ID",
"Id": "$ASSET_ID",
"Name": "$ASSET_ID/$API_STAGE",
"RevisionId": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:38:52.457000+00:00"
}
]
}
```
Sie sind jetzt bereit, [das API-Datenprodukt zu veröffentlichen](#publish-api-data-product).
### Bearbeiten Sie eine Revision
**Um die Revision zu bearbeiten, nachdem Sie sie abgeschlossen haben**
1. Wählen Sie in der **Revisionsübersicht** die Option **De-finalisieren** aus.
Es wird eine Meldung angezeigt, dass sich die Revision nicht mehr im finalisierten Zustand befindet.
1. Um die Revision zu bearbeiten, wählen Sie in der **Revisionsübersicht** die Optionen **Aktionen**, **Bearbeiten** aus.
1. Nehmen Sie Ihre Änderungen vor und wählen Sie dann **Aktualisieren**.
1. Überprüfen Sie Ihre Änderungen und wählen Sie dann **Finalize** aus.
### Lösche eine Revision
**Um die Revision zu löschen, nachdem Sie sie abgeschlossen haben**
1. Wählen Sie in der **Revisionsübersicht** die Option **Löschen** aus.
1. Geben **Sie **Delete** im Dialogfeld „Revision löschen**“ etwas ein, und wählen Sie dann **Löschen** aus.
**Warnung**
Dadurch werden die Revision und alle zugehörigen Elemente gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.
## Schritt 5: Veröffentlichen Sie ein neues Produkt mit APIs
Nachdem Sie mindestens einen Datensatz erstellt und eine Überarbeitung mit Ressourcen abgeschlossen haben, können Sie diesen Datensatz als Teil eines Produkts veröffentlichen. Weitere Informationen finden Sie unter [Bewährte Produktpraktiken in AWS Data Exchange](product-details.md). Stellen Sie sicher, dass Sie über alle erforderlichen Informationen zu Ihrem Produkt und Angebot verfügen.
Sie verwenden die AWS Data Exchange Konsole oder die AWS Marketplace Katalog-API, um ein neues Produkt zu veröffentlichen, das Folgendes enthält APIs: Weitere Informationen zum Veröffentlichen eines neuen Produkts mithilfe der AWS Marketplace Katalog-API finden Sie unter[Verwendung AWS Data Exchange mit der AWS Marketplace Catalog API](appendices.md).
+ [Veröffentlichung eines neuen Produkts, das APIs (Konsole) enthält](#publish-api-product-console)
### Veröffentlichung eines neuen Produkts, das APIs (Konsole) enthält
**Um ein neues Produkt zu veröffentlichen, das Folgendes enthält APIs**
1. Wählen Sie im linken Navigationsbereich der [AWS Data Exchange Konsole](https://console.aws.amazon.com/dataexchange) unter **Daten veröffentlichen** die Option **Produkte** aus.
1. Wählen Sie **unter Produkte** die Option **Neues Produkt veröffentlichen** aus, um den Assistenten zur **Veröffentlichung neuer Produkte** zu öffnen.
1. Unter **Produktsichtbarkeit**:
1. Wählen Sie für Ihr **Produkt die Sichtbarkeitsoptionen** „**Öffentlich**“ oder „**Privat**“ aus.
Für alle AWS Data Exchange Produkte, bei denen die Sichtbarkeit auf „**Öffentlich**“ eingestellt ist, ist ein öffentliches Angebot erforderlich.
Weitere Informationen finden Sie unter [Sichtbarkeit des Produkts in AWS Data Exchange](product-visibility.md).
1. Wählen Sie die Konfiguration für **sensible Informationen** für Ihr Produkt aus.
Weitere Informationen finden Sie unter [Vertrauliche Informationskategorien in AWS Data Exchange](sensitive-information.md).
1. Wählen Sie **Weiter** aus.
1. Unter **Daten hinzufügen**:
1. Aktivieren **Sie unter Eigene Datensätze** die Kontrollkästchen neben den Datensätzen, die Sie hinzufügen möchten, und wählen Sie dann **Ausgewählte hinzufügen** aus.
**Anmerkung**
Für die ausgewählten Datensätze muss eine endgültige Version vorliegen. Datensätze ohne abgeschlossene Versionen werden nicht hinzugefügt.
1. Gehen Sie zu **Ausgewählte Datensätze**, um Ihre Auswahl zu überprüfen.
Sie können den **Namen** des Datensatzes, den **Typ** des Datensatzes und den Zeitstempel der **letzten** Aktualisierung des Datensatzes überprüfen.
1. Gehen **Sie zu Revisionszugriffsregeln** auswählen und wählen Sie die Revisionszugriffsregeln aus, die Sie für die in diesem Produkt enthaltenen Datensätze festlegen möchten.
Weitere Informationen finden Sie unter [Überarbeitung der Zugriffsregeln in AWS Data Exchange](best-practices-revisions.md).
1. Wählen Sie **Weiter** aus.
1. Unter **Produkt definieren**:
1. Geben Sie unter **Produktübersicht** Informationen zu Ihrem Produkt ein, einschließlich des **Produktnamens**, des **Produktlogos**, der **Support-Kontaktinformationen** und der **Produktkategorien**.
Weitere Informationen finden Sie unter [Bewährte Produktpraktiken in AWS Data Exchange](product-details.md).
1. **(Optional) Wählen Sie unter **Datenwörterbücher und Beispiele — optional** einen Datensatz aus, indem Sie auf das Optionsfeld neben dem Namen des Datensatzes klicken und dann Bearbeiten auswählen.**
1. Wählen **Sie im Dialogfeld Bearbeiten** die Option **Hochladen** aus, um ein neues Datenwörterbuch hochzuladen.
Sie können ein Datenwörterbuch im CSV-Format mit einer maximalen Größe von 1 MB auswählen.
1. Wählen Sie ein gespeichertes Datenwörterbuch auf Ihrem Computer aus und wählen Sie dann **Öffnen**.
Die CSV-Datei mit dem Datenwörterbuch wird im Dialogfeld **Bearbeiten** angezeigt.
**Anmerkung**
Ihr Datenwörterbuch muss der AWS Data Exchange Datenwörterbuchvorlage entsprechen. Wenn Sie kein gespeichertes Datenwörterbuch zum Hochladen haben, können Sie entweder den **leeren Link zur Datenwörterbuchvorlage** oder den **Beispiellink für ein Datenwörterbuch** in der AWS Data Exchange Konsole wählen.
1. Wählen Sie **Datenwörterbuchvorschau**, um eine Vorschau des Datenwörterbuchs anzuzeigen.
1. Wählen Sie unter **Beispiele — optional** die Option **Beispiele hochladen** aus, wählen Sie ein Beispiel von Ihrem Computer aus und wählen Sie dann **Öffnen** aus.
Die Samples werden im Dialogfeld „**Bearbeiten**“ angezeigt.
**Anmerkung**
Sie können bis zu 10 Samples mit einer maximalen Größe von 50 MB hochladen. Beispiele im CSV-Format können in der Vorschau angezeigt werden.
1. Geben Sie für jedes Muster eine Beschreibung ein, die auf der Produktdetailseite angezeigt wird.
1. Wählen Sie **Speichern**.
1. Geben Sie unter **Produktdefinition** eine **Kurzbeschreibung** und eine **Langbeschreibung** Ihres Produkts ein.
Wenn Sie eine Vorlage für Ihre ausführliche Beschreibung verwenden möchten, wählen Sie **Vorlage anwenden** aus, wählen Sie Ihren Vorlagentyp aus und füllen Sie dann die Vorlage mit Ihren spezifischen Produktdetails aus.
1. Wählen Sie **Weiter** aus.
1. Konfigurieren Sie Ihr Angebot entweder unter **Öffentliches Angebot hinzufügen** (für öffentliches Angebot) oder **Benutzerdefiniertes Angebot hinzufügen** (für private Angebote):
Für alle AWS Data Exchange Produkte, deren Sichtbarkeit auf **Öffentlich** gesetzt ist, ist ein öffentliches Angebot erforderlich.
1. Nur für private Angebote:
1. Wählen Sie eine der aufgeführten **Angebotstypen**: **Privatangebot**, **Erneuertes Privatangebot** oder **Bring Your Own Subscription (BYOS)**.
1. Fügen Sie im Abschnitt **Informationen zum Abonnentenkonto** mindestens ein Abonnentenkonto hinzu, auf das Sie das Angebot erweitern möchten.
1. Wählen Sie Ihre Optionen für **Preise und Zugriffsdauer** für das Abonnement aus.
1. Wählen Sie **für Kostenberechnung — optional** die Option **Hinzufügen** aus.
1. Wählen Sie unter **„Gemessene Kosten hinzufügen**“ die Art der Kosten für den API-Aufruf aus der Liste **Typ** aus:
+ **Pro API-Anfrage**
+ **Pro erfolgreicher API-Anfrage**
+ **Pro übertragener Dateneinheit in Byte**
+ **Neue, individuell berechnete Kosten**
1. Geben Sie den **Anzeigenamen für die Kosten** ein, der auf der Rechnung des Abonnenten angezeigt wird, oder aktualisieren Sie ihn.
1. Wenn du **vordefinierte, gemessene Kosten** verwendest, wird der **Schlüssel** automatisch generiert, kann nicht bearbeitet werden und muss nicht im Antwort-Header zurückgesendet werden.
1. Wenn Sie eine **neue benutzerdefinierte Kostenberechnung** erstellen, geben Sie den **Schlüssel** ein. Dabei handelt es sich um die Kennung für die gemessenen Kosten im API-Antwort-Header (maximal 15 Zeichen).
Dieser **Schlüssel** sollte als Teil des `x-amz-dataexchange-metering` Antwort-Headers zurückgesendet werden.
**Example Benutzerdefinierter Schlüssel**
Wenn Sie einen benutzerdefinierten Schlüssel aufgerufen **VertexCount** und einen anderen benutzerdefinierten Schlüssel aufgerufen haben**EdgeCount**, könnte der Antwortheader „x-amz-dataexchange-metering“ den Wert haben `VertexCount=3,EdgeCount=10` oder Sie könnten zwei separate Header-Zeilen zurückgeben:
`x-amz-dataexchange-metering: VertextCount=3`
`x-amz-dataexchange-metering: EdgeCount=10`
1. Geben Sie im Feld **Preis/Einheit den Preis ein, der dem Abonnenten pro Einheit** berechnet wird.
1. (Optional) Geben Sie die Anzahl der Einheiten ein, um ein Beispiel für die Kosten im **Rechner für gemessene Kosten** anzuzeigen.
1. (Optional) Geben Sie eine kurze **Beschreibung** der gemessenen Kosten ein, die auf der Produktdetailseite angezeigt wird.
1. Wählen Sie **Hinzufügen** aus.
1. (Optional) Wiederholen Sie den Vorgang, um weitere gemessene Kosten hinzuzufügen.
Die Reihenfolge der gemessenen Kosten wird auf der Produktdetailseite angezeigt. Sie können sie nicht nachbestellen.
**Anmerkung**
Nachdem das Angebot erstellt wurde, können Sie den Preis und die Beschreibung eines gemessenen Preises bearbeiten. Weitere Informationen finden Sie unter [Aktualisierung der Produkt- und Angebotsdetails in AWS Data Exchange](update-product-details.md).
1. Nur für private Angebote wählen Sie das **Ablaufdatum des Angebots** aus, bis zu dem der Abonnent das Angebot annehmen muss.
1. Wählen Sie Ihre **Steuereinstellungen**, den **Datenabonnementvertrag (DSA)** und die **Rückerstattungsrichtlinie** aus.
1. (Optional) Lege nur für öffentliche Angebote die **Abonnementbestätigung** fest, sodass du kontrollieren kannst, wer dieses Produkt abonnieren kann. Weitere Informationen finden Sie unter [Abonnementüberprüfung für Anbieter in AWS Data Exchange](subscription-verification-pro.md).
1. Wählen Sie Ihre Option für **die automatische Verlängerung**. Weitere Informationen finden Sie unter [Ein Angebot für AWS Data Exchange Produkte erstellen](prepare-offers.md).
1. Wählen Sie **Weiter** aus.
1. **Überprüfen Sie im Bereich Überprüfen und veröffentlichen** Ihre Produktinformationen.
1. Erweitern Sie die **Vorschau der Produktseite**, um zu sehen, wie die Produktseite nach der Veröffentlichung aussehen wird.
1. (Optional) Wählen Sie in einem beliebigen Abschnitt die Schaltfläche **Bearbeiten**, um diesen Abschnitt zu bearbeiten.
1. Wenn Sie sicher sind, dass Sie das Produkt und das öffentliche Angebot sichtbar und für alle verfügbar machen möchten, wählen Sie **Veröffentlichen**.
Sie haben jetzt den manuellen Teil der Veröffentlichung eines Datenprodukts mit einem öffentlichen Angebot abgeschlossen. AWS Data Exchange bereitet Ihr Produkt vor und veröffentlicht es.
Auf der **Produktübersichtsseite** lautet der Status Ihres Produkts **Wartet auf Genehmigung** und ändert sich nach der **Veröffentlichung** in Veröffentlicht.
## Schritt 6: (Optional) Kopieren Sie ein Produkt
Nachdem Sie Ihr erstes Produkt erstellt haben, können Sie dessen Details und öffentliche Angebote kopieren, um ein neues Produkt zu erstellen.
**Anmerkung**
Sie können ein öffentliches, privates, veröffentlichtes oder unveröffentlichtes Produkt kopieren. Benutzerdefinierte Angebote, die mit dem Produkt verknüpft sind, werden nicht kopiert, öffentliche Angebote werden jedoch kopiert.
**So kopieren Sie ein Produkt**
1. [Öffnen Sie Ihren Webbrowser und melden Sie sich an der Konsole an.AWS Data Exchange](https://console.aws.amazon.com/dataexchange)
1. Wählen Sie im linken Navigationsbereich unter **Daten veröffentlichen** die Option **Produkte** aus.
1. Wählen Sie unter **Produkte** die Schaltfläche neben dem Produkt aus, das Sie kopieren möchten.
1. Wählen Sie das Drop-down-Menü **Aktionen** aus und wählen Sie dann **Kopie erstellen** aus.
1. Fahren Sie mit dem Workflow „**Neues Produkt veröffentlichen**“ fort, wobei die Details für das Produkt, das Sie in Schritt 3 ausgewählt haben, bereits ausgefüllt sind. Weitere Informationen finden Sie unter [Schritt 5: Veröffentlichen Sie ein neues Produkt](publish-data-product.md#publish-products).