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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples d'utilisation de S3 Glacier AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide de S3 Glacier.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserabort-multipart-upload.

AWS CLI

La commande suivante supprime un téléchargement partitionné en cours vers un coffre nommé : my-vault

aws glacier abort-multipart-upload --account-id - --vault-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 du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.

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 (DELETElock-policy) dans le manuel du développeur Amazon Glacier API.

  • Pour API plus de détails, voir AbortVaultLockla 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 API plus de détails, voir AddTagsToVaultla 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 SHA arborescent -256 de l'archive en hexadécimal.

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

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 (POSTlockId) dans le manuel du API développeur Amazon Glacier.

  • Pour API plus de détails, voir CompleteVaultLockla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-vault.

AWS CLI

La commande suivante crée un coffre-fort nommé my-vault :

aws glacier create-vault --vault-name my-vault --account-id -

Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.

  • Pour API plus de détails, voir CreateVaultla 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 API plus de détails, voir DeleteArchivela 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.

L'exemple de code suivant montre comment utiliserdelete-vault-notifications.

AWS CLI

Pour supprimer les SNS notifications relatives à un coffre-fort

L'delete-vault-notificationsexemple suivant supprime les notifications envoyées par Amazon Simple Notification Service (AmazonSNS) pour le coffre spécifié.

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

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserdelete-vault.

AWS CLI

La commande suivante supprime un coffre-fort nommé my-vault :

aws glacier delete-vault --vault-name my-vault --account-id -

Cette commande ne génère pas de sortie. Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.

  • Pour API plus de détails, voir DeleteVaultla 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 API plus de détails, voir DescribeJobla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-vault.

AWS CLI

La commande suivante récupère les données relatives à un coffre-fort nommé my-vault :

aws glacier describe-vault --vault-name my-vault --account-id -

Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.

  • Pour API plus de détails, voir DescribeVaultla 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.

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 API plus de détails, voir GetJobOutputla 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\"}]}"
    }
}

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 (GETlock-policy) dans le manuel du APIdéveloppeur Amazon Glacier.

  • Pour API plus de détails, voir GetVaultLockla 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.

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 visant à 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 JSON fichier du dossier local qui indique le type de tâche, l'ID de l'archive et certains paramètres facultatifs :

{
  "Type": "archive-retrieval",
  "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
  "Description": "Retrieve archive on 2015-07-17",
  "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic"
}

IDsLes archives sont disponibles dans la sortie de aws glacier upload-archive etaws glacier get-job-output.

Sortie :

{
    "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
    "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav"
}

Consultez Initiate Job dans le manuel Amazon Glacier API Reference pour plus de détails sur le format des paramètres de la tâche.

  • Pour API plus de détails, voir InitiateJobla 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 du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.

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 (POSTlock-policy) dans le manuel du APIdéveloppeur Amazon Glacier.

  • Pour API plus de détails, voir InitiateVaultLockla 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 API plus de détails, voir ListJobsla 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 du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.

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 du AWS CLI, consultez la section Utilisation d'Amazon Glacier dans le guide de l'AWS CLIutilisateur.

  • Pour API plus de détails, voir ListPartsla 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"
        }
    ]
}

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 API plus de détails, voir ListTagsForVaultla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-vaults.

AWS CLI

La commande suivante répertorie les coffres-forts dans le compte et la région par défaut :

aws glacier list-vaults --account-id -

Sortie :

{
    "VaultList": [
        {
            "SizeInBytes": 3178496,
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "LastInventoryDate": "2015-04-07T00:26:19.028Z",
            "VaultName": "my-vault",
            "NumberOfArchives": 1,
            "CreationDate": "2015-04-06T21:23:45.708Z"
        }
    ]
}

Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.

  • Pour API plus de détails, voir ListVaultsla 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 API plus de détails, voir RemoveTagsFromVaultla 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 JSON fichier du dossier actuel qui définit une politique de récupération des données :

{
  "Rules":[
     {
         "Strategy":"BytesPerHour",
         "BytesPerHour":10737418240
      }
   ]
}

Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.

La commande suivante définit la politique de récupération des données en fonction de FreeTier l'utilisation en JSON ligne :

aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'

Consultez la section Définir la politique de récupération des données dans le manuel Amazon Glacier API Reference pour plus de détails sur le format de la politique.

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.

L'exemple de code suivant montre comment utiliserset-vault-notifications.

AWS CLI

La commande suivante configure les SNS notifications pour un coffre nommé my-vault :

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

notificationconfig.jsonest un JSON fichier du dossier en cours qui indique un SNS sujet et les événements à publier :

{
  "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
  "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"]
}

Amazon Glacier nécessite un argument d’ID de compte pour effectuer des opérations, mais vous pouvez utiliser un trait d’union pour spécifier le compte en cours d’utilisation.

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 API plus de détails, voir UploadArchivela 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 range prend une plage de HTTP contenu indiquant les octets que la partie occupe dans l'archive terminée. L’ID de téléchargement est renvoyé par la commande aws glacier initiate-multipart-upload et peut également être obtenu avec aws glacier list-multipart-uploads.

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

  • Pour API plus de détails, voir UploadMultipartPartla section Référence des AWS CLI commandes.