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.
AMI | Partagez
Partagez une AMI avec plusieurs comptes AMS ou unités organisationnelles (OUs).
Classification complète : Gestion | Composants de pile avancés | AMI | Partager
Détails du type de modification
Modifier l'identifiant du type |
ct-1eiczxw8ihc18 |
Version actuelle |
2.0 |
Durée d'exécution prévue |
60 minutes |
Approbation AWS |
Obligatoire |
Approbation du client |
Facultatif |
Mode d'exécution |
Automatisé |
Informations supplémentaires
Partagez AMIs
Ce qui suit montre ce type de modification dans la console AMS.
Comment cela fonctionne :
Accédez à la page Créer une RFC : Dans le volet de navigation de gauche de la console AMS, cliquez RFCspour ouvrir la page de RFCs liste, puis cliquez sur Créer une RFC.
Choisissez un type de modification (CT) populaire dans la vue Parcourir les types de modification par défaut, ou sélectionnez un CT dans la vue Choisir par catégorie.
Parcourir par type de modification : vous pouvez cliquer sur un CT populaire dans la zone de création rapide pour ouvrir immédiatement la page Run RFC. Notez que vous ne pouvez pas choisir une ancienne version CT avec création rapide.
Pour trier CTs, utilisez la zone Tous les types de modifications dans l'affichage Carte ou Tableau. Dans l'une ou l'autre vue, sélectionnez un CT, puis cliquez sur Créer une RFC pour ouvrir la page Exécuter une RFC. Le cas échéant, une option Créer avec une ancienne version apparaît à côté du bouton Créer une RFC.
Choisissez par catégorie : sélectionnez une catégorie, une sous-catégorie, un article et une opération et la zone de détails du CT s'ouvre avec une option permettant de créer avec une ancienne version, le cas échéant. Cliquez sur Créer une RFC pour ouvrir la page Exécuter une RFC.
Sur la page Run RFC, ouvrez la zone de nom du CT pour voir la boîte de détails du CT. Un sujet est requis (il est renseigné pour vous si vous choisissez votre CT dans la vue Parcourir les types de modification). Ouvrez la zone de configuration supplémentaire pour ajouter des informations sur le RFC.
Dans la zone Configuration de l'exécution, utilisez les listes déroulantes disponibles ou entrez des valeurs pour les paramètres requis. Pour configurer les paramètres d'exécution facultatifs, ouvrez la zone de configuration supplémentaire.
Lorsque vous avez terminé, cliquez sur Exécuter. S'il n'y a aucune erreur, la page RFC créée avec succès s'affiche avec les détails de la RFC soumise et le résultat d'exécution initial.
Ouvrez la zone Paramètres d'exécution pour voir les configurations que vous avez soumises. Actualisez la page pour mettre à jour l'état d'exécution de la RFC. Vous pouvez éventuellement annuler la RFC ou en créer une copie à l'aide des options en haut de la page.
Comment cela fonctionne :
Utilisez soit le Inline Create (vous émettez une
create-rfccommande avec tous les paramètres RFC et d'exécution inclus), soit le Template Create (vous créez deux fichiers JSON, un pour les paramètres RFC et un pour les paramètres d'exécution) et émettez lacreate-rfccommande avec les deux fichiers en entrée. Les deux méthodes sont décrites ici.Soumettez la
aws amscm submit-rfc --rfc-idcommande RFC : avec l'ID RFC renvoyé.IDSurveillez la
aws amscm get-rfc --rfc-idcommande RFC :.ID
Pour vérifier la version du type de modification, utilisez cette commande :
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
Note
Vous pouvez utiliser n'importe quel CreateRfc paramètre avec n'importe quelle RFC, qu'ils fassent ou non partie du schéma du type de modification. Par exemple, pour recevoir des notifications lorsque le statut de la RFC change, ajoutez cette ligne --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" aux paramètres RFC de la demande (et non aux paramètres d'exécution). Pour obtenir la liste de tous les CreateRfc paramètres, consultez le manuel AMS Change Management API Reference.
CRÉATION EN LIGNE :
Émettez la commande create RFC avec les paramètres d'exécution fournis en ligne (évitez les guillemets lorsque vous fournissez des paramètres d'exécution en ligne), puis soumettez l'ID RFC renvoyé. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :
aws amscm create-rfc --change-type-id "ct-1eiczxw8ihc18" --change-type-version "2.0" --title "Share AMI" --execution-parameters "{ \"DocumentName\": \"AWSManagedServices-ShareAMI\", \"Region\": \"us-east-1\", \"Parameters\": { \"ImageId\": \"amiid\" , \"OrganizationalUnitARNs\": \"ouarn\" } }"
CRÉATION D'UN MODÈLE :
Afficher le schéma JSON des paramètres d'exécution pour ce type de modification dans un fichier ; cet exemple le nomme ShareAmiParams .json :
aws amscm get-change-type-version --change-type-id "ct-1eiczxw8ihc18" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > ShareAmiParams.jsonModifiez et enregistrez le fichier JSON des paramètres d'exécution. Le JSON pour les seuls paramètres requis et pour tous les paramètres est affiché. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :
Seuls les paramètres nécessaires sont les suivants :
{ "DocumentName": "AWSManagedServices-ShareAMI", "Region": "us-east-1", "Parameters": { "ImageId": "amiid" } }Tous les paramètres :
{ "DocumentName": "AWSManagedServices-ShareAMI", "Region": "us-east-1", "Parameters": { "AccountIds": "awsaccountid", "ImageId": "amiid", "OrganizationalUnitARNs": "ouarn", "ShareSnapshots": "false" } }Sortez le fichier JSON du modèle RFC ; cet exemple le nomme ShareAmiRfc .json :
aws amscm create-rfc --generate-cli-skeleton > ShareAmiRfc.jsonModifiez et enregistrez le fichier ShareAmiRfc .json. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :
{ "ChangeTypeVersion": "2.0", "ChangeTypeId": "ct-1eiczxw8ihc18", "Title": "Share" }Créez la RFC en spécifiant le ShareAmiRfc fichier et le ShareAmiParams fichier :
aws amscm create-rfc --cli-input-json file://ShareAmiRfc.json --execution-parameters file://ShareAmiParams.jsonVous recevez l'identifiant de la nouvelle RFC dans la réponse et vous pouvez l'utiliser pour soumettre et surveiller la RFC. Tant que vous ne l'avez pas soumise, la RFC reste en cours d'édition et ne démarre pas.
Une AMI AMS ne peut pas être partagée avec un compte non-AMS. Ce type de modification copie une AMI de la région AWS source vers la même région dans le compte de destination. Vous devez être intégré à AMS dans la région AWS de destination de la région spécifiée TargetAwsAccountId, sinon l'AMI partagée sera inutilisable dans le compte cible.
En outre, le chiffrement ne AMIs peut pas être partagé entre les comptes sans l'intervention de l'administrateur AD et d'un ingénieur des opérations AMS. Pour ce faire, déposez un dossier Management | Other | Other | Create (ct-1e1xtak34nx76) auprès d'AMS avec l'ID AMI, les informations du compte et tous les détails.
Ce type de modification est désormais disponible en version 2.0.
Important
Lorsque vous partagez une AMI personnalisée que vous avez créée à partir d'une instance de votre compte AMS, assurez-vous que l'AMI est utilisable dans le nouveau compte. En particulier, l'instance utilisée pour créer l'AMI doit avoir été séparée de son domaine. Pour de plus amples informations, veuillez consulter Créer une AMI.
Pour en savoir plus sur le partage AMIs, consultez Partage d'une AMI avec des comptes AWS spécifiques.
Paramètres d'entrée d'exécution
Pour des informations détaillées sur les paramètres d'entrée d'exécution, consultezSchéma pour le type de modification ct-1eiczxw8ihc18.
Exemple : paramètres obligatoires
{ "DocumentName": "AWSManagedServices-ShareAMI", "Region": "us-east-1", "Parameters": { "ImageId": "ami-12345678" } }
Exemple : tous les paramètres
{ "DocumentName": "AWSManagedServices-ShareAMI", "Region": "us-east-1", "Parameters": { "ImageId": "ami-12345678", "AccountIds": "123456789012", "OrganizationalUnitARNs": "arn:aws:organizations::111111111111:organization/o-rkw1234jc5", "ShareSnapshots": true } }