Exemples d’utilisation de l’AWS CLI avec S3 Glacier

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 chargements partitionnés vers Amazon Glacier à l’aide de l’interface de ligne de commande AWS, consultez Utilisation d’Amazon Glacier dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

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-fort (DELETE lock-policy) dans le Manuel du développeur API Amazon Glacier.

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.

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 chargements partitionnés vers Amazon Glacier à l’aide de l’interface de ligne de commande AWS, avec des instructions sur le hachage d’arborescence, consultez Utilisation d’Amazon Glacier dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

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-fort (POST lockId) dans le Manuel du développeur API Amazon Glacier.

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

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.

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.

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.

La commande suivante permet d’obtenir la politique de récupération des données du 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.

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 récupérer la stratégie d’accès d’un coffre-fort

L’exemple get-vault-access-policy suivant récupère 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 obtenir les détails de verrouillage d’un coffre-fort

L’exemple get-vault-lock suivant récupère 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-fort (GET lock-policy) dans le Manuel du développeur API Amazon Glacier.

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.

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 à récupérer 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’identifiant 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"
}

Les identifiants d’archive sont disponibles dans la sortie 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 Amazon Glacier.

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 chargements partitionnés vers Amazon Glacier à l’aide de l’interface de ligne de commande AWS, consultez Utilisation d’Amazon Glacier dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

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-fort (POST lock-policy) dans le Manuel du développeur API Amazon Glacier.

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.

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 chargements partitionnés vers Amazon Glacier à l’aide de l’interface de ligne de commande AWS, consultez Utilisation d’Amazon Glacier dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

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 chargements partitionnés vers Amazon Glacier à l’aide de l’interface de ligne de commande AWS, consultez Utilisation d’Amazon Glacier dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.

Pour récupérer les unités de capacité allouée

L’exemple list-provisioned-capacity suivant récupère 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"
        }
    ]
}

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.

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 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"
}

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.

La commande suivante configure une politique de récupération 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 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 sur FreeTier à l’aide d’un extrait JSON intégré :

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 Amazon Glacier pour en savoir plus sur le format de la stratégie.

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.

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.

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.

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 chargements partitionnés vers Amazon Glacier à l’aide de l’interface de ligne de commande AWS, consultez Utilisation d’Amazon Glacier dans le Guide de l’utilisateur de l’interface de ligne de commande AWS.