View a markdown version of this page

Utilizar DescribeVolumes con una CLI - Amazon Elastic Compute Cloud

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilizar DescribeVolumes con una CLI

Los siguientes ejemplos de código muestran cómo utilizar DescribeVolumes.

Los ejemplos de acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Puede ver esta acción en contexto en los siguientes ejemplos de código:

CLI
AWS CLI

Ejemplo 1: descripción de un volumen

En el siguiente ejemplo de describe-volumes se describen los volúmenes especificados en la región actual.

aws ec2 describe-volumes \ --volume-ids vol-049df61146c4d7901 vol-1234567890abcdef0

Salida:

{ "Volumes": [ { "AvailabilityZone": "us-east-1a", "Attachments": [ { "AttachTime": "2013-12-18T22:35:00.000Z", "InstanceId": "i-1234567890abcdef0", "VolumeId": "vol-049df61146c4d7901", "State": "attached", "DeleteOnTermination": true, "Device": "/dev/sda1" } ], "Encrypted": true, "KmsKeyId": "arn:aws:kms:us-east-2a:123456789012:key/8c5b2c63-b9bc-45a3-a87a-5513eEXAMPLE, "VolumeType": "gp2", "VolumeId": "vol-049df61146c4d7901", "State": "in-use", "Iops": 100, "SnapshotId": "snap-1234567890abcdef0", "CreateTime": "2019-12-18T22:35:00.084Z", "Size": 8 }, { "AvailabilityZone": "us-east-1a", "Attachments": [], "Encrypted": false, "VolumeType": "gp2", "VolumeId": "vol-1234567890abcdef0", "State": "available", "Iops": 300, "SnapshotId": "", "CreateTime": "2020-02-27T00:02:41.791Z", "Size": 100 } ] }

Ejemplo 2: descripción de los volúmenes que están asociados a una instancia específica

En el siguiente ejemplo de describe-volumes se describen todos los volúmenes que están asociados a la instancia especificada y configurados para que se eliminen cuando la instancia termine.

aws ec2 describe-volumes \ --region us-east-1 \ --filters Name=attachment.instance-id,Values=i-1234567890abcdef0 Name=attachment.delete-on-termination,Values=true

Para ver un ejemplo del resultado de describe-volumes, consulte el ejemplo 1.

Ejemplo 3: descripción de los volúmenes disponibles en una zona de disponibilidad específica

En el siguiente ejemplo de describe-volumes se describen todos los volúmenes que tienen el estado available y encuentran en la zona de disponibilidad especificada.

aws ec2 describe-volumes \ --filters Name=status,Values=available Name=availability-zone,Values=us-east-1a

Para ver un ejemplo del resultado de describe-volumes, consulte el ejemplo 1.

Ejemplo 4: descripción de volúmenes basados en etiquetas

En el siguiente ejemplo de describe-volumes se describen todos los volúmenes que tienen la clave de etiqueta Name y un valor que comienza por Test. A continuación, el resultado se filtra con una consulta que muestra solo las etiquetas y IDs los volúmenes.

aws ec2 describe-volumes \ --filters Name=tag:Name,Values=Test* \ --query "Volumes[*].{ID:VolumeId,Tag:Tags}"

Salida:

[ { "Tag": [ { "Value": "Test2", "Key": "Name" } ], "ID": "vol-1234567890abcdef0" }, { "Tag": [ { "Value": "Test1", "Key": "Name" } ], "ID": "vol-049df61146c4d7901" } ]

Para ver ejemplos adicionales de uso de filtros de etiquetas, consulte Trabajo con etiquetas en la Guía del usuario de Amazon EC2.

  • Para obtener más información sobre la API, consulte DescribeVolumesla Referencia de AWS CLI comandos.

PowerShell
Herramientas para la PowerShell versión 4

Ejemplo 1: En este ejemplo se describe el volumen de EBS especificado.

Get-EC2Volume -VolumeId vol-12345678

Salida:

Attachments : {} AvailabilityZone : us-west-2c CreateTime : 7/17/2015 4:35:19 PM Encrypted : False Iops : 90 KmsKeyId : Size : 30 SnapshotId : snap-12345678 State : in-use Tags : {} VolumeId : vol-12345678 VolumeType : standard

Ejemplo 2: En este ejemplo se describen los volúmenes de EBS que tienen el estado “disponible”.

Get-EC2Volume -Filter @{ Name="status"; Values="available" }

Salida:

Attachments : {} AvailabilityZone : us-west-2c CreateTime : 12/21/2015 2:31:29 PM Encrypted : False Iops : 60 KmsKeyId : Size : 20 SnapshotId : snap-12345678 State : available Tags : {} VolumeId : vol-12345678 VolumeType : gp2 ...

Ejemplo 3: En este ejemplo se describen todos los volúmenes de EBS.

Get-EC2Volume
Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se describe el volumen de EBS especificado.

Get-EC2Volume -VolumeId vol-12345678

Salida:

Attachments : {} AvailabilityZone : us-west-2c CreateTime : 7/17/2015 4:35:19 PM Encrypted : False Iops : 90 KmsKeyId : Size : 30 SnapshotId : snap-12345678 State : in-use Tags : {} VolumeId : vol-12345678 VolumeType : standard

Ejemplo 2: En este ejemplo se describen los volúmenes de EBS que tienen el estado “disponible”.

Get-EC2Volume -Filter @{ Name="status"; Values="available" }

Salida:

Attachments : {} AvailabilityZone : us-west-2c CreateTime : 12/21/2015 2:31:29 PM Encrypted : False Iops : 60 KmsKeyId : Size : 20 SnapshotId : snap-12345678 State : available Tags : {} VolumeId : vol-12345678 VolumeType : gp2 ...

Ejemplo 3: En este ejemplo se describen todos los volúmenes de EBS.

Get-EC2Volume
  • Para obtener más información sobre la API, consulte DescribeVolumesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

Para obtener una lista completa de guías para desarrolladores del 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.