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.
# So rufen Sie Objekte auf der Grundlage von Metadaten mit bedingten Lesevorgängen ab oder kopieren 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ür `GET`-, `HEAD`- oder `COPY`-Anforderungen verwenden, 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. Entitäts-Tags (ETags) Last-Modified sind Beispiele für systemgesteuerte Metadaten. Das ETag eines Objekts ist eine Zeichenfolge, die eine bestimmte Version eines Objekts darstellt. Last-Modified Datum sind Metadaten, die das Erstellungsdatum eines Objekts oder das Datum der letzten Änderung angeben, je nachdem, welches Datum das letzte ist.
Mit bedingten Lesevorgängen können Sie ein Objekt auf der Grundlage des ETags oder Last-Modified Datums des Objekts zurückgeben. Sie können bei Ihrer Anfrage einen ETag-Wert angeben und das Objekt nur zurückgeben, wenn der ETag-Wert übereinstimmt. Dadurch wird sichergestellt, dass Sie nur eine bestimmte Version eines Objekts zurückgeben oder kopieren. Sie können in Ihrer Leseanforderung einen Last-Modified Wert angeben und ein Objekt nur zurückgeben, wenn dieses Objekt seit einem von Ihnen angegebenen Datum geändert wurde.
## Unterstützte APIs
Die folgenden S3-APIs unterstützen bedingte Lesevorgänge:
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)
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 und finden Sie Last-Modified unter[System-defined Objekt-Metadaten](UsingMetadata.md#SysMetadata).
**[https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)**
+ `If-Match` – Gibt das Objekt nur zurück, wenn sein 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 sein ETag 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 Informationen zu diesen Headern, den zurückgegebenen Fehlern und der Reihenfolge, in der S3 mehrere bedingte Header in einer einzigen Anforderung verarbeitet, finden Sie unter [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) in der API-Referenz zum Amazon Simple Storage Service.
**[https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html)**
+ `If-Match` – Gibt das Objekt nur zurück, wenn sein 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 sein ETag 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 Informationen zu diesen Headern, den zurückgegebenen Fehlern und der Reihenfolge, in der S3 mehrere bedingte Header in einer einzigen Anforderung verarbeitet, finden Sie unter [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) in der API-Referenz zum Amazon Simple Storage Service.
**[https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html)**
+ `x-amz-copy-source-if-match` – Kopiert das Quellobjekt nur, wenn sein 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 sein ETag 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.
+ `If-Match`— Kopiert das Objekt nur, wenn sein ETag mit dem angegebenen übereinstimmt. `If-Match`erwartet den ETag-Wert als Zeichenfolge.
+ `If-None-Match`— Kopiert das Objekt nur, wenn sein ETag nicht mit dem angegebenen übereinstimmt. `If-None-Match`erwartet das Zeichen '\*' (Sternchen).
Weitere Informationen zu diesen Headern, den zurückgegebenen Fehlern und der Reihenfolge, in der S3 mehrere bedingte Header in einer einzigen Anforderung verarbeitet, finden Sie unter [https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) in der API-Referenz zum Amazon Simple Storage Service.