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.
AddDataSets
Note
Les ensembles de données ajoutés via l'API Catalog modifient le type d'ensembleAddDataSets
par défaut en fonction de la méthode de publication du produit.
Pour ajouter des ensembles de données à votreAWS Data Exchange produit, commencez par modifier le type d'ensembleAddDataSets
. Pour ce faire, vous pouvez utiliser l'opérationStartChangeSet
API et spécifier le type de modification, l'identifiant du produit, le type de produit et les détails, y compris l'ensemble 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 deAWS Data Exchange données à un produit publié. Le didacticiel comporte les étapes de haut niveau suivantes.
Rubriques
Configuration des autorisations IAM
Avant de commencer, vous devez disposer d'autorisationsAWS Identity and Access Management (IAM) pour utiliser l'APIAWS Marketplace Catalog. Ces autorisations s'ajoutent aux autorisations dont vous avez besoin pour utiliserAWS Data Exchange.
-
Accédez à la console IAM depuis votre navigateur et connectez-vous à l'aide d'unCompte AWS outil capable de gérer les autorisations IAM.
-
Dans le panneau de navigation de gauche, choisissez Policies (Policies).
-
Choisissez Create Policy (Créer une politique).
-
Choisissez l'onglet JSON et fournissez les autorisations suivantes. Cela fournit un accès complet à l'API duAWS Marketplace catalogue. Vous pouvez restreindre l'accès en fonction de votre cas d'utilisation.
{ "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": "*" } ] }
-
Choisissez Next: Review (Suivant : Vérification).
-
Indiquez un nom pour la politique (par exemple,
CatalogAPIFullAccess
), puis choisissez Créer une politique. -
À l'aide de la console IAM, choisissez les utilisateurs, groupes ou rôles auxquels vous souhaitez associer la politique.
Accédez à l'API duAWS Marketplace catalogue
Pour accéder à l'API duAWS Marketplace catalogue, utilisez le point de terminaison client HTTP suivant.
catalog.marketplace.us-east-1.amazonaws.com
Obtenez l'identifiant de votre produit depuis laAWS Data Exchange console
Avant de pouvoir utiliser l'APIAWS Marketplace Catalog pour publier de nouveaux ensembles de données, obtenez l'identifiant de votre produit depuis laAWS 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 duAWS Marketplace catalogue pour trouver l'identifiant de votre produit, en utilisant l'ListEntities
action associée au 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
-
Copiez l'identifiant d'entité que vous obtenez en suivant les instructions fournies dansObtenez l'identifiant de votre produit depuis laAWS Data Exchange console.
-
Faites une
StartChangeSet
demande avec un type deAddDataSets
modification.
Note
Pour plus d'informations sur l'utilisation des ensembles de modifications dans l'APIAWS Marketplace Catalog, consultez la section Utilisation des ensembles de modifications. Pour de plus amples informations sur l'utilisation de l'identifiant des entités, veuillez consulter Identificateur.
Exemple de demande
https://catalog.marketplace.us-east-1.amazonaws.com/StartChangeSet
Exemple de corps de la 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érationStartChangeSet
API pour démarrer la demande de modification, vous pouvez utiliser l'DescribeChangeSet
opération pour vérifier son statut. Fournissez l'ID de l'ensemble de modifications renvoyé dans la réponse deStartChangeSet
l'API.
Exemple de demande
https://catalog.marketplace.us-east-1.amazonaws.com/DescribeChangeSet?catalog=AWSMarketplace&changeSetId=cs-bnEXAMPLE4mkz9oh
Exemple de corps de la 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'APIAWS Marketplace Catalog avecAWS Data Exchange :
ENSEMBLE 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 de l'ensemble de données et que vousCompte AWS êtes propriétaire de l'ensemble de données, puis réessayez.
ENTRÉE NON VALIDE
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 DUPLIQUÉ FOURNI
Cela se produit lorsque le même ensemble de données est fourni plusieurs fois dans la demande.