Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Exemples d'utilisation de S3 Glacier AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide de S3 Glacier.
Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliserabort-multipart-upload
.
- AWS CLI
-
La commande suivante supprime un téléchargement partitionné en cours vers un coffre nommé :
my-vault
aws glacier abort
-
multipart-upload --account-id - --vault-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
Cette commande ne génère pas de sortie. Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation. L’ID de téléchargement est renvoyé par la commande
aws glacier initiate-multipart-upload
et peut également être obtenu avecaws glacier list-multipart-uploads
.Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.
-
Pour API plus de détails, voir AbortMultipartUpload
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserabort-vault-lock
.
- AWS CLI
-
Pour abandonner un processus de verrouillage du coffre-fort en cours
L'
abort-vault-lock
exemple suivant supprime une politique de verrouillage du coffre-fort spécifié et rétablit l'état de verrouillage du coffre-fort sur déverrouillé.aws glacier abort
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez Abort Vault Lock (DELETElock-policy) dans le manuel du développeur Amazon Glacier API.
-
Pour API plus de détails, voir AbortVaultLock
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliseradd-tags-to-vault
.
- AWS CLI
-
La commande suivante ajoute deux balises à un coffre-fort nommé
my-vault
:aws glacier add
-
tags-to-vault --account-id - --vault-namemy-vault
--tagsid=1234,date=july2015
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir AddTagsToVault
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercomplete-multipart-upload
.
- AWS CLI
-
La commande suivante termine le téléchargement partitionné pour une archive de 3 Mio :
aws glacier complete-multipart-upload --archive-size
3145728
--checksum9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
-
-account-id - --vault-namemy-vault
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
L’ID de téléchargement est renvoyé par la commande
aws glacier initiate-multipart-upload
et peut également être obtenu avecaws glacier list-multipart-uploads
. Le paramètre checksum prend un hachage SHA arborescent -256 de l'archive en hexadécimal.Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide du AWS CLI, y compris les instructions sur le calcul d'un hachage arborescent, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.
-
Pour API plus de détails, voir CompleteMultipartUpload
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercomplete-vault-lock
.
- AWS CLI
-
Pour terminer un processus de verrouillage du coffre-fort en cours
L'
complete-vault-lock
exemple suivant complète la progression du verrouillage en cours pour le coffre-fort spécifié et définit l'état de verrouillage du coffre-fort surLocked
. Vous obtenez la valeur dulock-id
paramètre lors de l'exécutioninitiate-lock-process
.aws glacier complete
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --lock-id9QZgEXAMPLEPhvL6xEXAMPLE
Cette commande ne produit aucun résultat.
Pour plus d'informations, consultez Complete Vault Lock (POSTlockId) dans le manuel du API développeur Amazon Glacier.
-
Pour API plus de détails, voir CompleteVaultLock
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisercreate-vault
.
- AWS CLI
-
La commande suivante crée un coffre-fort nommé
my-vault
:aws glacier create-vault --vault-name
my-vault
-
-account-id -Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir CreateVault
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-archive
.
- AWS CLI
-
Pour supprimer une archive d’un coffre-fort
L’exemple
delete-archive
suivant supprime l’archive spécifiée deexample_vault
.aws glacier delete-archive \ --account-id
111122223333
\ --vault-nameexample_vault
\ --archive-idSc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w
Cette commande ne produit aucun résultat.
-
Pour API plus de détails, voir DeleteArchive
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-vault-access-policy
.
- AWS CLI
-
Pour supprimer la politique d'accès d'un coffre-fort
L'
delete-vault-access-policy
exemple suivant supprime la politique d'accès pour le coffre spécifié.aws glacier delete-vault-access-policy \ --account-id
111122223333
\ --vault-nameexample_vault
Cette commande ne produit aucun résultat.
-
Pour API plus de détails, voir DeleteVaultAccessPolicy
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-vault-notifications
.
- AWS CLI
-
Pour supprimer les SNS notifications relatives à un coffre-fort
L'
delete-vault-notifications
exemple suivant supprime les notifications envoyées par Amazon Simple Notification Service (AmazonSNS) pour le coffre spécifié.aws glacier delete-vault-notifications \ --account-id
111122223333
\ --vault-nameexample_vault
Cette commande ne produit aucun résultat.
-
Pour API plus de détails, voir DeleteVaultNotifications
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-vault
.
- AWS CLI
-
La commande suivante supprime un coffre-fort nommé
my-vault
:aws glacier delete-vault --vault-name
my-vault
-
-account-id -Cette commande ne génère pas de sortie. Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir DeleteVault
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-job
.
- AWS CLI
-
La commande suivante récupère des informations sur une tâche d’extraction d’inventaire sur un coffre-fort nommé
my-vault
:aws glacier describe
-
job --account-id - --vault-namemy-vault
--job-idzbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW
Sortie :
{ "InventoryRetrievalParameters": { "Format": "JSON" }, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "Completed": false, "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "Action": "InventoryRetrieval", "CreationDate": "2015-07-17T20:23:41.616Z", "StatusCode": "InProgress" }
L’ID de tâche se trouve dans la sortie de
aws glacier initiate-job
etaws glacier list-jobs
. Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.-
Pour API plus de détails, voir DescribeJob
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdescribe-vault
.
- AWS CLI
-
La commande suivante récupère les données relatives à un coffre-fort nommé
my-vault
:aws glacier describe-vault --vault-name
my-vault
-
-account-id -Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir DescribeVault
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-data-retrieval-policy
.
- AWS CLI
-
La commande suivante permet d'obtenir la politique de récupération des données pour le compte en cours d'utilisation :
aws glacier get
-
data-retrieval-policy --account-id -Sortie :
{ "Policy": { "Rules": [ { "BytesPerHour": 10737418240, "Strategy": "BytesPerHour" } ] } }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir GetDataRetrievalPolicy
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-job-output
.
- AWS CLI
-
La commande suivante enregistre la sortie d’une tâche d’inventaire du coffre-fort dans un fichier du répertoire actuel nommé
output.json
:aws glacier get
-
job-output --account-id - --vault-namemy-vault
--job-idzbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW
output.json
Le
job-id
est disponible dans la sortie deaws glacier list-jobs
. Notez que le nom du fichier de sortie est un argument positionnel qui n’est pas préfixé par un nom d’option. Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.Sortie :
{ "status": 200, "acceptRanges": "bytes", "contentType": "application/json" }
output.json
:{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}
-
Pour API plus de détails, voir GetJobOutput
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-vault-access-policy
.
- AWS CLI
-
Pour récupérer la politique d'accès d'un coffre
L'
get-vault-access-policy
exemple suivant récupère la politique d'accès pour le coffre spécifié.aws glacier get-vault-access-policy \ --account-id
111122223333
\ --vault-nameexample_vault
Sortie :
{ "policy": { "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}" } }
-
Pour API plus de détails, voir GetVaultAccessPolicy
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-vault-lock
.
- AWS CLI
-
Pour obtenir les détails d'un verrou de coffre-fort
L'
get-vault-lock
exemple suivant permet de récupérer les détails relatifs au verrou du coffre spécifié.aws glacier get
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
Sortie :
{ "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}", "State": "Locked", "CreationDate": "2019-07-29T22:25:28.640Z" }
Pour plus d'informations, consultez Get Vault Lock (GETlock-policy) dans le manuel du APIdéveloppeur Amazon Glacier.
-
Pour API plus de détails, voir GetVaultLock
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-vault-notifications
.
- AWS CLI
-
La commande suivante obtient une description de la configuration des notifications pour un coffre-fort nommé
my-vault
:aws glacier get
-
vault-notifications --account-id - --vault-namemy-vault
Sortie :
{ "vaultNotificationConfig": { "Events": [ "InventoryRetrievalCompleted", "ArchiveRetrievalCompleted" ], "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault" } }
Si aucune notification n’a été configurée pour le coffre-fort, une erreur est renvoyée. Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir GetVaultNotifications
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserinitiate-job
.
- AWS CLI
-
La commande suivante lance une tâche visant à obtenir un inventaire du coffre
my-vault
:aws glacier initiate
-
job --account-id - --vault-namemy-vault
--job-parameters '{"Type": "inventory-retrieval"}
'Sortie :
{ "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW" }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
La commande suivante lance une tâche visant à récupérer une archive depuis le coffre
my-vault
:aws glacier initiate
-
job --account-id - --vault-namemy-vault
--job-parametersfile://job-archive-retrieval.json
job-archive-retrieval.json
est un JSON fichier du dossier local qui indique le type de tâche, l'ID de l'archive et certains paramètres facultatifs :{ "Type": "archive-retrieval", "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "Description": "Retrieve archive on 2015-07-17", "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic" }
IDsLes archives sont disponibles dans la sortie de
aws glacier upload-archive
etaws glacier get-job-output
.Sortie :
{ "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav" }
Consultez Initiate Job dans le manuel Amazon Glacier API Reference pour plus de détails sur le format des paramètres de la tâche.
-
Pour API plus de détails, voir InitiateJob
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserinitiate-multipart-upload
.
- AWS CLI
-
La commande suivante lance un téléchargement partitionné vers un coffre-fort nommé
my-vault
avec une taille de pièce de 1 MiB (1024 x 1024 octets) par fichier :aws glacier initiate
-
multipart-upload --account-id - --part-size1048576
--vault-namemy-vault
--archive-description"multipart upload test"
Le paramètre de description de l'archive est facultatif. Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
Cette commande génère un ID de téléchargement en cas de réussite. Utilisez l'identifiant de téléchargement lorsque vous chargez chaque partie de votre archive avec
aws glacier upload-multipart-part
. Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.-
Pour API plus de détails, voir InitiateMultipartUpload
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserinitiate-vault-lock
.
- AWS CLI
-
Pour lancer le processus de verrouillage du coffre-fort
L'
initiate-vault-lock
exemple suivant installe une politique de verrouillage du coffre-fort sur le coffre-fort spécifié et définit l'état de verrouillage du coffre-fort sur.InProgress
Vous devez terminer le processus en appelantcomplete-vault-lock
dans les 24 heures pour régler l'état du verrou du coffre-fort surLocked
.aws glacier initiate
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --policyfile://vault_lock_policy.json
Contenu de
vault_lock_policy.json
:{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
Le résultat est l'ID de verrouillage du coffre-fort que vous pouvez utiliser pour terminer le processus de verrouillage du coffre-fort.
{ "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE" }
Pour plus d'informations, consultez Initiate Vault Lock (POSTlock-policy) dans le manuel du APIdéveloppeur Amazon Glacier.
-
Pour API plus de détails, voir InitiateVaultLock
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-jobs
.
- AWS CLI
-
La commande suivante répertorie les tâches en cours et récemment terminées pour un coffre-fort nommé
my-vault
:aws glacier list
-
jobs --account-id - --vault-namemy-vault
Sortie :
{ "JobList": [ { "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "RetrievalByteRange": "0-3145727", "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Completed": false, "SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", "JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "JobDescription": "Retrieve archive on 2015-07-17", "ArchiveSizeInBytes": 3145728, "Action": "ArchiveRetrieval", "ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67", "CreationDate": "2015-07-17T21:16:13.840Z", "StatusCode": "InProgress" }, { "InventoryRetrievalParameters": { "Format": "JSON" }, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "Completed": false, "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "Action": "InventoryRetrieval", "CreationDate": "2015-07-17T20:23:41.616Z", "StatusCode": ""InProgress"" } ] }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir ListJobs
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-multipart-uploads
.
- AWS CLI
-
La commande suivante affiche tous les téléchargements partitionnés en cours pour un coffre nommé :
my-vault
aws glacier list
-
multipart-uploads --account-id - --vault-namemy-vault
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.
-
Pour API plus de détails, voir ListMultipartUploads
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-parts
.
- AWS CLI
-
La commande suivante répertorie les parties téléchargées pour un téléchargement en plusieurs parties dans un coffre nommé
my-vault
:aws glacier list
-
parts --account-id - --vault-namemy-vault
--upload-id"SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"
Sortie :
{ "MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D", "Parts": [ { "RangeInBytes": "0-1048575", "SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553" }, { "RangeInBytes": "1048576-2097151", "SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6" } ], "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "CreationDate": "2015-07-18T00:05:23.830Z", "PartSizeInBytes": 1048576 }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.
-
Pour API plus de détails, voir ListParts
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-provisioned-capacity
.
- AWS CLI
-
Pour récupérer les unités de capacité provisionnées
L'
list-provisioned-capacity
exemple suivant permet de récupérer les détails de toutes les unités de capacité allouées pour le compte spécifié.aws glacier list-provisioned-capacity \ --account-id
111122223333
Sortie :
{ "ProvisionedCapacityList": [ { "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K", "ExpirationDate": "2020-03-18T19:59:24.000Z", "StartDate": "2020-02-18T19:59:24.912Z" } ] }
-
Pour API plus de détails, voir ListProvisionedCapacity
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-tags-for-vault
.
- AWS CLI
-
La commande suivante répertorie les balises appliquées à un coffre-fort nommé
my-vault
:aws glacier list
-
tags-for-vault --account-id - --vault-namemy-vault
Sortie :
{ "Tags": { "date": "july2015", "id": "1234" } }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir ListTagsForVault
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-vaults
.
- AWS CLI
-
La commande suivante répertorie les coffres-forts dans le compte et la région par défaut :
aws glacier list
-
vaults --account-id -Sortie :
{ "VaultList": [ { "SizeInBytes": 3178496, "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault", "LastInventoryDate": "2015-04-07T00:26:19.028Z", "VaultName": "my-vault", "NumberOfArchives": 1, "CreationDate": "2015-04-06T21:23:45.708Z" } ] }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir ListVaults
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserpurchase-provisioned-capacity
.
- AWS CLI
-
Pour acheter une unité de capacité provisionnée
L'
purchase-provisioned-capacity
exemple suivant achète une unité de capacité provisionnée.aws glacier purchase-provisioned-capacity \ --account-id
111122223333
Sortie :
{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }
-
Pour API plus de détails, voir PurchaseProvisionedCapacity
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserremove-tags-from-vault
.
- AWS CLI
-
La commande suivante supprime une balise contenant la clé
date
d'un coffre nommémy-vault
:aws glacier remove
-
tags-from-vault --account-id - --vault-namemy-vault
--tag-keysdate
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir RemoveTagsFromVault
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserset-data-retrieval-policy
.
- AWS CLI
-
La commande suivante configure une politique de récupération de données pour le compte en cours d'utilisation :
aws glacier set
-
data-retrieval-policy --account-id - --policyfile://data-retrieval-policy.json
data-retrieval-policy.json
est un JSON fichier du dossier actuel qui définit une politique de récupération des données :{ "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
La commande suivante définit la politique de récupération des données en fonction de
FreeTier
l'utilisation en JSON ligne :aws glacier set
-
data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}
'Consultez la section Définir la politique de récupération des données dans le manuel Amazon Glacier API Reference pour plus de détails sur le format de la politique.
-
Pour API plus de détails, voir SetDataRetrievalPolicy
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserset-vault-access-policy
.
- AWS CLI
-
Pour définir la politique d'accès d'un coffre-fort
L'
set-vault-access-policy
exemple suivant attache une politique d'autorisation au coffre spécifié.aws glacier set-vault-access-policy \ --account-id
111122223333
\ --vault-nameexample_vault
--policy '{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}
'Cette commande ne produit aucun résultat.
-
Pour API plus de détails, voir SetVaultAccessPolicy
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserset-vault-notifications
.
- AWS CLI
-
La commande suivante configure les SNS notifications pour un coffre nommé
my-vault
:aws glacier set
-
vault-notifications --account-id - --vault-namemy-vault
--vault-notification-configfile://notificationconfig.json
notificationconfig.json
est un JSON fichier du dossier en cours qui indique un SNS sujet et les événements à publier :{ "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
-
Pour API plus de détails, voir SetVaultNotifications
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupload-archive
.
- AWS CLI
-
La commande suivante charge une archive du dossier actuel nommé
archive.zip
vers un coffre-fort nommémy-vault
:aws glacier upload
-
archive --account-id - --vault-namemy-vault
--bodyarchive.zip
Sortie :
{ "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67", "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw" }
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
Pour récupérer une archive chargée, lancez une tâche d’extraction à l’aide de la commande aws glacier initiate-job.
-
Pour API plus de détails, voir UploadArchive
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupload-multipart-part
.
- AWS CLI
-
La commande suivante télécharge le premier Mio (1 024 x 1 024 octets) d’une archive :
aws glacier upload-multipart-part --body
part1
--range 'bytes 0-1048575/*
'-
-account-id - --vault-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.
Le paramètre corps indique le chemin d’un fichier partiel sur le système de fichiers local. Le paramètre range prend une plage de HTTP contenu indiquant les octets que la partie occupe dans l'archive terminée. L’ID de téléchargement est renvoyé par la commande
aws glacier initiate-multipart-upload
et peut également être obtenu avecaws glacier list-multipart-uploads
.Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.
-
Pour API plus de détails, voir UploadMultipartPart
la section Référence des AWS CLI commandes.
-