本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
将 CreateVolume 与 CLI 配合使用
以下代码示例演示如何使用 CreateVolume。
- CLI
-
- AWS CLI
-
创建空通用型 SSD(gp2)卷
以下
create-volume示例将在指定的可用区中创建一个 80 GiB 的通用型 SSD(gp2)卷。请注意,当前区域必须为us-east-1,或者您可以添加--region参数来为命令指定区域。aws ec2 create-volume \ --volume-typegp2\ --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 \ --size80\ --availability-zoneus-east-1a示例 2:从快照创建预调配 IOPS SSD(io1)卷
以下
create-volume示例将使用指定的快照在指定的可用区中创建具有 1000 预调配 IOPS 的预调配 IOPS SSD(io1)卷。aws ec2 create-volume \ --volume-typeio1\ --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示例使用 EBS 加密的默认 CMK 创建加密卷。如果默认情况下禁用了加密,则必须按以下方式指定--encrypted参数。aws ec2 create-volume \ --size80\ --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 \ --size80\ --availability-zoneus-east-1a如果您使用
--kms-key-id参数指定客户托管的 CMK,则即使默认情况下已启用加密,也必须指定--encrypted参数。aws ec2 create-volume \ --volume-typegp2\ --size80\ --encrypted \ --kms-key-id0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE\ --availability-zoneus-east-1a示例 4:创建带有标签的卷
以下
create-volume示例将创建一个卷并添加两个标签。aws ec2 create-volume \ --availability-zoneus-east-1a\ --volume-typegp2\ --size80\ --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'-
有关 API 的详细信息,请参阅AWS CLI 命令参考CreateVolume
中的。
-
- PowerShell
-
- 适用于 PowerShell V4 的工具
-
示例 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 参考 (V 4) CreateVolume中的。
-
- 适用于 PowerShell V5 的工具
-
示例 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 参考 (V 5) CreateVolume中的。
-
有关 S AWS DK 开发者指南和代码示例的完整列表,请参阅使用 AWS 软件开发工具包创建 Amazon EC2 资源。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。