AWS CLI est un outil puissant basé sur des commandes pour un accès et une gestion faciles des services AWS. Avec cet utilitaire, les utilisateurs peuvent directement communiquer, configurer, automatiser, télécharger ou manipuler les ressources. Comme son nom l'indique, il fonctionne sur des commandes qui acceptent différents indicateurs. Une de ces commandes est la « décrire les sous-réseaux » commande dans AWS CLI.
Aperçu rapide
Cet article couvre les aspects suivants :
- Qu'est-ce que la commande décrire-subnet dans l'AWS CLI ?
- Comment utiliser la commande décrire-subnet dans AWS CLI ?
- Conclusion
Avant de comprendre le « décrire les sous-réseaux » commande, comprenons d’abord le concept des VPC. Dans AWS, le Cloud privé virtuel (VPC) est un réseau de ressources mondiales qui offre le contrôle et la gestion complets des réseaux, des ressources et de la connectivité à ses utilisateurs. Au sein du VPC, il existe différents sous-réseaux. UN sous-réseau est une large gamme d’adresses IP. Après avoir configuré un VPC, l'utilisateur peut ajouter des ressources, par exemple des instances EC2, des bases de données relationnelles, etc. Ces ressources seront accessibles globalement avec les adresses IP attribuées à partir des sous-réseaux du VPC.
En savoir plus: Comment utiliser VPC | Premiers pas avec AWS
Qu'est-ce que la commande « describe-subnets » dans l'AWS CLI ?
Le « décrire les sous-réseaux » La commande répertorie tous les sous-réseaux pour un compte donné. Il prend en charge la pagination par défaut qui peut être désactivée en utilisant le '–pas de pagination' drapeau. Le « décrire les sous-réseaux » La commande dans l'AWS CLI émet plusieurs appels d'API au service pour récupérer les données lorsque la pagination est activée.
En savoir plus: Comment désactiver la page dans AWS CLI ?
Comment utiliser la commande « describe-subnets » dans AWS CLI ?
Plusieurs options sont disponibles pour filtrer, interroger, spécifier des sous-réseaux ou afficher des données dans différents formats de sortie. Cette commande est couramment utilisée avec l'instance EC2.
Syntaxe
La syntaxe de la commande est la suivante :
aws ec2 décrit les sous-réseaux < Possibilités >
Possibilités
Vous trouverez ci-dessous une brève description des options pour le « décrire les sous-réseaux » commande:
| Possibilités | Description |
| –filtres | L'option –filters est utilisée pour extraire les détails spécifiques des données. Voici les différents types de filtres pris en charge par le « décrire les sous-réseaux » commande:
– zone de disponibilité : Cette option permet de filtrer à l'aide de la zone de disponibilité du sous-réseau. – ID de zone de disponibilité : Il fait référence à l’ID de la zone de disponibilité. – Disponibilité-adresse-IP-compte : Le nombre d'adresses IPv4 disponibles. – Bloc CIDR : Cette option fait référence au bloc CIDR IPV4. Le bloc CIDR fourni par l’utilisateur doit correspondre exactement à celui d’un sous-réseau. – Identifiant du propriétaire : L'ID de compte du propriétaire du sous-réseau – étiqueter: Les paires clé-valeur qui forment une balise peuvent également être utilisées comme type de filtre pour extraire des résultats spécifiques.
Plusieurs types de filtres sont également disponibles. Pour en savoir plus à leur sujet, reportez-vous au Documentation AWS. |
| –identifiants de sous-réseau | Ce paramètre saisit l’ID d’un sous-réseau spécifique à répertorier. |
| –essai à sec | Ce paramètre vérifie si l'utilisateur a l'autorisation pour les actions ou non. La sortie est au format d'erreur. Si l'utilisateur dispose de l'autorisation requise, la sortie contiendra le «Opération DryRun» . D'un autre côté, si l'utilisateur ne contient aucune autorisation pour l'action, la sortie contiendra le 'Opération non autorisée' . Pour désactiver cette fonctionnalité, utilisez le «–pas de fonctionnement à sec» option. |
| –cli-input-json | Le –cli-input-json est utilisé pour fournir plusieurs instructions JSON à la fois au service AWS. Les instructions sont fournies au format JSON qui est généré par le '–générer-cli-squelette' paramètre. |
| –jeton de départ | Le paramètre accepte la valeur du Jeton suivant paramètre. Il est de type chaîne et le NextToken est généré lorsqu'il y a plus de données à lister. La valeur du NextToken fournie dans ce champ spécifiera où commencer la pagination. |
| -taille de la page | Ce paramètre spécifie la taille de page qui doit être utilisée dans chaque appel de service AWS. Une taille de page plus petite entraîne davantage d’appels d’API vers le service. Cela évite l'expiration du délai en récupérant moins de données à chaque appel de service. |
| –max-articles | Le paramètre –max-items affiche des données limitées par réponse. S'il y a plus de données à lister, la sortie de la commande contiendra le « Jeton suivant » valeur qui reprendra le listing des données lorsque la commande sera à nouveau exécutée. |
| –générer-cli-squelette | Ce paramètre est utilisé pour créer le squelette ou le modèle JSON pour que plusieurs instructions soient données en même temps. Ce modèle est utilisé par le paramètre –cli-input-json. |
Il existe également des options globales disponibles qui peuvent être utilisées avec « décrire les sous-réseaux » commande. Les options globales sont les options qui peuvent être utilisées avec plusieurs commandes de l'AWS CLI. Pour en savoir plus sur ces options, reportez-vous au Documentation AWS .
Exemples
Cette section de l'article démontre l'utilisation de ces drapeaux avec le « décrire les sous-réseaux » commande:
- Exemple 1 : Comment décrire tous les sous-réseaux à l'aide de la commande « describe-subnets » ?
- Exemple 2 : Comment décrire un sous-réseau spécifique via la commande « describe-subnets » ?
- Exemple 3 : Comment filtrer les détails d'un sous-réseau via la commande « describe-subnets » ?
- Exemple 4 : Comment déterminer les autorisations via la commande « describe-subnets » ?
- Exemple 5 : Comment afficher la sortie dans plusieurs formats à l'aide de la commande « describe-subnets » ?
- Exemple 6 : Comment répertorier un nombre limité de sous-réseaux via la commande « describe-subnets » ?
- Exemple 7 : Comment interroger les détails spécifiques d'un sous-réseau via les commandes « describe-subnets » ?
- Exemple 8 : Comment répertorier les balises de sous-réseau à l'aide de la commande « describe-subnet » ?
Exemple 1 : Comment décrire tous les sous-réseaux à l'aide de la commande « describe-subnets » ?
Pour lister tous les sous-réseaux d'un compte donné, utilisez la commande suivante :
aws ec2 décrit les sous-réseaux
Sortir
Exemple 2 : Comment décrire un sous-réseau spécifique via la commande « describe-subnets » ?
Pour acquérir l'ID de sous-réseau de votre instance EC2, cliquez sur l'instance EC2 depuis votre tableau de bord. Cela affichera la configuration de l'instance EC2. Clique sur le 'La mise en réseau' de l'interface affichée. Au sein du 'Détails du réseau' section, copiez l'ID de sous-réseau à partir de la « ID de sous-réseau » champ:
Pour lister un sous-réseau particulier, la commande est donnée comme suit :
aws ec2 décrit les sous-réseaux --identifiants de sous-réseau < sous-réseau >
Remplace le
Sortir
Exemple 3 : Comment filtrer les détails d'un sous-réseau via la commande « describe-subnets » ?
Différents filtres sont disponibles pour filtrer les sous-réseaux, c'est-à-dire zones de disponibilité, ID de propriétaire, bloc CIDR, etc. Pour déterminer la zone de disponibilité de votre instance EC2, cliquez sur le nom de l'instance dans le tableau de bord EC2. Cela affichera les configurations de l'instance EC2 dans le 'La mise en réseau' languette. À partir de cet onglet, localisez le « Zone de disponibilité » et copiez l'ID de celui-ci :
À filtrer les sous-réseaux en fonction de la zone de disponibilité , la commande est donnée ci-dessous :
aws ec2 décrit les sous-réseaux --filtres 'Nom=zone de disponibilité, Valeurs=ap-southeast-1b'
Remplacez la valeur ' ap-sud-est-1b » avec le nom de la zone de disponibilité copié.
Sortir
L'ID de compte AWS peut être déterminé en cliquant sur le nom d'utilisateur dans le coin supérieur droit. Copiez l'ID de compte en cliquant sur le 'copie' dans la liste déroulante pour copier l'ID du compte :
Similaire à filtrer les sous-réseaux en fonction de l'ID de compte de l'utilisateur, la commande suivante est utilisée :
aws ec2 décrit les sous-réseaux --filtres 'Nom=ID-propriétaire, Valeurs=
Remplace le «
Sortir
Le résultat de la commande est le suivant :
Exemple 4 : Comment déterminer les autorisations via la commande « describe-subnets » ?
Pour déterminer les autorisations pour un sous-réseau spécifique, le – essai à sec est utilisée. Ce champ suit le format d'erreur et est utilisé de la manière suivante :
aws ec2 décrit les sous-réseaux --essai à sec
Sortir
Le résultat de la commande est le suivant :
En revanche, si l'utilisateur souhaite désactiver cette option et lister tous les équilibreurs de charge, utilisez la commande suivante :
aws ec2 décrit les sous-réseaux --pas de fonctionnement à sec
Sortir
Le résultat de la commande est le suivant :
Exemple 5 : Comment afficher la sortie dans plusieurs formats à l'aide de la commande « describe-subnets » ?
Plusieurs formats de sortie sont pris en charge par le décrire les sous-réseaux commande d'AWS. Ceux-ci incluent JSON, YAML ou texte. L'utilisateur peut simplement remplacer la valeur du champ –output :
aws ec2 décrit les sous-réseaux --sortir tableau
Remplace le tableau valeur dans le -sortir champ avec différents formats de sortie, c'est-à-dire JSON, YAML ou texte.
Sortir
Le résultat de la commande est le suivant :
Exemple 6 : Comment lister un nombre limité de sous-réseaux via la commande « describe-subnets » ?
Le –max-items est utilisé pour limiter le nombre de sous-réseaux dans une seule réponse :
aws ec2 décrit les sous-réseaux --max-articles 1
Remplacez la valeur « 1 » par n'importe quelle valeur numérique de votre choix entre 1 et 1 000.
Sortir
Le résultat de la commande est le suivant :
Fournissez la valeur du NextToken de la sortie au –jeton de départ . Ce jeton reprendra la liste des données à partir du prochain équilibreur de charge :
aws ec2 décrit les sous-réseaux --jeton de départ < Jeton suivant >
Remplacez
Sortir
Le résultat du code est le suivant :
Exemple 7 : Comment interroger les détails spécifiques d'un sous-réseau via la commande « describe-subnet » ?
La sortie du « décrire les sous-réseaux » La commande consiste en un tableau de sous-réseaux. Pour extraire les informations spécifiques du tableau Subnet, la commande suivante est utilisée :
aws ec2 décrit les sous-réseaux --requête 'Sous-réseaux[*].SubnetId'
Sortir
Le résultat de la commande est le suivant :
Exemple 8 : Comment répertorier les balises de sous-réseau à l'aide de la commande « describe-subnets » ?
Une autre méthode de filtrage des sous-réseaux consiste à utiliser les balises. Une balise est une paire de clés clé-valeur. 59 balises peuvent être associées à une seule ressource AWS. Pour déterminer la clé d'un sous-réseau, visitez le 'VPC' service en le recherchant dans la barre de recherche d'AWS Management Console. Cliquez sur l'option « Sous-réseau » dans le tableau de bord du service VPC :
Du Sous-réseaux tableau de bord, sélectionnez un sous-réseau. Cela affichera ses configurations. Clique le 'Mots clés' et copiez le nom et la valeur sous l'onglet 'Clé' et 'Valeur' des champs:
La commande suivante est utilisée pour filtrer les sous-réseaux par balises :
aws ec2 décrit les sous-réseaux --filtres 'Nom=tag :
Remplacer la valeur '
Sortir
Le résultat de la commande est le suivant :
C'est tout de ce guide.
Conclusion
Pour répertorier les sous-réseaux dans l'AWS CLI, utilisez l'outil « décrire les sous-réseaux » commande. Il décrit tous les sous-réseaux ou des sous-réseaux spécifiques dans un VPC et accepte plusieurs options pour des actions distinctes. Pour les utilisateurs AWS, le « décrire les sous-réseaux » La commande peut aider à configurer et à dépanner le réseau. Pour utiliser cette commande, configurez l'AWS CLI et fournissez les commandes ci-dessus au terminal. Cet article est une démonstration étape par étape de l'utilisation de décrire les sous-réseaux commande dans AWS CLI.