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*.