搭配使用 ModifyInstanceAttribute 與 CLI

下列程式碼範例示範如何使用 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 支援的執行個體根磁碟區的 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.txt 的內容新增為指定之執行個體的 UserData。

原始檔案 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

此命令不會產生輸出。

如需詳細資訊，請參閱 EC2 AWS 使用者指南中的使用者資料和 CLI。 EC2

• 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》中的 ModifyInstanceAttribute。

PowerShell

Tools for PowerShell V4

範例 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，此值必須為 '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 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》中的 ModifyInstanceAttribute。

Tools for PowerShell V5

範例 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，此值必須為 '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 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》中的 ModifyInstanceAttribute。

如需 AWS SDK 開發人員指南和程式碼範例的完整清單，請參閱 使用 SDK 建立 Amazon EC2 資源 AWS。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。