D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . 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 d'Amazon 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 d'Amazon 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 configuration et l’exécution du code en contexte. **Topics** + [Actions](#actions) ## Actions ### `abort-multipart-upload` L'exemple de code suivant montre comment utiliser`abort-multipart-upload`. **AWS CLI** La commande suivante supprime un chargement partitionné en cours sur un coffre-fort 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 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)à la section *Référence des AWS CLI commandes*. ### `abort-vault-lock` L'exemple de code suivant montre comment utiliser`abort-vault-lock`. **AWS CLI** **Pour abandonner un processus de verrouillage de coffre-fort en cours** L’exemple `abort-vault-lock` suivant supprime une politique de verrouillage du coffre-fort spécifié et réinitialise l’état de verrouillage de ce coffre-fort pour qu’il soit déverrouillé. ``` aws glacier abort{{-}}vault-lock \ --account-id - \ --vault-name {{MyVaultName}} ``` Cette commande ne produit aucune sortie. Pour plus d’informations, consultez [Interruption du verrouillage du coffre (DELETE lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html) dans le *Guide du développeur API Amazon Glacier*. + Pour plus de détails sur l'API, reportez-vous [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html)à la section *Référence des AWS CLI commandes*. ### `add-tags-to-vault` L'exemple de code suivant montre comment utiliser`add-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html)à la section *Référence des AWS CLI commandes*. ### `complete-multipart-upload` L'exemple de code suivant montre comment utiliser`complete-multipart-upload`. **AWS CLI** La commande suivante effectue le 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 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 de total de contrôle utilise un hachage d’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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)à la section *Référence des AWS CLI commandes*. ### `complete-vault-lock` L'exemple de code suivant montre comment utiliser`complete-vault-lock`. **AWS CLI** **Pour mener à bien un processus de verrouillage du coffre-fort en cours** L’exemple `complete-vault-lock` suivant effectue le processus de verrouillage en cours du coffre-fort spécifié et définit son état de verrouillage sur `Locked`. Vous obtenez la valeur du paramètre `lock-id` lorsque vous exécutez `initiate-lock-process`. ``` aws glacier complete{{-}}vault-lock \ --account-id - \ --vault-name {{MyVaultName}} \ --lock-id {{9QZgEXAMPLEPhvL6xEXAMPLE}} ``` Cette commande ne produit aucune sortie. Pour plus d’informations, consultez [Achèvement du verrouillage du coffre (POST lockId)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html) dans le *Guide du développeur API Amazon Glacier*. + Pour plus de détails sur l'API, reportez-vous [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html)à la section *Référence des AWS CLI commandes*. ### `create-vault` L'exemple de code suivant montre comment utiliser`create-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)à la section *Référence des AWS CLI commandes*. ### `delete-archive` L'exemple de code suivant montre comment utiliser`delete-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 aucune sortie. + Pour plus de détails sur l'API, reportez-vous [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)à la section *Référence des AWS CLI commandes*. ### `delete-vault-access-policy` L'exemple de code suivant montre comment utiliser`delete-vault-access-policy`. **AWS CLI** **Pour supprimer la stratégie d’accès d’un coffre-fort** L’exemple `delete-vault-access-policy` suivant supprime la stratégie d’accès du coffre-fort spécifié. ``` aws glacier delete-vault-access-policy \ --account-id {{111122223333}} \ --vault-name {{example_vault}} ``` Cette commande ne produit aucune sortie. + Pour plus de détails sur l'API, reportez-vous [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html)à la section *Référence des AWS CLI commandes*. ### `delete-vault-notifications` L'exemple de code suivant montre comment utiliser`delete-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 aucune sortie. + Pour plus de détails sur l'API, reportez-vous [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)à la section *Référence des AWS CLI commandes*. ### `delete-vault` L'exemple de code suivant montre comment utiliser`delete-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)à la section *Référence des AWS CLI commandes*. ### `describe-job` L'exemple de code suivant montre comment utiliser`describe-job`. **AWS CLI** La commande suivante récupère les 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)à la section *Référence des AWS CLI commandes*. ### `describe-vault` L'exemple de code suivant montre comment utiliser`describe-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html)à la section *Référence des AWS CLI commandes*. ### `get-data-retrieval-policy` L'exemple de code suivant montre comment utiliser`get-data-retrieval-policy`. **AWS CLI** La commande suivante permet d’obtenir la politique d’extraction 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html)à la section *Référence des AWS CLI commandes*. ### `get-job-output` L'exemple de code suivant montre comment utiliser`get-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)à la section *Référence des AWS CLI commandes*. ### `get-vault-access-policy` L'exemple de code suivant montre comment utiliser`get-vault-access-policy`. **AWS CLI** **Pour extraire la stratégie d’accès d’un coffre-fort** L’exemple `get-vault-access-policy` suivant extrait la stratégie d’accès du coffre-fort 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html)à la section *Référence des AWS CLI commandes*. ### `get-vault-lock` L'exemple de code suivant montre comment utiliser`get-vault-lock`. **AWS CLI** **Pour obtenir les détails de verrouillage d’un coffre-fort** L’exemple `get-vault-lock` suivant extrait les détails de verrouillage du coffre-fort 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 [Obtenir le verrouillage de coffre (GET lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html) dans le *Guide du développeur API Amazon Glacier*. + Pour plus de détails sur l'API, reportez-vous [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html)à la section *Référence des AWS CLI commandes*. ### `get-vault-notifications` L'exemple de code suivant montre comment utiliser`get-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)à la section *Référence des AWS CLI commandes*. ### `initiate-job` L'exemple de code suivant montre comment utiliser`initiate-job`. **AWS CLI** La commande suivante lance une tâche visant à obtenir un inventaire du coffre-fort `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 visant à extraire une archive depuis le coffre-fort `my-vault` : ``` aws glacier initiate{{-}}job --account-id - --vault-name {{my-vault}} --job-parameters {{file://job-archive-retrieval.json}} ``` `job-archive-retrieval.json` est 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` et`aws glacier get-job-output`. Sortie : ``` { "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav" } ``` Pour plus d’informations sur le format des paramètres de tâche, consultez Lancement d’une tâche dans la *Référence des API d’Amazon Glacier*. + Pour plus de détails sur l'API, reportez-vous [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html)à la section *Référence des AWS CLI commandes*. ### `initiate-multipart-upload` L'exemple de code suivant montre comment utiliser`initiate-multipart-upload`. **AWS CLI** La commande suivante lance un chargement partitionné sur un coffre-fort nommé `my-vault` avec une taille de 1 Mio (1 024 x 1 024 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 chargement en cas de réussite. Utilisez cet ID de chargement lorsque vous chargez chaque partie de l’archive avec `aws 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html)à la section *Référence des AWS CLI commandes*. ### `initiate-vault-lock` L'exemple de code suivant montre comment utiliser`initiate-vault-lock`. **AWS CLI** **Pour lancer le processus de verrouillage du coffre-fort** L’exemple `initiate-vault-lock` suivant installe une politique de verrouillage au niveau du coffre-fort spécifié et définit son état de verrouillage sur `InProgress`. Pour finaliser le processus, vous devez appeler `complete-vault-lock` dans les 24 heures afin de définir l’état de verrouillage du coffre-fort sur `Locked`. ``` 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\"}}}]}"} ``` La sortie 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 [Lancement de verrouillage de coffre (POST lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html) dans le *Guide du développeur des API d’Amazon Glacier*. + Pour plus de détails sur l'API, reportez-vous [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html)à la section *Référence des AWS CLI commandes*. ### `list-jobs` L'exemple de code suivant montre comment utiliser`list-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)à la section *Référence des AWS CLI commandes*. ### `list-multipart-uploads` L'exemple de code suivant montre comment utiliser`list-multipart-uploads`. **AWS CLI** La commande suivante affiche tous les chargements partitionnés en cours pour un coffre-fort 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)à la section *Référence des AWS CLI commandes*. ### `list-parts` L'exemple de code suivant montre comment utiliser`list-parts`. **AWS CLI** La commande suivante répertorie les parties chargées d’un chargement partitionné dans un coffre-fort 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html)à la section *Référence des AWS CLI commandes*. ### `list-provisioned-capacity` L'exemple de code suivant montre comment utiliser`list-provisioned-capacity`. **AWS CLI** **Pour extraire les unités de capacité allouée** L’exemple `list-provisioned-capacity` suivant extrait les détails de toutes les unités de capacité allouée 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html)à la section *Référence des AWS CLI commandes*. ### `list-tags-for-vault` L'exemple de code suivant montre comment utiliser`list-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html)à la section *Référence des AWS CLI commandes*. ### `list-vaults` L'exemple de code suivant montre comment utiliser`list-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)à la section *Référence des AWS CLI commandes*. ### `purchase-provisioned-capacity` L'exemple de code suivant montre comment utiliser`purchase-provisioned-capacity`. **AWS CLI** **Pour acheter une unité de capacité allouée** L’exemple `purchase-provisioned-capacity` suivant achète une unité de capacité allouée. ``` aws glacier purchase-provisioned-capacity \ --account-id {{111122223333}} ``` Sortie : ``` { "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" } ``` + Pour plus de détails sur l'API, reportez-vous [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html)à la section *Référence des AWS CLI commandes*. ### `remove-tags-from-vault` L'exemple de code suivant montre comment utiliser`remove-tags-from-vault`. **AWS CLI** La commande suivante supprime une balise contenant la clé `date` d’un coffre-fort 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html)à la section *Référence des AWS CLI commandes*. ### `set-data-retrieval-policy` L'exemple de code suivant montre comment utiliser`set-data-retrieval-policy`. **AWS CLI** La commande suivante configure une stratégie d’extraction des 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.json` est un fichier JSON dans le dossier actuel. Il spécifie une stratégie d’extraction 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 stratégie d’extraction des données sur `FreeTier` à l’aide d’un JSON en ligne : ``` aws glacier set{{-}}data-retrieval-policy --account-id - --policy '{{{"Rules":[{"Strategy":"FreeTier"}]}}}' ``` Consultez Définition de stratégie d’extraction de données dans la *Référence des API d’Amazon Glacier* pour en savoir plus sur le format de la stratégie. + Pour plus de détails sur l'API, reportez-vous [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html)à la section *Référence des AWS CLI commandes*. ### `set-vault-access-policy` L'exemple de code suivant montre comment utiliser`set-vault-access-policy`. **AWS CLI** **Pour définir la stratégie d’accès d’un coffre-fort** L’exemple `set-vault-access-policy` suivant attache une stratégie d’autorisation au coffre-fort 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 aucune sortie. + Pour plus de détails sur l'API, reportez-vous [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html)à la section *Référence des AWS CLI commandes*. ### `set-vault-notifications` L'exemple de code suivant montre comment utiliser`set-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)à la section *Référence des AWS CLI commandes*. ### `upload-archive` L'exemple de code suivant montre comment utiliser`upload-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)à la section *Référence des AWS CLI commandes*. ### `upload-multipart-part` L'exemple de code suivant montre comment utiliser`upload-multipart-part`. **AWS CLI** La commande suivante 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 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)à la section *Référence des AWS CLI commandes*.