Delete Vault (DELETE vault)

Descrizione

Questa operazione elimina un vault. Amazon S3 Glacier (S3 Glacier) elimina un vault solo se non contiene archivi alla data dell'ultimo inventario e se non sono state effettuate scritture nel vault dall'ultimo inventario. Se una delle due condizioni non è soddisfatta, l'eliminazione del vault ha esito negativo (l'archivio non viene rimosso) e S3 Glacier restituisce un errore.

Puoi utilizzare l'operazione Describe Vault (GET vault) che fornisce informazioni sul vault, incluso il numero di archivi nel vault; tuttavia, le informazioni sono basate sull'ultimo inventario vault generato da S3 Glacier.

Questa operazione è idempotente.

Nota

Quando elimini un vault, viene eliminata anche la policy di accesso a vault associata al vault. Per ulteriori informazioni sulle policy di accesso a vault, consulta Policy di accesso delle vault.

Richieste

Per eliminare un vault, invia una richiesta DELETE all'URI della risorsa vault.

Sintassi

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

Nota

Il valore AccountId è l'ID dell'Account AWS dell'account proprietario del vault. 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 utilizzi un ID account, non includere alcun trattino ("-") 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

Questa operazione non ha un corpo della richiesta.

Risposte

Sintassi

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

Intestazioni di risposta

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.

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 elimina un vault denominato examplevault. L'esempio di richiesta rappresenta una richiesta DELETE inviata all'URI della risorsa (il vault) da eliminare.

DELETE /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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

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

Sezioni correlate

• Create Vault (PUT vault)

• List Vaults (GET vaults)

• Initiate Job (POST jobs)

• 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