Mettre à jour les produits - AWS Data Exchange Guide de l'utilisateur
Mettre à jour les détails du produit et de l'offreMettre à jour un dictionnaire de donnéesMise à jour d'un échantillonMise à jour de métadonnées personnaliséesPublication d'une nouvelle révision d'ensemble de donnéesDépublier un produitSupprimer une révisionRévocation de révisions

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.

Mettre à jour les produits

Les sections suivantes décrivent comment mettre à jour vosAWS Data Exchange produits. Les instructions partent du principe que vous êtes un fournisseur familier avecDonnées en AWS Data Exchange. Après avoir publié un produit, vous pouvez modifier les détails du produit et son offre publique. Vous pouvez également mettre à jour les ensembles de données sous-jacents en publiant de nouvelles révisions pour les abonnés. Pour plus d'informations, consultez Révisions.

Mettre à jour les détails du produit et de l'offre

Après avoir publié un produit, vous pouvez utiliser laAWS Data Exchange console pour modifier les détails du produit. Vous pouvez également modifier les offres publiques ou personnalisées du produit et modifier les conditions de l'offre. Lorsque vous mettez à jour les conditions de l'offre de votre produit, les abonnés ayant un abonnement actif conservent les conditions de l'offre existantes tant que leur abonnement est actif. Les abonnés qui ont choisi le renouvellement automatique utilisent les nouvelles conditions de l'offre.

Gardez les points suivants à l'esprit lorsque vous mettez à jour vos produits :

  • Vous ne pouvez pas supprimer ou modifier la durée d'un abonnement dans vos offres. Cela garantit que les abonnés existants conservent la possibilité de renouveler leur abonnement. Si vous ne souhaitez plus proposer une durée d'abonnement spécifique, vous pouvez annuler la publication de votre produit existant, puis publier un nouveau produit. Pour plus d'informations, consultez Dépublier un produit.

  • Vous ne pouvez pas supprimer des ensembles de données d'un produit après sa publication, quel que soit le nombre d'abonnés abonnés à votre produit.

  • Si vous mettez à jour les coûts mesurés pour un produit contenant des API :

    • Une baisse de prix mesurée apparaît immédiatement sur la page détaillée du produit pour les nouveaux abonnés.

      Avertissement

      Si vous annulez une baisse de prix pour les coûts mesurés, vous augmentez le prix des coûts mesurés. Consultez le point suivant pour plus d'informations sur les augmentations de prix des coûts mesurés.

    • Une augmentation de prix mesurée entrera en vigueur le premier jour du mois, 90 jours après la soumission de l'augmentation de prix pour les abonnés existants OU lors du renouvellement (selon la première éventualité). L'e-mail est envoyé aux abonnés existants lorsque le changement de prix est soumis. L'augmentation de prix apparaît immédiatement sur la page détaillée du produit pour les nouveaux abonnés.

      Exemple

      Vous soumettez une augmentation de prix mesurée le 10 mai. Les abonnés existants reçoivent un e-mail concernant le changement de prix. L'augmentation de prix entre en vigueur le 1er septembre.

      Avertissement

      Vous ne pouvez pas annuler une augmentation de prix (car cette action fait baisser le prix) avant que l'augmentation de prix n'entre en vigueur pour les abonnés existants.

Pour mettre à jour les détails d'un produit, d'un ensemble de données ou d'une offre

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, sous Publier les données, choisissez Produits sous Produits.

  3. Dans Produits, choisissez le produit que vous souhaitez mettre à jour. Assurez-vous que son statut est publié.

  4. À partir des détails du produit :

    • Si vous modifiez une offre publique, choisissez l'onglet Offre publique, choisissez Modifier, puis suivez les instructions pour modifier le produit.

    • Si vous modifiez une offre privée, choisissez l'onglet Offres personnalisées, cliquez sur le bouton d'option à côté de l'offre privée que vous souhaitez modifier, choisissez Modifier, puis suivez les instructions pour modifier le produit.

    1. Pour les produits contenant des API avec des coûts mesurés, dans Coûts mesurés — facultatif, sélectionnez le bouton d'option à côté du type de coûts mesurés que vous souhaitez modifier, puis choisissez Modifier.

    2. Dans la boîte de dialogue Modifier le coût mesuré, mettez à jour le prix/unité ou la description.

    3. Sélectionnez Update (Mettre à jour).

      Les coûts mesurés mis à jour apparaissent sous Coûts mesurés — facultatif.

  5. Dans Ensembles de données, sous Informations sensibles, choisissez Modifier, puis suivez les instructions pour modifier les informations.

  6. Dans Évaluation des données, mettez à jour le dictionnaire de données ou l'échantillon en sélectionnant le bouton d'option à côté du dictionnaire de données ou du nom de l'échantillon, puis en choisissant Actions. Pour en savoir plus, consultez les sections Mettre à jour un dictionnaire de données et Mise à jour d'un échantillon.

  7. Configurez votre offre en fonction du type d'offre :

    • Si votre produit est une offre publique, dans Offre publique, choisissez Modifier, puis suivez les instructions pour modifier l'offre publique.

    • Si votre produit est une offre personnalisée, dans Offres personnalisées, choisissez Modifier, puis suivez les instructions pour modifier l'offre personnalisée.

    • Si votre produit est une offre privée, dans Offres privées, choisissez Modifier, puis suivez les instructions pour modifier l'offre privée.

  8. Sélectionnez Update (Mettre à jour).

Mettre à jour un dictionnaire de données

Vous pouvez mettre à jour un dictionnaire de données en supprimant d'abord le dictionnaire de données existant, puis en chargeant un nouveau.

Pour mettre à jour un dictionnaire de données

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, sous Publier les données, choisissez Produits sous Produits.

  3. Dans Produits, choisissez le produit que vous souhaitez mettre à jour et confirmez que son statut est publié.

  4. Choisissez l'onglet Évaluation des données.

  5. Sous Dictionnaire de données et échantillons, développez l'ensemble de données en cliquant sur l'icône plus, puis choisissez le dictionnaire de données en sélectionnant le bouton d'option à côté du nom du dictionnaire de données.

    1. Choisissez Actions, puis Supprimer le dictionnaire de données.

      Le dictionnaire de données est supprimé.

    2. Sélectionnez le bouton d'option à côté de l'ensemble de données, choisissez Actions, puis Charger le dictionnaire de données.

    3. Choisissez Ajouter un fichier.

    4. Sélectionnez un nouveau dictionnaire de données, puis cliquez sur Ouvrir.

    5. Sélectionnez Charger.

  6. (Facultatif) Choisissez le dictionnaire de données en sélectionnant le bouton d'option à côté du nom du dictionnaire de données, choisissez Actions, puis choisissez Télécharger le dictionnaire de données (CSV) pour télécharger le dictionnaire de données sur votre ordinateur.

Mise à jour d'un échantillon

Pour mettre à jour un échantillon

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, sous Publier les données, choisissez Produits sous Produits.

  3. Dans Produits, choisissez le produit que vous souhaitez mettre à jour et confirmez que son statut est publié.

  4. Choisissez l'onglet Évaluation des données.

  5. Sous Dictionnaire de données et exemples, sélectionnez le bouton d'option à côté d'un ensemble de données.

  6. Choisissez Actions, puis Ajouter des échantillons.

    1. Choisissez Charger des échantillons.

    2. Sélectionnez un nouvel échantillon sur votre ordinateur, puis choisissez Ouvrir.

    3. Entrez une description facultative, puis choisissez Ajouter.

  7. (Facultatif) Sélectionnez le bouton d'option à côté du nom de l'exemple, choisissez Actions, puis choisissez l'une des actions suivantes :

    • Téléchargez l'échantillon sélectionné

    • Exemple d'aperçu (CSV uniquement)

    • Supprimer l'échantillon sélectionné

Mise à jour de métadonnées personnalisées

Après avoir publié un produit, vous pouvez utiliser laAWS Data Exchange console pour modifier les métadonnées personnalisées du produit.

Pour mettre à jour les métadonnées personnalisées

  1. Ouvrez votre navigateur Web et connectez-vous à laAWS Data Exchange console.

  2. Dans le volet de navigation de gauche, sous Publier les données, choisissez Produits sous Produits.

  3. Dans Produits, choisissez le produit que vous souhaitez mettre à jour. Assurez-vous que son statut est publié.

  4. (Facultatif) Dans Abonnements, choisissez Afficher les métadonnées personnalisées, puis Afficher les métadonnées, puis cliquez sur Fermer.

  5. Dans Abonnements, choisissez Modifier les métadonnées personnalisées, puis suivez les instructions pour modifier les métadonnées ou ajouter de nouvelles métadonnées.

  6. Choisissez Save (Enregistrer).

Publication d'une nouvelle révision d'ensemble de données

AWS Data Exchangeprend en charge les produits mis à jour dynamiquement. Les abonnés s'abonnent au produit pendant une certaine durée et accèdent à tous les ensembles de données publiés tant que leur abonnement est actif. Par exemple, un fournisseur peut souhaiter proposer un produit contenant les cours de clôture quotidiens des actions américaines, qui seraient mis à jour quotidiennement avec les cours de clôture du jour. Vous pouvez créer et finaliser de nouvelles révisions qui seront disponibles dans les ensembles de données de votre produit, ou ajouter de nouveaux ensembles de données à votre produit.

Votre produit inclut certaines ou toutes les révisions historiques et future dans le cadre d'un abonnement. Pour plus d'informations, consultez Règles d'accès aux révisions.

Dans la procédure suivante, vous créez et finalisez une nouvelle révision pour un ensemble de données qui a déjà été publié à l'aide de laAWS Data Exchange console. La révision de l'ensemble de données est ensuite automatiquement publiée sur tous les produits auxquels appartient l'ensemble de données. Pour plus d'informations, consultez Révisions.

Important

Un fournisseur peut révoquer l'accès des abonnés à une révision, puis supprimer les actifs de la révision à l'aide de la console ou de l'AWS Data ExchangeAPI. Pour plus d'informations, consultez Révocation de révisions.

Pour publier une nouvelle révision d'un ensemble de données pour un produit

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, sous Publier les données, choisissez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez l'ensemble de données que vous souhaitez mettre à jour.

  4. Accédez à l'onglet Produits pour vous assurer que l'ensemble de données est associé à un produit publié.

  5. Dans l'onglet Révisions, choisissez Créer une révision pour ouvrir la page Créer une révision.

    1. (Facultatif) Dans Paramètres de révision, fournissez un commentaire facultatif pour votre révision qui décrit l'objectif de la révision.

    2. (Facultatif) Sous Ajouter des balises — facultatif, ajoutez des balises associées à la ressource.

    3. Choisissez Créer une révision.

      Votre nouvelle révision est créée.

  6. Dans la section Tâches, choisissez Importer depuis Amazon S3 ou Charger (à télécharger depuis votre ordinateur), selon que les actifs que vous souhaitez inclure sont stockés dans un compartiment Amazon S3 que vous possédez ou sur votre ordinateur local.

    1. Suivez les instructions, en fonction de votre sélection. Une tâche est lancée pour importer votre actif dans votre ensemble de données.

    2. Une fois la tâche terminée, le champ État de la section Tâches est mis à jour sur Terminé.

  7. Sous Vue d'ensemble des révisions, passez en revue votre révision et ses éléments, puis choisissez Finaliser.

La révision a été publiée sur le produit et est désormais disponible pour les abonnés.

Approche suggérée pour les données historiques publiées avec le type de livraison Fichiers

Certains produits dynamiques contiennent un contenu historique auquel les abonnés peuvent accéder. Par exemple, si votre produit inclut un historique de 30 ans du cours de clôture quotidien des actions américaines, les abonnés auront accès à ces données en plus des mises à jour dynamiques quotidiennes.

Pour ces types de produits qui contiennent un historique de données, la meilleure pratique consiste à publier toutes les données historiques dans une seule révision de l'ensemble de données. Vous pouvez utiliser le commentaire facultatif relatif à la révision pour indiquer qu'il s'agit d'un téléchargement unique de tous les historiques de données à partir d'une date spécifique.

Si la révision historique unique contient une série chronologique de plusieurs objets, vous pouvez envisager d'étiqueter les noms de vos objets pour décrire la périodicité des données sous-jacente. Par exemple, si votre révision unique de l'historique contient 200 fichiers contenant chacun une semaine de données historiques, vous pouvez nommer chaque fichier avec une date correspondant à la semaine de début de l'historique des données.

Approches suggérées pour les mises à jour

Vous pouvez mettre à jour vos ensembles de données de différentes façons de façon dynamique. Voici trois exemples d'approches, qui créent toutes une nouvelle révision pour chaque mise à jour, mais dont le contenu est différent.

  • Utilisez une nouvelle révision pour chaque mise à jour qui contient uniquement les éléments qui ont changé depuis la dernière révision. La taille de votre révision serait plus petite car seuls les éléments modifiés sont mis à jour. Cette approche convient aux ensembles de données pour lesquels les mises à jour ne concernent qu'un petit sous-ensemble des données et les abonnés se concentrent uniquement sur les éléments qui ont changé.

  • Utilisez une nouvelle révision pour chaque mise à jour contenant les données mises à jour : la nouvelle révision contient un fichier entièrement mis à jour. Tous les éléments sont inclus dans la nouvelle révision, y compris ceux qui n'ont pas changé depuis la dernière révision. Cette approche est pratique pour les abonnés qui souhaitent conserver un seul up-to-date fichier pour vos données. Les abonnés exportent le ou les actifs de la dernière révision vers la même destination et remplacent le ou les fichiers précédents.

  • Utilisez une nouvelle révision pour chaque mise à jour qui contient l'historique complet et les données mises à jour : la nouvelle révision contient l'historique complet des données, y compris l'état le plus récent des données et l'historique des révisions précédentes. Cette approche nécessite davantage de stockage. Il convient aux ensembles de données pour lesquels les abonnés souhaitent avoir une vue complète la plus récente de l'historique des données, y compris les éventuelles corrections ou ajustements antérieurs. Dans cette approche, chaque révision est autosuffisante et fournit une vue complète de l'historique de l'ensemble de données sans dépendre des révisions précédentes.

Dépublier un produit

Une fois votre produit publié, tout le monde peut le trouver et s'y abonner, en fonction des paramètres de visibilité du produit. Vous pouvez annuler la publication d'un produit si vous souhaitez obtenir l'un des résultats suivants :

  • Supprimez un produit que vous avez créé pour l'Publier un nouveau produitexercice.

  • Nettoyer vos ressources.

  • Supprimer un produit des produits mis en vente surAWS Data Exchange.

  • Empêchez les abonnés de renouveler automatiquement votre produit.

Gardez les points suivants à l'esprit lorsque vous annulez la publication d'un produit :

  • Vous pouvez annuler la publication d'un produit quand vous le souhaitez.

  • Si vous annulez la publication d'un produit, il n'est plus visible dans leAWS Data Exchange catalogue ou surAWS Marketplace.

  • Les abonnés ayant un abonnement actif conservent l'accès au produit de données jusqu'à l'expiration de la durée de leur abonnement.

  • Les abonnements actifs qui expirent une fois que vous avez dépublié votre produit ne sont pas renouvelés, même si l'abonné a activé le renouvellement automatique.

  • Les abonnés existants peuvent toujours consulter les détails du produit jusqu'à l'expiration de leur abonnement.

Pour annuler la publication d'un produit

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, sous Publier les données, choisissez Produits sous Produits.

  3. Dans Produits, choisissez le produit que vous souhaitez supprimer. Assurez-vous que son statut est publié.

  4. Dans Vue d'ensemble du produit, choisissez Annuler la publication, puis suivez les instructions pour annuler la publication du produit.

    Important

    Cette action ne peut pas être annulée.

Une fois ces étapes terminées, le statut de votre produit est Non publié. Un produit non publié ne peut pas être publié à nouveau, mais vous pouvez créer un nouveau produit (avec un nouvel identifiant de produit) qui possède les mêmes ensembles de données, les mêmes détails sur le produit et les mêmes détails d'offre.

Supprimer une révision

Un fournisseur peut révoquer l'accès des abonnés à une révision, puis supprimer les actifs de la révision à l'aide de la console ou de l'AWS Data ExchangeAPI. Pour plus d'informations, consultez Révocation de révisions.

Vous pouvez modifier ou supprimer une révision une fois qu'elle est finalisée, mais avant de l'ajouter à un produit. Pour plus d'informations, consultez les rubriques suivantes :

Révocation de révisions

En tant que fournisseur, vous pouvez révoquer à tout moment l'accès d'un abonné à une révision spécifique. Cette action est généralement effectuée par les fournisseurs pour des raisons de conformité. La révocation d'une révision ne supprime pas les actifs sous-jacents. Une fois que vous avez révoqué la révision, tous les abonnés reçoivent une notification Amazon EventBridge (anciennement connue sous le nom d' CloudWatch Events) indiquant que la révision a été révoquée. Les abonnés peuvent ensuite consulter la raison de la révocation de la révision sur laAWS Data Exchange console. Les abonnés ne peuvent pas exporter ou interroger les données d'une révision révoquée.

Pour pouvoir révoquer les révisions, les fournisseurs qui gèrent leurs propres politiques IAM doivent ajouterdataexchange:RevokeRevision une nouvelle action. Les fournisseurs qui utilisent les politiquesAWS Data Exchange gérées n'ont pas besoin d'apporter de modifications.

Après la révocation d'une révision, vous pouvez supprimer les actifs de la révision à l'aide de la console ou de l'opérationAWS Data ExchangeDeleteAsset API.

Révocation d'une révision (AWS CLI)

Pour révoquer une révision (AWS CLI)

  1. Utilisez larevoke-revision commande pour révoquer une révision. 

    $ aws dataexchange revoke-revision \
--data-set-id $DATA_SET_ID \
--revision-id $REVISION_ID \
--comment 'Revoking Revision Example'

{
"Id": "ab7859881EXAMPLEdd3e8a4b88fc6a8d",
"Arn": "arn:aws:dataexchange:us-east-1:427362365172:data-sets/$DATA_SET_ID/revisions/$REVISION_ID",
"Comment": "Revoking Revision Example",
"CreatedAt": "2022-03-08T18:54:20.746Z",
"UpdatedAt": "2022-03-09T20:28:53.105Z",
"DataSetId": "24d30f8446a878237c35d011e7b22d0b",
"Finalized": true,
"Revoked": true,
"RevokedAt": "2022-03-09T20:28:53.105Z",
"RevocationComment": "revoking revision example"
}

  2. Après la révocation d'une révision, vous pouvez supprimer les actifs de la révision à l'aide de l'opérationAWS Data ExchangeDeleteAsset API.

Révocation d'une révision unique en tant que fournisseur (console)

Pour révoquer une révision en tant que fournisseur (console)

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, pour Publier des données, choisissez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez l'ensemble de données dont vous souhaitez annuler la révision.

  4. Dans l'onglet Révisions, sous Révisions, choisissez la révision.

  5. Sur la page de révision, sous Vue d'ensemble des révisions, pour Actions, choisissez Révoquer.

  6. Dans la boîte de dialogue Révoquer la révision, entrez une brève description de la raison pour laquelle vous annulez la révision. Les abonnés verront cette description.

  7. Choisissez Révoquer.

    Le statut de la révision est défini sur Révoqué.

    Avertissement

    Cela annule la révision et tous ses actifs. Les abonnés peuvent consulter le motif de la révocation mais ne peuvent pas accéder aux actifs ni les exporter. Cette action ne peut pas être annulée.

  8. Après la révocation d'une révision, vous pouvez supprimer les actifs de la révision en accédant à la page de révision, en sélectionnant les actifs que vous souhaitez supprimer dans le tableau des actifs importés, puis en choisissant Supprimer.

Pour modifier le motif d'une révision révoquée, reportez-vous à la sectionModifier un motif de révocation en tant que fournisseur (console).

Révocation de plusieurs révisions en tant que fournisseur (console)

Pour révoquer plusieurs révisions en tant que fournisseur (console)

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, pour Publier des données, choisissez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez l'ensemble de données contenant les révisions que vous souhaitez révoquer.

  4. Dans l'onglet Révisions, choisissez jusqu'à 10 révisions.

  5. Choisissez Révoquer.

  6. Dans la boîte de dialogue Révoquer {x} révisions, entrez une brève description de la raison pour laquelle vous annulez les révisions. Les abonnés verront cette description. Ensuite, choisissez Révoquer.

    Le statut des révisions est défini sur Révoqué.

    Avertissement

    Cela annule les révisions et tous les actifs. Les abonnés peuvent consulter le motif de la révocation mais ne peuvent pas accéder aux actifs ni les exporter. Cette action ne peut pas être annulée.

  7. Après la révocation d'une révision, vous pouvez supprimer les actifs de la révision en accédant à la page de révision, en sélectionnant les actifs que vous souhaitez supprimer dans le tableau des actifs importés, puis en choisissant Supprimer.

Pour modifier le motif d'une révision révoquée, reportez-vous à la sectionModifier un motif de révocation en tant que fournisseur (console).

Modifier un motif de révocation en tant que fournisseur (console)

En tant que fournisseur, vous pouvez modifier le motif de la révocation une fois que la révision a été révoquée.

Pour modifier une révision de révocation en tant que fournisseur (console)

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, pour Publier des produits de données, choisissez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez l'ensemble de données dont la révision a été révoquée.

  4. Dans l'onglet Révisions, choisissez la révision révoquée.

  5. Sur la page de révision, choisissez Modifier le motif de la révocation.

  6. Dans la boîte de dialogue Modifier la révision de révocation, entrez une brève description de la raison pour laquelle vous révoquez la révision.

  7. Choisissez Save (Enregistrer).

    Le statut de la révision est défini sur Révoqué.

    Le motif de révocation mis à jour est affiché sur la page de révision.

Afficher les révisions révoquées en tant qu'abonné (console)

Pour consulter une révision révoquée en tant qu'abonné (console)

  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchangeconsole.

  2. Dans le volet de navigation de gauche, sous Mes abonnements, choisissez Données autorisées.

  3. Sous Produits, choisissez un produit, puis développez l'ensemble de données sous le produit pour afficher la liste des révisions.

  4. Sur la page de l'ensemble de données, sous l'onglet Révisions, consultez le statut de la révision (publiée ou révoquée).

  5. Choisissez une révision.

  6. Consultez le motif de la révision en haut de la page détaillée de la révision.