Offres d'emploi dans AWS Data Exchange - AWS Data Exchange Guide de l'utilisateur

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.

Offres d'emploi dans AWS Data Exchange

AWS Data Exchange les jobs sont des opérations d'importation ou d'exportation asynchrones.

En tant que fournisseur, vous pouvez créer et gérer les ensembles de données que vous souhaitez publier sur un produit. Vous pouvez télécharger (exporter) ou copier vos ressources ou révisions sur Amazon Simple Storage Service (Amazon S3) ou sur une URL signée. En outre, les fournisseurs peuvent importer des actifs depuis une API Amazon API Gateway ou importer des actifs depuis un ensemble de données Amazon Redshift.

En tant qu'abonné, vous pouvez consulter et accéder aux ensembles de données auxquels vous avez droit par le biais d'un abonnement. Vous pouvez utiliser les opérations d'API pour télécharger (exporter) ou copier vos ensembles de données autorisés vers Amazon S3 afin de les utiliser avec divers services d' AWS analyse et d'apprentissage automatique.

Pour créer ou copier des actifs ou copier des révisions via des tâches, vous pouvez utiliser AWS Management Console, AWS Command Line Interface (AWS CLI), votre propre application REST ou l'un des AWS SDK.

Les jobs sont supprimés 90 jours après leur création.

Propriétés de la tâche

Les jobs possèdent les propriétés suivantes :

  • ID du travail : identifiant généré lors de la création du travail qui identifie le travail de manière unique.

  • Type de tâche : les types de tâches suivants sont pris en charge :

    • Importer des données depuis Amazon S3

    • Autorisation d'importation et de AWS Lake Formation données (aperçu)

    • Importer depuis une URL signée

    • Importer depuis l'API Amazon API Gateway

    • Importation depuis un partage de AWS Data Exchange données pour Amazon Redshift

    • Importer un accès aux données Amazon S3

    • Exporter vers Amazon S3

    • Exporter vers une URL signée

  • Amazon Resource Name (ARN) : identifiant unique pour les AWS ressources.

  • État de la tâche : les états de la tâche sont WAITING IN_PROGRESSCOMPLETED,CANCELLED,ERROR, ouTIMED_OUT. Lorsqu'une tâche est créée, elle est en l'WAITINGétat jusqu'à ce qu'elle soit démarrée.

  • Détails de la tâche : détails de l'opération à exécuter par la tâche, tels que les détails de la destination d'exportation ou les détails de la source d'importation.

Exemple ressource d'emploi
{ "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/6cEXAMPLE818f7c7a23b3d0EXAMPLE1c", "Id": "6cEXAMPLE818f7c7a23b3d0EXAMPLE1c", "State": "COMPLETED", "Type": "IMPORT_ASSETS_FROM_S3", "CreatedAt": "2019-10-11T14:12:24.640Z", "UpdatedAt": "2019-10-11T14:13:00.804Z", "Details": { "ImportAssetsFromS3": { "AssetSources": [ { "Bucket": "DOC-EXAMPLE-BUCKET", "Key": "MyKey" } ], "DataSetId": "14EXAMPLE4460dc9b005a0dEXAMPLE2f", "RevisionId": "e5EXAMPLE224f879066f999EXAMPLE42" } } }

Régions AWS et emplois

Si vous importez ou exportez un actif vers ou depuis un compartiment Amazon S3 situé dans une Région AWS région différente de celle de l'ensemble de données, les frais de transfert de données vous Compte AWS sont facturés, conformément aux politiques de tarification des transferts de données d'Amazon S3.

Si vous exportez des ressources vers une URL signée, les frais de transfert de données d'Amazon S3 vers Internet vous sont facturés conformément aux politiques tarifaires d'Amazon S3. Compte AWS

Lorsque votre abonnement à un ensemble de données AWS Data Exchange for Files prend fin, vous conservez l'accès à tous les fichiers que vous avez déjà exportés. Consultez votre contrat d'abonnement aux données pour vérifier s'il exige que vous supprimiez les données exportées lorsque vous mettez fin à un abonnement.

Importation d'actifs

Vous pouvez importer des actifs dans une révision de différentes manières :

Importation de ressources depuis un compartiment S3

Lorsque vous importez des actifs depuis Amazon S3 vers AWS Data Exchange, les autorisations AWS Identity and Access Management (IAM) que vous utilisez doivent inclure la possibilité d'écrire dans les compartiments S3 du AWS Data Exchange service et de lire à partir du compartiment S3 dans lequel vos actifs sont stockés. Vous pouvez effectuer une importation depuis n'importe quel compartiment S3 auquel vous êtes autorisé à accéder, quel que soit son propriétaire. Pour plus d’informations, consultez Autorisations Amazon S3.

Vous pouvez importer jusqu'à 100 actifs en une seule tâche.

Importation d'actifs depuis un compartiment S3 (AWS SDK)

Pour importer des actifs depuis un compartiment Amazon S3 (AWS SDK)
  1. Créez une CreateJob demande de typeIMPORT_ASSETS_FROM_S3.

  2. Incluez les éléments suivants dans la demande :

    • AssetSources

      • Bucket

      • Key

    • DataSetID

    • RevisionID

  3. Commencez la CreateJob demande par une StartJob opération qui nécessite le JobId renvoi à l'étape 1.

  4. (Facultatif) Mettez à jour la propriété du nom des actifs après leur création.

Importation de ressources depuis un compartiment S3 (console)

Pour importer un actif depuis un compartiment S3 (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le jeu de données dont vous souhaitez mettre à jour la révision.

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

    1. Pour les paramètres de révision, fournissez un commentaire facultatif pour votre révision qui décrit l'objectif de la révision.

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

    3. Choisissez Créer.

      Votre nouvelle révision est créée.

  5. Pour la section Jobs, choisissez Importer depuis Amazon S3.

  6. Suivez les instructions de la fenêtre Importer depuis Amazon S3, puis choisissez Importer des actifs.

    Une tâche est lancée pour importer votre actif dans votre ensemble de données. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Importation de ressources à partir d'une URL signée

Vous pouvez utiliser des URL signées pour importer des actifs qui ne sont pas stockés dans Amazon S3.

Importation de ressources à partir d'une URL signée (AWS SDK)

Pour importer des ressources à partir d'une URL signée (AWS SDK)
  1. Créez une CreateJob demande de typeIMPORT_ASSET_FROM_SIGNED_URL.

  2. Incluez les éléments suivants dans la demande :

    • AssetName

    • DataSetID

    • Md5Hash

    • RevisionID

  3. Commencez la CreateJob demande par une StartJob opération qui nécessite le JobId renvoi à l'étape 1.

  4. (Facultatif) Mettez à jour la propriété du nom des actifs après leur création.

  5. Les détails de la réponse incluent SignedUrl ceux que vous pouvez utiliser pour importer votre fichier.

Note

L'URL signée expire une minute après sa création.

Importation de ressources à partir d'une URL signée (console)

Pour importer un actif à partir d'une URL signée (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le jeu de données contenant la ressource que vous souhaitez mettre à jour.

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

    1. Pour les paramètres de révision, fournissez un commentaire facultatif pour votre révision qui décrit l'objectif de la révision.

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

    3. Choisissez Créer.

      Votre nouvelle révision est créée.

  5. Pour la section Tâches, choisissez Upload.

  6. Suivez les instructions de la fenêtre de téléchargement, puis choisissez Ouvrir.

    Une tâche est lancée pour importer votre actif dans votre ensemble de données. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Importation d'actifs depuis une API Amazon API Gateway

AWS Data Exchange les abonnés peuvent utiliser leurs informations d'identification IAM et leurs AWS SDK pour appeler les API des fournisseurs de données. AWS Data Exchange gère l'accès aux API en gérant l'authentification et les droits d'abonnement.

Importation de ressources d'API depuis une API Amazon API Gateway (AWS SDK)

Note

Actuellement, l'SendApiAssetopération n'est pas prise en charge pour les SDK suivants :

  • AWS SDK for .NET

  • AWS SDK for C++

  • AWS SDK for Java 2.x

Pour importer des actifs depuis une API Amazon API Gateway (AWS SDK)
  1. Créez une CreateJob demande de typeIMPORT_ASSET_FROM_API_GATEWAY_API.

  2. Incluez les éléments suivants dans la demande :

    • ApiID

    • DataSetID

    • ProtocolType

    • RevisionID

    • Stage

  3. Commencez la CreateJob demande par une StartJob opération qui nécessite le JobId renvoi à l'étape 1.

  4. (Facultatif) Interrogez l'GetJobopération pour attendre la fin de la tâche.

  5. (Facultatif) Mettez à jour la propriété du nom des actifs après leur création.

Importation de ressources d'API depuis une API Amazon API Gateway (console)

Pour importer un actif depuis une API Amazon API Gateway (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le jeu de données contenant la ressource que vous souhaitez mettre à jour.

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

    1. Pour les paramètres de révision, fournissez un commentaire facultatif pour votre révision qui décrit l'objectif de la révision.

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

    3. Choisissez Créer.

      Votre nouvelle révision est créée.

  5. Pour la section Ressources d'API, choisissez Ajouter une étape d'API.

  6. Sur la page Ajouter une API stage, sélectionnez l'API Amazon API Gateway et le nom de l'étape depuis votre compte Compte AWS ou celui d'un autre compte.

  7. Pour l'API Document pour les abonnés :

    1. Mettez à jour le nom de l'API avec un nom clair et concis que les abonnés puissent comprendre.

    2. Documentez la spécification OpenAPI 3.0 en la saisissant dans le champ, en important la spécification en choisissant Importer depuis un fichier .JSON ou en important la spécification en choisissant Importer depuis Amazon API Gateway.

  8. Choisissez Ajouter une étape d'API.

    Une tâche est lancée pour importer vos actifs d'API dans votre ensemble de données. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Importation de ressources depuis un partage de AWS Data Exchange données pour Amazon Redshift

Lorsque vous importez des actifs à l'aide du AWS Data Exchange partage de données pour Amazon Redshift, vous pouvez commencer à interroger, à analyser et à mettre en œuvre des tables Amazon Redshift tierces après votre inscription.

Importation d'actifs depuis un AWS Data Exchange partage de données pour Amazon AWS Redshift (SDK)

Pour importer des actifs depuis un partage de AWS Data Exchange données pour Amazon AWS Redshift (SDK)
  1. Créez une CreateJob demande de typeIMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES.

  2. Incluez les éléments suivants dans la demande :

    • AssetSources

      • DataShareArn

    • DataSetID

    • RevisionID

  3. Commencez la CreateJob demande par une StartJob opération qui nécessite le JobId renvoi à l'étape 1.

  4. (Facultatif) Interrogez l'GetJobopération pour attendre la fin de la tâche.

  5. (Facultatif) Mettez à jour la propriété du nom des actifs après leur création.

Importation de ressources depuis un AWS Data Exchange partage de données pour Amazon Redshift (console)

Pour importer un actif depuis un partage de données ADE (pour la console Amazon Redshift)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le jeu de données contenant la ressource que vous souhaitez mettre à jour.

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

    1. Pour les paramètres de révision, fournissez un commentaire facultatif pour votre révision qui décrit l'objectif de la révision.

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

    3. Choisissez Créer.

      Votre nouvelle révision est créée.

  5. Pour la section AWS Data Exchange partages de données pour Amazon Redshift, choisissez Ajouter des partages de données.

  6. Sur la page Ajouter un partage AWS Data Exchange de données à la révision, sélectionnez le ou les partages de données que vous souhaitez ajouter.

  7. Choisissez Ajouter un ou plusieurs partages de données.

    Une tâche est lancée pour importer vos actifs dans votre ensemble de données. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Importation de ressources depuis AWS Lake Formation (version préliminaire)

Lorsque vous importez des actifs depuis AWS Lake Formation vers AWS Data Exchange, les autorisations IAM que vous utilisez doivent inclure les fonctionnalités suivantes :

  • Écrire, accorder et révoquer les autorisations de Lake Formation

  • Création de partages de ressources pour les tables, les bases de données et les catalogues

  • Mettre à jour, supprimer, associer et dissocier les partages de ressources pour tout partage de ressources en commençant par Lake Formation

Pour plus d'informations sur les autorisations IAM requises et recommandées, consultezGestion des identités et des accès dans AWS Data Exchange.

Importation d'actifs depuis AWS Lake Formation (version préliminaire) (kits SDK AWS)

Pour importer des actifs depuis AWS Lake Formation (version préliminaire) (SDK AWS)
  1. Créez une CreateJob demande de typeImport_Assets_From_Lake_Formation_Tag_Policy.

  2. Incluez les éléments suivants dans la demande :

    • AssetSources

      • CatalogId

      • Database

        • Expression

          • TagKey

          • TagValues

        • Permissions

      • Table

        • Expression

          • TagKey

          • TagValues

        • Permissions

    • RoleArn

    • DataSetId

    • RevisionId

  3. Démarrez la CreateJob demande par une StartJob opération qui nécessite leJobId.

  4. (Facultatif) Interrogez l'GetJobopération pour attendre la fin de la tâche.

  5. (Facultatif) Mettez à jour la propriété du nom des actifs après leur création.

Importation de ressources depuis AWS Lake Formation (version préliminaire) (console)

Pour importer un actif depuis AWS Lake Formation (Preview) (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le jeu de données dont vous souhaitez mettre à jour la révision.

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

    1. Pour les paramètres de révision, fournissez un commentaire facultatif pour votre révision qui décrit l'objectif de la révision.

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

    3. Choisissez Créer.

      Votre nouvelle révision est créée.

  5. Pour la section d'autorisation des données de Lake Formation, choisissez Add LF-Tag.

  6. Choisissez la clé et les valeurs que vous souhaitez ajouter, puis choisissez Ajouter une balise LF.

    1. (Facultatif) Choisissez Prévisualiser les ressources pour afficher les ressources du catalogue de données associées auxquelles vous accordez une autorisation.

  7. Dans Accès aux services, sélectionnez le rôle dans lequel vous souhaitez importer les AWS Lake Formation ressources AWS Data Exchange.

  8. Choisissez l'autorisation de créer des données de Lake Formation.

    Une tâche est lancée pour importer vos actifs dans votre ensemble de données. Une fois le travail terminé, le champ État de la section Tâches est mis à jour sur Terminé.

Exporter des actifs

Les fournisseurs et les abonnés peuvent exporter des actifs à partir d'une révision publiée d'un produit. Vous pouvez exporter des actifs de deux manières :

Exportation de ressources vers un compartiment S3

Lorsque vous exportez des actifs vers Amazon S3, les autorisations IAM que vous utilisez doivent inclure la possibilité de lire à partir des compartiments S3 du AWS Data Exchange service et d'écrire dans le compartiment S3 dans lequel vos actifs sont stockés. Vous pouvez exporter vers n'importe quel compartiment S3 auquel vous êtes autorisé à accéder, quel que soit son propriétaire. Pour plus d’informations, consultez Autorisations Amazon S3.

AWS Data Exchange prend en charge les paramètres de chiffrement configurables lors de l'exportation d'ensembles de données vers Amazon S3. Dans les détails de votre tâche d'exportation, vous pouvez spécifier la configuration de chiffrement côté serveur Amazon S3 que vous souhaitez appliquer aux objets exportés. Vous pouvez choisir d'utiliser le chiffrement côté serveur avec des clés gérées par Amazon S3 (SSE-S3) ou le chiffrement côté serveur avec des clés stockées dans (SSE-KMS). AWS KMS keys AWS Key Management Service Pour plus d'informations, consultez la section Protection des données à l'aide du chiffrement côté serveur dans le Guide de l'utilisateur Amazon Simple Storage Service.

Important

Nous vous recommandons de prendre en compte les fonctionnalités de sécurité d'Amazon S3 lorsque vous exportez des données vers Amazon S3. Pour plus d'informations sur les directives générales et les meilleures pratiques, consultez les meilleures pratiques de sécurité pour Amazon S3 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

Important

Si le fournisseur a marqué un produit comme contenant des informations de santé protégées (PHI) conformément à la loi de 1996 sur la portabilité et la responsabilité de l'assurance maladie (HIPAA), vous ne pouvez pas exporter les ensembles de données du produit vers votre compte, Compte AWS sauf si celui-ci Compte AWS est désigné comme un compte HIPAA (tel que défini dans l'addendum relatif aux partenaires AWS commerciaux trouvé dans). AWS Artifact

Vous pouvez exporter jusqu'à 100 actifs en une seule tâche.

La vidéo suivante explique plus en détail comment exporter des actifs depuis AWS Data Exchange.

Exportation de ressources vers un compartiment S3 (AWS SDK)

Pour exporter des actifs vers un compartiment S3 (AWS SDK)
  1. Créez une CreateJob demande de typeEXPORT_ASSETS_TO_S3.

  2. Incluez les éléments suivants dans la demande :

    • AssetDestinations

      • AssetID

      • Bucket

      • Key

    • DataSetID

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionID

  3. Commencez la CreateJob demande par une StartJob opération qui nécessite le JobId renvoi à l'étape 1.

  4. (Facultatif) Mettez à jour la propriété du nom des actifs après leur création.

Note

Pour plus d'informations sur l'exportation d'une révision complète en tant que tâche unique, consultezExporter des révisions.

Exportation de ressources vers un compartiment S3 en tant qu'abonné (console)

Pour exporter un actif vers un compartiment S3 en tant qu'abonné (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Mes abonnements, sélectionnez Données autorisées.

  3. Dans Données autorisées, choisissez le produit dont vous souhaitez exporter la révision.

  4. Dans Ensembles de données autorisés, sélectionnez l'ensemble de données.

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

  6. Dans l'onglet Ressources, cochez la case à côté des ressources que vous souhaitez exporter.

  7. Sélectionnez Exporter les actions, puis sélectionnez Exporter les actifs sélectionnés vers Amazon S3.

  8. Suivez les instructions de la fenêtre Exporter vers Amazon S3, puis choisissez Exporter.

    Une tâche est lancée pour exporter votre actif. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Exportation de ressources vers un compartiment S3 en tant que fournisseur (console)

Pour exporter un actif vers un compartiment S3 en tant que fournisseur (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le jeu de données contenant la ressource que vous souhaitez exporter.

  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, sélectionnez la révision.

  6. Pour la section Ressources importées, cochez la case à côté du nom de la ressource.

  7. Sélectionnez Exporter les actions, puis sélectionnez Exporter les actifs sélectionnés vers Amazon S3.

  8. Suivez les instructions de la fenêtre Exporter vers Amazon S3, puis choisissez Exporter.

    Une tâche est lancée pour exporter votre actif. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Exportation de ressources vers une URL signée

Vous pouvez utiliser des URL signées pour exporter des actifs qui ne sont pas stockés dans Amazon S3.

Exportation de ressources vers une URL signée (AWS SDK)

Vous pouvez utiliser des URL signées pour exporter des actifs vers des destinations autres que les compartiments S3.

Pour exporter des ressources vers une URL signée (AWS SDK)
  1. Créez une CreateJob demande de typeEXPORT_ASSET_TO_SIGNED_URL.

  2. Incluez les éléments suivants dans la demande :

    • AssetID

    • DataSetID

    • RevisionID

  3. Commencez la CreateJob demande par une StartJob opération qui nécessite le JobId renvoi à l'étape 1.

  4. (Facultatif) Mettez à jour la propriété du nom des actifs après leur création.

  5. Les détails de la réponse incluent SignedUrl ceux que vous pouvez utiliser pour importer votre fichier.

Note

L'URL signée expire une minute après sa création.

Exportation de ressources vers une URL signée en tant qu'abonné (console)

Pour exporter un actif vers une URL signée en tant qu'abonné (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Mes abonnements, sélectionnez Données autorisées.

  3. Dans Données autorisées, choisissez le produit dont vous souhaitez exporter la révision.

  4. Dans Ensembles de données autorisés, sélectionnez l'ensemble de données.

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

  6. Dans l'onglet Ressources, cochez la case à côté des ressources que vous souhaitez exporter.

  7. Sélectionnez Exporter les actions, puis sélectionnez Télécharger les ressources sélectionnées.

    Une tâche est lancée pour exporter votre actif. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Exportation de ressources vers une URL signée en tant que fournisseur (console)

Pour exporter un actif vers une URL signée en tant que fournisseur (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le produit dont vous souhaitez exporter la révision.

  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 la révision.

  6. Pour la section Ressources importées, cochez la case à côté du nom de la ressource.

  7. Sélectionnez Exporter les actions, puis sélectionnez Télécharger les ressources sélectionnées.

    Une tâche est lancée pour exporter votre actif. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Exporter des révisions

Les fournisseurs et les abonnés peuvent exporter les révisions d'un ensemble de données vers un compartiment S3 auquel ils sont autorisés à accéder.

AWS Data Exchange prend en charge les paramètres de chiffrement configurables lors de l'exportation de révisions vers Amazon S3. Dans les détails de votre tâche d'exportation, vous pouvez spécifier la configuration de chiffrement côté serveur Amazon S3 que vous souhaitez appliquer aux objets exportés. Vous pouvez choisir d'utiliser le chiffrement côté serveur avec les clés gérées par Amazon S3 (SSE-S3) ou le chiffrement côté serveur avec les clés KMS stockées dans (SSE-KMS). AWS Key Management Service Pour de plus amples informations, veuillez consulter Protection des données à l'aide du chiffrement côté serveur dans le Manuel du développeur Amazon Simple Storage Service.

Important

Si le fournisseur a marqué un produit comme contenant des informations de santé protégées (PHI) conformément à la loi de 1996 sur la portabilité et la responsabilité de l'assurance maladie (HIPAA), vous ne pouvez pas exporter les ensembles de données du produit vers votre compte, Compte AWS sauf si celui-ci Compte AWS est désigné comme un compte HIPAA (tel que défini dans l'addendum relatif aux partenaires AWS commerciaux trouvé dans). AWS Artifact

La vidéo suivante explique comment exporter des ressources depuis AWS Data Exchange (à partir de 2:18).

Exportation de révisions vers un compartiment S3 (AWS SDK)

Pour exporter une révision vers un compartiment S3 (AWS SDK)
  1. Créez une CreateJob demande de typeEXPORT_REVISIONS_TO_S3.

  2. Incluez les éléments suivants dans la demande :

    • DataSetId

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionDestinations

      • Bucket

      • KeyPattern

      • RevisionId

  3. Commencez la CreateJob demande par une StartJob opération qui nécessite le JobId renvoi à l'étape 1.

  4. Les actifs nouvellement créés ont une propriété de nom égale à la clé de l'objet S3 d'origine. La clé d'objet Amazon S3 utilise par défaut le modèle de clé. ${Asset.Name}

    Vous pouvez mettre à jour la propriété du nom des actifs après leur création.

    Pour plus d'informations sur les modèles clés, consultezPrincipaux modèles lors de l'exportation de révisions.

Note

Si vous l'utilisez DataSet.Name comme référence dynamique, vous devez disposer de l'autorisation dataexchange:GetDataSet IAM. Pour plus d’informations, consultez AWS Data Exchange APIautorisations : référence aux actions et aux ressources.

Exportation de révisions vers un compartiment S3 en tant que fournisseur (console)

Pour exporter une révision vers un compartiment S3 en tant que fournisseur (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Publier les données, sélectionnez Ensembles de données détenus.

  3. Dans Ensembles de données détenus, choisissez le produit dont vous souhaitez exporter la révision.

  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 la révision.

  6. Pour la section Ressources importées, cochez la case à côté du nom de la ressource.

  7. Sélectionnez Exporter les actions, puis sélectionnez Exporter les actifs sélectionnés vers Amazon S3.

  8. Suivez les instructions de la fenêtre Exporter vers Amazon S3, puis choisissez Exporter.

    Une tâche est lancée pour exporter votre actif. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Exportation de révisions vers un compartiment S3 en tant qu'abonné (console)

Pour exporter une révision vers un compartiment S3 en tant qu'abonné (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Mes abonnements, sélectionnez Données autorisées.

  3. Dans Données autorisées, choisissez le produit dont vous souhaitez exporter la révision.

  4. Dans Ensembles de données autorisés, sélectionnez l'ensemble de données.

  5. Dans l'onglet Révisions, sélectionnez la révision, puis choisissez Exporter vers Amazon S3.

  6. Dans Exporter la révision vers Amazon S3, sélectionnez une option de destination, la destination du dossier du compartiment Amazon S3, configurez les options de chiffrement, puis choisissez Exporter.

    Une tâche est lancée pour exporter votre révision. Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

Exportation automatique des révisions vers un compartiment S3 en tant qu'abonné

Lorsque le fournisseur publie de nouvelles révisions, vous pouvez choisir d'exporter automatiquement les nouvelles révisions vers votre compartiment Amazon S3. Vous pouvez exporter les nouvelles révisions vers un maximum de cinq compartiments S3. Les nouvelles révisions apparaîtront automatiquement dans les compartiments S3 que vous avez sélectionnés.

Note

Pour exporter automatiquement les révisions vers un compartiment S3 de votre choix, votre compartiment S3 doit disposer d'une politique de compartiment avec des autorisations définies pour autoriser l'exportation de données AWS Data Exchange vers celui-ci. Pour plus d’informations, consultez Conditions requises pour les autorisations liées à la politique des compartiments S3.

Conditions requises pour les autorisations liées à la politique des compartiments S3

Avant de pouvoir exporter automatiquement les révisions vers un compartiment S3, vous devez désactiver le paiement par les demandeurs et votre compartiment S3 doit disposer d'une politique de compartiment avec des autorisations définies pour autoriser l'exportation de données AWS Data Exchange vers celui-ci. Les procédures suivantes fournissent des informations sur la manière de modifier votre politique de compartiment S3 existante ou de créer une politique de compartiment S3 avec ces autorisations.

Si votre compartiment S3 est configuré pour le chiffrement SSE-KMS, l'utilisateur qui configure la tâche d'exportation automatique doit être CreateGrant autorisé AWS Data Exchange à copier les objets dans votre compartiment S3 sur la clé KMS.

Important

Pour vérifier que les conditions requises pour les autorisations de politique du compartiment S3 sont respectées, un objet au format de dénomination _ADX-TEST-ACCOUNTID# est ajouté au compartiment S3 pendant le processus d'exportation automatique.

Modification d'une politique de compartiment S3 existante

Si votre compartiment S3 dispose d'une politique de compartiment, suivez la procédure suivante pour autoriser l'exportation AWS Data Exchange de données vers ce compartiment.

Pour modifier une politique de compartiment S3 existante
  1. Accédez au compartiment vers lequel vous souhaitez exporter les révisions.

  2. Sélectionnez l'onglet Autorisations, puis choisissez Modifier dans la section relative à la politique du compartiment.

  3. Copiez l'instruction suivante et collez-la à la fin de la liste des instructions.

    { "Effect": "Allow", "Principal": { "Service": "dataexchange.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::<BUCKET-NAME>/*", "Condition": { "StringEquals": { "aws:SourceAccount": "<AWS ID>" } } }
  4. Remplacez <BUCKET-NAME> par le nom de votre compartiment S3 et remplacez <AWS ID> par votre AWS ID.

  5. Sélectionnez Enregistrer les modifications.

  6. Si vous souhaitez ajouter d'autres compartiments comme destination pour vos tâches d'exportation automatique, répétez la procédure en commençant par l'étape 1.

Création d'une politique de compartiment S3

Si votre compartiment S3 ne possède pas de politique de compartiment, suivez la procédure suivante pour créer une politique de compartiment S3 autorisant l'exportation de données AWS Data Exchange vers celui-ci.

Pour créer une politique de compartiment S3
  1. Accédez au compartiment vers lequel vous souhaitez exporter les révisions.

  2. Sélectionnez l'onglet Autorisations, puis choisissez Modifier dans la section relative à la politique du compartiment.

  3. Copiez la politique de compartiment complète suivante et collez-la dans l'éditeur de politique de compartiment.

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "dataexchange.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::<BUCKET-NAME>/*", "Condition": { "StringEquals": { "aws:SourceAccount": "<AWS ID>" } } } ] }
  4. Remplacez <BUCKET-NAME> par le nom de votre compartiment S3 et remplacez <AWS ID> par votre AWS ID.

  5. Sélectionnez Enregistrer les modifications.

  6. Si vous souhaitez ajouter d'autres compartiments comme destination pour vos tâches d'exportation automatique, répétez la procédure en commençant par l'étape 1.

Exportation automatique des révisions vers un compartiment S3 en tant qu'abonné (console)

Note

Pour exporter automatiquement les révisions vers un compartiment S3 de votre choix, votre compartiment S3 doit disposer d'une politique de compartiment avec des autorisations définies pour autoriser l'exportation de données AWS Data Exchange vers celui-ci. Pour plus d’informations, consultez Conditions requises pour les autorisations liées à la politique des compartiments S3.

Pour exporter automatiquement une révision vers un compartiment S3 en tant qu'abonné (console)
  1. Ouvrez votre navigateur Web et connectez-vous à la AWS Data Exchange console.

  2. Dans le volet de navigation de gauche, pour Mes abonnements, sélectionnez Données autorisées.

  3. Dans Données autorisées, choisissez le produit dont vous souhaitez exporter la révision.

  4. Dans Ensembles de données autorisés, sélectionnez l'ensemble de données.

  5. Dans l'onglet Révisions, sous Exportation automatique des destinations de travail, sélectionnez Actions, puis choisissez Ajouter une destination de tâche d'exportation automatique.

  6. Dans Ajouter une destination de tâche d'exportation automatique, choisissez l'option de destination simple ou avancée.

    1. Si vous choisissez l'option Simple, sélectionnez la destination du dossier du compartiment Amazon S3 dans la liste déroulante et dans les options de chiffrement, puis choisissez Ajouter une destination de compartiment.

    2. Si vous choisissez l'option Avancé, sélectionnez la destination du dossier du compartiment Amazon S3 dans la liste déroulante, sélectionnez le modèle de dénomination des clés et ajoutez-le au chemin.

  7. Passez en revue le résultat.

  8. Définissez les options de chiffrement, consultez la tarification d'Amazon S3, puis choisissez Ajouter une destination de compartiment.

    La destination du compartiment Amazon S3 apparaît dans l'onglet Révisions sous Destinations de travail d'exportation automatique.

    Une tâche est lancée pour exporter automatiquement votre révision.

    Pour vérifier que les conditions requises pour les autorisations de politique du compartiment S3 sont respectées, un objet au format de dénomination _ADX-TEST-ACCOUNTID# est ajouté au compartiment S3.

    Une fois la tâche terminée, le champ État de la section Tâches passe à Terminé.

    Pour ajouter une autre destination, choisissez Actions, puis Ajouter une destination de tâche d'exportation automatique.

    Pour modifier, sélectionnez la destination que vous souhaitez modifier, choisissez Actions, puis Modifier la configuration de destination.

    Pour supprimer, choisissez Actions, puis sélectionnez Supprimer la destination de la tâche d'exportation automatique.

Exportation automatique des révisions vers un compartiment S3 en tant qu'abonné (AWS SDK)

Note

Pour exporter automatiquement les révisions vers un compartiment S3 de votre choix, votre compartiment S3 doit disposer d'une politique de compartiment avec des autorisations définies pour autoriser l'exportation de données AWS Data Exchange vers celui-ci. Pour plus d’informations, consultez Conditions requises pour les autorisations liées à la politique des compartiments S3.

Pour exporter automatiquement une révision vers un compartiment S3 (AWS SDK)
  1. Créez une Create_Event_Action demande.

  2. Incluez les éléments suivants dans la demande :

    • Action

      • ExportRevisionToS3

        • Encryption

          • KmsKeyArn

          • Type

      • RevisionDestination

        • Bucket

        • KeyPattern

    • Event

      • RevisionPublished

        • DataSetId

  3. Modifiez le modèle de touches si nécessaire. La clé d'objet Amazon S3 utilise par défaut le modèle de clé. {Revision.CreatedAt}/{Asset.Name}

    Pour plus d'informations sur les modèles clés, consultezPrincipaux modèles lors de l'exportation de révisions.

    Pour vérifier que les conditions requises pour les autorisations de politique du compartiment S3 sont respectées, un objet au format de dénomination _ADX-TEST-ACCOUNTID# est ajouté au compartiment S3.

Principaux modèles lors de l'exportation de révisions

Lorsque vous exportez une révision, chaque ressource devient un objet dans le compartiment S3. Les noms des objets sont basés sur un modèle clé que vous fournissez. Vous pouvez utiliser des références dynamiques qui représentent les attributs des actifs afin de créer un modèle pour les noms générés automatiquement lors de l'exportation. Utilisez les références dynamiques indiquées dans le tableau suivant.

Références dynamiques Description
${Asset.Id} L'identifiant de l'actif.
${Asset.Name} Le nom de l'actif.
${DataSet.Id} L'identifiant de l'ensemble de données exporté.
${DataSet.Name} Nom de l'ensemble de données exporté.
${Revision.CreatedAt} Date et heure UTC auxquelles la révision a été créée, au format suivant : YYYY-MM-DDTHH:MM:SSZ. Par exemple : 2021-10-08T 16:33:19.787 Z
${Revision.CreatedAt.Day} Le jour du mois où la révision a été créée.
${Revision.CreatedAt.Month} Le mois où la révision a été créée.
${Revision.CreatedAt.Year} Année de création de la révision.
${Revision.Id} L'ID de la révision en cours d'exportation.

Vous pouvez utiliser ces références dynamiques pour créer les modèles clés pour les noms de vos actifs. Vous devez inclure au moins l'une des deux références Asset dynamiques, à savoir ${Asset.Name} et${Asset.Id}.

Par exemple, si vous l'utilisez ${Revision.Id}/${Asset.Name} comme modèle clé, les objets Amazon S3 utilisent l'ID de révision et le nom de l'actif (séparés par une barre oblique) comme nom d'objet.

Si vous exportez une révision avec l'ID testRevisionId dont deux actifs sont nommés asset1 etasset2, les actifs sont exportés vers les emplacements suivants dans Amazon S3 :

  • <bucket>/testRevisionId/asset1

  • <bucket>/testRevisionId/asset2

Note

Les objets que vous obtenez doivent avoir des noms uniques. S'ils portent le même nom que les objets existants dans le compartiment S3, votre exportation remplacera les objets existants. Si la révision que vous exportez porte des noms non uniques (par exemple, deux actifs portant le même nom), l'exportation échouera. La seule référence dynamique unique est${Asset.Id}.