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.

    • CreationDates: (optional) The dates and times at which the volumes were created, in ISO 8601 date-time format (for example, 2020-06-30T00:00:00.000Z).

    • LinkVolumeDeleteOnVmDeletion: (optional) Whether the volumes are deleted or not when terminating the VMs.

    • LinkVolumeDeviceNames: (optional) The VM device names.

    • LinkVolumeLinkDates: (optional) The dates and times at which the volumes were attached, in ISO 8601 date-time format (for example, 2020-06-30T00:00:00.000Z).

    • LinkVolumeLinkStates: (optional) The attachment states of the volumes (attaching | detaching | attached | detached).

    • LinkVolumeVmIds: (optional) One or more IDs of VMs.

    • SnapshotIds: (optional) The snapshots from which the volumes were created.

    • SubregionNames: (optional) The names of the Subregions in which the volumes were created.

    • TagKeys: (optional) The keys of the tags associated with the volumes.

    • TagValues: (optional) The values of the tags associated with the volumes.

    • Tags: (optional) The key/value combination of the tags associated with the volumes, in the following format: "Filters":{"Tags":["TAGKEY=TAGVALUE"]}.

    • VolumeIds: (optional) The IDs of the volumes.

    • VolumeSizes: (optional) The sizes of the volumes, in gibibytes (GiB).

    • VolumeStates: (optional) The states of the volumes (creating | available | in-use | updating | deleting | error).

    • VolumeTypes: (optional) The types of the volumes (standard | gp2 | io1).

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

    • RequestId: The ID of the request.

  • Volumes: Information about one or more volumes.

    • CreationDate: The date and time (UTC) at which the volume was created.

    • Iops: The number of I/O operations per second (IOPS):

      • For io1 volumes, the number of provisioned IOPS

      • For gp2 volumes, the baseline performance of the volume

    • LinkedVolumes: Information about your volume attachment.

      • DeleteOnVmDeletion: If true, the volume is deleted when terminating the VM. If false, the volume is not deleted when terminating the VM.

      • DeviceName: The name of the device.

      • State: The state of the attachment of the volume (attaching | detaching | attached | detached).

      • VmId: The ID of the VM.

      • VolumeId: The ID of the volume.

    • Size: The size of the volume, in gibibytes (GiB).

    • SnapshotId: The snapshot from which the volume was created.

    • State: The state of the volume (creating | available | in-use | updating | deleting | error).

    • SubregionName: The Subregion in which the volume was created.

    • Tags: One or more tags associated with the volume.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

    • VolumeId: The ID of the volume.

    • VolumeType: The type of the volume (standard | gp2 | io1).

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 oapi-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
$ oapi-cli --profile "default" ReadVolumes \
    --Filters '{
        "VolumeIds": ["vol-12345678"]
      }'
Request sample
$ oapi-cli --profile "default" ReadVolumes \
    --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.

    • CreationDates: (optional) The dates and times at which the volumes were created, in ISO 8601 date-time format (for example, 2020-06-30T00:00:00.000Z).

    • LinkVolumeDeleteOnVmDeletion: (optional) Whether the volumes are deleted or not when terminating the VMs.

    • LinkVolumeDeviceNames: (optional) The VM device names.

    • LinkVolumeLinkDates: (optional) The dates and times at which the volumes were attached, in ISO 8601 date-time format (for example, 2020-06-30T00:00:00.000Z).

    • LinkVolumeLinkStates: (optional) The attachment states of the volumes (attaching | detaching | attached | detached).

    • LinkVolumeVmIds: (optional) One or more IDs of VMs.

    • SnapshotIds: (optional) The snapshots from which the volumes were created.

    • SubregionNames: (optional) The names of the Subregions in which the volumes were created.

    • TagKeys: (optional) The keys of the tags associated with the volumes.

    • TagValues: (optional) The values of the tags associated with the volumes.

    • Tags: (optional) The key/value combination of the tags associated with the volumes, in the following format: "Filters":{"Tags":["TAGKEY=TAGVALUE"]}.

    • VolumeIds: (optional) The IDs of the volumes.

    • VolumeSizes: (optional) The sizes of the volumes, in gibibytes (GiB).

    • VolumeStates: (optional) The states of the volumes (creating | available | in-use | updating | deleting | error).

    • VolumeTypes: (optional) The types of the volumes (standard | gp2 | io1).

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

    • RequestId: The ID of the request.

  • Volumes: Information about one or more volumes.

    • CreationDate: The date and time (UTC) at which the volume was created.

    • Iops: The number of I/O operations per second (IOPS):

      • For io1 volumes, the number of provisioned IOPS

      • For gp2 volumes, the baseline performance of the volume

    • LinkedVolumes: Information about your volume attachment.

      • DeleteOnVmDeletion: If true, the volume is deleted when terminating the VM. If false, the volume is not deleted when terminating the VM.

      • DeviceName: The name of the device.

      • State: The state of the attachment of the volume (attaching | detaching | attached | detached).

      • VmId: The ID of the VM.

      • VolumeId: The ID of the volume.

    • Size: The size of the volume, in gibibytes (GiB).

    • SnapshotId: The snapshot from which the volume was created.

    • State: The state of the volume (creating | available | in-use | updating | deleting | error).

    • SubregionName: The Subregion in which the volume was created.

    • Tags: One or more tags associated with the volume.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

    • VolumeId: The ID of the volume.

    • VolumeType: The type of the volume (standard | gp2 | io1).

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

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer 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 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. Pour en savoir plus, voir Installer et configurer AWS CLI.

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.