Esempi di utilizzo di S3 Glacier AWS CLI - AWS Command Line Interface
Azioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di utilizzo di S3 Glacier AWS CLI

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

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, puoi vedere le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareabort-multipart-upload.

AWS CLI

Il comando seguente elimina un caricamento multiparte in corso su un archivio denominato: 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 utilizzando Amazon Glacier, AWS CLI consulta Using Amazon Glacier nella Guida per l'utente.AWS CLI

Il seguente esempio di codice mostra come utilizzareabort-vault-lock.

AWS CLI

Per interrompere un processo di blocco del vault in corso

L'abort-vault-lockesempio seguente elimina una politica di blocco del vault dal vault specificato e reimposta lo stato di blocco del vault su Unlocked.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Abort Vault Lock (DELETElock-policy) nella Amazon Glacier Developer Guide. API

  • Per i API dettagli, consulta Command Reference. AbortVaultLockAWS CLI

Il seguente esempio di codice mostra come utilizzareadd-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 API i dettagli, vedere AddTagsToVaultin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecomplete-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 richiede un hash ad albero SHA -256 dell'archivio in formato esadecimale.

Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier utilizzando, comprese le istruzioni sul calcolo di un AWS CLI tree hash, consulta Using Amazon Glacier nella Guida per l'utente.AWS CLI

Il seguente esempio di codice mostra come utilizzarecomplete-vault-lock.

AWS CLI

Per completare un processo di blocco del vault in corso

L'complete-vault-lockesempio seguente completa l'avanzamento del blocco in corso per l'archivio specificato e imposta lo stato di blocco del deposito su. Locked Si ottiene il valore del parametro durante l'lock-idesecuzione. 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 (POSTlockId) nella Amazon Glacier Developer API Guide.

Il seguente esempio di codice mostra come utilizzarecreate-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 API i dettagli, vedere CreateVaultin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-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 API i dettagli, vedere DeleteArchivein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-vault-access-policy.

AWS CLI

Per rimuovere la politica di accesso di un vault

L'delete-vault-access-policyesempio seguente rimuove la politica di accesso per il vault specificato.

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

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzaredelete-vault-notifications.

AWS CLI

Per rimuovere le SNS notifiche per un vault

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

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

Questo comando non produce alcun output.

Il seguente esempio di codice mostra come utilizzaredelete-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 API i dettagli, vedere DeleteVaultin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-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 API i dettagli, vedere DescribeJobin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-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 API i dettagli, vedere DescribeVaultin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-data-retrieval-policy.

AWS CLI

Il comando seguente ottiene la politica 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.

Il seguente esempio di codice mostra come utilizzareget-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 API i dettagli, vedere GetJobOutputin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-vault-access-policy.

AWS CLI

Per recuperare la politica di accesso di un vault

L'get-vault-access-policyesempio seguente recupera la politica di accesso per il vault specificato.

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

Il seguente esempio di codice mostra come utilizzareget-vault-lock.

AWS CLI

Per ottenere i dettagli di una serratura del vault

L'get-vault-lockesempio seguente ha recuperato i dettagli sulla serratura per il vault specificato.

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 (GETlock-policy) nella Amazon Glacier Developer Guide. API

  • Per i API dettagli, consulta Command Reference. GetVaultLockAWS CLI

Il seguente esempio di codice mostra come utilizzareget-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.

Il seguente esempio di codice mostra come utilizzareinitiate-job.

AWS CLI

Il comando seguente avvia un processo per ottenere un inventario del my-vault 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 dal 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 JSON file nella cartella locale che specifica il tipo di lavoro, l'ID di archivio e alcuni parametri opzionali:

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

IDsGli archivi sono disponibili nell'output di aws glacier upload-archive eaws glacier get-job-output.

Output:

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

Per dettagli sul formato dei parametri del lavoro, consulta Initiate Job in APIAmazon Glacier Reference.

  • Per API i dettagli, consulta Command InitiateJobReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareinitiate-multipart-upload.

AWS CLI

Il comando seguente avvia un caricamento in più parti su un archivio denominato 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 genera un ID di caricamento in caso di successo. Usa l'ID di caricamento quando carichi ogni parte del tuo archivio con. aws glacier upload-multipart-part Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier utilizzando Amazon Glacier, AWS CLI consulta Using Amazon Glacier nella Guida per l'utente.AWS CLI

Il seguente esempio di codice mostra come utilizzareinitiate-vault-lock.

AWS CLI

Per avviare il processo di blocco del vault

L'initiate-vault-lockesempio seguente installa una politica di blocco del vault sull'archivio specificato e imposta lo stato di blocco del vault su. InProgress È necessario completare il processo chiamando complete-vault-lock entro 24 ore per impostare lo stato del blocco del vault. 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 del blocco del vault che è possibile utilizzare per completare il processo di blocco del vault.

{
    "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}

Per ulteriori informazioni, consulta Initiate Vault Lock (POSTlock-policy) nella Amazon Glacier Developer Guide. API

Il seguente esempio di codice mostra come utilizzarelist-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 API i dettagli, vedere ListJobsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-multipart-uploads.

AWS CLI

Il comando seguente mostra tutti i caricamenti multiparte in corso per un archivio denominato: 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 utilizzando Amazon Glacier, AWS CLI consulta Using Amazon Glacier nella Guida per l'utente.AWS CLI

Il seguente esempio di codice mostra come utilizzarelist-parts.

AWS CLI

Il comando seguente elenca le parti caricate per un caricamento in più parti su un archivio denominato: 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 utilizzando Amazon Glacier, AWS CLI consulta Using Amazon Glacier nella Guida per l'utente.AWS CLI

  • Per i API dettagli, consulta Command Reference. ListPartsAWS CLI

Il seguente esempio di codice mostra come utilizzarelist-provisioned-capacity.

AWS CLI

Per recuperare le unità di capacità assegnate

L'list-provisioned-capacityesempio seguente recupera i dettagli di 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-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.

Il seguente esempio di codice mostra come utilizzarelist-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 API i dettagli, vedere ListVaultsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarepurchase-provisioned-capacity.

AWS CLI

Per acquistare un'unità di capacità assegnata

L'purchase-provisioned-capacityesempio seguente acquista un'unità di capacità assegnata.

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

Output:

{
    "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}

Il seguente esempio di codice mostra come utilizzareremove-tags-from-vault.

AWS CLI

Il comando seguente rimuove un tag con la chiave date da un archivio denominatomy-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.

Il seguente esempio di codice mostra come utilizzareset-data-retrieval-policy.

AWS CLI

Il comando seguente configura una politica 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 JSON file nella cartella corrente che specifica una politica 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 politica di recupero dei dati sull'utilizzo di inline: FreeTier JSON

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

Per dettagli sul formato della policy, consulta la sezione Set Data Retrieval Policy in Amazon API Glacier Reference.

Il seguente esempio di codice mostra come utilizzareset-vault-access-policy.

AWS CLI

Per impostare la politica di accesso di un vault

L'set-vault-access-policyesempio seguente allega una politica di autorizzazione al vault specificato.

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.

Il seguente esempio di codice mostra come utilizzareset-vault-notifications.

AWS CLI

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

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

notificationconfig.jsonè un JSON file nella cartella corrente che specifica un SNS argomento 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.

Il seguente esempio di codice mostra come utilizzareupload-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 API i dettagli, vedere UploadArchivein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupload-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 accetta un intervallo di HTTP contenuto che indica i byte occupati dalla parte nell'archivio completo. 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 utilizzando Amazon Glacier, AWS CLI consulta Using Amazon Glacier nella Guida per l'utente.AWS CLI