Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples
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.
Utilícelo DescribeVolumes
con un o AWS SDK CLI
En los siguientes ejemplos de código, se muestra cómo utilizar DescribeVolumes
.
- CLI
-
- AWS CLI
-
Ejemplo 1: Para describir un volumen
El siguiente
describe-volumes
ejemplo describe 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: Para describir los volúmenes que están adjuntos a una instancia específica
En el siguiente
describe-volumes
ejemplo, se describen todos los volúmenes que están adjuntos a la instancia especificada y configurados para que se eliminen cuando la instancia finalice.aws ec2 describe-volumes \ --region
us-east-1
\ --filtersName=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: Para describir los volúmenes disponibles en una zona de disponibilidad específica
El siguiente
describe-volumes
ejemplo describe todos los volúmenes que tienen un estado igual o se encuentran en la zona de disponibilidad especificada.available
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: Para describir los volúmenes en función de las etiquetas
En el siguiente
describe-volumes
ejemplo se describen todos los volúmenes que tienen la clave de etiquetaName
y un valor que comienza porTest
. A continuación, el resultado se filtra con una consulta que muestra únicamente 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 más ejemplos de uso de filtros de etiquetas, consulta Cómo trabajar con etiquetas en la Guía del EC2 usuario de Amazon.
-
Para API obtener más información, consulte DescribeVolumes
la Referencia de AWS CLI comandos.
-
- PowerShell
-
- Herramientas para PowerShell
-
Ejemplo 1: En este ejemplo se describe el EBS volumen 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 EBS los volúmenes 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. EBS
Get-EC2Volume
-
Para API obtener más información, consulte DescribeVolumes AWS Tools for PowerShellCmdlet Reference.
-