Image de la machine Amazon est un modèle utilisé pour lancer les instances EC2. Une AMI est similaire à un modèle qui contient un système d'exploitation et tous les logiciels ou configurations d'application nécessaires pour les instances. Les AMI peuvent être prédéfinies ou gérées sur mesure. AWS CLI est un utilitaire puissant permettant d'accéder et de gérer des images via des commandes simples telles que « décrire-images » commande. Le « décrire-images » La commande est utilisée pour lister toutes les AMI configurées pour un compte donné.
Aperçu rapide
Dans cet article, nous découvrirons :
- Qu'est-ce que la commande « describe-images » dans l'AWS CLI ?
- Comment utiliser la commande « describe-images » dans AWS CLI ?
- Conclusion
Qu'est-ce que la commande « describe-images » dans l'AWS CLI ?
Le « décrire-images » La commande dans AWS CLI est une opération paginée utilisée pour répertorier toutes les AMI ou des AMI spécifiques au sein d'un compte. La sortie du « décrire-images » La commande se présente sous forme de liste qui contient des informations sur diverses images. Ces images peuvent être publiques, privées, définies par l'utilisateur ou gérées par AWS. Les données de l'AMI sont accessibles dans plusieurs appels d'API au service lorsque la pagination est activée.
En savoir plus: Comment désactiver la page dans AWS CLI ?
Comment utiliser la commande « describe-images » dans AWS CLI ?
Les images désenregistrées sont celles qui sont supprimées d'AWS et ne sont plus prises en charge par le service EC2 et la plateforme. Cependant, ces images sont également incluses dans la sortie du « décrire-images » commande. L'utilisateur peut contrôler la sortie de la commande en filtrant, en interrogeant ou en spécifiant une AMI particulière, etc. via plusieurs paramètres différents.
Syntaxe
La syntaxe du « décrire-images » la commande est donnée comme suit :
aws ec2 décrire-images < Possibilités >
Possibilités
Voici une brève description des options de la commande mentionnée ci-dessus :
| Option | Descriptions |
| –utilisateurs-exécutables | Ce paramètre est utilisé pour extraire et lister les AMI en fonction des autorisations de l'utilisateur. L'utilisateur peut spécifier « soi », « tous » ou l'identifiant du compte AWS. |
| –filtres | Le paramètre –filters est utilisé pour répertorier des détails spécifiques ou des AMI dans la sortie. Il existe différents types de filtres pris en charge par cette commande : – nom: L'utilisateur peut filtrer les AMI en spécifiant le nom. – identifiant du propriétaire : L'ID de compte AWS peut également filtrer les AMI en décrivant uniquement les images configurées dans un compte spécifique. – étiqueter: Les balises sont la combinaison des paires clé-valeur. En spécifiant les balises, un utilisateur peut facilement filtrer les AMI pour un compte donné. – identifiant de l'image : Une autre méthode de filtrage des AMI consiste à spécifier l'ID de l'image. Cela répertoriera uniquement une AMI spécifique. |
| –identifiants d'image | Ce paramètre saisit l'ID de l'AMI. |
| -les propriétaires | Le paramètre –owner accepte les options d'ID de compte, self, amazon ou aws-marketplace. Ces options répertorieront uniquement les AMI qui correspondent exactement à l'option spécifiée. |
| –include-obsolète | Ce paramètre est utilisé pour spécifier s'il faut ou non lister les AMI obsolètes. Les AMI obsolètes sont les images dont l'utilisation n'est plus recommandée. |
| –inclure-désactivé | Ce champ spécifie s'il faut ou non répertorier les AMI désactivées dans la sortie. |
| –essai à sec | Le paramètre –dry-run est utilisé pour déterminer si l'utilisateur a l'autorisation pour l'action souhaitée ou non. Il renvoie la sortie au format Erreur. De plus, si l'utilisateur dispose des autorisations, la sortie contiendra le « DryRunOperation ». Si l'utilisateur ne dispose pas de cette autorisation, il renverra « UnauthorizedOperation » dans la sortie. |
| –cli-input-json | Ce paramètre est utilisé pour fournir plusieurs instructions JSON à la fois sous la forme d'un modèle pour les services AWS. Le modèle suivi est généré par le paramètre « –generate-cli-skeleton ». |
| –jeton de départ | Ce paramètre saisit la valeur du champ « NextToken » à partir de la sortie. Le NextToken symbolise qu'il y a plus de données à lister. Lorsque la valeur du NextToken est fournie au –starting-token, il commencera à répertorier les données de la réponse précédente. |
| -taille de la page | Ce paramètre définit la taille de la page dans chaque appel de service AWS. Une taille de page plus petite entraîne davantage d'appels d'API qui empêchent l'erreur de délai d'attente. Cependant, il récupère moins de données à chaque appel. |
| –max-articles | Le paramètre –max-items est utilisé pour limiter le nombre d'entrées à afficher dans la sortie. |
| –générer-cli-squelette | Il génère un squelette ou un modèle qui doit être suivi lors de la fourniture simultanée de plusieurs instructions au service AWS. |
Outre ces options, il existe également des options globales fournies par AWS. Les options globales sont communes à la commande AWS CLI et peuvent être utilisées avec différentes commandes. Le Documentation AWS discute de diverses options globales.
Exemples
Cette section de l'article présente divers exemples de « décrire-images » commande dans AWS CLI :
- Exemple 1 : Comment décrire des images dans AWS CLI ?
- Exemple 2 : Comment décrire toutes les images dans AWS CLI ?
- Exemple 3 : Comment décrire l'AMI par ID de propriétaire dans AWS CLI ?
- Exemple 4 : Comment filtrer les images dans AWS CLI ?
- Exemple 5 : Comment interroger l'AMI dans AWS CLI ?
- Exemple 6 : Comment décrire les images obsolètes dans AWS CLI ?
- Exemple 7 : Comment décrire les images activées ou désactivées dans AWS CLI ?
- Exemple 8 : Comment décrire des images dans plusieurs formats de sortie ?
Exemple 1 : Comment décrire des images dans AWS CLI ?
Le « décrire-images » La commande dans AWS CLI est utilisée pour répertorier les détails d'une AMI spécifique pour un compte donné. Cette commande nécessite l'ID d'image de l'AMI. Visitez le service EC2 et cliquez sur le 'LEQUEL' option dans le volet de navigation de gauche. Sélectionnez l’image créée et elle affichera les configurations de l’image. Au sein du Détails section, copiez et enregistrez l'ID AMI :
La commande pour lister une AMI spécifique est donnée comme suit :
aws ec2 décrire-images --région ap-sud-est- 1 --image-ids < AMIImageID >
Remplace le
Sortir
Exemple 2 : Comment décrire toutes les images dans AWS CLI ?
La commande pour répertorier toutes les images disponibles dans AWS CLI est la suivante :
aws ec2 décrire-images
Sortir
Cela prendra un certain temps pour afficher une liste de toutes les images. Continuez à appuyer sur le 'Entrer' touche du clavier pour visualiser les détails de toutes les images :
Exemple 3 : Comment décrire l'AMI par ID de propriétaire dans AWS CLI ?
Les AMI configurées dans un compte AWS peuvent également être déterminées par le propriétaire ou l'ID du compte. L'ID de compte peut être déterminé en cliquant sur le nom d'utilisateur dans le coin supérieur droit d'AWS Management Console. Clique le 'copie' icône pour copier l'ID du compte :
La commande est personnalisée avec un paramètre supplémentaire de la manière suivante :
aws ec2 décrire-images --les propriétaires < Identifiant de compte >
Remplace le
Sortir
Exemple 4 : Comment filtrer les images dans AWS CLI ?
Différents filtres sont disponibles pour extraire des détails spécifiques de l'image. L'utilisateur peut filtrer les images par ID de propriétaire, ID d'image, balises, nom ou statut, etc. Pour répertorier une image par son nom, la commande suivante est utilisée :
aws ec2 décrire-images --filtres 'Nom=nom, Valeurs=ec2image'
Remplace le “ec2image” dans Valeurs avec le nom de votre AMI.
Sortir
La valeur des paires clé-valeur de la balise d'une AMI peut être déterminée en sélectionnant l'AMI dans le tableau de bord de l'AMI. Cela affichera les configurations de l’image. Appuyez sur le 'Mots clés' et copiez la valeur des champs clé-valeur :
Pour filtrer une image par ses balises, la commande est donnée ci-dessous :
aws ec2 décrire-images --filtres 'Nom=tag:firstkey, Values=first'
Remplace le 'première clé' dans le champ Nom avec la clé. De même, remplacez le 'd'abord' dans Valeurs avec la valeur de la balise.
Sortir
Exemple 5 : Comment interroger l'AMI dans AWS CLI ?
L'utilisateur peut extraire des détails spécifiques d'une image de la liste affichée en utilisant le '-requête' paramètre. La commande est donnée comme suit :
aws ec2 décrire-images --requête 'Images[*].[IdImage]'
Sortir
De même, l'utilisateur peut également interroger des détails particuliers d'une image en spécifiant l'identifiant de l'image avec le paramètre de requête :
aws ec2 décrire-images --id-image < AMII > --requête 'Image[*].[Type d'image, Description, État]'
Sortir
Exemple 6 : Comment décrire les images obsolètes dans AWS CLI ?
Les AMI obsolètes sont les images dont l'utilisation n'est plus recommandée par AWS. Pour déterminer quelles images sont obsolètes, utilisez la commande suivante :
aws ec2 décrire-images --include-obsolète
Sortir
De même, l'utilisateur peut également spécifier le «–no-include-obsolète» paramètre pour lister toutes les images, y compris celles obsolètes :
aws ec2 décrire-images --no-include-obsolète
Sortir
Exemple 7 : Comment décrire les images activées ou désactivées dans AWS CLI ?
Le « décrire-images » La commande peut également être utilisée pour répertorier les images désactivées ou non pour le compte. Cela aidera les utilisateurs à déterminer quelles AMI utiliser. La commande ci-dessous est utilisée pour lister les AMI désactivées pour le compte :
aws ec2 décrire-images --include-disabled
Sortir
De même, le « décrire-images » La commande renvoie uniquement les AMI qui ne sont pas désactivées pour un compte donné. Pour cela, utilisez la commande ci-dessous :
aws ec2 décrire-images --no-include-disabled
Sortir
Exemple 8 : Comment décrire des images dans plusieurs formats de sortie ?
Il existe plusieurs formats de sortie pris en charge par le « décrire-images » commande. Les formats incluent YAML, JSON, texte ou tableau. Vous trouverez ci-dessous la commande permettant de décrire les images au format tabulaire :
aws ec2 décrire-images --sortir tableau
Remplace le 'tableau' valeur dans le champ de sortie avec un format de sortie différent de votre choix tel que JSON, YAML ou texte.
Sortir
Presse 'Entrer' depuis le clavier pour continuer à lister les données :
Conclusion
Le « décrire-images » La commande dans AWS renvoie une liste de toutes les AMI ou de certaines AMI pour un compte donné. Il accepte des paramètres facultatifs, par exemple –query, –output, etc. « décrire-images » La commande est utile pour les développeurs AWS car elle les aide à comprendre et à choisir entre différentes AMI pour leurs applications. Avant d'utiliser le « décrire-images » , assurez-vous que l'AWS CLI est configurée sur vos machines locales, puis fournissez les commandes mentionnées au terminal. Cet article fournit une compréhension approfondie de « décrire-images » commande avec plusieurs exemples pour discuter de ses différents paramètres.