Modifiez le type d'EC2instance Amazon à l'aide d'un script bash dans le AWS CLI - AWS Command Line Interface
Avant de commencerÀ propos de cet exempleParamètresDépôt de Références

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.

Modifiez le type d'EC2instance Amazon à l'aide d'un script bash dans le AWS CLI

Cet exemple de script bash pour Amazon EC2 modifie le type d'instance d'une EC2 instance Amazon à l'aide du AWS Command Line Interface ()AWS CLI. Il arrête l'instance si elle est en cours d'exécution, change le type d'instance, puis, sur demande, redémarre l'instance. Les scripts Shell sont des programmes conçus pour être exécutés dans une interface de ligne de commande.

Note

Pour des exemples de commandes supplémentaires, consultez le de référence.

Avant de commencer

Avant de pouvoir exécuter l'un des exemples ci-dessous, vous devez effectuer les opérations suivantes.

  • Installation et configuration de l' AWS CLI. Pour plus d’informations, consultez Installation ou mise à jour vers la dernière version du AWS CLI et Authentification et informations d'accès pour AWS CLI.

  • Le profil que vous utilisez doit disposer d'autorisations autorisant les AWS opérations effectuées dans les exemples.

  • Une EC2 instance Amazon en cours d'exécution dans le compte pour laquelle vous êtes autorisé à arrêter et à modifier. Si vous exécutez le script de test, il lance une instance pour vous, teste la modification du type, puis met fin à l'instance.

  • Il est AWS recommandé d'accorder à ce code le privilège minimal, ou uniquement les autorisations requises pour effectuer une tâche. Pour plus d'informations, consultez la section Grant Least Privilege du guide de l'utilisateur d'AWS Identity and Access Management (IAM).

  • Ce code n'a pas été testé dans toutes les AWS régions. Certains AWS services ne sont disponibles que dans certaines régions. Pour plus d'informations, voir Points de terminaison de service et quotas dans le Guide de référence AWS général.

  • L'exécution de ce code peut entraîner des frais sur votre AWS compte. Il est de votre responsabilité de veiller à ce que toutes les ressources créées par ce script soient supprimées lorsque vous en aurez fini avec elles.

À propos de cet exemple

Cet exemple est écrit sous forme de fonction dans le fichier de script shell change_ec2_instance_type.sh que vous pouvez utiliser source à partir d'un autre script ou de la ligne de commande. Chaque fichier de script contient des commentaires décrivant chacune des fonctions. Une fois que la fonction est en mémoire, vous pouvez l'invoquer depuis la ligne de commande. Par exemple, les commandes suivantes modifient le type de l'instance spécifiée en t2.nano :

$ source ./change_ec2_instance_type.sh
$ ./change_ec2_instance_type -i *instance-id* -t new-type

Pour obtenir l'exemple complet et les fichiers de script téléchargeables, consultez Modifier le type d'EC2instance Amazon dans le référentiel d'exemples de AWS code sur GitHub.

Paramètres

-i - (chaîne) Spécifie l'ID d'instance à modifier.

-t - (string) Spécifie le type d'EC2instance Amazon vers lequel passer.

-r - (switch) Par défaut, ce paramètre n'est pas défini. S'il -r est défini, redémarre l'instance après le changement de type.

-f - (switch) Par défaut, le script invite l'utilisateur à confirmer l'arrêt de l'instance avant de procéder au changement. Si elle -f est définie, la fonction n'invite pas l'utilisateur avant d'arrêter l'instance à changer de type

-v - (switch) Par défaut, le script fonctionne silencieusement et affiche le résultat uniquement en cas d'erreur. Si cette -v option est définie, la fonction affiche son état tout au long de son fonctionnement.

Dépôt de

change_ec2_instance_type.sh

Le fichier de script principal contient la change_ec2_instance_type() fonction qui exécute les tâches suivantes :

  • Vérifie que l'EC2instance Amazon spécifiée existe.

  • À moins que cette option ne -f soit sélectionnée, avertit l'utilisateur avant d'arrêter l'instance.

  • Modifie le type d'instance

  • Si vous définissez-r, redémarre l'instance et confirme qu'elle est en cours d'exécution

Consultez le code correspondant change_ec2_instance_type.sh à GitHub.

test_change_ec2_instance_type.sh

Le test_change_ec2_instance_type.sh script de fichier teste les différents chemins de code de la change_ec2_instance_type fonction. Si toutes les étapes du script de test fonctionnent correctement, le script de test supprime toutes les ressources qu'il a créées.

Vous pouvez exécuter le script de test avec les paramètres suivants :

  • -v - (switch) Chaque test indique un pass/failure status as they run. By default, the tests runs silently and the output includes only the final overall pass/failure état.

  • -i - (switch) Le script s'arrête après chaque test pour vous permettre de parcourir les résultats intermédiaires de chaque étape. Vous permet d'examiner l'état actuel de l'instance à l'aide de la EC2 console Amazon. Le script passe à l'étape suivante une fois que vous avez ENTERappuyé sur l'invite.

Consultez le code correspondant test_change_ec2_instance_type.sh à GitHub.

awsdocs_general.sh

Le fichier de script awsdocs_general.sh contient les fonctions générales utilisées dans les exemples avancés de AWS CLI.

Consultez le code correspondant awsdocs_general.sh à GitHub.

Références

AWS CLI référence :

Autre référence :