Utilisation de DescribeVolumes avec une CLI - Exemples de code de kit AWS SDK

D’autres exemples de kits AWS SDK sont disponibles dans le référentiel GitHub AWS Doc SDK Examples.

Utilisation de DescribeVolumes avec une CLI

Les exemples de code suivants illustrent comment utiliser DescribeVolumes.

CLI
AWS CLI

Exemple 1 : pour décrire un volume

L’exemple describe-volumes suivant décrit les volumes spécifiés dans la région spécifiée.

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

Sortie :

{ "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 } ] }

Exemple 2 : pour décrire les volumes attachés à une instance spécifique

L’exemple describe-volumes suivant décrit tous les volumes qui sont à la fois attachés à l’instance spécifiée et définis pour être supprimés lorsque l’instance est résiliée.

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

Pour obtenir un exemple de la manière de procéder pour describe-volumes, reportez-vous à l’exemple 1.

Exemple 3 : pour décrire les volumes disponibles dans une zone de disponibilité spécifique

L’exemple describe-volumes suivant décrit tous les volumes dont l’état est available et qui se trouvent dans la zone de disponibilité spécifiée.

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

Pour obtenir un exemple de la manière de procéder pour describe-volumes, reportez-vous à l’exemple 1.

Exemple 4 : pour décrire des volumes sur la base de balises

L’exemple describe-volumes suivant décrit tous les volumes dotés de la clé de balise Name et d’une valeur commençant par Test. La sortie est ensuite filtrée avec une requête qui affiche uniquement les balises et les ID des volumes.

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

Sortie :

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

Pour d’autres exemples d’utilisation de filtres de balises, consultez la rubrique Utiliser des balises dans le Guide de l’utilisateur Amazon EC2.

  • Pour plus de détails sur l’API, consultez DescribeVolumes dans la Référence des commandes de l’AWS CLI.

PowerShell
Outils pour PowerShell V4

Exemple 1 : cet exemple décrit le volume EBS spécifié.

Get-EC2Volume -VolumeId vol-12345678

Sortie :

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

Exemple 2 : cet exemple décrit vos volumes EBS dont le statut est « disponible ».

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

Sortie :

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 ...

Exemple 3 : cet exemple décrit tous vos volumes EBS.

Get-EC2Volume
  • Pour plus de détails sur l’API, consultez DescribeVolumes dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple décrit le volume EBS spécifié.

Get-EC2Volume -VolumeId vol-12345678

Sortie :

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

Exemple 2 : cet exemple décrit vos volumes EBS dont le statut est « disponible ».

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

Sortie :

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 ...

Exemple 3 : cet exemple décrit tous vos volumes EBS.

Get-EC2Volume
  • Pour plus de détails sur l’API, consultez DescribeVolumes dans la Référence des applets de commande pour les Outils AWS pour PowerShell (V5).