Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # 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 le statut 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 IDs les 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI) dans le *Guide de l’utilisateur Amazon EC2*. + Pour plus de détails sur l'API, reportez-vous [DescribeVolumes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/describe-volumes.html)à la section *Référence des AWS CLI commandes*. ------ #### [ 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, reportez-vous [DescribeVolumes](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (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, reportez-vous [DescribeVolumes](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. ------ Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Création de EC2 ressources Amazon à l'aide d'un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.