D’autres exemples de kits AWS SDK sont disponibles dans le référentiel GitHub AWS Doc SDK Examples
Utilisation de ModifyInstanceAttribute avec une CLI
Les exemples de code suivants illustrent comment utiliser ModifyInstanceAttribute.
- CLI
-
- AWS CLI
-
Exemple 1 : pour modifier le type d’instance
L’exemple
modify-instance-attributesuivant modifie le type de l’instance spécifiée. L’instance doit être dans l’étatstopped.aws ec2 modify-instance-attribute \ --instance-idi-1234567890abcdef0\ --instance-type "{\"Value\": \"m1.small\"}"Cette commande ne produit aucun résultat.
Exemple 2 : pour activer la mise en réseau améliorée sur une instance
L’exemple
modify-instance-attributesuivant permet d’améliorer la mise en réseau pour l’instance spécifiée. L’instance doit être dans l’étatstopped.aws ec2 modify-instance-attribute \ --instance-idi-1234567890abcdef0\ --sriov-net-supportsimpleCette commande ne produit aucun résultat.
Exemple 3 : pour modifier l’attribut sourceDestCheck
L’exemple
modify-instance-attributesuivant définit l’attributsourceDestCheckde l’instance spécifiée surtrue. L’instance doit être dans un VPC.aws ec2 modify-instance-attribute --instance-idi-1234567890abcdef0--source-dest-check "{\"Value\": true}"Cette commande ne produit aucun résultat.
Exemple 4 : pour modifier l’attribut deleteOnTermination du volume racine
L’exemple
modify-instance-attributesuivant définit l’attributdeleteOnTerminationdu volume racine de l’instance basée sur Amazon EBS spécifiée surfalse. Par défaut, cet attribut esttruepour le volume racine.Commande :
aws ec2 modify-instance-attribute \ --instance-idi-1234567890abcdef0\ --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"DeleteOnTermination\":false}}]"Cette commande ne produit aucun résultat.
Exemple 5 : pour modifier les données utilisateur attachées à une instance
L’exemple
modify-instance-attributesuivant ajoute le contenu du fichierUserData.txten tant que UserData pour l’instance spécifiée.Contenu du fichier original
UserData.txt:#!/bin/bash yum update -y service httpd start chkconfig httpd onLe contenu du fichier doit être encodé en base64. La première commande convertit le fichier texte en base64 et l’enregistre en tant que nouveau fichier.
Version Linux/macOS de la commande :
base64 UserData.txt > UserData.base64.txtCette commande ne produit aucun résultat.
Version Windows de la commande :
certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txtSortie :
Input Length = 67 Output Length = 152 CertUtil: -encode command completed successfully.Vous pouvez maintenant référencer ce fichier dans la commande CLI suivante :
aws ec2 modify-instance-attribute \ --instance-id=i-09b5a14dbca622e76 \ --attributeuserData--valuefile://UserData.base64.txtCette commande ne produit aucun résultat.
Pour plus d’informations, consultez Données utilisateur et AWS CLI dans le Guide de l’utilisateur Amazon EC2.
-
Pour plus de détails sur l’API, consultez ModifyInstanceAttribute
dans la Référence des commandes de l’AWS CLI.
-
- PowerShell
-
- Outils pour PowerShell V4
-
Exemple 1 : cet exemple modifie le type d’instance de l’instance spécifiée.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.mediumExemple 2 : cet exemple permet d’améliorer la mise en réseau pour l’instance spécifiée, en spécifiant « simple » comme valeur du paramètre de support réseau de virtualisation des E/S à racine unique (SR-IOV), -SriovNetSupport.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"Exemple 3 : cet exemple modifie les groupes de sécurité pour l’instance spécifiée. L’instance doit être dans un VPC. Vous devez spécifier l’ID de chaque groupe de sécurité, et non le nom.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )Exemple 4 : cet exemple active l’optimisation des E/S EBS pour l’instance spécifiée. Cette fonctionnalité n’est pas disponible avec tous les types d’instance. Des frais d’utilisation supplémentaires s’appliquent lorsque vous utilisez une instance optimisée EBS.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $trueExemple 5 : cet exemple active la vérification de la source/de la destination pour l’instance spécifiée. Pour qu’une instance NAT effectue la traduction d’adresses réseau, cette valeur doit être « false ».
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $trueExemple 6 : cet exemple désactive la résiliation pour l’instance spécifiée.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $trueExemple 7 : cet exemple modifie l’instance spécifiée afin qu’elle s’arrête lorsque l’arrêt est lancé à partir de l’instance.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate-
Pour plus de détails sur l’API, consultez ModifyInstanceAttribute dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V4).
-
- Outils pour PowerShell V5
-
Exemple 1 : cet exemple modifie le type d’instance de l’instance spécifiée.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.mediumExemple 2 : cet exemple permet d’améliorer la mise en réseau pour l’instance spécifiée, en spécifiant « simple » comme valeur du paramètre de support réseau de virtualisation des E/S à racine unique (SR-IOV), -SriovNetSupport.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"Exemple 3 : cet exemple modifie les groupes de sécurité pour l’instance spécifiée. L’instance doit être dans un VPC. Vous devez spécifier l’ID de chaque groupe de sécurité, et non le nom.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )Exemple 4 : cet exemple active l’optimisation des E/S EBS pour l’instance spécifiée. Cette fonctionnalité n’est pas disponible avec tous les types d’instance. Des frais d’utilisation supplémentaires s’appliquent lorsque vous utilisez une instance optimisée EBS.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $trueExemple 5 : cet exemple active la vérification de la source/de la destination pour l’instance spécifiée. Pour qu’une instance NAT effectue la traduction d’adresses réseau, cette valeur doit être « false ».
Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $trueExemple 6 : cet exemple désactive la résiliation pour l’instance spécifiée.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $trueExemple 7 : cet exemple modifie l’instance spécifiée afin qu’elle s’arrête lorsque l’arrêt est lancé à partir de l’instance.
Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate-
Pour plus de détails sur l’API, consultez ModifyInstanceAttribute dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V5).
-