Esempi per S3 Glacier con la AWS CLI - AWS Command Line Interface

Esempi per S3 Glacier con la AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando l’AWS Command Line Interface con S3 Glacier.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare abort-multipart-upload.

AWS CLI

Il comando seguente elimina un caricamento in più parti in corso in una vault denominata my-vault:

aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Il comando non produce output. Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso. L'ID di caricamento viene restituito dal comando aws glacier initiate-multipart-upload e può essere ottenuto anche utilizzando aws glacier list-multipart-uploads.

Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier tramite l'AWS CLI, consulta Uso di Amazon Glacier nella Guida per l'utente di AWS CLI.

  • Per informazioni dettagliate sull’API, consulta AbortMultipartUpload in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare abort-vault-lock.

AWS CLI

Come interrompere un processo di blocco vault in corso

L’esempio abort-vault-lock seguente elimina una policy di Vault Lock dalla vault specificata e reimposta lo stato del blocco della vault su sbloccato.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Abort Vault Lock (DELETE lock-policy) nella Guida per gli sviluppatori delle API di Amazon Glacier.

  • Per informazioni dettagliate sull’API, consulta AbortVaultLock in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare add-tags-to-vault.

AWS CLI

Il comando seguente aggiunge due tag a un vault denominato my-vault:

aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sulle API, consulta AddTagsToVault in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare complete-multipart-upload.

AWS CLI

Il comando seguente completa il caricamento in più parti per un archivio da 3 MiB:

aws glacier complete-multipart-upload --archive-size 3145728 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-vault

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

L'ID di caricamento viene restituito dal comando aws glacier initiate-multipart-upload e può essere ottenuto anche utilizzando aws glacier list-multipart-uploads. Il parametro checksum considera una struttura hash SHA-256 dell’archivio in formato esadecimale.

Per ulteriori informazioni sui caricamenti in più parti su Amazon Glacier tramite la AWS CLI, con istruzioni per il calcolo di una struttura hash, consulta Using Amazon Glacier nella Guida per l’utente di AWS CLI.

L’esempio di codice seguente mostra come utilizzare complete-vault-lock.

AWS CLI

Come completare un processo di blocco vault in corso

L’esempio complete-vault-lock seguente completa l’esecuzione del blocco in corso per la vault specificata e imposta lo stato del blocco della vault su Locked. Il valore per il parametro lock-id si ottiene quando si esegue initiate-lock-process.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Complete Vault Lock (POST lockId) nella Guida per gli sviluppatori delle API di Amazon Glacier.

  • Per informazioni dettagliate sull’API, consulta CompleteVaultLock in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-vault.

AWS CLI

Il comando seguente crea un nuovo vault denominato my-vault:

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

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per ulteriori informazioni sulle API, consulta CreateVault nel Riferimento ai comandi AWS CLI.

L’esempio di codice seguente mostra come utilizzare delete-archive.

AWS CLI

Eliminazione di un archivio da un vault

L'esempio delete-archive seguente rimuove l'archivio specificato da example_vault.

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

Questo comando non produce alcun output.

  • Per informazioni dettagliate sulle API, consulta DeleteArchive in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-vault-access-policy.

AWS CLI

Come rimuovere la policy di accesso di una vault

L’esempio delete-vault-access-policy seguente rimuove la policy di accesso per la vault specificata.

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

Questo comando non produce alcun output.

L’esempio di codice seguente mostra come utilizzare delete-vault-notifications.

AWS CLI

Rimuovere le notifiche SNS per un vault

L'esempio delete-vault-notifications seguente rimuove le notifiche inviate da Amazon Simple Notification Service (Amazon SNS) per il vault specificato.

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

Questo comando non produce alcun output.

L’esempio di codice seguente mostra come utilizzare delete-vault.

AWS CLI

Il comando seguente elimina un vault denominato my-vault:

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

Il comando non produce output. Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sulle API, consulta DeleteVault in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-job.

AWS CLI

Il comando seguente recupera le informazioni su un processo di recupero dell'inventario su un vault denominato my-vault:

aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW

Output:

{ "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 del processo si trova nell'output di aws glacier initiate-job e aws glacier list-jobs. Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sulle API, consulta DescribeJob in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-vault.

AWS CLI

Il comando seguente recupera i dati relativi a un vault denominato my-vault:

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

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sulle API, consulta DescribeVault in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-data-retrieval-policy.

AWS CLI

Il comando seguente ottiene la policy di recupero dei dati per l’account in uso:

aws glacier get-data-retrieval-policy --account-id -

Output:

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

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

L’esempio di codice seguente mostra come utilizzare get-job-output.

AWS CLI

Il comando seguente salva l'output di un processo di inventario del vault in un file nella directory corrente denominata output.json:

aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json

job-id è disponibile nell'output di aws glacier list-jobs. Nota che il nome del file di output è un argomento posizionale non preceduto dal nome di un'opzione. Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Output:

{ "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"}]}
  • Per informazioni dettagliate sull'API, consulta GetJobOutput in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-vault-access-policy.

AWS CLI

Come recuperare la policy di accesso di una vault

L’esempio get-vault-access-policy seguente recupera la policy di accesso per la vault specificata.

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

Output:

{ "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\"}]}" } }
  • Per informazioni dettagliate sull’API, consulta GetVaultAccessPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-vault-lock.

AWS CLI

Come ottenere i dettagli di un blocco vault

L’esempio get-vault-lock seguente recupera i dettagli sul blocco della vault specificata.

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

Output:

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

Per ulteriori informazioni, consulta Get Vault Lock (GET lock-policy) nella Guida per gli sviluppatori delle API di Amazon Glacier.

  • Per informazioni dettagliate sull’API, consulta GetVaultLock in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-vault-notifications.

AWS CLI

Il comando seguente ottiene una descrizione della configurazione della notifica per un vault denominato my-vault:

aws glacier get-vault-notifications --account-id - --vault-name my-vault

Output:

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

Se non è stata configurata alcuna notifica per il vault, viene restituito un errore. Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

L’esempio di codice seguente mostra come utilizzare initiate-job.

AWS CLI

Il comando seguente avvia un processo per ottenere un inventario della vault my-vault:

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}'

Output:

{ "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW" }

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Il comando seguente avvia un processo per recuperare un archivio dalla vault my-vault:

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

job-archive-retrieval.json è un file JSON nella cartella locale che specifica il tipo di processo, l’ID di archivio e alcuni parametri facoltativi:

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

Gli ID di archivio sono disponibili nell’output di aws glacier upload-archive e aws glacier get-job-output.

Output:

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

Per informazioni sul formato dei parametri del processo, consulta la sezione relativa all’avvio del processo nella documentazione di riferimento delle API di Amazon Glacier.

  • Per informazioni dettagliate sull’API, consulta InitiateJob in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare initiate-multipart-upload.

AWS CLI

Il comando seguente avvia un caricamento in più parti in una vault denominata my-vault con una dimensione della parte di 1 MiB (1024 x 1024 byte) per file:

aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test"

Il parametro di descrizione dell’archivio è facoltativo. Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Questo comando restituisce un ID di caricamento in caso di esito positivo. Usa l’ID di caricamento quando carichi le singole parti del tuo archivio con aws glacier upload-multipart-part. Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier tramite l'AWS CLI, consulta Uso di Amazon Glacier nella Guida per l'utente di AWS CLI.

L’esempio di codice seguente mostra come utilizzare initiate-vault-lock.

AWS CLI

Come avviare il processo di blocco della vault

L’esempio initiate-vault-lock seguente installa una policy di Vault Lock nella vault specificata e imposta lo stato del blocco della vault su InProgress. Devi completare il processo chiamando complete-vault-lock entro 24 ore per impostare lo stato del blocco della vault su Locked.

aws glacier initiate-vault-lock \ --account-id - \ --vault-name MyVaultName \ --policy file://vault_lock_policy.json

Contenuto di 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\"}}}]}"}

L’output è l’ID di Vault Lock che puoi utilizzare per completare il processo di blocco della vault.

{ "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE" }

Per ulteriori informazioni, consulta Initiate Vault Lock (POST lock-policy) nella Guida per gli sviluppatori delle API di Amazon Glacier.

  • Per informazioni dettagliate sull’API, consulta InitiateVaultLock in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-jobs.

AWS CLI

Il comando seguente elenca i lavori in corso e quelli completati di recente per un vault denominato my-vault:

aws glacier list-jobs --account-id - --vault-name my-vault

Output:

{ "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 richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sull’API, consulta ListJobs in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-multipart-uploads.

AWS CLI

Il comando seguente mostra tutti i caricamenti in più parti in corso per una vault denominata my-vault:

aws glacier list-multipart-uploads --account-id - --vault-name my-vault

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier tramite l'AWS CLI, consulta Uso di Amazon Glacier nella Guida per l'utente di AWS CLI.

  • Per informazioni dettagliate sull’API, consulta ListMultipartUploads in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-parts.

AWS CLI

Il comando seguente elenca le parti caricate per un caricamento in più parti in una vault denominata my-vault:

aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"

Output:

{ "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 richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier tramite l'AWS CLI, consulta Uso di Amazon Glacier nella Guida per l'utente di AWS CLI.

  • Per informazioni dettagliate sull’API, consulta ListParts in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-provisioned-capacity.

AWS CLI

Come recuperare le unità di capacità assegnate

L’esempio list-provisioned-capacity seguente recupera i dettagli per tutte le unità di capacità assegnate per l’account specificato.

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

Output:

{ "ProvisionedCapacityList": [ { "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K", "ExpirationDate": "2020-03-18T19:59:24.000Z", "StartDate": "2020-02-18T19:59:24.912Z" } ] }

L’esempio di codice seguente mostra come utilizzare list-tags-for-vault.

AWS CLI

Il comando seguente consente di elencare i tag applicati a un vault denominato my-vault:

aws glacier list-tags-for-vault --account-id - --vault-name my-vault

Output:

{ "Tags": { "date": "july2015", "id": "1234" } }

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sull’API, consulta ListTagsForVault in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-vaults.

AWS CLI

Il comando seguente consente di elencare i vault nell'account e nella regione predefiniti:

aws glacier list-vaults --account-id -

Output:

{ "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 richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sull’API, consulta ListVaults in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare purchase-provisioned-capacity.

AWS CLI

Come acquistare un’unità di capacità assegnata

L’esempio purchase-provisioned-capacity seguente determina l’acquisto di un’unità di capacità assegnata.

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

Output:

{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }

L’esempio di codice seguente mostra come utilizzare remove-tags-from-vault.

AWS CLI

Il comando seguente rimuove un tag con la chiave date da un archivio denominato my-vault:

aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

  • Per informazioni dettagliate sull’API, consulta RemoveTagsFromVault in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare set-data-retrieval-policy.

AWS CLI

Il comando seguente configura un policy di recupero dei dati per l’account in uso:

aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json

data-retrieval-policy.json è un file JSON nella cartella corrente che specifica una policy di recupero dei dati:

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

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Il comando seguente imposta la policy di recupero dei dati su FreeTier utilizzando JSON in linea:

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

Per dettagli sul formato della policy, consulta la sezione relativa all’impostazione della policy di recupero dei dati nella documentazione di riferimento delle API di Amazon Glacier.

L’esempio di codice seguente mostra come utilizzare set-vault-access-policy.

AWS CLI

Come impostare la policy di accesso di una vault

L’esempio set-vault-access-policy seguente collega una policy di autorizzazione alla vault specificata.

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\"}]}"}'

Questo comando non produce alcun output.

  • Per informazioni dettagliate sull’API, consulta SetVaultAccessPolicy in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare set-vault-notifications.

AWS CLI

Il comando seguente configura le notifiche SNS per un vault denominato my-vault:

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

notificationconfig.json è un file JSON nella cartella corrente che specifica un argomento SNS e gli eventi da pubblicare:

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

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

L’esempio di codice seguente mostra come utilizzare upload-archive.

AWS CLI

Il comando seguente carica un archivio nella cartella corrente denominata archive.zip in un archivio denominato my-vault:

aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip

Output:

{ "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67", "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw" }

Amazon Glacier richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Per recuperare un archivio caricato, avvia un processo di recupero con il comando initiate-job di aws glacier.

  • Per i dettagli sull'API, consulta UploadArchive in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare upload-multipart-part.

AWS CLI

Il comando seguente carica la prima parte da 1 MiB (1024 x 1024 byte) di un archivio:

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 richiede un argomento ID account durante l'esecuzione delle operazioni, ma puoi utilizzare un trattino per specificare l'account in uso.

Il parametro body indica il percorso di un file delle parti sul filesystem locale. Il parametro range utilizza un intervallo di contenuti HTTP che indica i byte occupati dalla parte nell'archivio completato. L'ID di caricamento viene restituito dal comando aws glacier initiate-multipart-upload e può essere ottenuto anche utilizzando aws glacier list-multipart-uploads.

Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier tramite l'AWS CLI, consulta Uso di Amazon Glacier nella Guida per l'utente di AWS CLI.

  • Per informazioni dettagliate sulle API, consulta UploadMultipartPart in AWS CLI Command Reference.