Utilizar DescribeVolumes con una CLI - Ejemplos de código de AWS SDK

Hay más ejemplos de AWS SDK disponibles en el repositorio de GitHub de ejemplos de AWS SDK de documentos.

Utilizar DescribeVolumes con una CLI

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

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, la salida se filtra mediante una consulta que muestra únicamente las etiquetas y los ID de 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 información sobre la API, consulte DescribeVolumes en la Referencia de comandos de la AWS CLI.

PowerShell
Herramientas para PowerShell V4

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 información sobre la API, consulte DescribeVolumes en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

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 información sobre la API, consulte DescribeVolumes en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V5).