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

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

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'describe-volumesexemple suivant décrit les volumes spécifiés dans la région actuelle.

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'describe-volumesexemple 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 se termine.

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'describe-volumesexemple suivant décrit tous les volumes dont le statut est available et 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 en fonction de balises

L'describe-volumesexemple suivant décrit tous les volumes dotés de la clé de balise Name et d'une valeur commençant parTest. 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 section Utilisation des balises dans le guide de EC2 l'utilisateur Amazon.

  • Pour plus de détails sur l'API, reportez-vous DescribeVolumesà 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à 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à la section Référence des Outils AWS pour PowerShell applets de commande (V5).