Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Ajoutez des ensembles de données à AWS Data Exchange
**Note**
Les ensembles de données ajoutés via l'API du catalogue modifient le type d'ensemble `AddDataSets` par défaut en fonction de la méthode de publication du produit.
Pour ajouter des ensembles de données à votre AWS Data Exchange produit, lancez un ensemble de modifications de type`AddDataSets`. Pour ce faire, vous pouvez utiliser l'opération `StartChangeSet` API et spécifier le type de modification, l'identifiant du produit, le type de produit et les détails, notamment le jeu de données Amazon Resource Name (ARN).
## Tutoriel : Ajouter de nouveaux ensembles de données à un produit de données publié
Ce didacticiel explique en détail les étapes à suivre pour ajouter de nouveaux ensembles de AWS Data Exchange données à un produit publié. Le didacticiel comporte les étapes de haut niveau suivantes.
**Topics**
+ [Définir des autorisations IAM](#data-set-catalog-iam-permissions)
+ [Accédez à l'API du AWS Marketplace catalogue](#data-set-access-catalog-api)
+ [Obtenez l'identifiant de votre produit depuis la AWS Data Exchange console](#get-data-set-exchange-product-id)
+ [Lancer une demande de modification](#start-data-set-change-request)
+ [Vérifiez le statut de votre ensemble de modifications](#check-data-set-change-status)
### Définir des autorisations IAM
Avant de commencer, vous devez disposer d'autorisations Gestion des identités et des accès AWS (IAM) pour utiliser l'API AWS Marketplace Catalog. Ces autorisations s'ajoutent aux autorisations dont vous avez besoin pour les utiliser AWS Data Exchange.
1. Accédez à la console IAM dans votre navigateur et connectez-vous à l'aide d'un système Compte AWS capable de gérer les autorisations IAM.
1. Dans le volet de navigation de gauche, sélectionnez **Policies**.
1. Choisissez **Create Policy** (Créer une politique).
1. Choisissez l'onglet **JSON** et fournissez les autorisations suivantes. Cela fournit un accès complet à l'API du AWS Marketplace catalogue. Vous pouvez restreindre l'accès en fonction de votre cas d'utilisation.
------
#### [ 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. Choisissez **Suivant : Vérification**.
1. Donnez un nom à la politique (par exemple,**CatalogAPIFullAccess**), puis choisissez **Create Policy**.
1. À l'aide de la console IAM, choisissez les utilisateurs, les groupes ou les rôles auxquels vous souhaitez associer la politique.
### Accédez à l'API du AWS Marketplace catalogue
Pour accéder à l'API AWS Marketplace Catalog, utilisez le point de terminaison client HTTP suivant.
```
catalog.marketplace.us-east-1.amazonaws.com
```
### Obtenez l'identifiant de votre produit depuis la AWS Data Exchange console
Avant de pouvoir utiliser l'API AWS Marketplace Catalog pour publier de nouveaux ensembles de données, obtenez votre identifiant de produit depuis la AWS Data Exchange console. Accédez au tableau de **bord du produit**, puis copiez l'identifiant du produit pour lequel vous souhaitez publier des ensembles de données. Vous pouvez également utiliser l'[API du AWS Marketplace catalogue](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html) pour trouver l'identifiant de votre produit, en utilisant l'`ListEntities`action avec le type d'**DataProduct@1.0**entité.
### Lancer une demande de modification
**Pour lancer une demande de modification afin d'ajouter un ensemble de données dans votre produit de test**
1. Copiez l'ID d'entité que vous obtenez en suivant les instructions de[Obtenez l'identifiant de votre produit depuis la AWS Data Exchange console](#get-data-set-exchange-product-id).
1. Faites une `StartChangeSet` demande avec un type de `AddDataSets` modification.
**Note**
Pour plus d'informations sur l'utilisation des ensembles de modifications dans l'API du AWS Marketplace catalogue, consultez la section [Utilisation des ensembles de modifications](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets). Pour plus d'informations sur l'utilisation de l'identifiant des entités, consultez la section [Identifiant](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#identifier).
**Exemple de demande**
```
https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet
```
**Exemple de corps de demande**
```
{
"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\" } ] }"
}
]
}
```
**Exemple de réponse**
```
{
"ChangeSetId": "cs-bnEXAMPLE4mkz9oh",
"ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:account-id:AWSMarketplace/ChangeSet/cs-bnEXAMPLE4mkz9oh"
}
```
### Vérifiez le statut de votre ensemble de modifications
Après avoir utilisé l'opération `StartChangeSet` API pour démarrer la demande de modification, vous pouvez utiliser l'`DescribeChangeSet`opération pour vérifier son statut. Indiquez l'ID du groupe de modifications renvoyé dans la réponse de `StartChangeSet` l'API.
**Exemple de demande**
```
https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh
```
**Exemple de corps de demande**
```
{
"changeSetId":"cs-bnEXAMPLE4mkz9oh"
}
```
**Exemple de réponse**
```
{
"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 exceptions
Les exceptions suivantes peuvent se produire lorsque vous utilisez l'API AWS Marketplace Catalog avec AWS Data Exchange :
**JEU DE DONNÉES NON TROUVÉ**
Cela se produit lorsque l'ensemble de données demandé n'a pas été trouvé. Pour résoudre ce problème, assurez-vous qu'il n'y a pas de faute de frappe dans l'ARN du jeu de données et que vous êtes le Compte AWS propriétaire de l'ensemble de données, puis réessayez.
**ENTRÉE\$1VALIDE**
La demande n'a pas pu être traitée en raison d'une saisie non valide. Pour résoudre ce problème, assurez-vous qu'il n'y a pas de faute de frappe dans la demande et que le produit ne dépasse pas le nombre maximum d'ensembles de données autorisés.
**ENSEMBLE DE DONNÉES DÉJÀ PUBLIÉ**
Cela se produit lorsque l'ensemble de données a déjà été ajouté au produit.
**JEU DE DONNÉES DUPLICATE\$1FOURNI**
Cela se produit lorsque le même ensemble de données est fourni plusieurs fois dans la demande.