

Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub 

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
<a name="cli_2_glacier_code_examples"></a>

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.

**Topics**
+ [Azioni](#actions)

## Azioni
<a name="actions"></a>

### `abort-multipart-upload`
<a name="glacier_AbortMultipartUpload_cli_2_topic"></a>

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 *  
+  *Per i dettagli sull'API, consulta Command Reference. [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)AWS CLI * 

### `abort-vault-lock`
<a name="glacier_AbortVaultLock_cli_2_topic"></a>

Il seguente esempio di codice 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 [Interrompere Vault Lock (policy di blocco DELETE)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html) nella *Guida per gli sviluppatori dell’API Amazon Glacier*.  
+  Per i dettagli sull'API, consulta [AbortVaultLock AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html)*Command Reference*. 

### `add-tags-to-vault`
<a name="glacier_AddTagsToVault_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [AddTagsToVault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html)*Command Reference*. 

### `complete-multipart-upload`
<a name="glacier_CompleteMultipartUpload_cli_2_topic"></a>

Il seguente esempio di codice 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 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 *  
+  *Per i [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)dettagli AWS CLI sull'API, consulta Command Reference.* 

### `complete-vault-lock`
<a name="glacier_CompleteVaultLock_cli_2_topic"></a>

Il seguente esempio di codice 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 [Completare Vault Lock (ID blocco POST)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html) nella *Guida per gli sviluppatori dell’API Amazon Glacier*.  
+  Per i dettagli sull'API, consulta [CompleteVaultLock AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html)*Command Reference*. 

### `create-vault`
<a name="glacier_CreateVault_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [CreateVault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)*Command Reference*. 

### `delete-archive`
<a name="glacier_DeleteArchive_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [DeleteArchive AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)*Command Reference*. 

### `delete-vault-access-policy`
<a name="glacier_DeleteVaultAccessPolicy_cli_2_topic"></a>

Il seguente esempio di codice 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.  
+  Per i dettagli sull'API, consulta [DeleteVaultAccessPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html)*Command Reference*. 

### `delete-vault-notifications`
<a name="glacier_DeleteVaultNotifications_cli_2_topic"></a>

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

```
aws glacier delete-vault-notifications \
    --account-id 111122223333 \
    --vault-name example_vault
```
Questo comando non produce alcun output.  
+  Per i dettagli sull'API, consulta [DeleteVaultNotifications AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)*Command Reference*. 

### `delete-vault`
<a name="glacier_DeleteVault_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [DeleteVault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)*Command Reference*. 

### `describe-job`
<a name="glacier_DescribeJob_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [DescribeJob AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)*Command Reference*. 

### `describe-vault`
<a name="glacier_DescribeVault_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [DescribeVault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html)*Command Reference*. 

### `get-data-retrieval-policy`
<a name="glacier_GetDataRetrievalPolicy_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [GetDataRetrievalPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html)*Command Reference*. 

### `get-job-output`
<a name="glacier_GetJobOutput_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [GetJobOutput AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)*Command Reference*. 

### `get-vault-access-policy`
<a name="glacier_GetVaultAccessPolicy_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [GetVaultAccessPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html)*Command Reference*. 

### `get-vault-lock`
<a name="glacier_GetVaultLock_cli_2_topic"></a>

Il seguente esempio di codice 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 [Ottenere Vault Lock (policy di blocco GET)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html) nella *Guida per gli sviluppatori dell’API Amazon Glacier*.  
+  Per i dettagli sull'API, consulta [GetVaultLock AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html)*Command Reference*. 

### `get-vault-notifications`
<a name="glacier_GetVaultNotifications_cli_2_topic"></a>

Il seguente esempio di codice 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.  
+  Per i dettagli sull'API, consulta [GetVaultNotifications AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)*Command Reference*. 

### `initiate-job`
<a name="glacier_InitiateJob_cli_2_topic"></a>

Il seguente esempio di codice mostra come utilizzare`initiate-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` 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 dell’API Amazon Glacier*.  
+  Per i dettagli sull'API, consulta [InitiateJob AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html)*Command Reference*. 

### `initiate-multipart-upload`
<a name="glacier_InitiateMultipartUpload_cli_2_topic"></a>

Il seguente esempio di codice 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. 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 *  
+  *Per i dettagli sull'API, consulta Command Reference. [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html)AWS CLI * 

### `initiate-vault-lock`
<a name="glacier_InitiateVaultLock_cli_2_topic"></a>

Il seguente esempio di codice 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 [Avviare Vault Lock (policy di blocco POST)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html) nella *Guida per gli sviluppatori dell’API Amazon Glacier*.  
+  Per i dettagli sull'API, consulta [InitiateVaultLock AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html)*Command Reference*. 

### `list-jobs`
<a name="glacier_ListJobs_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [ListJobs AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)*Command Reference*. 

### `list-multipart-uploads`
<a name="glacier_ListMultipartUploads_cli_2_topic"></a>

Il seguente esempio di codice 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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS *  
+  *Per i dettagli sull'API, consulta Command Reference. [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)AWS CLI * 

### `list-parts`
<a name="glacier_ListParts_cli_2_topic"></a>

Il seguente esempio di codice 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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS *  
+  *Per i dettagli sull'API, consulta Command Reference. [ListParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html)AWS CLI * 

### `list-provisioned-capacity`
<a name="glacier_ListProvisionedCapacity_cli_2_topic"></a>

Il seguente esempio di codice 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"
        }
    ]
}
```
+  Per i dettagli sull'API, consulta [ListProvisionedCapacity AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html)*Command Reference*. 

### `list-tags-for-vault`
<a name="glacier_ListTagsForVault_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [ListTagsForVault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html)*Command Reference*. 

### `list-vaults`
<a name="glacier_ListVaults_cli_2_topic"></a>

Il seguente esempio di codice mostra come utilizzare`list-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.  
+  Per i dettagli sull'API, consulta [ListVaults AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)*Command Reference*. 

### `purchase-provisioned-capacity`
<a name="glacier_PurchaseProvisionedCapacity_cli_2_topic"></a>

Il seguente esempio di codice 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"
}
```
+  Per i dettagli sull'API, consulta [PurchaseProvisionedCapacity AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html)*Command Reference*. 

### `remove-tags-from-vault`
<a name="glacier_RemoveTagsFromVault_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [RemoveTagsFromVault AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html)*Command Reference*. 

### `set-data-retrieval-policy`
<a name="glacier_SetDataRetrievalPolicy_cli_2_topic"></a>

Il seguente esempio di codice 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 dell’API Amazon Glacier*.  
+  Per i dettagli sull'API, consulta [SetDataRetrievalPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html)*Command Reference*. 

### `set-vault-access-policy`
<a name="glacier_SetVaultAccessPolicy_cli_2_topic"></a>

Il seguente esempio di codice 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 i dettagli sull'API, consulta [SetVaultAccessPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html)*Command Reference*. 

### `set-vault-notifications`
<a name="glacier_SetVaultNotifications_cli_2_topic"></a>

Il seguente esempio di codice 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.  
+  Per i dettagli sull'API, consulta [SetVaultNotifications AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)*Command Reference*. 

### `upload-archive`
<a name="glacier_UploadArchive_cli_2_topic"></a>

Il seguente esempio di codice 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 AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)*Command Reference*. 

### `upload-multipart-part`
<a name="glacier_UploadMultipartPart_cli_2_topic"></a>

Il seguente esempio di codice 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'interfaccia a riga di comando, consulta Using Amazon Glacier AWS nella CLI User Guide.AWS *  
+  *Per i dettagli sull'API, consulta Command Reference. [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)AWS CLI * 