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.

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.

1. Accédez à la console IAM depuis votre navigateur et connectez-vous à l'aide d'unCompte AWS outil capable de gérer les autorisations IAM.

2. Dans le panneau de navigation de gauche, choisissez Policies (Policies).

3. Choisissez Create Policy (Créer une politique).

4. 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": "*"
       }
     ]
   }

5. Choisissez Next: Review (Suivant : Vérification).

6. Indiquez un nom pour la politique (par exemple,CatalogAPIFullAccess), puis choisissez Créer une politique.

7. À 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'ListEntitiesaction associée au type d'DataProduct@1.0entité.

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'identifiant d'entité que vous obtenez en suivant les instructions fournies dansObtenez l'identifiant de votre produit depuis laAWS Data Exchange console.

2. Faites uneStartChangeSet 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'DescribeChangeSetopé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.