Exemples d'utilisation de S3 Glacier AWS CLI - AWS Command Line Interface

Cette documentation concerne AWS CLI uniquement la version 1 du. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

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-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_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 avec aws glacier list-multipart-uploads.

Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide de l'interface AWS de ligne de commande, consultez la section Utilisation d'Amazon Glacier dans le guide de l'utilisateur de la AWS CLI.

  • Pour plus de détails sur l'API, reportez-vous 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-lockexemple 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-name MyVaultName

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez Abort Vault Lock (DELETE lock-policy) dans le guide du développeur d'API Amazon Glacier.

  • Pour plus de détails sur l'API, reportez-vous 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-name my-vault --tags id=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 plus de détails sur l'API, reportez-vous 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 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-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 avec aws glacier list-multipart-uploads. Le paramètre checksum prend un hachage de l'arborescence SHA-256 de l'archive en hexadécimal.

Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide de l' AWS interface de ligne de commande, y compris les instructions relatives au calcul d'un hachage arborescent, consultez la section Utilisation d'Amazon Glacier dans le guide de l'utilisateur de la AWS CLI.

  • Pour plus de détails sur l'API, reportez-vous 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-lockexemple 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 du lock-id paramètre lors de l'exécutioninitiate-lock-process.

aws glacier complete-vault-lock \ --account-id - \ --vault-name MyVaultName \ --lock-id 9QZgEXAMPLEPhvL6xEXAMPLE

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez Complete Vault Lock (POST LockID) dans le guide du développeur de l'API Amazon Glacier.

  • Pour plus de détails sur l'API, reportez-vous 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 plus de détails sur l'API, reportez-vous 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 de example_vault.

aws glacier delete-archive \ --account-id 111122223333 \ --vault-name example_vault \ --archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w

Cette commande ne produit aucun résultat.

  • Pour plus de détails sur l'API, reportez-vous 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-policyexemple suivant supprime la politique d'accès pour le coffre spécifié.

aws glacier delete-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault

Cette commande ne produit aucun résultat.

  • Pour plus de détails sur l'API, reportez-vous 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 notifications SNS d’un coffre-fort

L’exemple delete-vault-notifications suivant supprime les notifications envoyées par Amazon Simple Notification Service (Amazon SNS) pour le coffre-fort spécifié.

aws glacier delete-vault-notifications \ --account-id 111122223333 \ --vault-name example_vault

Cette commande ne produit aucun résultat.

  • Pour plus de détails sur l'API, reportez-vous 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 plus de détails sur l'API, reportez-vous 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-name my-vault --job-id zbxcm3Z_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 et aws 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 plus de détails sur l'API, reportez-vous 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 plus de détails sur l'API, reportez-vous 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 plus de détails sur l'API, reportez-vous 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-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json

Le job-id est disponible dans la sortie de aws 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 plus de détails sur l'API, reportez-vous 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-policyexemple suivant récupère la politique d'accès pour le coffre spécifié.

aws glacier get-vault-access-policy \ --account-id 111122223333 \ --vault-name example_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 plus de détails sur l'API, reportez-vous 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-lockexemple suivant permet de récupérer les détails relatifs au verrou du coffre spécifié.

aws glacier get-vault-lock \ --account-id - \ --vault-name MyVaultName

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 (GET lock-policy) dans le guide du développeur d'API Amazon Glacier.

  • Pour plus de détails sur l'API, reportez-vous 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-name my-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 plus de détails sur l'API, reportez-vous 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-name my-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 pour récupérer une archive depuis le coffre my-vault :

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json

job-archive-retrieval.jsonest un fichier JSON situé dans le dossier local qui indique le type de tâche, l'ID d'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" }

IDs Les 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 tâche.

  • Pour plus de détails sur l'API, reportez-vous 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-size 1048576 --vault-name my-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 avecaws glacier upload-multipart-part. Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide de l'interface AWS de ligne de commande, consultez la section Utilisation d'Amazon Glacier dans le guide de l'utilisateur de la AWS CLI.

  • Pour plus de détails sur l'API, reportez-vous 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-lockexemple 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 appelant complete-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-name MyVaultName \ --policy file://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 (POST lock-policy) dans le guide du développeur d'API Amazon Glacier.

  • Pour plus de détails sur l'API, reportez-vous 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-name my-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 plus de détails sur l'API, reportez-vous 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-name my-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 de l'interface AWS de ligne de commande, consultez la section Utilisation d'Amazon Glacier dans le guide de l'utilisateur de la AWS CLI.

  • Pour plus de détails sur l'API, reportez-vous 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-name my-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 de l'interface AWS de ligne de commande, consultez la section Utilisation d'Amazon Glacier dans le guide de l'utilisateur de la AWS CLI.

  • Pour plus de détails sur l'API, reportez-vous 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-capacityexemple 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 plus de détails sur l'API, reportez-vous 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-name my-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 plus de détails sur l'API, reportez-vous 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 plus de détails sur l'API, reportez-vous 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-capacityexemple suivant achète une unité de capacité provisionnée.

aws glacier purchase-provisioned-capacity \ --account-id 111122223333

Sortie :

{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }

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-name my-vault --tag-keys date

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 de détails sur l'API, reportez-vous 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 - --policy file://data-retrieval-policy.json

data-retrieval-policy.jsonest un fichier JSON dans le dossier actuel qui spécifie 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 de manière à FreeTier utiliser le JSON intégré :

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 plus de détails sur l'API, reportez-vous 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-policyexemple suivant attache une politique d'autorisation au coffre spécifié.

aws glacier set-vault-access-policy \ --account-id 111122223333 \ --vault-name example_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 plus de détails sur l'API, reportez-vous 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 notifications SNS pour un coffre-fort nommé my-vault :

aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json

notificationconfig.json est un fichier JSON dans le dossier actuel qui indique une rubrique SNS 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 plus de détails sur l'API, reportez-vous 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-name my-vault --body archive.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 plus de détails sur l'API, reportez-vous 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-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_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 plage prend une plage de contenu HTTP 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 avec aws glacier list-multipart-uploads.

Pour plus d'informations sur les téléchargements partitionnés vers Amazon Glacier à l'aide de l'interface AWS de ligne de commande, consultez la section Utilisation d'Amazon Glacier dans le guide de l'utilisateur de la AWS CLI.

  • Pour plus de détails sur l'API, reportez-vous UploadMultipartPartà la section Référence des AWS CLI commandes.