CLI ModifyInstanceAttributeで使用する

以下のコード例は、ModifyInstanceAttribute の使用方法を示しています。

CLI

AWS CLI

例 1: インスタンスタイプを変更するには

次のmodify-instance-attribute例では、指定されたインスタンスのインスタンスタイプを変更します。インスタンスは stopped の状態である必要があります。

aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --instance-type "{\"Value\": \"m1.small\"}"

このコマンドでは何も出力されません。

例 2: インスタンスで拡張ネットワーキングを有効にするには

次のmodify-instance-attribute例では、指定されたインスタンスの拡張ネットワーキングを有効にします。インスタンスは stopped の状態である必要があります。

aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --sriov-net-support simple

このコマンドでは何も出力されません。

例 3: sourceDestCheck 属性を変更するには

次のmodify-instance-attribute例では、指定されたインスタンスの sourceDestCheck 属性を に設定しますtrue。インスタンスは VPC にある必要があります。

aws ec2 modify-instance-attribute --instance-id i-1234567890abcdef0 --source-dest-check "{\"Value\": true}"

このコマンドでは何も出力されません。

例 4: ルートボリュームの deleteOnTermination 属性を変更するには

次のmodify-instance-attribute例では、指定された Amazon EBS-backed インスタンスのルートボリュームの deleteOnTermination 属性を に設定しますfalse。デフォルトでは、この属性はルートボリュームtrue用です。

コマンド:

aws ec2 modify-instance-attribute \
  --instance-id i-1234567890abcdef0 \
  --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"DeleteOnTermination\":false}}]"

このコマンドでは何も出力されません。

例 5: インスタンスにアタッチされたユーザーデータを変更するには

次のmodify-instance-attribute例では、指定されたインスタンスの UserData UserData.txtとしてファイルの内容を追加します。

元のファイルの内容UserData.txt：

#!/bin/bash
yum update -y
service httpd start
chkconfig httpd on

ファイルの内容は base64 でエンコードされている必要があります。最初のコマンドはテキストファイルを base64 に変換し、新しいファイルとして保存します。

コマンドの Linux/macOS バージョン：

base64 UserData.txt > UserData.base64.txt

このコマンドでは何も出力されません。

コマンドの Windows バージョン：

certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txt

出力:

Input Length = 67
Output Length = 152
CertUtil: -encode command completed successfully.

これで、次の CLI コマンドでそのファイルを参照できるようになりました。

aws ec2 modify-instance-attribute \
    --instance-id=i-09b5a14dbca622e76 \
    --attribute userData --value file://UserData.base64.txt

このコマンドでは何も出力されません。

詳細については、「 AWS CLI ユーザーガイド」の「ユーザーデータ」とEC2」を参照してください。

• API の詳細については、AWS CLI 「 コマンドリファレンス」のModifyInstanceAttribute」を参照してください。

PowerShell

ツール for PowerShell

例 1: この例では、指定されたインスタンスのインスタンスタイプを変更します。

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceType m3.medium

例 2: この例では、「simple」を単一ルート I/O 仮想化 (SR-IOV) ネットワークサポートパラメータ -SriovNetSupport の値として指定することで、指定されたインスタンスの拡張ネットワーキングを有効にします。

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SriovNetSupport "simple"

例 3: この例では、指定されたインスタンスのセキュリティグループを変更します。インスタンスは VPC である必要があります。名前ではなく、各セキュリティグループの ID を指定する必要があります。

Edit-EC2InstanceAttribute -InstanceId i-12345678 -Group @( "sg-12345678", "sg-45678901" )

例 4: この例では、指定したインスタンスの EBS I/O 最適化を有効にします。この機能は、すべてのインスタンスタイプで使用できるわけではありません。EBS 最適化インスタンスを使用する場合、追加の使用料が適用されます。

Edit-EC2InstanceAttribute -InstanceId i-12345678 -EbsOptimized $true

例 5: この例では、指定したインスタンスのソース/宛先チェックを有効にします。NAT インスタンスが NAT を実行するには、値が 'false' である必要があります。

Edit-EC2InstanceAttribute -InstanceId i-12345678 -SourceDestCheck $true

例 6: この例では、指定されたインスタンスの終了を無効にします。

Edit-EC2InstanceAttribute -InstanceId i-12345678 -DisableApiTermination $true

例 7: この例では、インスタンスからシャットダウンが開始されると終了するように、指定されたインスタンスを変更します。

Edit-EC2InstanceAttribute -InstanceId i-12345678 -InstanceInitiatedShutdownBehavior terminate

• API の詳細については、「コマンドレットリファレンス」のModifyInstanceAttribute」を参照してください。 AWS Tools for PowerShell