Obtenir des informations sur vos volumes

Vous pouvez obtenir des informations sur vos volumes en utilisant AWS CLI, comme leur type, taille, et leur attachement à une instance.

Si vous dépassez le nombre autorisé de requêtes identiques pour une durée configurée, le message d’erreur RequestLimitExceeded est renvoyé.

Cette procédure utilise uniquement AWS CLI. Des informations sur ces ressources sont également disponibles dans Cockpit. Pour en savoir plus, voir Interface utilisateur des volumes (pour Cockpit v1) ou le dashboard Volumes (pour Cockpit v2-beta).

Pour obtenir des informations sur vos volumes, utilisez la commande describe-volumes suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-volumes \
    --profile YOUR_PROFILE \
    --volume-id vol-12345678 \
    --filters Name=X,Values=Y \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Utiliser et configurer AWS CLI.

  • (optionnel) volume-id : Un ou plusieurs ID de volumes.

    Si aucun ID de volume n’est spécifié, la requête renvoie une description de l’ensemble de vos volumes.

  • (optionnel) filters : Un ou plusieurs filtres, au format "Name=X,Values=Y".

    Vous pouvez spécifier plusieurs valeurs pour un même filtre en utilisant le format "Name=X,Values=Y, Z".

    Les filtres suivants sont disponibles :

    • attachment.attach-time : L’heure à laquelle l’attachement à été initié.

    • attachment.delete-on-termination : Indique si le volume est supprimé lorsque l’instance est terminée.

    • attachment.device : L’appareil sur lequel le volume est attaché.

    • attachment.instance-id : L’ID de l’instance à laquelle le volume est attaché.

    • attachment.status : L’état de l’attachement (attaching | attached | detaching | detached)

    • availability-zone : L’Availability Zone dans laquelle le volume a été créé. Pour en savoir plus, voir À propos des Régions, endpoints et Availability Zones.

    • create-time : La date et l’heure de création.

    • tag-key : La clé d’un tag associé à la ressource.

    • tag-value : La valeur d’un tag associé à la ressource.

    • tag:XXXX : La valeur d’un tag associé à la ressource, où XXXX est la clé du tag.

      Pour filtrer un tag dont la clé est XXXX et la valeur est YYYY, vous pouvez donc utiliser un des deux formats suivants :

      • --filters Name=tag-key,Values=XXXX Name=tag-value,Values=YYYY

      • --filters Name=tag:XXXX,Values=YYYY

    • volume-id : L’ID du volume.

    • volume-type : Le type du volume (standard | gp2 | io1).

    • snapshot-id : Le snapshot à partir duquel le volume a été créé.

    • size : La taille du volume, en gibioctets (Gio).

    • status : L’état du volume (creating | available | in-use | deleting | error). Pour en savoir plus, voir À propos des volumes.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande describe-volumes renvoie le résultat suivant :

  • Volumes : Informations à propos d’un ou plusieurs volumes. Cet élément contient les informations suivantes :

    • AvailabilityZone : L’Availability Zone où vous avez placé le volume.

    • Attachments : Informations sur votre volume. Cet élément contient les informations suivantes :

      • AttachTime : La date et l’heure à laquelle votre volume a été attaché.

      • InstanceId : L’ID de l’instance.

      • VolumeId : L’ID du volume.

      • State : L’état de l’attachement du volume (attaching | detaching | attached | detached).

      • DeleteOnTermination : Si true, le volume est supprimé une fois l’instance terminée. Si false, le volume n’est pas supprimé une fois l’instance terminée.

      • Device : Le nom du device.

    • Tags : Un ou plusieurs tags associés au volume.

    • VolumeType : Le type de volume (standard | gp2 | io1). Pour en savoir plus, voir À propos des volumes > Types de volumes et IOPS.

    • VolumeId : L’ID du volume.

    • State : L’état du volume. Pour en savoir plus, voir À propos des volumes.

    • (io1 et gp2 uniquement) Iops : Le nombre d’IOPS. Pour les volumes io1, le nombre d’IOPS provisionnées. Pour les volumes gp2, la performance de base du volume. Pour en savoir plus, voir À propos des volumes.

    • SnapshotId : L’ID du snapshot à partir duquel vous avez créé le snapshot.

    • CreateTime : La date et l’heure de la création.

    • Size : La taille du volume (en Gio).

Exemple de résultat
"Volumes": [
    {
        "AvailabilityZone": "eu-west-2a",
        "Attachments": [
            {
                "AttachTime": "2015-03-18T09:36:45.728Z",
                "InstanceId": "i-12345678",
                "VolumeId": "vol-87654321",
                "State": "attached",
                "DeleteOnTermination": false,
                "Device": "/dev/sdb"
            }
        ],
        "Tags": [],
        "VolumeType": "io1",
        "VolumeId": "vol-87654321",
        "State": "in-use",
        "Iops": 500,
        "SnapshotId": null,
        "CreateTime": "2015-01-26T11:01:08.381Z",
        "Size": 50
    }
]

Pages connexes

Méthode API correspondante

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.