本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
搭配使用 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
\ --size80
\ --availability-zoneus-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-zoneus-east-1a
範例 2:從快照建立佈建 IOPS SSD (io1) 磁碟區
下列
create-volume
範例會使用指定的快照,在指定的可用區域中建立具有 1000 個佈建 IOPS 的佈建 IOPS SSD (io1) 磁碟區。aws ec2 create-volume \ --volume-type
io1
\ --iops1000
\ --snapshot-idsnap-066877671789bd71b
\ --availability-zoneus-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-zoneus-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-zoneus-east-1a
如果您使用
--kms-key-id
參數來指定客戶受管 CMK,即使預設啟用加密,仍必須指定--encrypted
參數。aws ec2 create-volume \ --volume-type
gp2
\ --size80
\ --encrypted \ --kms-key-id0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE
\ --availability-zoneus-east-1a
範例 4:使用標籤建立磁碟區
下列
create-volume
範例會建立磁碟區並新增兩個標籤。aws ec2 create-volume \ --availability-zone
us-east-1a
\ --volume-typegp2
\ --size80
\ --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]
'-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 CreateVolume
。
-
- PowerShell
-
- Tools for 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。
-
如需 AWS SDK 開發人員指南和程式碼範例的完整清單,請參閱 使用 建立 Amazon EC2 資源 AWS SDK。此主題也包含有關入門的資訊和舊版 SDK 的詳細資訊。