CreateVolume 搭配 使用 CLI - AWS SDK 程式碼範例

文件範例儲存庫中有更多 AWS SDK可用的範例。 AWS SDK GitHub

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

CreateVolume 搭配 使用 CLI

下列程式碼範例示範如何使用 CreateVolume

CLI
AWS CLI

若要建立空的一般用途 SSD(gp2) 磁碟區

下列create-volume範例會在指定的可用區域中建立 80 GiB 一般用途 SSD(gp2) 磁碟區。請注意,目前區域必須是 us-east-1,或者您可以新增 --region 參數來指定命令的區域。

aws ec2 create-volume \ --volume-type gp2 \ --size 80 \ --availability-zone us-east-1a

輸出:

{ "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": false, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 240, "SnapshotId": "", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 80 }

如果您未指定磁碟區類型,預設磁碟區類型為 gp2

aws ec2 create-volume \ --size 80 \ --availability-zone us-east-1a

範例 2:從快照建立佈建 IOPSSSD(io1) 磁碟區

下列create-volume範例會使用指定的快照,在IOPS指定的可用區域中建立佈建為 1000 的佈建 IOPSSSD(io1) 磁碟區。

aws ec2 create-volume \ --volume-type io1 \ --iops 1000 \ --snapshot-id snap-066877671789bd71b \ --availability-zone us-east-1a

輸出:

{ "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": false, "VolumeType": "io1", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 1000, "SnapshotId": "snap-066877671789bd71b", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 500 }

範例 3:建立加密磁碟區

下列create-volume範例使用 加密CMK預設值建立EBS加密磁碟區。如果預設停用加密,您必須指定 --encrypted 參數,如下所示。

aws ec2 create-volume \ --size 80 \ --encrypted \ --availability-zone us-east-1a

輸出:

{ "AvailabilityZone": "us-east-1a", "Tags": [], "Encrypted": true, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "creating", "Iops": 240, "SnapshotId": "", "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z", "Size": 80 }

如果預設啟用加密,即使沒有 --encrypted 參數,下列範例命令也會建立加密磁碟區。

aws ec2 create-volume \ --size 80 \ --availability-zone us-east-1a

如果您使用 --kms-key-id 參數來指定客戶受管的 CMK,即使預設啟用加密,也必須指定 --encrypted 參數。

aws ec2 create-volume \ --volume-type gp2 \ --size 80 \ --encrypted \ --kms-key-id 0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE \ --availability-zone us-east-1a

範例 4:使用標籤建立磁碟區

下列create-volume範例會建立磁碟區並新增兩個標籤。

aws ec2 create-volume \ --availability-zone us-east-1a \ --volume-type gp2 \ --size 80 \ --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'
  • 如需API詳細資訊,請參閱 命令參考 CreateVolume中的 。 AWS CLI

PowerShell
適用於 的工具 PowerShell

範例 1:此範例會建立指定的磁碟區。

New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2

輸出:

Attachments : {} AvailabilityZone : us-west-2a CreateTime : 12/22/2015 1:42:07 AM Encrypted : False Iops : 150 KmsKeyId : Size : 50 SnapshotId : State : creating Tags : {} VolumeId : vol-12345678 VolumeType : gp2

範例 2:此範例請求會建立磁碟區,並套用具有堆疊索引鍵和生產值的標籤。

$tag = @{ Key="stack"; Value="production" } $tagspec = new-object Amazon.EC2.Model.TagSpecification $tagspec.ResourceType = "volume" $tagspec.Tags.Add($tag) New-EC2Volume -Size 80 -AvailabilityZone "us-west-2a" -TagSpecification $tagspec
  • 如需API詳細資訊,請參閱 AWS Tools for PowerShell Cmdlet 參考 CreateVolume中的 。