La référence d'API AWS Marketplace a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez le manuel [AWS Marketplace API Reference](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html). 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. # Travaillez avec les composants EC2 Image Builder En tant que vendeur AWS Marketplace, vous pouvez répertorier les AMI-based produits livrés aux acheteurs d'AWS Marketplace à l'aide des composants EC2 Image Builder. Pour créer votre composant et publier une AWS Marketplace liste, parcourez les sections suivantes de manière séquentielle. **Topics** + [Création et test de votre composant Image Builder](#build-and-test-ib-component) + [Copier l'ARN du composant](#ib-copy-component-arn) + [Création AWS Marketplace politiques IAM](#ib-create-iam-policies) + [Création du AWS Marketplace Rôle IAM](#ib-create-iam-role) + [Préparez la liste de vos composants Image Builder](#prepare-ec2-ib-listing) + [Publication de la liste des produits de votre composant Image Builder](#publishing-ib-component-listing) + [Mise à jour des informations sur le produit du composant Image Builder](#updating-ec2-image-builder-product) + [Ajouter une nouvelle version à un composant Image Builder existant](#adding-new-ec2-ib-version-existing-product) + [Mettre à jour les informations relatives à une version existante](#updating-ec2-ib-product-version) + [Restreindre la version d'un composant du produit Image Builder](#restricting-ec2-ib-product-version) + [Surveillance d'un ensemble de modifications](#monitor-changeset) + [Sécurisation des téléchargements de logiciels](#securing-software-downloads) ## Création et test de votre composant Image Builder Créez et testez votre composant sur Image Builder. Pour obtenir des instructions, reportez-vous à la section [Développement de composants personnalisés pour votre image Image Builder](https://docs.aws.amazon.com//imagebuilder/latest/userguide/create-custom-components.html) dans le *guide de l'utilisateur d'Image Builder*. Lorsque vous créez votre composant à l'aide d'Image Builder, veillez à effectuer les opérations suivantes : + Le composant et toutes ses dépendances sous-jacentes, telles qu'un bucket Amazon Simple Storage Service (Amazon S3), des secrets ou des paramètres, doivent être créés dans la région AWS de l'est des États-Unis (Virginie du Nord) (`us-east-1`). + Incluez l'architecture prise en charge et toutes les dépendances logicielles dans la description du composant. + Testez votre composant dans votre AWS compte en créant un [pipeline d'images](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) et en déployant l'AMI créée par le pipeline. + Si votre composant contient des instructions pour copier des fichiers binaires, des packages ou des fichiers depuis un compartiment S3, utilisez le module `S3Download` d'action. Dans le `S3Download` module, pour`source`, entrez l'emplacement statique de votre fichier dans le compartiment S3. L'exemple suivant copie un fichier binaire depuis un compartiment S3 dans le cadre de l'installation du composant. ``` - name: DownloadMyFile action: S3Download inputs: - source: s3://amzn-s3-demo-source-bucket/path/to/package.zip destination: C:\myfolder\package.zip ``` + Les composants peuvent ingérer des fichiers d'une capacité maximale de 2 Go lors de l'utilisation de l'`S3Download`action. + Si votre composant utilise des [paramètres](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-user-defined-variables.html#user-defined-vars-parameters), assurez-vous que tous les paramètres ont des valeurs par défaut. Par exemple, si un paramètre est nommé`region`, assurez-vous d'avoir une valeur par défaut valide, telle que`us-east-1`. Ces valeurs par défaut sont destinées AWS Marketplace au traitement et aux tests. Les tests risquent d'échouer si vous n'incluez pas les valeurs par défaut. + Si votre composant utilise AWS Secrets Manager le Parameter Store ou une fonctionnalité de AWS Systems Manager pour stocker des paramètres, procédez comme suit : + + Pour récupérer des valeurs en tant qu'étape dans votre composant, intégrez des AWS Command Line Interface commandes dans votre fichier de configuration YAML. + Créez une entrée correspondante dans Secrets Manager ou Parameter Store de votre AWS compte. Utilisez la clé par défaut et fournissez une valeur valide qui facilitera la création du composant pendant le processus de AWS Marketplace test. Supposons, par exemple, que vous ayez un paramètre appelé `saas_token` avec la valeur par défaut `token` qui utilise Parameter Store. Dans ce cas, créez une paire clé-valeur dans Parameter Store. `token`Utilisez-le comme clé. Pour la valeur, entrez un jeton SaaS valide pour votre application. Notez que les valeurs enregistrées dans votre compte AWS Marketplace vendeur ne seront utilisées qu'à des fins de AWS Marketplace test. Ces valeurs ne seront pas partagées avec les acheteurs. + AWS Marketplace génère automatiquement des Amazon Machine Images (AMI) pour votre composant sur toutes les versions de système d'exploitation compatibles que vous choisissez au cours du processus de création du composant. Lorsque vous créez votre composant, choisissez au moins une version de système d'exploitation compatible. Validez la compatibilité de votre composant avec toutes les versions de système d'exploitation choisies en utilisant les pipelines EC2 Image Builder pour créer et tester des AMI. ## Copier l'ARN du composant Après avoir créé et testé le composant sur Image Builder, copiez et enregistrez l'ARN du composant. Vous utiliserez l'ARN lorsque vous publierez la liste des produits à l'aide de l'API du AWS Marketplace catalogue. **Pour copier l'ARN du composant Image Builder** 1. Connectez-vous à l'AWS Management Console et ouvrez la console Image Builder à l'adresse[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Dans la barre de navigation de gauche, sous **Ressources enregistrées**, sélectionnez **Composants**. 1. Sur la page **Composants**, pour **Propriétaire du filtre**, sélectionnez **Owned by me**. 1. Choisissez le nom du composant. 1. Sur la page détaillée du composant, dans la section **Résumé**, copiez l'ARN. ## Création AWS Marketplace politiques IAM Créez les politiques IAM suivantes pour accorder l' AWS Marketplace accès à votre composant Image Builder et aux ressources associées, telles que les compartiments et les secrets Amazon S3. Utilisez les exemples de politiques fournis. Vous associez ces politiques à un [rôle AWS Marketplace IAM](#ib-create-iam-role). Pour obtenir de l'aide sur la création de politiques, consultez la section [Création de politiques à l'aide de l'éditeur JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) dans le *guide de l'utilisateur IAM*. + Politique Get-Component d'Image Builder, pour autoriser l'accès AWS Marketplace à votre composant sur Image Builder. Cette politique est obligatoire. Nommez la stratégie `mp_ib_ingest`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "imagebuilder:GetComponent", "Resource": "*" } ] } ``` ------ + Politique d'accès en lecture d'Amazon S3, permettant de AWS Marketplace récupérer des fichiers binaires depuis un compartiment S3. Cette politique n'est requise que si votre composant utilise le module `S3Download` d'action et stocke les fichiers binaires associés dans un compartiment S3. Nommez la stratégie `mp_ib_s3_read_only`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ListObjectsInBucket", "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::{{bucket_name}}" ] }, { "Sid": "ReadObjectsInBucket", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectAttributes" ], "Resource": [ "arn:aws:s3:::{{bucket_name}}/*" ] } ] } ``` ------ + Politique d'accès en lecture de Secrets Manager, pour permettre de AWS Marketplace récupérer les secrets stockés dans Secrets Manager. Cette politique n'est requise que si votre composant utilise Secrets Manager pour stocker des secrets. Nommez la stratégie `mp_ib_sm_read_only`. Pour limiter la politique à votre secret, remplacez le contenu `*` de la `Resource` section par votre secret. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": [ "*" ] } ] } ``` ------ + Politique d'accès en lecture au Parameter Store, pour permettre de AWS Marketplace récupérer les secrets stockés dans le Parameter Store. Cette politique n'est requise que si votre composant utilise le Parameter Store pour stocker des secrets. Nommez la stratégie `mp_ib_ssm_parameter_read_only`. Pour limiter la politique à votre secret, remplacez le contenu `*` de la `Resource` section par votre secret. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "ssm:getParameter" ], "Resource": [ "*" ] } ] } ``` ------ ## Création du AWS Marketplace Rôle IAM Utilisez la procédure suivante pour créer un rôle AWS Marketplace IAM avec des politiques permettant d'accorder l' AWS Marketplace accès à votre composant et à ses dépendances. **Pour créer le AWS Marketplace Rôle IAM** 1. Connectez-vous à la console de AWS gestion et ouvrez la console IAM à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse. 1. Dans la barre de navigation de gauche, sélectionnez **Rôles**. 1. Choisissez **Créer un rôle**. 1. Sélectionnez **Politique de confiance personnalisée**. 1. Entrez l'énoncé suivant : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Principal": { "Service": "assets.marketplace.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Choisissez **Suivant**. 1. Ajoutez la politique Get-component d'Image Builder que vous avez créée précédemment. La politique get-component est obligatoire. Ajoutez les politiques appropriées pour S3, Secrets Manager et Parameter Store si votre composant utilise ces AWS services. 1. Choisissez **Suivant**. 1. Entrez un nom de rôle, tel que`MPEC2IBIngestion`. 1. Choisissez **Créer un rôle**. ### Texte AWS Marketplace L’ARN du rôle IAM Après avoir créé le rôle AWS Marketplace IAM, copiez et enregistrez l'ARN du rôle. Vous utiliserez l'ARN lors de la publication de la liste à l'aide de l'API du AWS Marketplace catalogue. **Pour copier le AWS Marketplace L’ARN du rôle IAM** 1. Dans la console IAM, dans la barre de navigation de gauche, sélectionnez **Rôles**. 1. Choisissez le rôle AWS Marketplace IAM que vous avez créé précédemment, par exemple`MPEC2IBIngestion`. 1. Sur la page détaillée du rôle, dans la section **Résumé**, copiez l'ARN. ## Préparez la liste de vos composants Image Builder Avant de publier votre AWS Marketplace annonce, assurez-vous de disposer des informations suivantes : + **Métadonnées du produit :** les métadonnées incluent le logo du produit, le titre du produit, le contrat de licence utilisateur final, les types d'instances pris en charge et la région AWS. + **Informations sur les prix —** Vous pouvez proposer votre produit gratuitement, à un taux horaire ou à un taux horaire avec une période d'essai gratuite initiale. La licence Bring your own (BYOL) n'est pas prise en charge. + **Détails du composant —** Les détails incluent le numéro de ressource Amazon (ARN) du composant, les détails d'utilisation et le rôle Gestion des identités et des accès AWS (IAM) qui AWS Marketplace assumera le traitement de votre composant. ## Publication de la liste des produits de votre composant Image Builder Cette rubrique contient des instructions pour publier la liste de vos composants EC2 Image Builder à l'aide AWS Marketplace de AWS Marketplace l'API Catalog. ### Conditions préalables Assurez-vous de disposer des éléments suivants avant de publier la liste des produits de votre composant Image Builder : + Inscription en tant que vendeur dans AWS Marketplace. Pour plus d'informations, consultez la section S'[inscrire en tant que vendeur AWS Marketplace](https://catalog.workshops.aws/mpseller/en-US/pre-requisite-register-as-seller). + Un utilisateur IAM `AWSMarketplaceSellerFullAccess` autorisé. + Un bucket Amazon Simple Storage Service (Amazon S3) accessible au public pour héberger le logo et le CLUF de votre entreprise, s'ils sont utilisés dans votre composant. Vous allez entrer l'URL du compartiment S3 dans votre fichier `ChangeSet` JSON. + AWS Command Line Interface (AWS CLI). Pour plus d'informations, reportez-vous à [Qu'est-ce que l'interface de ligne de commande AWS ?](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) dans le *guide de AWS Command Line Interface l'utilisateur*. ### Création d'un composant Image Builder sur AWS Marketplace Pour créer un composant EC2 Image Builder à l'aide de AWS Marketplace l'API Catalog, reportez-vous à[Création d'un produit](work-with-seller-products.md#create-product). ## Mise à jour des informations sur le produit du composant Image Builder Vous pouvez mettre à jour les informations relatives à un composant du produit Image Builder sur le portail AWS Marketplace de gestion. **Pour mettre à jour les informations sur le produit du composant Image Builder** 1. Ouvrez le [Portail de gestion AWS Marketplace](https://aws.amazon.com/marketplace/management/tour/)et connectez-vous à votre compte vendeur. 1. Dans le menu **Produits**, sélectionnez **Serveur**. 1. Sur la page **des produits du serveur**, sélectionnez le produit. 1. Sur la page détaillée du produit, dans le menu **Demander des modifications**, choisissez l'élément correspondant aux informations que vous souhaitez mettre à jour. 1. Après avoir soumis des modifications, la demande apparaîtra dans l'onglet **Demandes** avec le statut « En cours d'examen » et deviendra « Réussi » une fois terminée. ## Ajouter une nouvelle version à un composant Image Builder existant Vous pouvez ajouter une nouvelle version à un composant du produit Image Builder en AWS Marketplace utilisant le AWS Marketplace Catalog API. **Pour ajouter une nouvelle version** 1. À partir du Portail de gestion AWS Marketplace, obtenez l'identifiant du produit. 1. Ouvrez le [Portail de gestion AWS Marketplace](https://aws.amazon.com/marketplace/management/tour/)et connectez-vous à votre compte vendeur. 1. Dans le menu **Produits**, sélectionnez **Serveur**. 1. Sur la page **des produits du serveur**, sélectionnez le produit. 1. Dans le **résumé du produit**, copiez l'**identifiant du produit**. 1. À l'aide de l'exemple de code suivant, créez un fichier d'ensemble de modifications au format JSON. Dans l'exemple, remplacez-le {{your-product-ID}} par l'identifiant du produit que vous avez obtenu à l'étape 1. Remplacez {{new-version-name}} par le titre de votre version. {{new-delivery-option-title}}Remplacez-le par le titre de votre option de livraison. ``` [ { "ChangeType": "AddDeliveryOptions", "Entity": { "Identifier": "{{your-product-ID}}", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "Version": { "VersionTitle": "{{new-version-name}}", "ReleaseNotes": "Release notes goes here." }, "DeliveryOptions": [ { "DeliveryOptionTitle": "{{new title}}", "Details": { "Ec2ImageBuilderComponentDeliveryOptionDetails": { "UsageInstructions": "Test usage instructions for IB", "AccessRoleArn": "arn:aws:iam::123456789:role/sample", "ComponentArn": "arn:aws:imagebuilder:us-east-1:123456789:component/sample/2.0.0/1" } } } ] } } ] ``` 1. Enregistrez le fichier du changeset sous son nom`addIBversion.json`. 1. Dans votre terminal ou AWS CloudShell exécutez la commande suivante : ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json ``` La `start-change-set` commande renverra une `ChangeSetId` valeur. Pour surveiller un ensemble de modifications, voir[Surveillance d'un ensemble de modifications](#monitor-changeset). **Erreurs asynchrones** Les erreurs suivantes sont spécifiques aux `AddDeliveryOptions` actions du AWS Marketplace Catalog API. Ces erreurs sont renvoyées lorsque vous appelez `DescribeChangeSet` après le traitement d'un ensemble de modifications. Pour plus d'informations sur l'utilisation `DescribeChangeSet` pour obtenir le statut d'une demande de modification, consultez[Travailler avec des ensembles de modifications](catalog-apis.md#working-with-change-sets). **Note** Les codes d'erreur suivants sont spécifiques au mode de livraison d'Image Builder. Pour les messages d'erreur existants sur des champs tels que `Usage Instructions``Recommended Instance type`, et`AccessRoleArn`, voir[Ajouter une nouvelle version](work-with-single-ami-products.md#ami-add-version). | Code d’erreur | Message d’erreur | | --- | --- | | ACTIF NON TROUVÉ | Vérifiez si [component arn] existe dans le compte [account-id] AWS et si l'accessARN fourni [ARN] est autorisé à partager ce composant Image Builder avec. AWS Marketplace | | ACTIF NON TROUVÉ | Le lien S3 [x] spécifié dans le composant [x] n'existe pas. Fournissez un lien S3 valide au sein du composant. | | NOM\_COMPOSANT\_DUPLIQUÉ | Le nom du composant [x] existe déjà dans la même version. Entrez un autre nom de composant. | | NOM\_COMPOSANT\_DUPLIQUÉ | Le nom du composant [x] que vous avez fourni est déjà utilisé par un autre produit. Entrez un autre nom de composant. | | DUPLICATE\_COMPONENT\_ARN | Le composant Arn [x] doit être différent du composant Arn utilisé dans les autres options de livraison de la même version de ce produit. | | DUPLICATE\_COMPONENT\_ARN | L'ARN du composant [x] doit être différent de l'ARN du composant utilisé dans les autres versions de ce produit. | | ERREUR DE NUMÉRISATION | Corrigez une vulnérabilité de sécurité [y] sur le composant [x]. | | EXCEPTION D'ACCÈS AUX ACTIFS | Nous n'avons pas les autorisations nécessaires pour lire le contenu du compartiment S3 spécifié [x]. Assurez-vous que le compartiment S3 dispose des autorisations de lecture appropriées. | | EXCEPTION D'ACCÈS AUX ACTIFS | Nous n'avons pas les autorisations nécessaires pour lire le contenu du composant ARN [x] spécifié. Assurez-vous que l'ARN du composant dispose des autorisations de lecture appropriées. | | EXCEPTION D'ACCÈS AUX ACTIFS | Nous n'avons pas les autorisations nécessaires pour lire le contenu de l'URI du package spécifié [x]. Assurez-vous que l'URI du package dispose des autorisations de lecture appropriées. | | EXCEPTION D'ACCÈS AUX ACTIFS | Impossible de lire à partir de la source HTTP [x]. Vérifiez que la source HTTP fournie est correcte. | | PACK\_COMPOSANT\_CONSTRUCTEUR D'IMAGES NON VALIDE | Les actifs des composants dépassent la limite de taille pour l'ingestion. Réduisez la taille des S3/web téléchargements ou éliminez les téléchargements inutiles pour continuer. | | PACK\_COMPOSANT\_CONSTRUCTEUR D'IMAGES NON VALIDE | Les actifs des composants prennent trop de temps à être ingérés. Assurez-vous que votre connexion réseau est stable et dispose d'une bande passante adéquate. | | TROP DE COMPOSANTS DU CONSTRUCTEUR D'IMAGES | Un maximum de 5 noms de composants uniques sont pris en charge par produit, ce qui limite l'option de livraison supplémentaire. | | PROFIL\_PUBLIC\_VENDEUR INCOMPLET | Votre profil public de vendeur n'est pas complet. Complétez votre profil public avant d'ajouter des versions au produit. | | DESCRIPTION\_INVALIDE | La description est manquante. Fournissez une description de moins de 1024 caractères dans le composant [x]. | | NOM\_COMPOSANT\_INVALIDE | Indiquez un nom de composant contenant moins de [x] caractères. | | VERSION DU SYSTÈME D'EXPLOITATION PRISE EN CHARGE NON VALIDE | La version du système d'exploitation est manquante. Indiquez une version valide du système d'exploitation prise en charge dans le composant [x]. | | FORMAT\_CHEMIN\_INVALIDE | L'étape [STEP\_NAME] de la phase [PHASE\_NAME] n'est pas autorisée à utiliser des URL S3 ou Web pour les actions. InstallMSI/UninstallMSI Assurez-vous que le chemin spécifié est un chemin local valide accessible depuis le système exécutant l'action. | | TYPE\_DE\_SYSTÈME D'EXPLOITATION INCOMPATIBLE | Le type de système d'exploitation du composant spécifié [x] n'est pas compatible avec la plate-forme de l'image de base. Indiquez un type de système d'exploitation compatible avec l'image de base. | | EXCEPTION D'ACCÈS AUX ACTIFS | Nous n'avons pas les autorisations nécessaires pour lire le contenu du paramètre SSM spécifié [x]. Assurez-vous que le rôle d'accès IAM fourni dans l'entrée de l'API dispose des autorisations de lecture requises. | | EXCEPTION D'ACCÈS AUX ACTIFS | Nous n'avons pas les autorisations nécessaires pour lire le contenu du SecretsManager secret spécifié [x]. Assurez-vous que le rôle d'accès IAM fourni dans l'entrée de l'API dispose des autorisations de lecture requises. | | VERSION\_IB\_COMPONENT\_BUILD\_INVALIDE | Le composant ARN [x] possède une version de compilation de [y]. AWS Marketplace ne prend en charge que la version 1 de build. Créez une nouvelle version d'EC2 Image Builder avec les versions 1 de Build, puis réessayez AWS Marketplace | | PARAMÈTRE\_IB\_COMPOSANT NON VALIDE | Impossible d'analyser le paramètre SSM dans l'entrée [x] pour le composant [y]. | | PARAMÈTRE\_IB\_COMPOSANT NON VALIDE | Impossible d'analyser le SecretsManager secret dans l'entrée [x] pour le composant [y]. | | PARAMÈTRE\_IB\_COMPOSANT MANQUANT | Paramètre introuvable dans le composant [x] pour l'entrée [y] | | PARAMÈTRE\_IB\_COMPOSANT NON VALIDE | Fournissez une valeur par défaut pour le paramètre [x] dans le composant [y]. | | TEST\_DE\_LANCEMENT RATÉ | Le test de lancement du composant [x] a échoué. Message d'erreur : [z] | | SSHAuthFailedForUserAndKeypair | Impossible de se connecter à l'instance avec le nom d'utilisateur par défaut du système d'exploitation [X]. | | INVALID\_IB\_COMPONENT | Une phase de construction des composants est requise. Ajouter une phase de construction valide au composant [x] | | TITRE\_DE\_VERSION DUPLIQUÉ | Le titre de la version doit être différent de celui des autres titres de version de ce produit. | | TITRE\_DE LA VERSION NON VALIDE | Supprimez les espaces devant le symbole de marque. | | TITRE\_DE LA VERSION NON VALIDE | Supprimer les caractères non pris en charge : [x, y, z] | | TITRE\_DE LA VERSION NON VALIDE | Supprimez les espaces au début du titre de la version. | | TITRE\_DE LA VERSION NON VALIDE | Indiquez le titre de la version contenant moins de [x] caractères. | | NOTES\_DE\_PUBLICATION NON VALIDES | Supprimez les espaces devant le symbole de marque. | | NOTES\_DE\_PUBLICATION NON VALIDES | Supprimer les caractères non pris en charge : [x, y, z] | | NOTES\_DE\_PUBLICATION NON VALIDES | Supprimez les espaces au début des notes de publication. | | NOTES\_DE\_PUBLICATION NON VALIDES | Fournissez des notes de version contenant moins de (x) caractères. | | INSTRUCTIONS D'UTILISATION NON VALIDES | Supprimez les espaces devant le symbole de marque. | | INSTRUCTIONS D'UTILISATION NON VALIDES | Supprimer les caractères non pris en charge : [x, y, z] | | INSTRUCTIONS D'UTILISATION NON VALIDES | Fournissez des instructions d'utilisation contenant moins de (x) caractères. | | TITRES\_OPTION\_DE LIVRAISON DUPLIQUÉS | Indiquez le titre unique de l'option de livraison. | | TITRES\_OPTION\_DE LIVRAISON NON VALIDES | Le titre de l'option de livraison existe déjà, réessayez avec un autre titre. | ## Mettre à jour les informations relatives à une version existante **Pour mettre à jour les informations relatives à une version existante** 1. À partir du Portail de gestion AWS Marketplace, obtenez l'identifiant du produit. 1. Ouvrez le [Portail de gestion AWS Marketplace](https://aws.amazon.com/marketplace/management/tour/)et connectez-vous à votre compte vendeur. 1. Dans le menu **Produits**, sélectionnez **Serveur**. 1. Sur la page **des produits du serveur**, sélectionnez le produit. 1. Dans le **résumé du produit**, copiez l'**identifiant du produit**. 1. Dans votre terminal, exécutez la commande suivante. Dans la commande, remplacez par {{your-product-ID}} l'identifiant que vous avez obtenu à l'étape 1. ``` aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}' ``` 1. Dans le résultat renvoyé, passez à la `Versions` section`DetailsDocument`,. Copiez la `Id` valeur`DeliveryOptions`, pour la version que vous souhaitez mettre à jour. 1. À l'aide de l'exemple de code suivant, créez un fichier d'ensemble de modifications au format JSON. Dans l'exemple, remplacez-le {{your-product-ID}} par l'identifiant du produit que vous avez obtenu à l'étape 1. {{your-release-notes}}Remplacez-le par vos notes de version. {{your-delivery-option-ID}}Remplacez-le par l'identifiant de l'option de livraison que vous avez obtenue à l'étape 3. {{your-usage-instructions}}Remplacez-le par vos instructions d'utilisation. ``` [ { "ChangeType": "UpdateDeliveryOptions", "Entity": { "Identifier": "{{your-product-ID}}", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "Version": { "ReleaseNotes": "{{your-release-notes}}" }, "DeliveryOptions": [ { "Id": "{{your-delivery-option-ID}}", "Details": { "Ec2ImageBuilderComponentDeliveryOptionDetails": { "UsageInstructions": "{{your-usage-instructions}}" } } } ] } } ] ``` 1. Enregistrez le fichier du changeset sous son nom`updateVersionInfo.json`. 1. Dans votre terminal ou AWS CloudShell exécutez la commande suivante : ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json ``` La `start-change-set` commande renverra une `ChangeSetId` valeur. Pour surveiller un ensemble de modifications, voir[Surveillance d'un ensemble de modifications](#monitor-changeset). ## Restreindre la version d'un composant du produit Image Builder Le fait de restreindre une version la rend indisponible pour les acheteurs. Vous pouvez limiter l' AWS Marketplace utilisation de l'API AWS Marketplace Catalog à une version de votre composant Image Builder. Vous devez conserver au moins une version de votre produit sans restriction AWS Marketplace. Vous ne pouvez pas restreindre l'accès à la seule version publique. **Pour mettre à jour les informations relatives à une version existante** 1. À partir du Portail de gestion AWS Marketplace, obtenez l'identifiant du produit. 1. Ouvrez le [Portail de gestion AWS Marketplace](https://aws.amazon.com/marketplace/management/tour/)et connectez-vous à votre compte vendeur. 1. Dans le menu **Produits**, sélectionnez **Serveur**. 1. Sur la page **des produits du serveur**, sélectionnez le produit. 1. Dans le **résumé du produit**, copiez l'**identifiant du produit**. 1. Dans votre terminal, exécutez la commande suivante. Dans la commande, remplacez par {{your-product-ID}} l'identifiant que vous avez obtenu à l'étape 1. ``` aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}' ``` 1. Dans le résultat renvoyé, passez à la `Versions` section`DetailsDocument`,. Copiez la `Id` valeur`DeliveryOptions`, pour la version que vous souhaitez mettre à jour. 1. À l'aide de l'exemple de code suivant, créez un fichier d'ensemble de modifications au format JSON. Dans l'exemple, remplacez-le {{your-product-ID}} par l'identifiant du produit que vous avez obtenu à l'étape 1. {{your-delivery-option-ID}}Remplacez-le par l'identifiant de l'option de livraison que vous avez obtenue à l'étape 3. ``` [ { "ChangeType": "RestrictDeliveryOptions", "Entity": { "Identifier": "{{your-product-ID}}", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "DeliveryOptionIds": [ "{{your-delivery-option-ID}}" ] } } ] ``` 1. Enregistrez le fichier du changeset sous son nom`restrictec2ibversion.json`. 1. Dans votre terminal ou AWS CloudShell exécutez la commande suivante : ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json ``` La `start-change-set` commande renverra une `ChangeSetId` valeur. Pour surveiller un ensemble de modifications, voir[Surveillance d'un ensemble de modifications](#monitor-changeset). ## Surveillance d'un ensemble de modifications La `start-change-set` commande renverra une `ChangeSetId` valeur. Vous pouvez suivre la progression de l'ensemble de modifications de la manière suivante : + Exécutez la commande suivante dans votre terminal. Dans la commande, remplacez {{changeset-ID}} par la `ChangeSetId` valeur renvoyée par la `start-change-set` commande. ``` aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id {{changesetID}} ``` + Consultez le statut de la demande dans l'onglet **Demandes** du [portail AWS Marketplace de gestion](https://aws.amazon.com/marketplace/management/). ## Sécurisation des téléchargements de logiciels Pour protéger la propriété intellectuelle des logiciels ISV et garantir une livraison stable et cohérente des logiciels aux AWS Marketplace acheteurs, analysez `S3Download` et `WebDownload` actionnez AWS Marketplace automatiquement les modules dans votre composant. Les fichiers référencés sont ensuite stockés de manière sécurisée dans un compartiment Amazon S3 privé géré par AWS Marketplace. Pour vous désinscrire de ce processus d'ingestion et gérer les téléchargements de logiciels de manière indépendante, exécutez des scripts bash utilisant les commandes `wget` ou `curl` download.