View a markdown version of this page

POST Object - Amazon Simple Storage Service
DescriptionAnforderungenBeispieleVerwandte Ressourcen

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.

POST Object

Description

Der POST Vorgang fügt mithilfe von HTML-Formularen ein Objekt zu einem angegebenen Bucket hinzu. POSTist eine alternative Form vonPUT, die browserbasierte Uploads ermöglicht, um Objekte in Buckets zu platzieren. Parameter, die PUT über HTTP-Header übergeben werden, werden stattdessen als Formularfelder an den mit multipart/form -data kodierten POST Nachrichtentext übergeben. Um ein Objekt zu einem Bucket hinzuzufügen, müssen Sie WRITE Zugriff auf den Bucket haben. Amazon S3 speichert niemals Teilobjekte. Wenn Sie eine erfolgreiche Antwort erhalten, können Sie sicher sein, dass das gesamte Objekt gespeichert wurde.

Amazon S3 ist ein verteiltes System. Wenn Amazon S3 mehrere Schreibanforderungen für dasselbe Objekt gleichzeitig empfängt, wird nur die letzte Version des geschriebenen Objekts gespeichert, es sei denn, Sie haben die Versionierung für einen Bucket aktiviert.

Verwenden Sie das Formularfeld, um sicherzustellen, dass Daten beim Durchlaufen des Netzwerks nicht beschädigt werden. Content-MD5 Wenn Sie dieses Formularfeld verwenden, vergleicht Amazon S3 das Objekt mit dem angegebenen MD5-Wert. Wenn sie nicht übereinstimmen, gibt Amazon S3 einen Fehler zurück. Darüber hinaus können Sie den MD5-Wert berechnen, während Sie ein Objekt an Amazon S3 senden, und den zurückgegebenen Wert mit ETag dem berechneten MD5-Wert vergleichen. Das ETag spiegelt nur Änderungen am Inhalt eines Objekts wider, nicht an seinen Metadaten.

Anmerkung

Um Ihre Anwendung so zu konfigurieren, dass sie die Anforderungsheader sendet, bevor der Anforderungstext gesendet wird, verwenden Sie den HTTP-Statuscode 100 (Weiter). Bei POST Operationen hilft Ihnen die Verwendung dieses Statuscodes dabei, das Senden des Nachrichtentexts zu vermeiden, wenn die Nachricht aufgrund der Header abgelehnt wird (z. B. aufgrund eines Authentifizierungsfehlers oder einer Umleitung). Weitere Informationen zum HTTP-Statuscode 100 (Weiter) finden Sie in Abschnitt 8.2.3 von. http://www.ietf.org/rfc/rfc2616.txt

Amazon S3 verschlüsselt automatisch alle neuen Objekte, die in einen S3-Bucket hochgeladen werden. Die Verschlüsselungseinstellung eines hochgeladenen Objekts hängt von der Standardverschlüsselungskonfiguration des Ziel-Buckets ab. Standardmäßig verfügen alle Buckets über eine Standardverschlüsselungskonfiguration, die serverseitige Verschlüsselung mit von Amazon S3 verwalteten Schlüsseln () SSE-S3 verwendet.

Wenn der Ziel-Bucket über eine Verschlüsselungskonfiguration verfügt, die serverseitige Verschlüsselung mit einem AWS Key Management Service (AWS KMS) -Schlüssel (SSE-KMS), eine duale serverseitige Verschlüsselung mit einem AWS KMS Schlüssel (DSSE-KMS) oder einen vom Kunden bereitgestellten Verschlüsselungsschlüssel (SSE-C) verwendet, verwendet Amazon S3 den entsprechenden KMS-Schlüssel oder den vom Kunden bereitgestellten Schlüssel, um das hochgeladene Objekt zu verschlüsseln. Wenn Sie beim Hochladen eines Objekts die Verschlüsselungseinstellung des hochgeladenen Objekts ändern möchten, können Sie die Art der serverseitigen Verschlüsselung angeben. Sie können SSE-S3, SSE-KMS DSSE-KMS, oder konfigurieren. SSE-C Weitere Informationen finden Sie unter Schutz von Daten durch serverseitige Verschlüsselung im Amazon Simple Storage Service User Guide.

Wichtig

Achten Sie beim Erstellen Ihrer Anfrage darauf, dass das file Feld das letzte Feld im Formular ist.

Anforderungen

Syntax

POST / HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
User-Agent: browser_data
Accept: file_types
Accept-Language: Regions
Accept-Encoding: encoding
Accept-Charset: character_set
Keep-Alive: 300
Connection: keep-alive
Content-Type: multipart/form-data; boundary=9431149156168
Content-Length: length

--9431149156168
Content-Disposition: form-data; name="key"

acl
--9431149156168
Content-Disposition: form-data; name="tagging"

<Tagging><TagSet><Tag><Key>Tag Name</Key><Value>Tag Value</Value></Tag></TagSet></Tagging>
--9431149156168
Content-Disposition: form-data; name="success_action_redirect"

success_redirect
--9431149156168
Content-Disposition: form-data; name="Content-Type"

content_type
--9431149156168
Content-Disposition: form-data; name="x-amz-meta-uuid"

uuid
--9431149156168
Content-Disposition: form-data; name="x-amz-meta-tag"

metadata
--9431149156168
Content-Disposition: form-data; name="AWSAccessKeyId"

access-key-id
--9431149156168
Content-Disposition: form-data; name="Policy"

encoded_policy
--9431149156168
Content-Disposition: form-data; name="Signature"

signature=
--9431149156168
Content-Disposition: form-data; name="file"; filename="MyFilename.jpg"
Content-Type: image/jpeg

file_content
--9431149156168
Content-Disposition: form-data; name="submit"

Upload to Amazon S3
--9431149156168--

Anforderungsparameter

Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.

Formularfelder

Dieser Vorgang kann die folgenden Formularfelder verwenden.

Name Description Erforderlich
AWSAccessKeyId

Die AWS Zugriffsschlüssel-ID des Besitzers des Buckets, der einem anonymen Benutzer Zugriff auf eine Anfrage gewährt, die die Einschränkungen in der Richtlinie erfüllt.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Erforderlich, wenn der Anfrage ein Richtliniendokument beigefügt ist.

Bedingt
acl

Die angegebene Amazon S3-Zugriffskontrollliste (ACL). Wenn die angegebene ACL nicht gültig ist, wird ein Fehler generiert. Weitere Informationen zu ACLs finden Sie in der Übersicht über die Zugriffskontrollliste (ACL) im Amazon Simple Storage Service-Benutzerhandbuch.

Typ: Zeichenfolge

Standard: privat

Zulässige Werte: private | public-read | public-read-write | aws-exec-read | authenticated-read | bucket-owner-read | bucket-owner-full-control

Nein
Cache-Control, Content-Type, Content-Disposition, Content-Encoding, Expires

Die REST-specific Header. Weitere Informationen finden Sie unter PutObject.

Typ: Zeichenfolge

Standard: keiner

Nein
file

Der Datei- oder Textinhalt.

Der Datei- oder Textinhalt muss das letzte Feld im Formular sein.

Sie können nicht mehr als eine Datei zur gleichen Zeit hochladen.

Typ: Datei- oder Textinhalt

Standard: keiner

Ja
key

Der Name des hochgeladenen Schlüssels.

Verwenden Sie die ${filename} Variable, um den vom Benutzer angegebenen Dateinamen zu verwenden. Wenn beispielsweise ein Benutzer namens Mary die Datei hochlädt example.jpg und Sie angeben/user/mary/${filename}, lautet /user/mary/example.jpg der Schlüsselname.

Weitere Informationen finden Sie unter Objektschlüssel und Metadaten im Amazon Simple Storage Service-Benutzerhandbuch.

Typ: Zeichenfolge

Standard: keiner

Ja
policy

Die Sicherheitsrichtlinie, die beschreibt, was in der Anfrage zulässig ist. Anfragen ohne Sicherheitsrichtlinie werden als anonym betrachtet und funktionieren nur in öffentlich beschreibbaren Buckets. Weitere Informationen finden Sie unter HTML-Formulare und Upload-Beispiele im Amazon Simple Storage Service-Benutzerhandbuch.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Eine Sicherheitsrichtlinie ist erforderlich, wenn der Bucket nicht öffentlich beschreibbar ist.

Bedingt
success_action_redirect, redirect

Die URL, zu der der Client nach einem erfolgreichen Upload umgeleitet wird.

Wenn success_action_redirect nicht angegeben ist, gibt Amazon S3 den leeren Dokumententyp zurück, der im Feld success_action_status angegeben ist.

Wenn Amazon S3 die URL nicht interpretieren kann, verhält es sich so, als ob das Feld nicht vorhanden wäre.

Wenn der Upload fehlschlägt, zeigt Amazon S3 einen Fehler an und leitet den Benutzer nicht zu einer URL um.

Typ: Zeichenfolge

Standard: keiner

Anmerkung

Der redirect Feldname ist veraltet und die Unterstützung für den redirect Feldnamen wird in Zukunft entfernt.

Nein
success_action_status

Wenn Sie nichts angebensuccess_action_redirect, wird der Statuscode an den Client zurückgegeben, wenn der Upload erfolgreich ist.

Dieses Feld akzeptiert die Werte 200201, oder 204 (die Standardeinstellung).

Wenn der Wert auf 200 oder gesetzt ist204, gibt Amazon S3 ein leeres Dokument mit einem Statuscode 200 oder 204 zurück.

Wenn der Wert auf gesetzt ist201, gibt Amazon S3 ein XML-Dokument mit einem Statuscode 201 zurück.

Wenn der Wert nicht festgelegt ist oder wenn er auf einen ungültigen Wert gesetzt ist, gibt Amazon S3 ein leeres Dokument mit einem 204-Statuscode zurück.

Typ: Zeichenfolge

Standard: keiner

Nein
tagging

Der angegebene Satz von Tags, die dem Objekt hinzugefügt werden sollen. Verwenden Sie das folgende Kodierungsschema, um Tags hinzuzufügen.

<Tagging>
  <TagSet>
    <Tag>
      <Key>TagName</Key>
      <Value>TagValue</Value>
    </Tag>
    ...
  </TagSet>
</Tagging>

Weitere Informationen finden Sie unter Objektkennzeichnung im Amazon Simple Storage Service-Benutzerhandbuch.

Typ: Zeichenfolge

Standard: keiner

Nein
x-amz-storage-class

Die Speicherklasse, die zum Speichern des Objekts verwendet werden soll. Wenn Sie keine Klasse angeben, verwendet Amazon S3 die Standardspeicherklasse,STANDARD. Amazon S3 unterstützt andere Speicherklassen. Weitere Informationen finden Sie unter Speicherklassen im Amazon Simple Storage Service-Benutzerhandbuch.

Typ: Zeichenfolge

Standard: STANDARD

Zulässige Werte: REDUCED_REDUNDANCY | EXPRESS_ONEZONE | DEEP_ARCHIVE | GLACIER | GLACIER_IR | INTELLIGENT_TIERING | ONEZONE_IA | STANDARD | STANDARD_IA

Nein
x-amz-meta-*

Header, die mit diesem Präfix beginnen, sind benutzerdefinierte Metadaten. Jeder wird gespeichert und als Satz von Schlüssel-Wert-Paaren zurückgegeben. Amazon S3 validiert oder interpretiert keine benutzerdefinierten Metadaten. Weitere Informationen finden Sie unter PutObject.

Typ: Zeichenfolge

Standard: keiner

Nein
x-amz-security-token

Das DevPay Amazon-Sicherheitstoken.

Für jede Anfrage, die Amazon verwendet, DevPay sind zwei x-amz-security-token Formularfelder erforderlich: eines für das Produkt-Token und eines für das Benutzer-Token.

Typ: Zeichenfolge

Standard: keiner

Nein
x-amz-signature

(AWS Signaturversion 4) Der HMAC-SHA256 Hash der Sicherheitsrichtlinie.

Typ: Zeichenfolge

Standard: keiner

Bedingt
x-amz-website-redirect-location

Wenn der Bucket als Website konfiguriert ist, leitet dieses Feld Anfragen für dieses Objekt an ein anderes Objekt im selben Bucket oder an eine externe URL weiter. Amazon S3 speichert den Wert dieses Headers in den Objektmetadaten. Informationen zu Objektmetadaten finden Sie unter Objektschlüssel und Metadaten im Amazon Simple Storage Service-Benutzerhandbuch.

Im folgenden Beispiel legt der Anforderungsheader die Weiterleitung auf ein Objekt (anotherPage.html) im selben Bucket fest:

x-amz-website-redirect-location: /anotherPage.html

Im folgenden Beispiel legt der Anforderungsheader die Objektumleitung auf eine andere Website fest:

x-amz-website-redirect-location: http://www.example.com/

Weitere Informationen zum Website-Hosting in Amazon S3 finden Sie unter Hosten von Websites auf Amazon S3 und So konfigurieren Sie Webseitenumleitungen im Amazon Simple Storage Service-Benutzerhandbuch.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Dem Wert muss /http://, oder https:// vorangestellt werden. Die Länge des Werts ist auf 2 KB begrenzt.

 Nein

Zusätzliche Felder für das Prüfsummen-Anforderungsformular

Beim Hochladen eines Objekts können Sie verschiedene Prüfsummen angeben, die Sie zur Überprüfung Ihrer Datenintegrität verwenden möchten. Sie können einen zusätzlichen Prüfsummenalgorithmus angeben, den Amazon S3 verwenden soll. Weitere Informationen zu zusätzlichen Prüfsummenwerten finden Sie unter Prüfen der Objektintegrität im Amazon Simple Storage Service-Benutzerhandbuch.

Name Description Erforderlich
x-amz-checksum-algorithm

Gibt den Algorithmus an, der zur Erstellung der Prüfsumme für das Objekt verwendet wurde. Wenn ein Wert angegeben ist, müssen Sie den entsprechenden Prüfsummen-Header angeben. Andernfalls generiert Ihre Anfrage einen 400-Fehler.

Mögliche Werte sind CRC32, CRC32C, SHA1 und SHA256.

 Nein
x-amz-checksum-crc32

Gibt die Base64-kodierte 32-Bit-CRC32-Prüfsumme des Objekts an.

Dieser Parameter ist erforderlich, wenn der Wert von ist. x-amz-checksum-algorithm CRC32

 Bedingt
x-amz-checksum-crc32c

Gibt die Base64-kodierte 32-Bit-CRC32C-Prüfsumme des Objekts an.

Dieser Parameter ist erforderlich, wenn der Wert von ist. x-amz-checksum-algorithm CRC32C

 Bedingt
x-amz-checksum-sha1

Gibt den Base64-kodierten SHA-1 160-Bit-Digest des Objekts an.

Dieser Parameter ist erforderlich, wenn der Wert von ist. x-amz-checksum-algorithm SHA1

 Bedingt
x-amz-checksum-sha256

Gibt den Base64-kodierten SHA-256 256-Bit-Digest des Objekts an.

Dieser Parameter ist erforderlich, wenn der Wert von ist. x-amz-checksum-algorithm SHA256

 Bedingt

Server-Side Verschlüsselungsspezifische Felder im Anforderungsformular

Server-side Verschlüsselung ist Datenverschlüsselung im Ruhezustand. Amazon S3 verschlüsselt Ihre Daten beim Schreiben auf Festplatten in AWS Rechenzentren und entschlüsselt Ihre Daten, wenn Sie darauf zugreifen. Beim Hochladen eines Objekts können Sie die Art der serverseitigen Verschlüsselung angeben, die Amazon S3 für die Verschlüsselung des Objekts verwenden soll.

Es gibt vier Arten der serverseitigen Verschlüsselung:

  • Server-side Verschlüsselung mit von Amazon S3 verwalteten Schlüsseln (SSE-S3) — Ab Mai 2022 ist für alle Amazon S3-Buckets standardmäßig eine Verschlüsselung konfiguriert. Die Standardoption für serverseitige Verschlüsselung ist mit. SSE-S3 Jedes Objekt wird mit einem eindeutigen Schlüssel verschlüsselt. SSE-S3 Verschlüsselt als zusätzliche Schutzmaßnahme den Schlüssel selbst mit einem Stammschlüssel, den er regelmäßig wechselt. SSE-S3 verwendet eine der stärksten verfügbaren Blockchiffren, den 256-Bit-Advanced Encryption Standard (AES-256), um Ihre Daten zu verschlüsseln.

  • Server-side Verschlüsselung mit AWS KMS Schlüsseln (SSE-KMS) — SSE-KMS wird durch eine Integration des AWS KMS Dienstes mit Amazon S3 bereitgestellt. Mit AWS KMS haben Sie mehr Kontrolle über Ihre Schlüssel. Sie können beispielsweise separate Schlüssel anzeigen, Kontrollrichtlinien bearbeiten und den Schlüsseln in AWS CloudTrail folgen. Darüber hinaus können Sie vom Kunden verwaltete Schlüssel erstellen und verwalten oder von Von AWS verwaltete Schlüssel verwaltete Schlüssel verwenden, die für Sie, Ihren Service und Ihre Region einzigartig sind.

  • Dual-layer serverseitige Verschlüsselung mit AWS KMS Schlüsseln (DSSE-KMS) — Die Dual-layer serverseitige Verschlüsselung mit AWS KMS keys (DSSE-KMS) ähnelt der Verschlüsselung auf Objektebene SSE-KMS, wendet jedoch statt einer Ebene zwei einzelne Ebenen an.

  • Server-side Verschlüsselung mit vom Kunden bereitgestellten Schlüsseln (SSE-C) — Mit SSE-C verwalten Sie die Verschlüsselungsschlüssel, und Amazon S3 verwaltet die Verschlüsselung beim Schreiben auf Festplatten sowie die Entschlüsselung, wenn Sie auf Ihre Objekte zugreifen.

    Anmerkung

    Wenn Sie die serverseitige Verschlüsselung mit vom Kunden bereitgestellten Schlüsseln (SSE-C) für Ihren Allzweck-Bucket gesperrt haben, erhalten Sie die Fehlermeldung HTTP 403 Access Denied, wenn Sie beim Schreiben neuer Daten in Ihren Bucket die SSE-C Anforderungsheader angeben. Weitere Informationen finden Sie unter Blockieren oder Entsperren SSE-C für einen Allzweck-Bucket.

Weitere Informationen finden Sie unter Schützen von Daten mithilfe serverseitiger Verschlüsselung im Amazon Simple Storage Service-Benutzerhandbuch.

Je nachdem, welche Art der serverseitigen Verschlüsselung Sie verwenden möchten, geben Sie die folgenden Formularfelder an.

  • Verwenden Sie SSE-S3 SSE-KMS, oder DSSE-KMS — Wenn Sie diese Arten der serverseitigen Verschlüsselung verwenden möchten, geben Sie die folgenden Formularfelder in der Anfrage an.

    Name Description Erforderlich
    x-amz-server-side-encryption

    Gibt den serverseitigen Verschlüsselungsalgorithmus an, der verwendet werden soll, wenn Amazon S3 ein Objekt erstellt. Um es zu verwenden SSE-S3, geben Sie anAES256. Um es zu verwenden SSE-KMS, geben Sie anaws:kms. Um es zu verwenden DSSE-KMS, geben Sie anaws:kms:dsse.

    Typ: Zeichenfolge

    Gültiger Wert:aws:kms,AES256, aws:kms:dsse

    		 Ja
    x-amz-server-side-encryption-aws-kms-key-id

    Wenn der x-amz-server-side-encryption Header den gültigen Wert aws:kms oder hataws:kms:dsse, gibt dieser Header die ID von an AWS KMS key , die zum Verschlüsseln des Objekts verwendet wurde.

    Typ: Zeichenfolge

    		 Ja, wenn der Wert von oder x-amz-server-side-encryption ist aws:kms aws:kms:dsse
    x-amz-server-side-encryption-context

    Wenn der gültige Wert aws:kms oder x-amz-server-side-encryption istaws:kms:dsse, gibt dieser Header den Verschlüsselungskontext für das Objekt an. Der Wert dieses Headers ist eine Base64-kodierte UTF-8 Zeichenfolge, die JSON-formatted Schlüssel-Wert-Paare für den Verschlüsselungskontext enthält.

    Typ: Zeichenfolge

    		 Nein
    x-amz-server-side-encryption-bucket-key-enabled

    Wenn der Wert aws:kms oder gültig x-amz-server-side-encryption ist, gibt dieser Header anaws:kms:dsse, ob Amazon S3 einen S3-Bucket-Schlüssel mit oder verwenden soll. SSE-KMS DSSE-KMS Wenn dieser Header auf gesetzt true wird, verwendet Amazon S3 einen S3-Bucket Key für die Objektverschlüsselung mit SSE-KMS oder DSSE-KMS.

    Typ: Boolescher Wert

    		 Nein
    Anmerkung

    Wenn Sie x-amz-server-side-encryption:aws:kms oder angebenx-amz-server-side-encryption:aws:kms:dsse, aber nicht angebenx-amz-server-side-encryption-aws-kms-key-id, verwendet Amazon S3 das Von AWS verwalteter Schlüssel (aws/S3), um die Daten zu schützen.

  • Verwenden SSE-C — Wenn Sie Ihre eigenen Verschlüsselungsschlüssel verwalten möchten, müssen Sie in der Anfrage alle folgenden Formularfelder angeben.

    Anmerkung

    Wenn Sie diesen Wert verwenden SSE-C, entspricht der ETag Wert, den Amazon S3 in der Antwort zurückgibt, nicht dem MD5-Wert des Objekts.

    Name Description Erforderlich
    x-amz-server-side-encryption-customer-algorithm

    Gibt den Algorithmus an, der beim Verschlüsseln des Objekts verwendet werden soll.

    Typ: Zeichenfolge

    Standard: keiner

    Gültiger Wert: AES256

    Einschränkungen: Muss von gültigen x-amz-server-side-encryption-customer-key x-amz-server-side-encryption-customer-key-MD5 UND-Feldern begleitet werden.

    		 Ja
    x-amz-server-side-encryption-customer-key

    Gibt den vom Kunden bereitgestellten Base64-kodierten Verschlüsselungsschlüssel an, den Amazon S3 zum Verschlüsseln von Daten verwenden soll. Dieser Wert wird verwendet, um das Objekt zu speichern, und dann wird es verworfen. Amazon speichert den Verschlüsselungsschlüssel nicht. Der Schlüssel muss für die Verwendung mit dem Algorithmus geeignet sein, der im x-amz-server-side-encryption-customer-algorithm-Header angegeben ist.

    Typ: Zeichenfolge

    Standard: keiner

    Einschränkungen: Muss von gültigen x-amz-server-side-encryption-customer-algorithm x-amz-server-side-encryption-customer-key-MD5 UND-Feldern begleitet werden.

    		 Ja
    x-amz-server-side-encryption-customer-key-MD5

    Gibt den Base64-kodierten 128-Bit-MD5-Digest des Verschlüsselungsschlüssels gemäß RFC 1321 an. http://tools.ietf.org/html/rfc1321 Amazon S3 verwendet diesen Header für eine Überprüfung der Nachrichtenintegrität, um sicherzustellen, dass der Verschlüsselungsschlüssel fehlerfrei übertragen wurde.

    Typ: Zeichenfolge

    Standard: keiner

    Einschränkungen: Muss von gültigen x-amz-server-side-encryption-customer-algorithm UND-Feldern begleitet werden. x-amz-server-side-encryption-customer-key

    		 Ja

Antworten

Antwort-Header

Diese Implementierung des Vorgangs kann zusätzlich zu den Antwortheadern, die allen Antworten gemeinsam sind, die folgenden Antwortheader enthalten. Weitere Informationen finden Sie unter Allgemeine Antwortheader.

Name Description
x-amz-checksum-crc32

Die Base64-kodierte 32-Bit-CRC32-Prüfsumme des Objekts.

Typ: Zeichenfolge
x-amz-checksum-crc32c

Die Base64-kodierte 32-Bit-CRC32C-Prüfsumme des Objekts.

Typ: Zeichenfolge
x-amz-checksum-sha1

Der Base64-kodierte 160-Bit-Digest des Objekts. SHA-1

Typ: Zeichenfolge
x-amz-checksum-sha256

Der Base64-kodierte 256-Bit-Digest des Objekts. SHA-256

Typ: Zeichenfolge
x-amz-expiration

Wenn im Rahmen der Lifecycle-Konfiguration des Buckets eine Expiration Aktion für das Objekt konfiguriert ist, gibt Amazon S3 diesen Header zurück.  Der Header-Wert umfasst eine expiry-date Komponente und eine URL-encoded rule-id Komponente.  Bei versionsfähigen Buckets gilt dieser Header nur für aktuelle Versionen. Amazon S3 bietet keinen Header, der angibt, wann eine nicht aktuelle Version dauerhaft gelöscht werden kann. Weitere Informationen finden Sie unter PutBucketLifecycleConfiguration.

Typ: Zeichenfolge
success_action_redirect, redirect

Die URL, zu der der Client bei einem erfolgreichen Upload umgeleitet wird.

Typ: Zeichenfolge

Vorfahr: PostResponse
x-amz-server-side-encryption

Der serverseitige Verschlüsselungsalgorithmus, der beim Speichern dieses Objekts in Amazon S3 verwendet wurde (z. B., AES256aws:kms,aws:kms:dsse).

Typ: Zeichenfolge
x-amz-server-side-encryption-aws-kms-key-id

Wenn der x-amz-server-side-encryption Header einen gültigen Wert von hataws:kms, gibt dieser Header die ID des KMS-Schlüssels an, der zum Verschlüsseln des Objekts verwendet wurde.

Typ: Zeichenfolge
x-amz-server-side-encryption-bucket-key-enabled

Wenn dieser Header einen gültigen Wert von x-amz-server-side-encryption hataws:kms, gibt dieser Header an, ob das Objekt SSE-KMS mithilfe eines S3-Bucket-Schlüssels verschlüsselt wurde. Wenn dieser Header auf gesetzt isttrue, verwendet das Objekt einen S3-Bucket Key mit SSE-KMS.

Typ: Boolescher Wert
x-amz-server-side-encryption-customer-algorithm

Wenn eine Anfrage gestellt SSE-C wurde, enthält die Antwort diesen Header, der den verwendeten Verschlüsselungsalgorithmus bestätigt.

Typ: Zeichenfolge

Zulässige Werte: AES256
x-amz-server-side-encryption-customer-key-MD5

Falls eine Anfrage gestellt SSE-C wurde, enthält die Antwort diesen Header, um die Integrität der Round-Trip-Nachricht des vom Kunden bereitgestellten Verschlüsselungsschlüssels zu überprüfen.

Typ: Zeichenfolge
x-amz-version-id

Version des Objekts.

Typ: Zeichenfolge

Antwortelemente

Name Description
Bucket

Der Name des Buckets, in dem das Objekt gespeichert wurde.

Typ: Zeichenfolge

Vorfahr: PostResponse
ETag

Das Entitäts-Tag (ETag) ist ein MD5-Hash des Objekts, das Sie für bedingte GET Operationen verwenden können, indem Sie das Anforderungs-Tag zusammen mit der If-Modified GET Anforderungsoperation verwenden. ETagspiegelt nur Änderungen am Inhalt eines Objekts wider, nicht an seinen Metadaten.

Typ: Zeichenfolge

Vorfahr: PostResponse
Key

Der Schlüsselname des Objekts.

Typ: Zeichenfolge

Vorfahr: PostResponse
Location

Die URI des Objekts.

Typ: Zeichenfolge

Vorfahr: PostResponse

Spezielle Fehler

Diese Implementierung der Operation gibt keine speziellen Fehler zurück. Allgemeine Informationen zu Amazon S3-Fehlern und eine Liste von Fehlercodes finden Sie unter Fehlerantworten.

Beispiele

Beispielanforderung

POST /Neo HTTP/1.1
Content-Length: 4
Host: quotes.s3.amazonaws.com
Date: Wed, 01 Mar  2006 12:00:00 GMT
Authorization: authorization string
Content-Type: text/plain
Expect: the 100-continue HTTP status code

ObjectContent

Beispielantwort mit unterbrochener Versionierung

Im Folgenden finden Sie ein Beispiel für eine Antwort, wenn die Bucket-Versionierung ausgesetzt ist:

HTTP/1.1 100 Continue
HTTP/1.1 200 OK
x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
x-amz-request-id: 0A49CE4060975EAC
x-amz-version-id: default
Date: Wed, 12 Oct 2009 17:50:00 GMT
ETag: "1b2cf535f27731c974343645a3985328"
Content-Length: 0
Connection: close
Server: AmazonS3

In dieser Antwort lautet null die Versions-ID.

Beispielantwort mit aktivierter Versionierung

Im Folgenden finden Sie ein Beispiel für eine Antwort, wenn die Bucket-Versionierung aktiviert ist.

HTTP/1.1 100 Continue
HTTP/1.1 200 OK
x-amz-id-2: LriYPLdmOdAiIfgSm/F1YsViT1LW94/xUQxMsF7xiEb1a0wiIOIxl+zbwZ163pt7
x-amz-request-id: 0A49CE4060975EAC
x-amz-version-id: 43jfkodU8493jnFJD9fjj3HHNVfdsQUIFDNsidf038jfdsjGFDSIRp
Date: Wed, 01 Mar  2006 12:00:00 GMT
ETag: "828ef3fdfa96f00ad9f27c383fc9ac7f"
Content-Length: 0
Connection: close
Server: AmazonS3