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.
# Hinzufügen von Datensätzen zu AWS Data Exchange
**Anmerkung**
Über die Catalog API hinzugefügte Datensätze ändern den `AddDataSets` Standardtyp des Datensatzes auf die Veröffentlichungsmethode des Produkts.
Um Ihrem AWS Data Exchange Produkt Datensätze hinzuzufügen, starten Sie einen Typänderungssatz`AddDataSets`. Dazu können Sie die `StartChangeSet` API-Operation verwenden und den Änderungstyp, die Produktkennzeichnung, den Produkttyp und die Details einschließlich des Datensatzes Amazon Resource Name (ARN) angeben.
## Tutorial: Hinzufügen neuer Datensätze zu einem veröffentlichten Datenprodukt
Dieses Tutorial führt Sie durch detaillierte Schritte zum Hinzufügen neuer AWS Data Exchange Datensätze zu einem veröffentlichten Produkt. Das Tutorial umfasst die folgenden allgemeinen Schritte.
**Topics**
+ [Einrichten von IAM-Berechtigungen](#data-set-catalog-iam-permissions)
+ [Greifen Sie auf die AWS Marketplace Katalog-API zu](#data-set-access-catalog-api)
+ [Rufen Sie Ihre Produkt-ID von der AWS Data Exchange Konsole ab](#get-data-set-exchange-product-id)
+ [Starten Sie eine Änderungsanfrage](#start-data-set-change-request)
+ [Überprüfen Sie den Status Ihres Änderungssatzes](#check-data-set-change-status)
### Einrichten von IAM-Berechtigungen
Bevor Sie beginnen, benötigen Sie AWS Identity and Access Management (IAM-) Berechtigungen für die Verwendung der AWS Marketplace Catalog API. Diese Berechtigungen gelten zusätzlich zu den Berechtigungen, die Sie für die Verwendung AWS Data Exchange benötigen.
1. Rufen Sie mit Ihrem Browser die IAM-Konsole auf und melden Sie sich mit einer an AWS-Konto , die IAM-Berechtigungen verwalten kann.
1. **Wählen Sie im linken Navigationsbereich Richtlinien aus.**
1. Wählen Sie **Richtlinie erstellen** aus.
1. Wählen Sie die Registerkarte **JSON** und geben Sie die folgenden Berechtigungen ein. Dies bietet vollen Zugriff auf die AWS Marketplace Katalog-API. Sie können den Zugriff entsprechend Ihrem Anwendungsfall einschränken.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-marketplace:CancelChangeSet",
"aws-marketplace:ListChangeSets",
"aws-marketplace:DescribeEntity",
"aws-marketplace:StartChangeSet",
"aws-marketplace:ListEntities",
"aws-marketplace:DescribeChangeSet",
"dataexchange:PublishDataSet"
],
"Resource": "*"
}
]
}
```
------
1. Wählen Sie **Weiter: Prüfen** aus.
1. Geben Sie einen Namen für die Richtlinie ein (z. B.**CatalogAPIFullAccess**) und wählen Sie dann **Create Policy** aus.
1. Wählen Sie in der IAM-Konsole die Benutzer, Gruppen oder Rollen aus, denen Sie die Richtlinie zuordnen möchten.
### Greifen Sie auf die AWS Marketplace Katalog-API zu
Verwenden Sie den folgenden HTTP-Client-Endpunkt, um auf die AWS Marketplace Katalog-API zuzugreifen.
```
catalog.marketplace.us-east-1.amazonaws.com
```
### Rufen Sie Ihre Produkt-ID von der AWS Data Exchange Konsole ab
Bevor Sie die AWS Marketplace Katalog-API verwenden können, um neue Datensätze zu veröffentlichen, müssen Sie Ihre Produkt-ID von der AWS Data Exchange Konsole abrufen. Navigieren Sie zum **Produkt-Dashboard** und kopieren Sie dann die Produkt-ID, für die Sie Datensätze veröffentlichen möchten. Sie können auch die [AWS Marketplace Katalog-API](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html) verwenden, um Ihre Produkt-ID zu finden, indem Sie die `ListEntities` Aktion mit dem **DataProduct@1.0** Entitätstyp verwenden.
### Starten Sie eine Änderungsanfrage
**Um eine Änderungsanforderung zu starten, um einen Datensatz zu Ihrem Testprodukt hinzuzufügen**
1. Kopieren Sie die Entitäts-ID, die Sie erhalten, indem Sie den Anweisungen unter folgen[Rufen Sie Ihre Produkt-ID von der AWS Data Exchange Konsole ab](#get-data-set-exchange-product-id).
1. Stellen Sie eine `StartChangeSet` Anfrage mit einem `AddDataSets` Änderungstyp.
**Anmerkung**
Informationen zum Arbeiten mit Änderungssätzen in der AWS Marketplace Katalog-API finden Sie unter [Mit Änderungssätzen arbeiten](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets). Weitere Informationen zum Arbeiten mit dem Identifier für Entitäten finden Sie unter [Identifier](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#identifier).
**Beispielanforderung**
```
https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet
```
**Beispiel für einen Anfragetext**
```
{
"Catalog": "AWSMarketplace",
"ChangeSetName": "Adding Data Set to my test Data Product",
"ChangeSet": [
{
"ChangeType": "AddDataSets",
"Entity": {
"Identifier": "entity-id@1",
"Type": "DataProduct@1.0"
},
"Details": "{ \"DataSets\": [ { \"Arn\": \"data-set-arn\" } ] }"
}
]
}
```
**Beispielantwort**
```
{
"ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh"
}
```
### Überprüfen Sie den Status Ihres Änderungssatzes
Nachdem Sie den `StartChangeSet` API-Vorgang zum Starten der Änderungsanforderung verwendet haben, können Sie den `DescribeChangeSet` Vorgang verwenden, um deren Status zu überprüfen. Geben Sie die in der `StartChangeSet` API-Antwort zurückgegebene Änderungssatz-ID an.
**Beispielanforderung**
```
https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh
```
**Beispiel für einen Anfragetext**
```
{
"changeSetId":"cs-bnEXAMPLE4mkz9oh"
}
```
**Beispielantwort**
```
{
"ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh",
"ChangeSetName": "Adding Data Set to my test Data Product",
"StartTime": "2018-09-20T19:45:03.115+0000",
"EndTime": "2018-09-20T19:48:12.517+0000",
"Status": "SUCCEEDED",
"FailureDescription": null,
"ChangeSet": [
{
"ChangeType": "AddDataSets",
"Entity": {
"Type": "DataProduct@1.0",
"Identifier": "entity-id@1"
},
"ErrorList": []
}
]
}
```
## AddDataSets Ausnahmen
Die folgenden Ausnahmen können auftreten, wenn Sie die AWS Marketplace Catalog API verwenden mit AWS Data Exchange:
**DATA\$1SET\$1NOT\$1FOUND**
Dies passiert, wenn der angeforderte Datensatz nicht gefunden wurde. Um dieses Problem zu beheben, stellen Sie sicher, dass der ARN des Datensatzes keinen Tippfehler enthält und dass Sie AWS-Konto Eigentümer des Datensatzes sind, und versuchen Sie es erneut.
**INVALID\$1INPUT**
Die Anfrage konnte aufgrund einer ungültigen Eingabe nicht bearbeitet werden. Um dieses Problem zu beheben, stellen Sie sicher, dass die Anfrage keinen Tippfehler enthält und dass das Produkt die maximal zulässige Anzahl von Datensätzen nicht überschreitet.
**DATA\$1SET\$1ALREADY\$1PUBLISHED**
Dies passiert, wenn der Datensatz dem Produkt bereits zuvor hinzugefügt wurde.
**DATA\$1SET\$1DUPLICATE\$1PROVIDED**
Dies passiert, wenn derselbe Datensatz in der Anfrage mehr als einmal bereitgestellt wird.