Obtenir des informations sur vos snapshots

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

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 snapshots (pour Cockpit v1) ou le dashboard Snapshots (pour Cockpit v2-beta).

Obtenir des informations générales sur les 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 Utiliser 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 utilisateurs 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 à propos des utilisateurs ayant l’autorisation d’utiliser un snapshot depuis Cockpit, vous devez cliquer sur le bouton Share/Unshare . 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 Utiliser 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: "",
            }
          ],
}

Page connexe

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.