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 OSC CLI
Voir l’exemple de commande ReadSnapshots dans la documentation de l’API OUTSCALE. |
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 :
$ 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 estYYYY
, 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.
{
"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 à propos des comptes ayant l’autorisation d’utiliser un snapshot depuis Cockpit v1, 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 :
$ 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é surcreateVolumePermission
). -
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).
-
{
"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.