Create Vault (PUT vault)

Descrizione

Questa operazione crea un nuovo vault con il nome specificato.  Il nome del vault deve essere univoco in una regione AWS di un Account AWS. È possibile creare fino a 1.000 vault per account. Per informazioni sulla creazione di ulteriori vault, consulta la pagina dei dettagli prodotto di Amazon S3 Glacier.

Quando assegni un nome a un vault, devi considerare quanto segue.

• I nomi possono contenere un numero di caratteri compreso tra 1 e 255.

• I caratteri validi sono a-z, , A-Z0-9, "_" (trattino basso), "-" (trattino) e "." (punto).

Questa operazione è idempotente, nel senso che puoi inviare la stessa richiesta più volte senza che ciò abbia una qualsiasi incidenza dopo che Amazon S3 Glacier (S3 Glacier) crea il vault specificato per la prima volta.

Richieste

Sintassi

Per creare un vault, invia una richiesta HTTP PUT all'URI del vault da creare.

PUT /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

Nota

Il valore di AccountId è l'ID dell'Account AWS. Questo valore deve corrispondere all'ID dell'Account AWS associato alle credenziali utilizzate per firmare la richiesta. Puoi specificare l'ID dell'Account AWS o eventualmente un "-" (trattino), nel qual caso Amazon S3 Glacier utilizza l'ID dell'Account AWS associato alle credenziali utilizzate per firmare la richiesta. Se specifichi l'ID del tuo account, non devi includere trattini ("-") nell'ID.

Parametri della richiesta

Questa operazione non utilizza parametri richiesta.

Intestazioni di richiesta

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.

Corpo della richiesta

Per questa operazione, il corpo della richiesta deve essere vuoto (0 byte).

Risposte

Sintassi

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location

Intestazioni di risposta

Una risposta corretta include le seguenti intestazioni di risposta, oltre alle intestazioni di risposta comuni a tutte le operazioni. Per informazioni sulle intestazioni di risposta comuni, consulta Intestazioni di risposta comuni.

Nome	Descrizione
Location	Il percorso URI relativo del vault che è stato creato. Tipo: string

Corpo della risposta

Questa operazione non restituisce un corpo della risposta.

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.

Esempi

Richiesta di esempio

L'esempio seguente invia una richiesta HTTP PUT per creare un vault denominato examplevault.

PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Content-Length: 0
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Risposta di esempio

S3 Glacier crea il vault e restituisce il percorso URI relativo del vault nell'intestazione Location. L'ID account è sempre visualizzato nell'intestazione Location indipendentemente da quanto specificato nella richiesta, ovvero l'ID account o un trattino ('-').

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Location: /111122223333/vaults/examplevault

Sezioni correlate

• List Vaults (GET vaults)

• Delete Vault (DELETE vault)

• Identity and Access Management per Amazon S3 Glacier

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli Amazon SDK specifici del linguaggio, consulta quanto segue:

• AWS Command Line Interface