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-namemy-vault--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJIl 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-uploade può essere ottenuto anche utilizzandoaws 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-lockseguente 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-nameMyVaultNameQuesto 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-namemy-vault--tagsid=1234,date=july2015Amazon 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-size3145728--checksum9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ--account-id - --vault-namemy-vaultAmazon 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-uploade può essere ottenuto anche utilizzandoaws 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.
-
Per informazioni dettagliate sull’API, consulta CompleteMultipartUpload
in AWS CLI Command Reference.
-
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-lockseguente completa l’esecuzione del blocco in corso per la vault specificata e imposta lo stato del blocco della vault suLocked. Il valore per il parametrolock-idsi ottiene quando si esegueinitiate-lock-process.aws glacier complete-vault-lock \ --account-id - \ --vault-nameMyVaultName\ --lock-id9QZgEXAMPLEPhvL6xEXAMPLEQuesto 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-namemy-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-archiveseguente rimuove l'archivio specificato daexample_vault.aws glacier delete-archive \ --account-id111122223333\ --vault-nameexample_vault\ --archive-idSc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7wQuesto 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-policyseguente rimuove la policy di accesso per la vault specificata.aws glacier delete-vault-access-policy \ --account-id111122223333\ --vault-nameexample_vaultQuesto comando non produce alcun output.
-
Per informazioni dettagliate sull’API, consulta DeleteVaultAccessPolicy
in AWS CLI Command Reference.
-
L’esempio di codice seguente mostra come utilizzare delete-vault-notifications.
- AWS CLI
-
Rimuovere le notifiche SNS per un vault
L'esempio
delete-vault-notificationsseguente rimuove le notifiche inviate da Amazon Simple Notification Service (Amazon SNS) per il vault specificato.aws glacier delete-vault-notifications \ --account-id111122223333\ --vault-nameexample_vaultQuesto comando non produce alcun output.
-
Per informazioni dettagliate sulle API, consulta DeleteVaultNotifications
in AWS CLI Command Reference.
-
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-namemy-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-namemy-vault--job-idzbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMWOutput:
{ "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-jobeaws 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-namemy-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.
-
Per informazioni dettagliate sull’API, consulta GetDataRetrievalPolicy
in AWS CLI Command Reference.
-
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-namemy-vault--job-idzbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMWoutput.jsonjob-idè disponibile nell'output diaws 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-policyseguente recupera la policy di accesso per la vault specificata.aws glacier get-vault-access-policy \ --account-id111122223333\ --vault-nameexample_vaultOutput:
{ "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-lockseguente recupera i dettagli sul blocco della vault specificata.aws glacier get-vault-lock \ --account-id - \ --vault-nameMyVaultNameOutput:
{ "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-namemy-vaultOutput:
{ "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.
-
Per informazioni dettagliate sull’API, consulta GetVaultNotifications
in AWS CLI Command Reference.
-
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-namemy-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-namemy-vault--job-parametersfile://job-archive-retrieval.jsonjob-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-archiveeaws 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-vaultcon una dimensione della parte di 1 MiB (1024 x 1024 byte) per file:aws glacier initiate-multipart-upload --account-id - --part-size1048576--vault-namemy-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.-
Per informazioni dettagliate sull’API, consulta InitiateMultipartUpload
in AWS CLI Command Reference.
-
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-lockseguente installa una policy di Vault Lock nella vault specificata e imposta lo stato del blocco della vault suInProgress. Devi completare il processo chiamandocomplete-vault-lockentro 24 ore per impostare lo stato del blocco della vault suLocked.aws glacier initiate-vault-lock \ --account-id - \ --vault-nameMyVaultName\ --policyfile://vault_lock_policy.jsonContenuto 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-namemy-vaultOutput:
{ "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-namemy-vaultAmazon 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-namemy-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-capacityseguente recupera i dettagli per tutte le unità di capacità assegnate per l’account specificato.aws glacier list-provisioned-capacity \ --account-id111122223333Output:
{ "ProvisionedCapacityList": [ { "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K", "ExpirationDate": "2020-03-18T19:59:24.000Z", "StartDate": "2020-02-18T19:59:24.912Z" } ] }-
Per informazioni dettagliate sull’API, consulta ListProvisionedCapacity
in AWS CLI Command Reference.
-
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-namemy-vaultOutput:
{ "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-capacityseguente determina l’acquisto di un’unità di capacità assegnata.aws glacier purchase-provisioned-capacity \ --account-id111122223333Output:
{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }-
Per informazioni dettagliate sull’API, consulta PurchaseProvisionedCapacity
in AWS CLI Command Reference.
-
L’esempio di codice seguente mostra come utilizzare remove-tags-from-vault.
- AWS CLI
-
Il comando seguente rimuove un tag con la chiave
dateda un archivio denominatomy-vault:aws glacier remove-tags-from-vault --account-id - --vault-namemy-vault--tag-keysdateAmazon 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 - --policyfile://data-retrieval-policy.jsondata-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
FreeTierutilizzando 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.
-
Per informazioni dettagliate sull’API, consulta SetDataRetrievalPolicy
in AWS CLI Command Reference.
-
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-policyseguente collega una policy di autorizzazione alla vault specificata.aws glacier set-vault-access-policy \ --account-id111122223333\ --vault-nameexample_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-namemy-vault--vault-notification-configfile://notificationconfig.jsonnotificationconfig.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.
-
Per informazioni dettagliate sulle API, consulta SetVaultNotifications
in AWS CLI Command Reference.
-
L’esempio di codice seguente mostra come utilizzare upload-archive.
- AWS CLI
-
Il comando seguente carica un archivio nella cartella corrente denominata
archive.zipin un archivio denominatomy-vault:aws glacier upload-archive --account-id - --vault-namemy-vault--bodyarchive.zipOutput:
{ "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 --bodypart1--range 'bytes 0-1048575/*'--account-id - --vault-namemy-vault--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJAmazon 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-uploade può essere ottenuto anche utilizzandoaws 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.
-