**Questa pagina è riservata ai clienti esistenti del servizio Amazon Glacier che utilizzano Vaults e l'API REST originale del 2012.**

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage Amazon Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage di [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (servizio autonomo originale basato su vault) non accetta più nuovi clienti. Amazon Glacier è un servizio APIs autonomo che archivia i dati in vault ed è distinto dalle classi di storage Amazon S3 e Amazon S3 Glacier. I dati esistenti rimarranno sicuri e accessibili in Amazon Glacier a tempo indeterminato. Non è richiesta alcuna migrazione. Per uno storage di archiviazione a lungo termine a basso costo, AWS consiglia le classi di storage [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la [AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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

# Set Vault Access Policy (PUT access-policy)
<a name="api-SetVaultAccessPolicy"></a>

## Description
<a name="api-SetVaultAccessPolicy-description"></a>

Questa operazione consente di configurare una policy di accesso per un vault e sovrascrive una policy esistente. Per configurare una policy di accesso a vault, invia una richiesta `PUT` alla sottorisorsa `access-policy` del vault. Puoi impostare una sola policy di accesso per vault, la cui dimensione non deve essere superiore a 20 KB. Per ulteriori informazioni sulle policy di accesso a vault, consulta [Policy di accesso delle vault](vault-access-policy.md). 

## Richieste
<a name="api-SetVaultAccessPolicy-requests"></a>

### Sintassi
<a name="api-SetVaultAccessPolicy-requests-syntax"></a>

Per impostare una policy di accesso a vault, invia una richiesta HTTP `PUT` all'URI della sottorisorsa `access-policy` del vault come illustrato nell'esempio di sintassi seguente.

```
 1. PUT /AccountId/vaults/vaultName/access-policy HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy": "string"
10. }
```

 

**Nota**  
Il `AccountId` valore è l' Account AWS ID dell'account proprietario del vault. Puoi specificare un Account AWS ID o, facoltativamente, un singolo '`-`' (trattino), nel qual caso Amazon Glacier utilizza Account AWS l'ID associato alle credenziali utilizzate per firmare la richiesta. Se utilizzi un ID account, non includere alcun trattino ("-") nell'ID.

### Parametri della richiesta
<a name="api-SetVaultAccessPolicy-requests-parameters"></a>

Questa operazione non utilizza parametri richiesta.

### Intestazioni di richiesta
<a name="api-SetVaultAccessPolicy-requests-headers"></a>

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta [Intestazioni di richiesta comuni](api-common-request-headers.md).

### Corpo della richiesta
<a name="api-SetVaultAccessPolicy-requests-elements"></a>

Il corpo della richiesta contiene i campi JSON descritti di seguito.

 **Policy**   
La policy di accesso a vault in forma di stringa JSON che utilizza "\$1" come carattere di escape.  
 Tipo: stringa   
 Obbligatorio: sì

## Risposte
<a name="api-SetVaultAccessPolicy-responses"></a>

In risposta, Amazon Glacier `204 No Content` restituisce il prodotto se la politica viene accettata.

### Sintassi
<a name="api-SetVaultAccessPolicy-response-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### Intestazioni di risposta
<a name="api-SetVaultAccessPolicy-responses-headers"></a>

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md).

### Corpo della risposta
<a name="api-SetVaultAccessPolicy-responses-elements"></a>

Questa operazione non restituisce un corpo della risposta.

### Errori
<a name="api-SetVaultAccessPolicy-responses-errors"></a>

Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md)

## Esempi
<a name="api-SetVaultAccessPolicy-examples"></a>

### Richiesta di esempio
<a name="api-SetVaultAccessPolicy-example-request"></a>

L'esempio seguente invia una richiesta HTTP `PUT` all'URI della sottorisorsa `access-policy` della vault. La stringa JSON `Policy` utilizza "\$1" come carattere di escape.

```
1. PUT /-/vaults/examplevault/access-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7. 
8. {"Policy":"{\"Version\":\"2012-10-17\",		 	 	 \"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"}
```

### Risposta di esempio
<a name="api-SetVaultAccessPolicy-example-response"></a>

Se la richiesta ha avuto esito positivo, Amazon Glacier (Amazon Glacier) restituisce `HTTP 204 No Content` un come illustrato nell'esempio seguente.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

## Sezioni correlate
<a name="related-sections-SetVaultAccessPolicy"></a>

 
+ [Delete Vault Access Policy (DELETE access-policy)](api-DeleteVaultAccessPolicy.md)

 
+ [Get Vault Access Policy (GET access-policy)](api-GetVaultAccessPolicy.md)

## Vedi anche
<a name="api-SetVaultAccessPolicy_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue SDKs Amazon specifiche per lingua, consulta quanto segue:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-access-policy.html)