

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.

# Einen Datenzuschuss für Folgendes erstellen AWS Data Exchange APIs
<a name="creating-a-data-grant-api"></a>

In den folgenden Themen wird beschrieben, wie ein REST-API-Datensatz erstellt und zu einem Data Grant hinzugefügt wird, APIs der AWS Data Exchange Folgendes enthält: 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 die Erstellung eines Data Grants mit einem API-Asset können Empfängeranfragen an einen AWS Data Exchange Endpunkt per Proxy an Ihre API-Gateway-API weitergeleitet werden.

Der Prozess umfasst die folgenden Schritte:

**Topics**
+ [Voraussetzungen](#creating-a-data-grant-api-prereq)
+ [Schritt 1: Aktualisieren Sie die API-Ressourcenrichtlinie](#data-grant-update-API-resource-policy)
+ [Schritt 2: Erstellen Sie einen API-Datensatz](#data-grant-create-api-data-set)
+ [Schritt 3: Erstellen Sie eine Revision](#data-grant-create-api-revision)
+ [Schritt 4: Fügen Sie API-Assets zu einer Revision hinzu](#data-grant-add-api-asset)
+ [Schritt 5: Erstellen Sie eine neue Datenzuweisung, die Folgendes enthält APIs](#data-grant-publish-api-data-product)

## Voraussetzungen
<a name="creating-a-data-grant-api-prereq"></a>

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 registrieren AWS und einen Administratorbenutzer 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*.
+ 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](publish-API-product.md#api-request-spec) aufgerufen.

Weitere Informationen finden Sie unter den folgenden Themen:

**Topics**
+ [Sicherheit von API-Datensätzen](#data-grant-api-data-set-security)
+ [Spezifikation der API-Integrationsanfrage](#data-grant-api-request-spec)
+ [Header-Weiterleitung](#data-grant-header-forwarding)

### Sicherheit von API-Datensätzen
<a name="data-grant-api-data-set-security"></a>

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.

### Spezifikation der API-Integrationsanfrage
<a name="data-grant-api-request-spec"></a>

Bei aktivierter API AWS Data Exchange werden alle Header (mit Ausnahme der unter aufgeführten Header[Header-Weiterleitung](publish-API-product.md#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
<a name="data-grant-header-forwarding"></a>

AWS Data Exchange entfernt alle Header im Zusammenhang mit der Authentifizierung oder dem Namespace für Amazon, bevor sie an ein Dateneigentümer-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
<a name="data-grant-update-API-resource-policy"></a>

Wenn Sie über eine Amazon API Gateway Gateway-REST-API verfügen, die die [Voraussetzungen](publish-API-product.md#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": "<account-id>"}}
   }
   ```

1. `account-id`Ersetzen Sie es durch das Konto, das den API-Datensatz erstellen wird. 

   Das Konto mit der API Gateway 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](publish-API-product.md#create-api-data-set).

## Schritt 2: Erstellen Sie einen API-Datensatz
<a name="data-grant-create-api-data-set"></a>

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)](publish-API-product.md#create-api-ds-console)
+ [Einen API-Datensatz erstellen (AWS CLI)](publish-API-product.md#create-api-ds-cli)

### Einen API-Datensatz erstellen (Konsole)
<a name="data-grant-create-api-ds-console"></a>

**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)
<a name="data-grant-create-api-ds-cli"></a>

**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
<a name="data-grant-create-api-revision"></a>

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)](publish-API-product.md#create-api-revision-console)
+ [Eine Revision erstellen (AWS CLI)](publish-API-product.md#create-api-revision-cli)

### Eine Revision erstellen (Konsole)
<a name="data-grant-create-api-revision-console"></a>

**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](publish-API-product.md#add-api-asset).

### Eine Revision erstellen (AWS CLI)
<a name="data-grant-create-api-revision-cli"></a>

**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](publish-API-product.md#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
<a name="data-grant-add-api-asset"></a>

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)](publish-API-product.md#add-api-assets)
+ [Hinzufügen von API-Assets zu einer Revision (AWS CLI)](publish-API-product.md#add-api-assets-cli)

### Hinzufügen von API-Assets zu einer Revision (Konsole)
<a name="data-grant-add-api-assets"></a>

**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 aus
**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 Empfängern angezeigt werden, nachdem sie die Datengewährung akzeptiert haben.

   1. Geben Sie als **API-Name** einen Namen ein, anhand dessen die Empfänger 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 Empfänger leicht verstehen kann, um welchen 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. Überprüfen Sie unter **Revisionsübersicht** Ihre Revision und ihre Inhalte. 

1. Wählen Sie **Finalize** aus.

Sie haben eine Revision für einen Datensatz erfolgreich abgeschlossen. 

Sie können [eine Revision bearbeiten](publish-API-product.md#edit-api-revision) oder [löschen](publish-API-product.md#delete-api-revision), bevor Sie sie einem Data Grant hinzufügen. 

Sie sind jetzt bereit, [eine neue Datengewährung zu erstellen, die Folgendes enthält APIs](publish-API-product.md#publish-api-data-product):

### Hinzufügen von API-Assets zu einer Revision (AWS CLI)
<a name="data-grant-add-api-assets-cli"></a>

Sie können API-Assets hinzufügen, indem Sie einen `IMPORT_ASSET_FROM_API_GATEWAY_API` Job ausführen.

**Um API-Assets zu einer Revision hinzuzufügen (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, einen neuen Data Grant zu erstellen, der Folgendes enthält APIs:

### Bearbeiten Sie eine Revision
<a name="data-grant-edit-api-revision"></a>

**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
<a name="data-grant-delete-api-revision"></a>

**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**“ einen Text 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: Erstellen Sie eine neue Datenzuweisung, die Folgendes enthält APIs
<a name="data-grant-publish-api-data-product"></a>

Nachdem Sie mindestens einen Datensatz erstellt und eine Überarbeitung mit Ressourcen abgeschlossen haben, können Sie diesen Datensatz als Teil einer Datengewährung veröffentlichen.

**Um eine neue Datenerteilung zu erstellen**

1. Wählen Sie im linken Navigationsbereich der AWS Data Exchange Konsole unter **Ausgetauschte Datenzuschüsse** die Option **Gesendete Datenzuschüsse** aus.

1. Wählen Sie **unter Gesendete Datenzuschüsse** die Option **Datengewährung erstellen** aus, um den Assistenten zur **Definition von Datenzuweisungen** zu öffnen.

1. **Aktivieren Sie im Abschnitt Eigenen Datensatz** auswählen das Kontrollkästchen neben dem Datensatz, den Sie hinzufügen möchten.
**Anmerkung**  
Der von Ihnen gewählte Datensatz muss eine endgültige Version haben. Datensätze ohne abgeschlossene Änderungen können nicht zu Data Grants hinzugefügt werden.  
Im Gegensatz zu Datensätzen, die in Datenprodukten enthalten sind, die gemeinsam genutzt werden AWS Marketplace, gibt es für Datensätze, die zu einer Datenzuweisung hinzugefügt wurden, keine Regeln für den Zugriff auf Änderungen. Das bedeutet, dass ein Empfänger einer Datenzuweisung, sobald die Datenzuweisung genehmigt wurde, Zugriff auf alle endgültigen Versionen eines bestimmten Datensatzes hat (einschließlich historischer Änderungen, die vor der Erstellung der Datenzuschüsse abgeschlossen wurden).

1. Geben Sie im Abschnitt **Übersicht über den Zuschuss** die Informationen ein, die dem Empfänger zu Ihrer Datengewährung angezeigt werden, einschließlich des **Namens der Datengewährung** und der **Beschreibung der Datengewährung**.

1. **Wählen Sie „Weiter**“.

1. Geben Sie im Abschnitt **Informationen zum Empfängerzugriff** unter **AWS-Konto ID** die AWS-Konto ID des Empfängerkontos ein, das die Datengewährung erhalten soll.

1. Wählen Sie außerdem im Abschnitt **Informationen zum Empfängerzugriff** **unter Enddatum** des Zugriffs aus, ob die Datenerteilung unbefristet gelten soll, wählen Sie **Kein Enddatum** oder ob sie ein Enddatum haben soll, wählen Sie **Spezifisches Enddatum** aus und wählen Sie das gewünschte Enddatum aus.

1. Wählen Sie **Weiter** aus.

1. Überprüfen Sie im Abschnitt **Überprüfen und senden** Ihre Informationen zur Datenerteilung.

1. Wenn Sie sicher sind, dass Sie die Datengewährung erstellen und an den ausgewählten Empfänger senden möchten, wählen Sie **Datengewährung erstellen und senden** aus.

Sie haben jetzt den manuellen Teil der Erstellung eines Datenzuschusses abgeschlossen. Die Datengewährung wird auf der Seite **Gesendete Datengewährungen** auf der Registerkarte **Gesendete Datenzuweisungen** angezeigt und hat den Status **Ausstehende Annahme**, bis das Empfängerkonto sie akzeptiert.