Utilizar CreateVolume con una CLI
Los siguientes ejemplos de código muestran cómo utilizar CreateVolume.
- CLI
-
- AWS CLI
-
Para crear un volumen de SSD de uso general (gp2) vacío
En el siguiente ejemplo de
create-volume, se crea un volumen de SSD de uso general (gp2) de 80 GiB en la zona de disponibilidad especificada. Tenga en cuenta que la región actual debe serus-east-1. También puede agregar el parámetro--regionpara especificarla en el comando.aws ec2 create-volume \ --volume-typegp2\ --size80\ --availability-zoneus-east-1aSalida:
{ "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 }Si no especifica un tipo de volumen, el predeterminado es
gp2.aws ec2 create-volume \ --size80\ --availability-zoneus-east-1aEjemplo 2: creación de un volumen de SSD de IOPS aprovisionadas (io1) a partir de una instantánea
En el siguiente ejemplo de
create-volume, se crea un volumen SSD de IOPS aprovisionadas (io1) con 1000 IOPS aprovisionadas en la zona de disponibilidad especificada mediante la instantánea especificada.aws ec2 create-volume \ --volume-typeio1\ --iops1000\ --snapshot-idsnap-066877671789bd71b\ --availability-zoneus-east-1aSalida:
{ "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 }Ejemplo 3: creación de un volumen cifrado
En el siguiente ejemplo de
create-volume, se crea un volumen cifrado con la CMK predeterminada para el cifrado de EBS. Si el cifrado se encuentra deshabilitado de forma predeterminada, debe especificar el parámetro--encryptedde la siguiente manera.aws ec2 create-volume \ --size80\ --encrypted \ --availability-zoneus-east-1aSalida:
{ "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 }Si el cifrado está habilitado de forma predeterminada, en el ejemplo de comando siguiente se crea un volumen cifrado, incluso sin el parámetro
--encrypted.aws ec2 create-volume \ --size80\ --availability-zoneus-east-1aSi se usa la opción
--kms-key-idpara especificar una CMK administrada por el cliente, también debe especificar la opción--encryptedaunque el cifrado esté habilitado de forma predeterminada.aws ec2 create-volume \ --volume-typegp2\ --size80\ --encrypted \ --kms-key-id0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE\ --availability-zoneus-east-1aEjemplo 4: creación de un volumen con etiquetas
En el siguiente ejemplo de
create-volume, se crea un volumen y se agregan dos etiquetas.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}]'-
Para obtener información sobre la API, consulte CreateVolume
en la Referencia de comandos de la AWS CLI.
-
- PowerShell
-
- Herramientas para PowerShell V4
-
Ejemplo 1: En este ejemplo se crea el volumen especificado.
New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2Salida:
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 : gp2Ejemplo 2: Esta solicitud de ejemplo crea un volumen y aplica una etiqueta con una clave de pila y un valor de producción.
$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-
Para obtener información sobre la API, consulte CreateVolume en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).
-
- Herramientas para PowerShell V5
-
Ejemplo 1: En este ejemplo se crea el volumen especificado.
New-EC2Volume -Size 50 -AvailabilityZone us-west-2a -VolumeType gp2Salida:
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 : gp2Ejemplo 2: Esta solicitud de ejemplo crea un volumen y aplica una etiqueta con una clave de pila y un valor de producción.
$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-
Para obtener información sobre la API, consulte CreateVolume en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).
-
Para obtener una lista completa de las guías para desarrolladores de AWS SDK y ejemplos de código, consulte Creación de recursos de Amazon EC2 mediante una AWS SDK. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.