Delete Archive (DELETE archive) - Amazon S3 Glacier
BeschreibungAnforderungenAntwortenBeispieleZugehörige Abschnitte

Wenn Sie mit dem Archivierungsspeicher in Amazon Simple Storage Service (Amazon S3) noch nicht vertraut sind, empfehlen wir Ihnen, sich zunächst über die S3-Glacier-Speicherklassen in Amazon S3 (S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive) zu informieren. Weitere Informationen finden Sie unter S3 Glacier-Speicherklassen und Speicherklassen für die Archivierung von Objekten im Amazon S3 S3-Benutzerhandbuch.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Delete Archive (DELETE archive)

Beschreibung

Mit dieser Operation wird ein Archiv aus einem Tresor gelöscht. Sie können zu einem gegebenen Zeitpunkt jeweils nur ein Archiv aus einem Tresor löschen. Zum Löschen des Archivs müssen Sie dessen Archiv-ID in der Löschanforderung angeben. Sie können die Archiv-ID ermitteln, indem Sie das Tresorinventar für den Tresor, in dem sich Archiv befindet, herunterladen. Weitere Informationen zum Herunterladen des Tresorinventars finden Sie unter Herunterladen eines Tresorinventars in Amazon S3 Glacier.

Nach der Löschung eines Archivs kann noch eine erfolgreiche Anforderung zur Initiierung eines Auftrags zum Abrufen des gelöschten Archivs möglich sein, der betreffende Auftrag schlägt jedoch fehl.

Wenn Sie ein Archiv löschen und währenddessen noch ein Abruf des Archivs über die Archiv-ID bearbeitet wird, kann der Abruf den folgenden Szenarien entsprechend fehlschlagen oder gelingen:

  • Wenn die Daten für den Archivabrufauftrag gerade noch zum Herunterladen vorbereitet werden, wenn Amazon S3 Glacier (S3 Glacier) die Anforderung zum Löschen des Archivs empfängt, kann der Archivabruf fehlschlagen.

  • Wenn das Archiv zu dem Zeitpunkt, zu dem S3 Glacier die Anforderung zum Löschen des Archivs empfängt, bereits erfolgreich vom Archivabrufauftrag zum Herunterladen vorbereitet wurde, dann können Sie die Ausgabe herunterladen.

Weitere Informationen zum Archivabruf finden Sie unter Herunterladen eines Archivs in S3 Glacier.

Dieser Vorgang ist idempotent. Der Versuch, ein bereits gelöschtes Archiv zu löschen, erzeugt keinen Fehler.

Anforderungen

Zum Löschen eines Archivs senden Sie eine DELETE-Anforderung an den URI der Archivressource.

Syntax

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

Anmerkung

Der AccountId-Wert ist die AWS-Konto-ID des Kontos, dem der Tresor gehört. Sie können entweder eine AWS-Konto-ID oder optional einen einzelnen Bindestrich („-“) angeben. Bei Angabe eines Bindestrichs verwendet Amazon S3 Glacier die AWS-Konto-ID, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Wenn Sie eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.

Anfrageparameter

Dieser Vorgang verwendet keine Anforderungsparameter.

Anforderungsheader

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter Häufig verwendete Anforderungsheader.

Anforderungstext

Dieser Vorgang besitzt keinen Anforderungstext.

Antworten

Syntax

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

Antwort-Header

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter Allgemeine Antwort-Header.

Antworttext

Dieser Vorgang gibt keinen Antworttext zurück.

Fehler

Weitere Informationen über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Archiv aus dem Tresor namens examplevault gelöscht wird.

Beispielanfrage

Die ID des zu löschenden Archivs wird als untergeordnete Ressource von archives angegeben.

DELETE /-/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId 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

Beispielantwort

Wenn die Anforderung erfolgreich ist, antwortet S3 Glacier mit 204 No Content, um anzuzeigen, dass das Archiv gelöscht wurde.

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