View a markdown version of this page

Allgemeine Anforderungsheader - Amazon Simple Storage Service

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.

Allgemeine Anforderungsheader

In der folgenden Tabelle werden Header beschrieben, die von verschiedenen Typen von Amazon S3-REST-Anfragen verwendet werden können.

Header-Name Description
Authorization

Die erforderlichen Informationen für die Anforderungsauthentifizierung. Weitere Informationen finden Sie im Amazon Simple Storage Service Developer Guide unter The Authentication Header. Für anonyme Anfragen ist dieser Header nicht erforderlich.

Access-Control-Request-Method Eine Liste von HTTP-Methoden, die als CORS-Anfrage vor dem Flug gesendet wird. Wenn die CORS-Bewertung vor dem Flug erfolgreich ist, dürfen die angegebenen Methoden in der folgenden CORS-Anfrage verwendet werden.
Content-Length

Länge der Nachricht (ohne Header) gemäß RFC 2616. Dieser Header ist für PUTs und Operationen erforderlich, die XML laden, wie Logging und ACLs.

Content-Type

Der Inhaltstyp der Ressource, falls die Anfrage Inhalt im Hauptteil enthält. Beispiel: text/plain

Content-MD5

Der Base64-kodierte 128-Bit-MD5-Digest der Nachricht (ohne die Header) gemäß RFC 1864. Dieser Header kann zur Überprüfung der Nachrichtenintegrität verwendet werden, um zu überprüfen, ob es sich bei den Daten um dieselben Daten handelt, die ursprünglich gesendet wurden. Obwohl er optional ist, empfehlen wir, den Content-MD5 Mechanismus als durchgängige Integritätsprüfung zu verwenden. Weitere Informationen zur REST-Anforderungsauthentifizierung finden Sie im Amazon Simple Storage Service Developer Guide unter REST-Authentifizierung.

Date

Das Datum, an dem die im Authorization-Header enthaltene Signatur erstellt werden kann. Wenn der Date-Header zum Signieren verwendet werden soll, muss das Format den Grundsätzen von ISO 8601 entsprechen In diesem Fall wird der x-amz-date-Header nicht benötigt. Wenn x-amz-date vorhanden ist, hat dieser Wert immer Vorrang vor dem Wert des Date-Headers.

Wenn der Datum-Header nicht zum Signieren verwendet wird, kann er in einem der vollständigen Datumsformate angegeben werden, die durch RFC 2616, Abschnitt 3.3, festgelegt sind. Das date/time Wed, 01 Mar 2006 12:00:00 GMT ist beispielsweise ein gültiger date/time Header für die Verwendung mit Amazon S3.

Wenn der Date-Header zum Signieren verwendet wird, muss er den Grundsätzen von ISO 8601 entsprechen und im Format YYYYMMDD'T'HHMMSS'Z' angegeben werden.

Wenn Date angegeben, aber nicht im ISO 8601-Basisformat vorliegt, müssen Sie auch den x-amz-date Header angeben. Wenn Date entsprechend den Grundsätzen von ISO 8601 angegeben ist, reicht diese Angabe zum Signieren von Anforderungen aus und der x-amz-date-Header ist nicht erforderlich. Weitere Informationen finden Sie unter Umgang mit Datumswerten in Signature Version 4 im Amazon Web Services-Glossar.

Expect

Wenn Ihre Anwendung 100-continue verwendet, sendet sie den Anforderungstext erst, wenn sie eine Bestätigung erhält. Wird die Nachricht basierend auf den Header abgewiesen, wird der Rumpf der Meldung nicht gesendet. Dieser Header kann nur verwendet werden, wenn Sie einen Text senden.

Gültige Werte: 100-continue

Host

Für Anfragen im Pfadstil lautet der Wert. s3.amazonaws.com Für Anfragen im virtuellen Stil ist der Wert. BucketName.s3.amazonaws.com Weitere Informationen finden Sie im Amazon Simple Storage Service-Benutzerhandbuch unter Virtual Hosting.

Dieser Header ist für HTTP 1.1 erforderlich (die meisten Toolkits fügen diesen Header automatisch hinzu); optional für HTTP/1.0 Anfragen.

Origin

Ein Endpunkt, der den Servernamen des ursprünglichen Anforderers angibt.

x-amz-content-sha256

Wenn Sie Signaturversion 4 zur Authentifizierung der Anfrage verwenden, liefert dieser Header einen Hash der Anforderungsnutzlast. Weitere Informationen finden Sie unter Signaturberechnungen für den Autorisierungs-Header: Übertragung der Nutzlast in einem einzigen Block (AWS Signatur (Version 4). Wenn Sie Objekte in Blöcken hochladen, setzen Sie den Wert auf, STREAMING-AWS4-HMAC-SHA256-PAYLOAD um anzuzeigen, dass die Signatur nur Header abdeckt und keine Nutzlast vorhanden ist. Weitere Informationen finden Sie unter Signaturberechnungen für den Autorisierungs-Header: Übertragung von Nutzdaten in mehreren Blöcken (Chunked Upload) (AWS Signatur (Version 4).

x-amz-date

Das Datum, an dem die Signatur im Autorisierungs-Header erstellt wurde. Das Datum muss den Grundsätzen von ISO 8601 entsprechen und im Format YYYYMMDD'T'HHMMSS'Z' angegeben werden. Das date/time 20170210T120000Z ist beispielsweise für die Verwendung mit Amazon S3 x-amz-date gültig.

x-amz-dateist für alle Anfragen optional; es kann verwendet werden, um das Datum zu überschreiben, das für das Signieren von Anfragen verwendet wird. Wenn der Date-Header den Grundsätzen von ISO 8601 entspricht, ist x-amz-date nicht erforderlich. Wenn x-amz-date vorhanden ist, hat dieser Wert immer Vorrang vor dem Wert des Date-Headers. Weitere Informationen finden Sie unter Umgang mit Datumswerten in Signature Version 4 im Amazon Web Services-Glossar.

x-amz-security-token

Dieser Header kann in den folgenden Szenarien verwendet werden:

  • Um Sicherheitstoken für DevPay Amazon-Operationen bereitzustellen — Jede Anfrage, die Amazon verwendet, DevPay benötigt zwei x-amz-security-token Header: einen für das Produkt-Token und einen für das Benutzer-Token. Wenn Amazon S3 eine authentifizierte Anfrage erhält, vergleicht es die berechnete Signatur mit der bereitgestellten Signatur. Falsch formatierte Header mit mehreren Werten, die zur Berechnung einer Signatur verwendet werden, können zu Authentifizierungsproblemen führen.

  • Um ein Sicherheitstoken bereitzustellen, wenn Sie temporäre Sicherheitsanmeldeinformationen verwenden — Wenn Sie Anfragen mit temporären Sicherheitsanmeldeinformationen stellen, die Sie von IAM erhalten haben, müssen Sie mithilfe dieses Headers ein Sicherheitstoken bereitstellen. Weitere Informationen zu temporären Sicherheitsanmeldeinformationen finden Sie unter Anfragen https://docs.aws.amazon.com/AmazonS3/latest/userguide/MakingRequests.html stellen.

Dieser Header ist für Anfragen erforderlich, die Amazon verwenden, DevPay und für Anfragen, die mit temporären Sicherheitsanmeldeinformationen signiert werden.