Obtenir des informations sur vos snapshots

Vous pouvez obtenir des informations sur vos snapshots en utilisant AWS CLI.

Obtenir des informations sur vos snapshots avec Cockpit v2

Voir le dashboard Snapshots.

Obtenir des informations sur vos snapshots avec OSC CLI

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

The ReadSnapshots command lists one or more snapshots that are available to you and the permissions to create volumes from them.

Request sample
$ osc-cli api ReadSnapshots --profile "default" \
    --Filters '{
        "SnapshotIds": ["snap-12345678"],
      }'
Request sample
$ osc-cli api ReadSnapshots --profile "default" \
    --Filters '{
        "TagKeys": ["env"],
        "TagValues": ["prod", "test"],
      }'

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.

The ReadSnapshots command returns the following elements:

  • ResponseContext: Information about the context of the response.

  • Snapshots: Information about one or more snapshots and their permissions.

Result sample
{
  "Snapshots": [
    {
      "VolumeSize": 10,
      "AccountId": "123456789012",
      "VolumeId": "vol-12345678",
      "CreationDate": "2010-10-01T12:34:56.789Z",
      "PermissionsToCreateVolume": {
        "GlobalPermission": false,
        "AccountIds": []
      },
      "Progress": 100,
      "SnapshotId": "snap-12345678",
      "State": "completed",
      "Description": "Snapshot created from a volume",
      "Tags": []
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}
Result sample
{
  "Snapshots": [
    {
      "VolumeSize": 10,
      "AccountId": "123456789012",
      "VolumeId": "vol-12345678",
      "CreationDate": "2010-10-01T12:34:56.789Z",
      "PermissionsToCreateVolume": {
        "GlobalPermission": false,
        "AccountIds": []
      },
      "Progress": 100,
      "SnapshotId": "snap-12345678",
      "State": "completed",
      "Description": "Test snapshot",
      "Tags": [
        {
          "Value": "test",
          "Key": "env"
        }
      ]
    }
  ],
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Obtenir des informations sur vos snapshots avec AWS CLI

Obtenir des informations générales sur vos snapshots

Vous pouvez obtenir des informations à propos d’un snapshot, telles que l’ID du volume à partir duquel il a été créé, les tags qui lui sont associés, ou son statut.

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

Exemple de requête
$ aws ec2 describe-snapshots \
    --profile YOUR_PROFILE  \
    --snapshot-id snap-12345678 \
    --filters Name=TAG_NAME,Values=TAG_VALUE \
    --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) snapshot-id : Un ou plusieurs ID de snapshots. Si aucun ID de snapshot n’est spécifié, la requête renvoie une description de l’ensemble de vos snapshots.

  • (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 :

    • description : La description du snapshot.

    • owner-alias : L’account alias du propriétaire du snapshot.

    • owner-id : L’ID de compte du propriétaire du snapshot.

    • progress : La progression du snapshot, en pourcentage.

    • snapshot-id : L’ID du snapshot.

    • start-time : L’heure à laquelle le snapshot a été lancé.

    • status : L’état du snapshot (in-queue | completed | error).

    • volume-id : L’ID du volume utilisé pour créer le snapshot.

    • volume-size : La taille du volume utilisé pour créer le snapshot, en gibioctets (Gio).

    • 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

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

La commande describe-snapshots renvoie les éléments suivants :

  • Description : La description du snapshot.

  • Encrypted : Le chiffrement d’un volume (true | false).

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

  • VolumeId : L’ID du volume.

  • State : L’état du snapshot.

  • VolumeSize : La taille du volume utilisé pour créer le snapshot, en gibioctets (Gio).

  • Progress : La progression du snapshot, en pourcentage.

  • SnapshotId : L’ID du snapshot.

  • OwnerId : L’ID du compte propriétaire du snapshot.

Exemple de résultat
{
    "Description": "Created by CreateImage i-12345678 for ami-12345678 from volume-12345678",
    "Encrypted": false,
    "Tags": [],
    "VolumeId": "vol-12345678",
    "State": "completed",
    "VolumeSize": 10,
    "Progress": "100%",
    "SnapshotId": "snap-87654321",
    "OwnerId": "123456789012"
}

Obtenir des informations sur les permissions pour un snapshot

Vous pouvez obtenir des informations sur la liste des comptes autorisés à créer un volume à partir d’un snapshot spécifique. Vous pouvez modifier ces autorisations à tout moment. Pour en savoir plus, voir Gérer les permissions pour un snapshot.

Pour obtenir des informations sur les permissions d’un snapshot, utilisez la commande describe-snapshot-attribute suivant cette syntaxe :

Exemple de requête
$ aws ec2 describe-snapshot-attribute \
    --profile YOUR_PROFILE \
    --snapshot-id snap-12345678 \
    --attribute createVolumePermission \
    --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.

  • snapshot-id : L’ID du snapshot.

  • attribute : L’attribut du snapshot pour lequel vous souhaitez obtenir des informations (doit être paramétré sur createVolumePermission).

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

La commande describe-snapshot-attribute renvoie les éléments suivants :

  • SnapshotId : L’ID du snapshot.

  • CreateVolumePermission : Les informations à propos d’une ou plusieurs permissions de créer un volume à partir du snapshot. Cet élément contient les informations suivantes :

    • UserId : Un ou plusieurs ID de comptes avec lesquels vous avez partagé le snapshot.

    • Group : Le nom du groupe avec lequel vous avez partagé le snapshot (all si public, sinon laissé vide).

Exemple de résultat
{
    "SnapshotId": "snap-1234578",
    "CreateVolumePermissions": [
        {
            "UserId": "1234567899999",
            "Group": "",
        }
    ]
}

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.