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.
Wie ruft man Objekte auf der Grundlage von Metadaten mit bedingten Lesevorgängen ab oder kopiert sie
Bei bedingten Lesevorgängen können Sie Ihrer Leseanforderung einen zusätzlichen Header hinzufügen, um Ihrem S3-Vorgang Vorbedingungen hinzuzufügen. Wenn diese Voraussetzungen nicht erfüllt sind, schlägt die Leseanforderung fehl.
Sie können bedingte Lesevorgänge fürGET, oder COPY -Anfragen verwendenHEAD, um ein Objekt nur auf der Grundlage seiner Metadaten zurückzugeben.
Wenn Sie ein Objekt hochladen, erstellt Amazon S3 systemgesteuerte Metadaten, die nur von S3 geändert werden können. Entity Tags (ETags) und Last-Modified sind Beispiele für systemgesteuerte Metadaten. Bei einem Objekt ETag handelt es sich um eine Zeichenfolge, die eine bestimmte Version eines Objekts darstellt. Bei dem Datum der letzten Änderung handelt es sich um Metadaten, die das Erstellungsdatum oder das Datum der letzten Änderung eines Objekts angeben, je nachdem, welches Datum das letzte ist.
Bei bedingten Lesevorgängen können Sie ein Objekt auf der Grundlage des Objekts ETag oder des Datums der letzten Änderung zurückgeben. Sie können in Ihrer Anfrage einen ETag Wert angeben und das Objekt nur zurückgeben, wenn der ETag Wert übereinstimmt. Dadurch kann sichergestellt werden, dass Sie nur eine bestimmte Version eines Objekts zurückgeben oder kopieren. Sie können in Ihrer Leseanforderung den Wert Letzte Änderung angeben und ein Objekt nur zurückgeben, wenn dieses Objekt seit einem von Ihnen angegebenen Datum geändert wurde.
Unterstützt APIs
Die folgende APIs S3-Unterstützung mit bedingten Lesevorgängen:
Sie können die folgenden Header verwenden, um ein Objekt zurückzugeben, das vom Entity-Tag (ETag) oder dem Datum der letzten Änderung abhängig ist. Weitere Hinweise zu Objektmetadaten wie ETags Last-Modified finden Sie unter. Systemdefinierte Objektmetadaten
GetObject
-
If-Match— Gibt das Objekt nur zurück, wenn es ETag mit dem angegebenen übereinstimmt. -
If-Modified-Since— Gibt das Objekt nur zurück, wenn es seit dem angegebenen Zeitpunkt geändert wurde. -
If-None-Match— Gibt das Objekt nur zurück, wenn ETag es nicht mit dem angegebenen übereinstimmt. -
If-Unmodified-Since— Gibt das Objekt nur zurück, wenn es seit dem angegebenen Zeitpunkt nicht geändert wurde.
Weitere Hinweise zu diesen Headern, den zurückgegebenen Fehlern und der Reihenfolge, in der S3 mehrere bedingte Header in einer einzigen Anfrage verarbeitet, finden Sie unter GetObjectin der Amazon Simple Storage Service API Reference.
HeadObject
-
If-Match— Gibt das Objekt nur zurück, wenn es ETag mit dem angegebenen übereinstimmt. -
If-Modified-Since— Gibt das Objekt nur zurück, wenn es seit dem angegebenen Zeitpunkt geändert wurde. -
If-None-Match— Gibt das Objekt nur zurück, wenn ETag es nicht mit dem angegebenen übereinstimmt. -
If-Unmodified-Since— Gibt das Objekt nur zurück, wenn es seit dem angegebenen Zeitpunkt nicht geändert wurde.
Weitere Hinweise zu diesen Headern, den zurückgegebenen Fehlern und der Reihenfolge, in der S3 mehrere bedingte Header in einer einzigen Anfrage verarbeitet, finden Sie unter HeadObjectin der Amazon Simple Storage Service API Reference.
CopyObject
-
x-amz-copy-source-if-match— Kopiert das Quellobjekt nur, wenn es ETag mit dem angegebenen übereinstimmt. -
x-amz-copy-source-if-modified-since— Kopiert das Quellobjekt nur, wenn es seit dem angegebenen Zeitpunkt geändert wurde. -
x-amz-copy-source-if-none-match— Kopiert das Quellobjekt nur, wenn ETag es nicht mit dem angegebenen übereinstimmt. -
x-amz-copy-source-if-unmodified-since— Kopiert das Quellobjekt nur, wenn es seit dem angegebenen Zeitpunkt nicht geändert wurde.
Weitere Hinweise zu diesen Headern, den zurückgegebenen Fehlern und der Reihenfolge, in der S3 mehrere bedingte Header in einer einzigen Anfrage verarbeitet, finden Sie unter CopyObjectin der Amazon Simple Storage Service API Reference.
