So verhindern Sie Objektüberschreibungen durch bedingte Schreibvorgänge

Durch die Verwendung von bedingten Schreibvorgängen können Sie Ihren WRITE-Anforderungen einen zusätzlichen Header hinzufügen, um die Vorbedingungen für Ihre Amazon-S3-Operation festzulegen. Um Objekte bedingt zu schreiben, fügen Sie den If-None-Match-HTTP- oder If-Match-Header hinzu.

Der If-None-Match-Header verhindert das Überschreiben vorhandener Daten, indem er überprüft, ob sich nicht bereits ein Objekt mit demselben Schlüsselnamen in Ihrem Bucket befindet.

Alternativ können Sie den If-Match Header hinzufügen, um das Entity-Tag (ETag) eines Objekts zu überprüfen, bevor Sie ein Objekt schreiben. Mit diesem Header vergleicht Amazon S3 den bereitgestellten ETag Wert mit dem ETag Wert des Objekts in S3. Wenn die ETag Werte nicht übereinstimmen, schlägt der Vorgang fehl.

Bucket-Eigentümer können Bucket-Richtlinien verwenden, um bedingte Schreibvorgänge für hochgeladene Objekte zu erzwingen. Weitere Informationen finden Sie unter Erzwingen bedingter Schreibvorgänge in Amazon-S3-Buckets.

So verhindern Sie Objektüberschreibungen auf der Grundlage von Schlüsselnamen

Sie können den bedingten If-None-Match-HTTP-Header verwenden, um anhand seines Schlüsselnamens zu überprüfen, ob ein Objekt bereits im angegebenen Bucket vorhanden ist, bevor Sie es erstellen. Wenn Sie ein Objekt in Amazon S3 hochladen, geben Sie den Schlüsselnamen an: eine eindeutige, zwischen Groß- und Kleinschreibung unterscheidende Kennung eines Objekts in einem Bucket. Ohne den If-None-Match-HTTP-Header wird das Objekt überschrieben, wenn Sie ein Objekt mit einem identischen Schlüsselnamen in einen Bucket ohne Version hochladen oder wenn die Version gesperrt ist. In einem versionierten Bucket wird das zuletzt hochgeladene Objekt zur aktuellen Version des Objekts. Bedingte Schreibvorgänge mit dem If-None-Match-HTTP-Header prüfen während des WRITE-Vorgangs, ob ein Objekt vorhanden ist. Wenn im Bucket ein identischer Schlüsselname gefunden wird, schlägt der Vorgang fehl. Weitere Informationen über das Verwenden von Schlüsselnamen finden Sie unter Markieren von Amazon-S3-Objekten.

Um bedingte Schreibvorgänge mit dem If-None-Match-HTTP-Header durchzuführen, benötigen Sie die entsprechende s3:PutObject-Berechtigung. Dadurch kann der Aufrufer überprüfen, ob Objekte im Bucket vorhanden sind. Der If-None-Match-Header erwartet den *-Wert (Sternchen).

Sie können den If-None-Match Header wie folgt verwenden APIs:

aws s3api put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --if-none-match "*"       

So verhindern Sie Überschreibungen, wenn sich das Objekt geändert hat

Bei einem Objekt ETag handelt es sich um eine Zeichenfolge, die für das Objekt eindeutig ist und eine Änderung am Inhalt des Objekts widerspiegelt. Sie können den If-Match Header verwenden, um den ETag Wert eines Objekts in einem Amazon S3 S3-Bucket mit einem Objekt zu vergleichen, das Sie während des WRITE Vorgangs angeben. Wenn die ETag Werte nicht übereinstimmen, schlägt der Vorgang fehl. Weitere Hinweise zu finden ETags Sie unterVerwenden Sie Content- MD5 und the, um hochgeladene ETag Objekte zu verifizieren.

Um bedingte Schreibvorgänge mit einem If-Match-HTTP-Header durchzuführen, benötigen Sie die Berechtigungen s3:GetObject und s3:PutObject. Auf diese Weise kann der Aufrufer den Zustand der Objekte im Bucket überprüfen ETag und deren Status verifizieren. Der If-Match Header erwartet den ETag Wert als Zeichenfolge.

Sie können den If-Match Header wie folgt verwenden APIs:

aws s3api put-object --bucket amzn-s3-demo-bucket --key dir-1/my_images.tar.bz2 --body my_images.tar.bz2 --if-match "6805f2cfc46c0f04559748bb039d69ae"       

Bedingtes Schreibverhalten

Bedingte Schreibszenarien

Berücksichtigen Sie die folgenden Szenarien, in denen zwei Clients Operationen auf demselben Bucket ausführen.

Bedingte Schreibvorgänge bei mehrteiligen Uploads

Bedingte Schreibvorgänge berücksichtigen keine laufenden Anforderungen für mehrteilige Uploads, da es sich bei diesen um noch nicht vollständig geschriebene Objekte handelt. Sehen Sie sich das folgende Beispiel an, in dem Client 1 ein Objekt mithilfe eines mehrteiligen Uploads hochlädt. Während des mehrteiligen Uploads kann Client 2 dasselbe Objekt mit dem bedingten Schreibvorgang erfolgreich schreiben. Wenn Client 1 anschließend versucht, den mehrteiligen Upload mithilfe eines bedingten Schreibvorgangs abzuschließen, schlägt der Upload fehl.

Gleichzeitiges Löschen bei mehrteiligen Uploads

Wenn eine Löschanforderung erfolgreich ist, bevor eine bedingte Schreibanforderung abgeschlossen werden kann, gibt Amazon S3 eine 409 Conflict- oder 404 Not Found-Antwort für den Schreibvorgang zurück. Das liegt daran, dass die zuvor initiierte Löschanforderung Vorrang vor dem bedingten Schreibvorgang hat. In solchen Fällen müssen Sie einen neuen mehrteiligen Upload initiieren.