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 machine virtuelle (VM).

Obtenir des informations sur vos volumes avec Cockpit v2

Voir le dashboard Volumes.

Obtenir des informations sur vos volumes avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The ReadVolumes command lists one or more specified Block Storage Unit (BSU) volumes.

Request sample
$ osc-cli api ReadVolumes --profile "default" \
    --Filters '{
        "VolumeIds": ["vol-12345678"],
      }'
Request sample
$ osc-cli api ReadVolumes --profile "default" \
    --Filters '{
        "VolumeStates": ["in-use"],
        "VolumeTypes": ["gp2", "io1"],
      }'

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Filters: (optional) One or more filters.

  • NextPageToken: (optional) The token to request the next page of results. Each token refers to a specific page.

  • ResultsPerPage: (optional) The maximum number of logs returned in a single response (between 1`and `1000, both included). By default, 100.

The ReadVolumes command returns the following elements:

  • NextPageToken: The token to request the next page of results. Each token refers to a specific page.

  • ResponseContext: Information about the context of the response.

  • Volumes: Information about one or more volumes.

Result sample
{
  "Volumes": [
    {
      "VolumeId": "vol-12345678",
      "Tags": [],
      "VolumeType": "gp2",
      "SubregionName": "eu-west-2a",
      "State": "in-use",
      "CreationDate": "2010-10-01T12:34:56.789Z",
      "Iops": 100,
      "LinkedVolumes": [
        {
          "VolumeId": "vol-12345678",
          "DeleteOnVmDeletion": false,
          "DeviceName": "/dev/sdb",
          "State": "attached",
          "VmId": "i-12345678"
        }
      ],
      "Size": 10
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Obtenir des informations sur vos volumes avec AWS CLI

Pour obtenir des informations sur vos volumes, utilisez la commande describe-volumes en 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 Installer 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 Sous-régions.

    • 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éthodes API correspondantes

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.

Exporter en PDF