Esempi di utilizzo di Amazon 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 Amazon Glacier AWS CLI

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

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

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come usare. 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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS

Il seguente esempio di codice mostra come utilizzareabort-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 Interrompere Vault Lock (policy di blocco DELETE) nella Guida per gli sviluppatori dell’API Amazon Glacier.

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.

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 considera una struttura hash SHA-256 dell’archivio in formato esadecimale.

Per ulteriori informazioni sui caricamenti multiparte su Amazon Glacier tramite AWS l'interfaccia a riga di comando, incluse le istruzioni sul calcolo di un tree hash, consulta Using Amazon Glacier nella CLI User Guide.AWS

Il seguente esempio di codice mostra come utilizzarecomplete-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 Completare Vault Lock (ID blocco POST) nella Guida per gli sviluppatori dell’API Amazon Glacier.

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.

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.

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

Il seguente esempio di codice mostra come utilizzaredelete-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 la vault specificata.

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.

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.

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.

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

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

Il seguente esempio di codice mostra come utilizzareget-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\"}]}"
    }
}

Il seguente esempio di codice mostra come utilizzareget-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 Ottenere Vault Lock (policy di blocco GET) nella Guida per gli sviluppatori dell’API Amazon Glacier.

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

IDs Gli 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 informazioni sul formato dei parametri del processo, consulta la sezione relativa all’avvio del processo nella documentazione di riferimento dell’API Amazon Glacier.

Il seguente esempio di codice mostra come utilizzareinitiate-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. Utilizza 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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS

Il seguente esempio di codice mostra come utilizzareinitiate-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 Avviare Vault Lock (policy di blocco POST) nella Guida per gli sviluppatori dell’API Amazon Glacier.

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.

Il seguente esempio di codice mostra come utilizzarelist-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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS

Il seguente esempio di codice mostra come utilizzarelist-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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS

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

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

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

Il seguente esempio di codice mostra come utilizzarepurchase-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"
}

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

Il seguente esempio di codice mostra come utilizzareset-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 dell’API Amazon Glacier.

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

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

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.

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 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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS