HTTP-Header und Abfragestringparameter für XML API

Die XML API von Cloud Storage verwendet mehrere Standard-HTTP-Header sowie mehrere (benutzerdefinierte) HTTP-Header. Einige HTTP-Methoden unterstützen auch Abfragestringparameter. Die Header und Parameter werden unten beschrieben.

Übersicht über HTTP-Header und Abfragestringparameter

Die XML API verwendet die folgenden Standard-HTTP-Header:

Anfrage Antwort Beides
Autorisierung
Content-MD5
Moderator/in
Wenn-Übereinstimmung
Datum der letzten Änderung
If-None-Match
If-Unmodified-Since
ETag
Letzte Änderung
Standort
Cache-Steuerung
Inhaltsanordnung
Inhaltscodierung
Inhaltssprache
Inhaltslänge
Content-Bereich
Inhaltstyp
Datum:
Schwankungsbreite
Übertragungscodierung

Die XML API verwendet die folgenden (benutzerdefinierten) HTTP-Header:

Anfrage Antwort Beides
x-goog-acl
x-goog-api-version
x-goog-bucket-retention-period
x-goog-content-length-range
x-goog-content-sha256
x-goog-copy-source
x-goog-copy-source-generation
x-goog-copy-source-if-generation-match
x-goog-copy-source-if-match
x-goog-copy-source-if-metageneration-match
x-goog-copy-source-if-modified-seit
x-goog-copy-source-if-none-match
x-goog-copy-source-if-unmodified-since
x-goog-date
x-goog-encryption-key
x-goog-encryption-kms-key-name
x-goog-if-generation-match
x-goog-if-metageneration-match
x-goog-metadata-directive
x-goog-project-id
X-goog-Fortsetzung
x-goog-nutzer-projekt
x-goog-component-count
x-goog-expiration
x-goog-generation
x-goog-metageneration
x-goog-stored-content-encoding
x-goog-stored-content-length
x-goog-custom-time
x-goog-encryption-algorithm
x-goog-encryption-key-sha256
x-goog-hash
x-goog-meta-
x-goog-storage-class

Die XML API verwendet die folgenden Abfragestringparameter:

Zugriffsschlüssel-ID
ACL
Aktion
Abrechnung
Schreiben
Cors
defaultObjectAcl
Trennzeichen
Codierungstyp
Verschlüsselung
encryptionConfig
Generation
Generation-Markierung
Lebenszyklus Standorterweiterung
Logging
Markierung
Markierung
Maximalwerte
Max. Elemente
Präfix
Antwort auf Inhalt antworten
response-content-type
Status
storageClass
Taggen
Upload-ID
Nutzername
Nutzerprojekt
Versionsverwaltung
Versionen
Websitekonfiguration
X-Goog-Algorithmus
X-Goog-Anmeldedaten
X-Goog-Datum
X-Goog-Expires
X-Goog-SignedHeaders
X-Goog-Signatur

Standard-HTTP-Header

Autorisierung

Ein Anfrage-Header, der einen String zur Authentifizierung von Anfragen enthält.

Gültige Werte Eine Authentifizierungs-ID ( Bearer | GOOG1| | AWS ), gefolgt von einer der folgenden:
  • Ein gültiges OAuth 2.0-Token
  • Zugriffsschlüssel
  • Eine Signatur
Beispiel Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s- ...
Details Weitere Informationen zur Verwendung dieses Headers finden Sie unter Authentifizierung.

Hinweis:Wenn Ihre Anfragen über einen Proxy weitergeleitet werden, müssen Sie sich möglicherweise mit Ihrem Netzwerkadministrator in Verbindung setzen, um zu überprüfen, ob der Authorization-Header, der Ihre Anmeldedaten enthält, nicht vom Proxy entfernt. Ohne den Authorization-Header erhalten Sie einen MissingSecurityHeader-Fehler und Ihre Anfrage wird abgelehnt. Weitere Informationen zum Zugriff auf Cloud Storage über einen Proxyserver finden Sie unter Fehlerbehebung.

Cache-Control

Ein Anfrage- und Antwort-Header, der die Einstellung "Cache-Steuerung" angibt.

Gültige Werte Jeder gültige Wert für die Cache-Steuerung (siehe Spezifikation).
Beispiel Cache-Control: public, max-age=6000
Details Sie sollten die Cache-Steuerung nur für Objekte festlegen, die für alle anonymen Nutzer zugänglich sind. Damit das Objekt anonym zugänglich ist, muss die ACL eines Objekts die Berechtigung READ oder FULL_CONTROL für AllUsers gewähren. Wenn ein Objekt für alle anonymen Nutzer zugänglich ist und Sie keine Einstellung für die Cachesteuerung festlegen, wendet Cloud Storage eine Cache-Steuerungseinstellung von 3.600 Sekunden an. Bei der Bereitstellung über XML berücksichtigt Cloud Storage die Cachesteuerung des Objekts gemäß den Metadaten.

Content-Disposition

Ein Anfrage- und Antwort-Header, der Präsentationsinformationen über die übertragenen Daten angibt.

Gültige Werte Jeder gültige Inhaltsanordnungswert (siehe Spezifikation).
Beispiel Content-Disposition: attachment; filename=FILENAME
Details Wenn Sie den Header "Content-Disposition" beim Hochladen eines Objekts festlegen, wird er beim Download bereitgestellt und anschließend von Webbrowsern und anderen HTTP-Clients interpretiert. Häufig wird für Content-Disposition der Einstellung attachment;filename=FILENAMEt verwendet. Dies führt normalerweise dazu, dass der Webbrowser ein Dialogfeld "Speichern unter..." öffnet.

Content-Encoding

Ein Anfrage- und Antwort-Header, der den Komprimierungsalgorithmus für ein Objekt angibt.

Gültige Werte Jeder gültige Komprimierungsalgorithmus (siehe Spezifikation).
Beispiel Content-Encoding: gzip
Details Cloud Storage komprimiert oder dekomprimiert die Objekte nicht. Wenn Sie in diesem Header einen Algorithmus für den Komprimierungstyp angeben (z. B. deflate), behält Cloud Storage den Header bei, aber komprimiert oder dekomprimieren das Objekt nicht.

Inhaltssprache

Der Sprachcode des Inhalts nach ISO 639-1.

Gültige Werte Eine Liste der Sprachcodes finden Sie in der Spalte "ISO 639-1" ISO 639-1.
Beispiel Content-Language: en

Inhaltslänge

Die Länge (in Byte) des Anfrage- oder Antworttextes.

Gültige Werte Beliebiger Wert von null oder größer.
Beispiel Content-Length: 1234
Details Dies ist für alle Anfragen erforderlich, mit Ausnahme der Anfragen mit aufgeteilter Übertragungscodierung (siehe Spezifikation). Wenn Sie keine aufgeteilte Übertragungscodierung verwenden und den Header Content-Length nicht in eine Anfrage aufnehmen, schlägt die Anfrage fehl und Cloud Storage antwortet mit dem Statuscode "41 Länge für erforderlich".

Content-MD5

Der MD5-Digest des Anfragetexts.

Gültige Werte Ein gültiger MD5-Digest-Wert.
Beispiel Content-MD5: iB94gawbwUSiZy5FuruIOQ==
Details Weitere Informationen finden Sie in den Spezifikationen. Cloud Storage kann damit die Integrität eines PUT-Vorgangs prüfen.

Content-Bereich

Ein Anfrage- oder Antwort-Header, der einen Byte-Bereich angibt.

Gültige Werte Jeder gültige Bytebereich.
Beispiel Content-Range: bytes 456-987/1234
Details

Der Header Content-Range gibt in einer Antwort den Bereich der Byte an, die als Ergebnis einer Anfrage mit einem Range-Header zurückgegeben werden.

Wenn es als Teil einer fortsetzbaren Upload-Anfrage verwendet wird, wird Content-Range für die Abfrage der aktuellen Position des Uploads oder als Indikator für den Startpunkt Der Datenblock, der in der aktuellen Anfrage hochgeladen wird.

Bytebereiche sind einschließend. Das heißt, bytes 0-999 stellt die ersten 1.000 Byte in einer Datei oder einem Objekt dar.

Weitere Informationen, insbesondere in Bezug auf Downloadantworten, finden Sie in der Spezifikation.

Content-Type

Der MIME-Typ der Anfrage oder Antwort.

Gültige Werte Jeder gültige MIME-Typ (siehe Spezifikation).
Beispiel Content-Type: text/html
Details Wenn Sie beim Hochladen eines Objekts keinen Inhaltstyp angeben, verwendet das Cloud Storage-System beim Bereitstellen des Objekts standardmäßig application/octet-stream.

Datum

Datum und Uhrzeit der Anfrage oder Antwort.

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format (siehe Spezifikationen).
Beispiel Date: Wed, 16 Jun 2010 11:11:11 GMT
Details Beim Erstellen Signierte URLs mit dem V2-Signaturprozess erstellen. Das Format sollte im herkömmlichen HTTP-Format vorliegen. Weitere InformationenAbschnitt 7.1.1.2 der Spezifikation auf. Wenn Sie den V4-Signaturprozess verwenden, muss das Format das ISO 8601-Basisformat YYYYMMDD'T'HHMMSS'Z' haben.

ETag

Ein Antwort-Header, der das Entitäts-Tag des Objekts enthält, auf das zugegriffen wird

Gültige Werte Ein String in Anführungszeichen. Weitere Informationen finden Sie unter Hashes und ETags: Best Practices.
Beispiele ETag: "39a59594290b0f9a30662a56d695b71d"
ETag: "-CKicn4fknbUCEAE="
Details Weitere Informationen finden Sie in den Spezifikationen.

Host

Ein Anfrage-Header, der den URI für Cloud Storage angibt

Gültige Werte Ein gültiges Format für den URI.
Beispiel Host: storage.googleapis.com
Details Weitere Informationen zu gültigen URIs finden Sie unter Anfrageendpunkte und in der Hostspezifikation.

If-Match

Ein Anfrage-Header, der ein Entitäts-Tag (ETag) angibt.

Gültige Werte Ein gültiges Entitäts-Tag.
Beispiel If-Match: "881f7881ac1bc144a2672e45babb8839"
Details Es kann nur ein einzelnes Entitäts-Tag (keine durch Kommas getrennte Liste von Entitäts-Tags) angegeben werden.Sie können diesen Header mit den Methoden HEAD-Objekt und GET-Objekt verwenden. Wenn das in diesem Header angegebene ETag mit dem ETag für das Objekt übereinstimmt, werden die Metadaten oder das Objekt zurückgegeben. Wenn das mit diesem Header angegebene ETag von dem ETag für das Objekt abweicht, werden die Metadaten oder das Objekt nicht zurückgegeben und Cloud Storage gibt einen412 Vorbedingung fehlgeschlagen Fehlercode. Weitere Informationen finden Sie in den Spezifikationen.

If-Modified-Since

Ein Anfrage-Header, der ein Datum und eine Uhrzeit angibt.

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format.
Beispiel If-Modified-Since: Fri, 19 Feb 2010 22:04:23 GMT
Details Sie können diesen Header mit den HEAD-Objekt- und GET-Objekt-Methoden verwenden. Wenn ein Objekt später geändert wurde als das Datum und die Uhrzeit, die Sie in diesem Header angeben, werden die Metadaten oder das Objekt zurückgegeben. Wenn ein Objekt vor dem in diesem Header angegebenen Datum und die Uhrzeit geändert wurde, werden die Metadaten oder das Objekt nicht zurückgegeben und Cloud Storage gibt den Fehler 304 Not Modified.

Weitere Informationen zum Header "If-Modified-Since" finden Sie in der Spezifikation. Weitere Informationen zu den HTTP-Datumsformaten finden Sie in der Spezifikation im Abschnitt 7.1.1.2.

If-None-Match

Ein Anfrage-Header, der ein Entitäts-Tag (ETag) angibt.

Gültige Werte Ein gültiges Entitäts-Tag.
Beispiel If-None-Match: "881f7881ac1bc144a2672e45babb8839"
Details Sie können diesen Header mit den HEAD-Objekt- und GET-Objekt-Methoden verwenden. Wenn das mit diesem Header angegebene ETag von dem ETag für das Objekt abweicht, werden die Metadaten oder das Objekt zurückgegeben. Wenn das mit diesem Header angegebene ETag dem ETag des Objekts entspricht, werden die Metadaten oder das Objekt nicht zurückgegeben und Cloud Storage gibt den Fehler 304 Not Modified. Weitere Informationen finden Sie in den Spezifikationen.

If-Unmodified-Since

Ein Anfrage-Header, der ein Datum und eine Uhrzeit angibt.

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format.
Beispiel If-Unmodified-Since: Fri, 19 Feb 2010 22:04:23 GMT
Details Sie können diesen Header mit den HEAD-Objekt- und GET-Objekt-Methoden verwenden. Wenn das Objekt nach dem in diesem Header angegebenen Datum nicht geändert wurde, werden die Metadaten oder das Objekt zurückgegeben. Wenn das Objekt nach dem in diesem Header angegebenen Datum geändert wurde, werden die Metadaten oder das Objekt nicht zurückgegeben und Cloud Storage gibt den Fehler 412 Precondition Failed.

Weitere Informationen zum Header "If-Unmodified-Since" finden Sie in der Spezifikation. Weitere Informationen zu HTTP-Datumsformaten finden Sie in der Spezifikation im Abschnitt 7.1.1.2.

Zuletzt geändert

Ein Antwortheader, der das Datum und die Uhrzeit der letzten Änderung des Objekts enthält

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format.
Beispiel Last-Modified: Fri, 19 Feb 2010 22:04:23 GMT
Details Weitere Informationen zum Header "Last-Modified" finden Sie in den Spezifikationen. Weitere Informationen zu HTTP-Datumsformaten finden Sie in der Spezifikation im Abschnitt 7.1.1.2.

Ort

Ein Antwortheader, der für mehrere Zwecke verwendet wird:

  • Als Antwort auf die Wiederaufnahme eines fortsetzbaren Uploads erhalten Sie einen Sitzungs-URI für einen fortsetzbaren Upload.
  • Als Antwort auf eine cookiebasierte Authentifizierungsanfrage erhalten Sie eine eindeutige Antwort-URL für den Webhost.
  • Als Reaktion auf eine JSON API-Downloadanfrage, die an einer anderen URL als www.googleapis.com/download gesendet wird, wird eine Weiterleitung an die JSON API-URL bereitgestellt, unter der der Download erfolgen kann.
Gültige Werte Jeder gültige URI.
Beispiel Location: https://example.storage.googleapis.com/?upload_id=tvA0...rot
Details Der Antwortheader Location wird zurückgegeben, wenn Sie einen fortsetzbaren Upload starten.

Bereich

Ein Anfrageheader, der den Bytebereich angibt, der zurückgegeben werden soll, und einen Antwortheader, der den Bereich der Byte angibt, die in das Cloud Storage-System hochgeladen wurden.

Gültige Werte Beliebiger Bytebereich.
Beispiele Range: bytes=0-1999 (erste 2.000 Byte)
Range: bytes=-2000 (letzte 2.000 Byte)
Range: bytes=2000- (von Byte 2000 bis Ende der Datei)
Details

Wenn sie als Header in eine Anfrage zu Objektdaten aufgenommen werden, wird nur der für Ihr Objekt angegebene Bytebereich zurückgegeben, was beim Fortsetzen von unterbrochenen Uploads hilfreich ist. Eine gültige und erfolgreiche Anfrage führt zum Antwortcode 206 Partial Content. Beachten Sie, dass der Anfrage-Header range unter bestimmten Umständen ignoriert wird.

Wird als Teil einer Antwort zurückgegeben, die mit einem fortsetzbaren Upload verknüpft ist, gibt Range die Anzahl der aktuell hochgeladenen Byte an. Anhand dieser Informationen können Sie den Upload fortsetzen.

Bytebereiche sind einschließen. Beispiel: bytes=0-999 stellt die ersten 1.000 Byte in einer Datei oder einem Objekt dar. Weitere Informationen zu diesem Header finden Sie in der Spezifikation.

Übertragungscodierung

Ein Anfrage- und Antwort-Header, der angibt, ob die Übertragungscodierung auf den Nachrichtentext angewendet wurde.

Gültige Werte chunked
Beispiel Transfer-Encoding: chunked
Details Dieser Header gibt an, ob der Nachrichtentext einer Anfrage oder einer Antwort aufgeteilt wurde. Ist dies der Fall, stellt der Server den Inhalt in mehreren Blöcken bereit. Der letzte Block ist null. Wenn Sie Transfer-Encoding: Chunked angeben, müssen Sie Content-Length nicht angeben. Dies kann nützlich sein, wenn Sie die Länge des Nachrichtentexts nicht im Voraus kennen, z. B. bei einem Streaming-Upload. Weitere Informationen zu Transferverschlüsselungen finden Sie in der Spezifikation. Weitere Informationen zur aufgeteilten Übertragungscodierung finden Sie in der Spezifikation.

Benutzerdefinierte HTTP-Header der Erweiterung

x-goog-acl

Ein Anfrageheader, der vordefinierte (gespeicherte) ACLs auf einen Bucket oder ein Objekt anwendet, wenn Sie ihn hochladen oder erstellen.

Gültige Werte Für Buckets: project-private, private, public-read, public-read-write, authenticated-read

Für Objekte: project-private, private, bucket-owner-read, bucket-owner-full-control, public-read, authenticated-read

Beispiel x-goog-acl: private
Details Wenn ein Nutzer ein Objekt hochlädt oder einen Bucket erstellt, ohne ACLs anzugeben, wird die ACL private angewendet. Weitere Informationen zu vordefinierten ACLs finden Sie unter Zugriffssteuerung.

x-goog-api-version

Dieser Header wurde verworfen und wird nicht verwendet.

x-goog-bucket-retention-period

Ein Anfrage-Header, der einem neuen Bucket eine Aufbewahrungsrichtlinie hinzufügt.

Gültige Werte Eine Ganzzahl zwischen 1 und 3.155.760.000.
Beispiel x-goog-bucket-retention-period: 32000
Details Dieser Anfrage-Header kann nur beim Erstellen eines neuen Buckets verwendet werden. Beim Hinzufügen des Headers erhält der neue Bucket eine Aufbewahrungsrichtlinie mit einer Dauer in Sekunden, die durch den Wert dieses Headers bestimmt wird.

x-goog-component-count

Ein Antwortheader, der die Anzahl der Komponenten angibt, aus denen ein zusammengesetztes Objekt besteht.

Gültige Werte Eine Ganzzahl größer oder gleich 1.
Beispiel x-goog-component-count: 32
Details Dieser Antwort-Header wird nur zurückgegeben, wenn das aufgerufene Objekt ein zusammengesetztes Objekt ist. Der Header gibt die Anzahl der Komponenten zurück, aus denen das Objekt besteht.

x-goog-content-length-range

Ein PUT-Anfrageheader. Bei einer Verwendung akzeptiert Cloud Storage die Anfrage nur, wenn die Größe des Anfrageinhalts im angegebenen Bereich des Headers liegt.

Gültige Werte Ein MIN,MAX-Paar
Beispiel x-goog-content-length-range: 0,256
Details Die Werte für die Contentgröße sind inklusive und werden in Byte angegeben. Wenn der Umfang des Anfrageinhalts im angegebenen Bereich liegt, wird er wie angefordert bereitgestellt. Wenn die Größe des Anfrageinhalts außerhalb des angegebenen Bereichs liegt, schlägt die Anfrage fehl und der 400 Bad Request-Code wird in der Antwort zurückgegeben. Wenn x-goog-content-length-range in einer anderen Anfrage als PUT verwendet wird, wird der Header ignoriert.

x-goog-content-sha256

Ein Anfrage-Header, der einen Hash des Anfragetexts enthält.

Gültige Werte Ein Kleinbuchstabe mit Hex-Codierung, SHA-256-Hash oder UNSIGNED-PAYLOAD
Beispiel x-goog-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Details Dieser Header ist für Anfragen erforderlich, die im Header Authorization eine Signatur verwenden. x-goog-content-sha256 muss mit dem Wert übereinstimmen, den Sie für den Nutzlastteil Ihrer kanonischen Anfrage verwendet haben.

x-goog-copy-source

Ein Anfrage-Header, der den Quell-Bucket und das Objekt für einen Kopiervorgang angibt.

Gültige Werte Ein /BUCKET_NAME/OBJECT_NAME-Pfad
Beispiel x-goog-copy-source: travel-maps/paris.jpg
Details Dieser Anfrage-Header gibt den Pfad zum Quellobjekt an. Ein gültiger Pfad muss den Bucket und das Objekt enthalten und durch einen Schrägstrich (/) getrennt sein. Der Quellobjektpfad muss eine rechtliche URL sein. Daher sollte sie normalerweise als Prozentwert codiert sein.

Sie benötigen mindestens die Berechtigung READ für das Quellobjekt sowie mindestens die Berechtigung WRITE für den Ziel-Bucket, um diesen Header zu verwenden.

Wenn die Quell- und Zielobjekte identisch sind (einschließlich der Generierung), wird die Kopie als Aktualisierung der Metadaten behandelt. Weitere Informationen zur Steuerung des Aktualisierungs- und Ersetzungsverhaltens finden Sie unter x-goog-metadata-directive.

x-goog-copy-source-generation

Ein Anfrage-Header, der die Generierung des zu kopierenden Objekts angibt.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel x-goog-copy-source-generation: 1360044097839000
Details Dieser Anfrageheader kann mit x-goog-copy-source verwendet werden, um die Generierung des zu kopierenden Objekts anzugeben. Sie ist ohne den Header x-goog-copy-source nicht gültig. Wenn keine solche Generierung des Quellobjekts vorhanden ist, gibt Cloud Storage den Statuscode 404 Not Found aus.

Wenn die Quell- und Zielobjekte identisch sind (einschließlich der Generierung), wird die Kopie als Aktualisierung der Metadaten behandelt. Weitere Informationen zur Steuerung des Aktualisierungs- und Ersetzungsverhaltens finden Sie unter x-goog-metadata-directive.

x-goog-copy-source-if-generation-match

Ein Anfrageheader, der die entsprechende Kopieranfrage angibt, wird nur ausgeführt, wenn das Quellobjekt x-goog-generation mit dem angegebenen Wert übereinstimmt. Dieser Header ist nur gültig, wenn er mit x-goog-copy-source verwendet wird.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel x-goog-copy-source-if-generation-match: 1360044097835000
Details Dieser Anfrage-Header kann verwendet werden, um das Quellobjekt nur dann bedingt zu kopieren, wenn die angegebene Generierung vorhanden ist. Wenn die Generierung nicht übereinstimmt, gibt Cloud Storage den Fehlercode 412 Precondition Failed aus.

Weitere Informationen finden Sie unter Objektversionen verwenden.

x-goog-copy-source-if-match

Ein Anfrage-Header, der die Bedingungen für einen Kopiervorgang angibt.

Gültige Werte Ein Entitäts-Tag (ETag)
Beispiel x-goog-copy-source-if-match: 53fc311c15eda0a031809982ccf92aac
Details Es kann nur ein einzelnes Entitäts-Tag angegeben werden (keine durch Kommas getrennte Liste von Entitäts-Tags). Dieser Anfrageheader kann nur verwendet werden, wenn Sie einen Kopiervorgang mit dem Anfrageheader x-goog-copy-source ausführen. Wenn das in diesem Anfrageheader angegebene ETag mit dem ETag des Quellobjekts übereinstimmt, wird der Kopiervorgang fortgesetzt. Wenn das ETag nicht übereinstimmt, gibt Cloud Storage den Fehlercode 412 Precondition Failed aus.

x-goog-copy-source-if-metageneration-match

Ein Anfrageheader, der die entsprechende Anfrage angibt, ist nur zulässig, wenn der metageneration des Quellobjekts mit dem Wert dieses Headers übereinstimmt.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel x-goog-copy-source-if-metageneration-match: 4
Details Wenn die Metaerstellung des Quellobjekts mit dem Header x-goog-copy-source-if-metageneration-match übereinstimmt, wird die Anfrage erfolgreich ausgeführt und Google Cloud Storage gibt den Status HTTP 200 OK zurück. Wenn die Metageneration nicht übereinstimmt, gibt Cloud Storage den Fehlercode 412 Precondition Failed aus.

Dieser Wert kann nur mit x-goog-copy-source-if-generation-match oder x-goog-copy-source-generation verwendet werden und wenn Sie versuchen, dieses zu verwenden, wird der Fehlercode HTTP 400 BadRequest mit einem ungültigen Argument ungültig.

Weitere Informationen finden Sie unter Objektversionen verwenden.

x-goog-copy-source-if-modified-seit

Ein Anfrage-Header, der die Bedingungen für einen Kopiervorgang angibt.

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format.
Beispiel x-goog-copy-source-if-modified-since: Fri, 19 Feb 2010 14:05:04 GMT
Details Dieser Anfrageheader kann nur verwendet werden, wenn Sie einen Kopiervorgang mit dem Anfrageheader x-goog-copy-source ausführen. Wenn das angegebene Datum und die angegebene Uhrzeit vor dem Last-Modified-Datum des Quellobjekts liegen, wird das Objekt kopiert. Wenn Datum und Uhrzeit später angegeben ist, gibt Cloud Storage den Fehlercode 412 Precondition Failed aus.

Weitere Informationen zum HTTP-Header "If-Modified-Sceed", der einen anderen als die Kopierquelle hat, finden Sie in der Spezifikation. Weitere Informationen zu HTTP-Datumsformaten finden Sie in der Spezifikation in Abschnitt 7.1.1.2.

x-goog-copy-source-if-none-match

Ein Anfrage-Header, der die Bedingungen für einen Kopiervorgang angibt.

Gültige Werte Ein Entitäts-Tag (ETag)
Beispiel x-goog-copy-source-if-none-match: 53fc311c15eda0a031809982ccf92aac
Details Dieser Anfrageheader kann nur verwendet werden, wenn Sie einen Kopiervorgang mit dem Anfrageheader x-goog-copy-source ausführen. Wenn das ETag, das Sie in diesem Anfrageheader angeben, nicht mit dem ETag des Quellobjekts übereinstimmt, wird der Kopiervorgang fortgesetzt. Wenn das ETag übereinstimmt, gibt Cloud Storage den Fehlercode 412 Precondition Failed aus. Weitere Informationen zum HTTP-Header "If-None-Match", der sich nach der Quelle des Kopiervorgangs befindet, finden Sie unter Spezifikation.

x-goog-copy-source-if-unmodified-since

Ein Anfrage-Header, der die Bedingungen für einen Kopiervorgang angibt.

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format.
Beispiel x-goog-copy-source-if-unmodified-since: Fri, 19 Feb 2010 14:05:04 GMT
Details Dieser Anfrageheader kann nur verwendet werden, wenn Sie einen Kopiervorgang mit dem Anfrageheader x-goog-copy-source ausführen. Wenn das angegebene Datum und die angegebene Uhrzeit nach dem Last-Modified-Datum des Quellobjekts liegen, wird das Objekt kopiert. Wenn Datum und Uhrzeit älter ist, gibt Cloud Storage den Fehlercode 412 Precondition Failed aus.

Weitere Informationen zum HTTP-Header "If-Unmodified-Sceeped" (den anderen als die Quellquelle gilt für diesen Anwendungsfall), finden Sie in der Spezifikation. Weitere Informationen zu HTTP-Datumsformaten finden Sie in der Spezifikation im Abschnitt 7.1.1.2.

x-goog-custom-time

Ein Anfrage- und Antwort-Header für benutzerdefinierte Metadatenobjekte für Zeitstempel.

Gültige Werte Ein Datum und eine Uhrzeit im RFC 3339-Format.
Beispiel x-goog-custom-time: 2020-04-12T23:20:50.52Z
Details Dieser Header kann bei PUT- oder POST-Anfragen für Objekte eingefügt werden. Der Wert, den Sie im Header angeben, wird mit dem Objekt gespeichert und in einem Antwort-Header zurückgegeben, wenn Sie eine GET- oder HEAD-Anfrage für das Objekt ausführen. Die benutzerdefinierte Zeit für ein Objekt wird normalerweise mit Verwaltung des Objektlebenszyklus verwendet.

x-goog-date

Ein Anfrage-Header, der einen Zeitstempel für authentifizierte Anfragen angibt.

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format.
Beispiel x-goog-date: Fri, 19 Feb 2010 14:05:04 GMT
Details Beim Erstellen Signierte URLs mit dem V2-Signaturprozess erstellen. Das Format sollte im herkömmlichen HTTP-Format vorliegen. Weitere Informationen finden Sie unterAbschnitt 7.1.1.2 der Spezifikation auf. Wenn Sie den V4-Signaturprozess verwenden, muss das Format das ISO 8601-Basisformat YYYYMMDD'T'HHMMSS'Z' haben.

x-goog-encryption-algorithm

Ein Anfrage- und Antwort-Header, der den zu verwendenden Verschlüsselungsalgorithmus angibt.

Gültige Werte AES256
Beispiel x-goog-encryption-algorithm: AES256
Details Dieser Anfrage- und Antwort-Header wird verwendet, wenn Sie vom Kunden bereitgestellte Verschlüsselungsschlüssel bereitstellen.

x-goog-encryption-key

Ein Anfrageheader, der einen AES-256-Verschlüsselungsschlüssel angibt.

Gültige Werte Ein gemäß RFC 4648 mit Base64 codierter String eines gültigen AES-256-Verschlüsselungsschlüssels
Beispiel x-goog-encryption-key: NwbyGGmcKAX4FxGpOERG2Ap33m5NVOgmXznSGTEvG0I=
Details Dieser Anfrage-Header wird verwendet, wenn Sie vom Kunden bereitgestellte Verschlüsselungsschlüssel bereitstellen.

x-goog-encryption-key-sha256

Ein Anfrage- und Antwort-Header, der den SHA256-Hash des Verschlüsselungsschlüssels angibt.

Gültige Werte Ein gemäß RFC 4648 mit Base64 codierter String eines gültigen SHA256-Hashs für einen Verschlüsselungsschlüssel
Beispiel x-goog-encryption-key-sha256: +eBzkZBt1Mj2CZx69L3c8yXoZB6DtRLlSvXMJB9JGIQ=
Details Dieser Anfrage-Header wird verwendet, wenn Sie vom Kunden bereitgestellte Verschlüsselungsschlüssel bereitstellen.

x-goog-encryption-kms-key-name

Ein Anfrageheader, der einen Cloud KMS-Verschlüsselungsschlüssel angibt.

Gültige Werte Eine Cloud KMS-Verschlüsselungsschlüsselressource.
Beispiel x-goog-encryption-kms-key-name: projects/my-project/locations/us-east1/keyRings/my-keyring/cryptoKeys/my-key
Details Dieser Anfrageheader wird verwendet, wenn Sie ein bestimmtes Objekt mit einem vom Kunden verwalteten Verschlüsselungsschlüssel verschlüsseln möchten.

x-goog-expiration

Ein Antwort-Header, der angibt, wann das Zugriffsobjekt gemäß der Lebenszykluskonfiguration gelöscht wird.

Gültige Werte Ein Datum und eine Uhrzeit im herkömmlichen HTTP-Format.
Beispiel x-goog-expiration: Tue, 25 June 2013 00:00:00 GMT
Details Dieser Antwort-Header wird nur für Objekte in einem Bucket mit aktivierter Lebenszyklusverwaltung zurückgegeben, wenn bestimmte Bedingungen erfüllt sind. Weitere Informationen finden Sie unter Verhalten des Objektlebenszyklus.

x-goog-generation

Ein Antwortheader, der angibt, auf welche Version der Objektdaten Sie zugreifen.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel x-goog-generation: 1360044097835000
Details Wenn ein Objekt erstellt oder ersetzt wird, weist Cloud Storage ihm automatisch eine Generierung zu. Die Generierung ändert sich jedes Mal, wenn Objektdaten ersetzt werden. Es gibt jedoch keine definierte Beziehung zwischen den Generationen für verschiedene Objekte.

Weitere Informationen finden Sie unter Objektversionen verwenden.

x-goog-if-generation-match

Ein Anfrageheader, der die entsprechende Anfrage angibt, ist nur zulässig, wenn der x-goog-generation des Objekts mit dem Wert dieses Headers übereinstimmt.

Gültige Werte Null oder eine positive Zahl (64-Bit-Wert)
Beispiel x-goog-if-generation-match: 1360044097835000
Details Wenn die Objektgenerierung mit dem Header x-goog-if-generation-match übereinstimmt, wird die Anfrage erfolgreich ausgeführt und Google Cloud Storage gibt den Status HTTP 200 OK zurück. Wenn die Generierung nicht übereinstimmt, gibt Google Cloud Storage den Fehlercode HTTP 412 Precondition Failed zurück.

Wenn Sie den Header x-goog-if-generation-match auf 0 festlegen, führt Google Cloud Storage die angegebene Anfrage nur aus, wenn das Objekt derzeit nicht vorhanden ist. Sie können beispielsweise eine PUT-Anfrage ausführen, um ein neues Objekt mit einem x-goog-if-generation-match zu erstellen. Das Objekt wird nur erstellt, wenn es nicht bereits als Live-Version vorhanden ist. Wenn das Objekt vorhanden ist, wird die Anfrage abgebrochen.

Weitere Informationen finden Sie unter Objektversionen verwenden.

x-goog-if-metageneration-match

Ein Anfrageheader, der die entsprechende Anfrage angibt, ist nur zulässig, wenn der x-goog-metageneration des Objekts mit dem Wert dieses Headers übereinstimmt.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel x-goog-if-metageneration-match: 4
Details Wenn die Meta-Generierung des Objekts mit dem Header x-goog-if-metageneration-match übereinstimmt, wird die Anfrage erfolgreich ausgeführt und Google Cloud Storage gibt den Status HTTP 200 OK zurück. Wenn die Metageneration nicht übereinstimmt, gibt Cloud Storage den Fehlercode HTTP 412 Precondition Failed zurück.

Dieser Anfrageheader sollte nur mit dem Header x-goog-if-generation-match verwendet werden, um sicherzustellen, dass Aktualisierungen der Metadaten tatsächlich über die Generierung des Objekts durchgeführt werden, das Sie Aktualisierungen werden durchgeführt und können daher Read-Modify-Write-Vorgänge sicher ausführen.

Weitere Informationen finden Sie unter Objektversionen verwenden.

x-goog-metadata-directive

Ein Anfrage-Header, der die Metadatenverarbeitung während eines Kopiervorgangs angibt.

Beachten Sie, dass Objekt-ACLs (falls vorhanden) niemals kopiert werden. Gegebenenfalls erhält das neue Objekt ACLs, die im Anfrageheader x-goog-acl oder in den Standard-Objekt-ACLs für den Bucket angegeben sind, der das neue Objekt enthält.

Gültige Werte COPY | REPLACE
Beispiel x-goog-metadata-directive: REPLACE
Details

Wird nur mit dem x-goog-copy-source-Anfrageheader verwendet. Der Standardwert ist COPY.

Wenn Sie COPY angeben, werden die Metadaten des Quellobjekts auf das neu erstellte Objekt angewendet.

Wenn Sie REPLACE angeben, wendet der Vorgang die in der Anfrage angegebenen Metadaten auf das neu erstellte Objekt an.

Wenn Sie ein Objekt kopieren, um das Quellobjekt neu zu schreiben, müssen Sie x-goog-metadata-directive: REPLACE angeben. In allen anderen Fällen ist der Header optional.

x-goog-metageneration

Ein Antwort-Header, der angibt, auf welche Version der Objektmetadaten Sie zugreifen.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel x-goog-metageneration: 1
Details Beim Erstellen oder Ersetzen eines Objekts weist Cloud Storage automatisch eine Metageneration von 1 zu. Die Metageneration erhöht sich bei jeder Objektaktualisierung (ACL-Aktualisierung oder andere Metadaten-Aktualisierungen). Das bedeutet, dass eine größere Meta-Generierung immer eine neuere Version der Objektmetadaten angibt. Es gibt jedoch keine definierte Beziehung zwischen verschiedenen Generationen für unterschiedliche Objekte oder auch unterschiedlicher Generierungen desselben Objekts. Jede Generation des Objekts hat eine eigene Metagenerations-Version, die nur für seine Generierung gilt.

Weitere Informationen finden Sie unter Objektversionen verwenden.

x-goog-hash

Ein Anfrage- und Antwort-Header zum Ausdrücken der MD5- und/oder CRC32C-base64-codierten Prüfsummen eines Objekts. Als Anfrageheader für Uploadanfragen werden die angegebenen Hashes anhand der von Cloud Storage berechneten Werte validiert.

Gültige Werte md5=BASE64_ENCODED_MD5 oder crc32c=BASE64_ENCODED_CRC32C. CRC32c-Werte in Big-Endian-Byte-Reihenfolge angeben Beachten Sie auch, dass HTTP kommagetrennte Headerwerte als äquivalente Header mit identischen Schlüsseln betrachtet.
Beispiele x-goog-hash: crc32c=n03x6A==
x-goog-hash: md5=Ojk9c3dhfxgoKVVHYwFbHQ==
x-goog-hash: crc32c=n03x6A==,md5=Ojk9c3dhfxgoKVVHYwFbHQ==
Details Cloud Storage speichert MD5-Hashes für alle nicht zusammengesetzten Objekte. CRC32Cs sind für alle Objekte verfügbar.

x-goog-meta-

Ein Anfrage- und Antwort-Header, mit dem Sie benutzerdefinierte Metadaten für ein Objekt definieren können.

Gültige Werte Ein gültiger Header-Name
Beispiel x-goog-meta-reviewer: jane
Details Um diesen Header zu verwenden, hängen Sie den Namen Ihres benutzerdefinierten Headers an das Präfix x-goog-meta- an und fügen dann den Header und den zugehörigen Wert zu Ihrer PUT- oder POST-Anfrage hinzu. Wenn Ihre Objekte z. B. mit verschiedenen Projekten verknüpft sind, können Sie die projektspezifischen Informationen zu den Objektmetadaten hinzufügen. Dazu erstellen Sie mehrere Anfrageheader, zum Beispiel x-goog-meta-project-name. x-goog-meta-project-number und x-goog-meta-project-manager. Sie können dann einen Wert für diese Anfrageheader während einer PUT- oder POST-Anfrage festlegen, wie im folgenden Beispiel gezeigt:

PUT /kitten.jpg HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Wed, 17 Jun 2020 11:11:11 GMT
Content-Type: image/jpg
Content-Length: 554
Authorization: Bearer 1/zVNpoQNsOSxZKqOZgckhpQ
x-goog-meta-project-name: Sales Projections
x-goog-meta-project-number: 878973
x-goog-meta-project-manager: W. Loman
    

x-goog-meta--Header werden mit einem Objekt gespeichert und immer in einem Antwort-Header zurückgegeben, wenn Sie eine GET- oder HEAD-Anfrage für ein Objekt ausführen. Für die Verwendung von Headern als benutzerdefinierte Metadaten fallen Kosten an, wie unter Preise und Support erläutert.

Hinweis:Alle benutzerdefinierten Header und die zugehörigen Werte dürfen nur druckbare US-ASCII-Zeichen enthalten.

Hinweis: Wir empfehlen, die Gesamtgröße der benutzerdefinierten Header auf einige KB zu beschränken.

x-goog-project-id

Ein Anfrage-Header, der angibt, an welchem Projekt Sie arbeiten.

Gültige Werte Eine gültige Projektnummer oder -name.
Beispiele x-goog-project-id: 000111222333
x-goog-project-id: my-project-name
x-goog-project-id: example.com:my-google-apps-for-work-project-name
Details Mit diesem Anfrage-Header wird für Cloud Storage angewiesen, in welchem Projekt ein Bucket erstellt werden soll oder in welchem Projekt die Buckets aufgelistet werden sollen. Dies ist bei diesen Aufgaben optional, wenn Sie ein Standardprojekt für den interoperablen Zugriff festgelegt haben.

X-goog-Fortsetzung

Ein Anfrage-Header, der einen fortsetzbaren Uploadvorgang initiiert.

Gültige Werte start
Beispiel x-goog-resumable: start
Details Dieser Anfrage-Header teilt dem Cloud Storage-System mit, dass Sie einen fortsetzbaren Upload initiieren möchten. Der Header kann nur mit einer POST-Objekt-Anfrage und nur für fortsetzbare Uploads verwendet werden.

x-goog-storage-class

Ein Anfrage- und Antwort-Header, der die Speicherklasse eines Objekts angibt.

Gültige Werte STANDARD, NEARLINE, COLDLINE, ARCHIVE, MULTI_REGIONAL, REGIONAL
Beispiel x-goog-storage-class: NEARLINE
Details Dieser Header kann in PUT Object- und POST Object-Anfragen eingefügt werden, um ein Objekt auf eine andere Speicherklasse als die Standardspeicherklasse des zugehörigen Buckets festzulegen. Der Header ist in allen GET Object-Antworten enthalten.

x-goog-stored-content-encoding

Ein Antwort-Header, der die Inhaltscodierung des Objekts gemäß der Speicherung in Cloud Storage angibt. Dies gilt unabhängig von servergesteuerten Verhandlungen, die für einzelne Objektanfragen auftreten können.

Gültige Werte Die im Objektupload oder identity angegebene Objektcodierung.
Beispiel x-goog-stored-content-encoding: gzip
Details Wurde ein Objekt ohne Inhaltscodierung hochgeladen, hat dieser Header den Wert identity.

x-goog-stored-content-length

Ein Antwortheader, der die Inhaltslänge (in Byte) des in Cloud Storage gespeicherten Objekts angibt, unabhängig von servergesteuerten Verhandlungen, die für einzelne Objektanfragen auftreten können.

Gültige Werte Alle Bytewerte von null oder größer.
Beispiel x-goog-stored-content-length: 350
Details

x-goog-nutzer-projekt

Ein Anfrage-Header, der ein Nutzerprojekt angibt, das mit der Anfrage verbundene Zugriffsgebühren in Rechnung stellt.

Gültige Werte Die Projekt-ID für ein vorhandenes Google Cloud-Projekt
Beispiel x-goog-user-project: my-project
Details Dem im Header angegebenen Projekt werden die mit der Anfrage verbundenen Gebühren in Rechnung gestellt. Dieser Header wird beispielsweise bei Anfragen an Buckets verwendet, für die Sender bezahlt aktiviert ist.

Abfragestringparameter

In den Beispielen für Abfragestrings, die in diesem Abschnitt beschrieben werden, werden die URIs nicht angezeigt, aber es wird angenommen, dass sie sich auf storage.googleapis.com beziehen. Wie in Anfrageendpunkte beschrieben, können Sie auch den Bucket-Namen als Teil des Hostnamens angeben, z. B. BUCKET-NAME.storage.googleapis.com. Wenn Sie den Bucket als Teil des Hostnamens angeben, geben Sie den Bucket-Namen nicht als Teil des URI-Pfads an. Im Folgenden finden Sie Beispiele für das Abrufen der ACL eines Objekts:

  • https://storage.googleapis.com/BUCKET-NAME/object-name?acl
  • https://BUCKET-NAME.storage.googleapis.com/object-name?acl

Zugriffsschlüssel-ID

Ein Abfragestringparameter, mit dem Sie ermitteln können, welcher HMAC-Schlüssel Sie aktualisieren oder löschen möchten.

Gültige Werte Eine mit einem HMAC-Schlüssel verknüpfte Zugriffs-ID
Beispiel /?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive
/?Action=DeleteAccessKey&AccessKeyId=GOOG1EXAMPLE
Details Mit dem Abfragestringparameter AccessKeyId können Sie angeben, welchen HMAC-Schlüssel Sie aktualisieren oder löschen möchten. Sie müssen AccessKeyId in Verbindung mit dem Abfrageparameter Action verwenden. Informationen zum Abrufen der Zugriffs-ID für den HMAC-Schlüssel finden Sie unter HMAC-Schlüsselinformationen abrufen.

acl

Ein Abfragestringparameter, mit dem Sie die Access Control List für einen Bucket oder ein Objekt abrufen oder ändern können.

Gültige Werte
Beispiel /BUCKET_NAME?acl
/BUCKET_NAME/OBJECT_NAME?acl
Details Optional für die folgenden Anfragen: PUT Bucket, PUT Object, GET Bucket, GET Object. Beim Senden einer PUT-Anfrage müssen Sie ein XML-Dokument in den Anfragetext einfügen, das die ACLs angibt, die Sie anwenden möchten. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

Aktion

Ein Abfragestringparameter, mit dem Sie ermitteln können, welcher HMAC-Schlüssel-Vorgang durchgeführt werden soll.

Gültige Werte ListAccessKeys, CreateAccessKey, UpdateAccessKey, DeleteAccessKey
Beispiel /?Action=ListAccessKeys
Details Mit dem Abfragestringparameter Action können Sie angeben, welcher HMAC-Schlüsselvorgang ausgeführt werden soll: list, create, update oder delete.

billing

Ein Abfragestringparameter, mit dem Sie den Status der Funktion Sender bezahlt für einen Bucket aktivieren, deaktivieren oder prüfen können.

Gültige Werte Innerhalb des Anfragetexts: Enabled, Disabled.
Beispiel /BUCKET_NAME?billing
Details Optional für die folgenden Anfragen: GET Bucket, PUT Bucket. Bei Verwendung in einer GET Bucket-Anfrage wird der aktuelle Status des Features "Sender bezahlt" im Antworttext zurückgegeben. Bei Verwendung in einer PUT Bucket-Anfrage sollte der Anfragetext ein <BillingConfiguration>-Element enthalten, das angibt, ob das Feature aktiviert oder deaktiviert werden soll. Weitere Informationen zum Festlegen der Funktion "Sender bezahlt" mit der XML API finden Sie unter Bucket-Anfragesteller festlegen.

compose

Einen Abfragestringparameter, mit dem Sie eine Sequenz vorhandener Objekte in einem neuen zusammengesetzten Objekt zusammenfassen können (nur mit der XML API möglich).

Gültige Werte
Beispiel /BUCKET_NAME/OBJECT_NAME?compose
Details Optional für PUT Object-Anfragen. Im Anfragetext muss ein XML-Dokument mit ComposeRequest angegeben werden. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

cors

Ein Abfragestringparameter, mit dem Sie die Cross-Origin Resource Sharing (CORS) für einen Bucket abrufen oder ändern können.

Gültige Werte
Beispiel /BUCKET_NAME?cors
Details Optional für die folgenden Anfragen: PUT-Bucket, GET-Bucket. Wenn Sie eine PUT-Anfrage senden, müssen Sie ein XML-Dokument in den Anfragetext einfügen, das die CORS angibt, die Sie anwenden möchten. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

defaultObjectAcl

Ein Abfragestringparameter, mit dem Sie die standardmäßige Objektzugriffssteuerungsliste für einen Bucket abrufen oder ändern können.

Gültige Werte
Beispiel /BUCKET_NAME?defaultObjectAcl
Details Optional für PUT-Bucket- und GET-Bucket-Anfragen. Wenn Sie eine PUT-Anfrage senden, müssen Sie ein XML-Dokument in den Anfragetext einfügen, das die ACL angibt, die standardmäßig für neue Objekte in den Bucket gültig ist. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden. Weitere Informationen finden Sie unter Standard-Objekt-ACLs festlegen.

delimiter

Ein Zeichen oder eine Gruppe von Zeichen, mit dem die Liste einer Objekte bei einer GET-Bucket-Anfrage eingeschränkt wird.

Gültige Werte Alle Unicode-Zeichen oder -Zeichen.
Beispiel /?delimiter=/
Details

Das delimiter vereinfacht eine Liste von Objekten, die ein verzeichnisähnliches Benennungsschema verwenden. Wenn dieses Flag angegeben ist, werden Objekte, deren Namen das Trennzeichen nicht enthalten, wie in den Contents-Elementen der Antwort zurückgegeben. Wenn ein Objektname das Trennzeichen enthält, wird der Teil des Objektnamens bis auf die erste Instanz des Trennzeichens in einem CommonPrefixes-Element der Antwort angezeigt.

Sie können einen delimiter in Verbindung mit einem prefix-Parameter verwenden. In diesem Fall begrenzt prefix die Ergebnisse auf Objekte, deren Name mit prefix übereinstimmt.

delimiter ist normalerweise auf / gesetzt, kann aber eine beliebige Zeichenfolge sein. Ein Beispiel für die Verwendung eines delimiter finden Sie im Beispiel zu Trennzeichen.

Codierungstyp

Ein Abfragestringparameter für die URL-Codierung von Objektnamen in Antworten auf Anfragen zur Objektauflistung.

Gültige Werte url
Beispiel /bucket?encoding-type=url
Details Optional, wenn Sie in einem Bucket Objekte auflisten. Wenn sie in der Anfrage enthalten sind, sind die zurückgegebenen Objektnamen URL-codiert. Dies ist hilfreich, wenn einer Ihrer Objektnamen Unicode-Zeichen enthält, die von XML 1.0 nicht geparst werden können.

encryption

Ein Abfragestringparameter, mit dem Sie die Verschlüsselungsinformationen eines Objekts abrufen können.

Gültige Werte
Beispiel /object?encryption
Details Optional für GET Object-Anfragen. Wenn das abgefragte Objekt mit einem vom Kunden bereitgestellten Verschlüsselungsschlüssel verschlüsselt ist, werden der Verschlüsselungsalgorithmus und der SHA-256-Schlüssel des Schlüssels in einem Encryption-Element zurückgegeben. Wenn das Abfrageobjekt mit einem vom Kunden verwalteten Verschlüsselungsschlüssel verschlüsselt ist, wird die Schlüsselressource des Cloud Key Management Service in einem Encryption-Element zurückgegeben. In allen anderen Fällen wird ein leeres Encryption-Element zurückgegeben.

Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

encryptionConfig

Ein Abfragestringparameter, mit dem Sie den vom Kunden verwalteten Standardverschlüsselungsschlüssel festlegen oder abrufen können.

Gültige Werte
Beispiel /bucket?encryptionConfig
Details Optional für GET Bucket-Anfragen. Wenn für den abgefragten Bucket ein vom Kunden verwalteter Verschlüsselungsschlüssel festgelegt ist, wird der Name der Schlüsselressource innerhalb eines EncryptionConfiguration-Elements zurückgegeben.

Optional für PUT Bucket-Anfragen. Wenn die Anfrage eine vom Kunden verwaltete Verschlüsselungsschlüsselressource im Anfragetext enthält, wird dieser Schlüssel zum Standardverschlüsselungsschlüssel für den Bucket. Wenn die Anfrage ein leeres EncryptionConfiguration-Element enthält, werden alle vorhandenen Standardschlüssel aus dem Bucket entfernt.

Generation

Ein Wert, der angibt, welche Generierung des Objekts abgerufen werden soll.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel ?generation=1360887759327000
Details Mit dem Abfragestringparameter generation können Sie festlegen, welche Version des Objekts verwendet werden soll.

Generation-Markierung

Ein Wert, der die Generierungsnummer angibt, mit der eine Liste von Objekten gestartet werden soll.

Gültige Werte Beliebige Zahl (64-Bit-Wert)
Beispiel ?generation-marker=1360887759327000
Details Der Abfragestringparameter generation-marker ist ein Ausgangspunkt für Seiteneinträge in versionierten Buckets. Muss in Verbindung mit marker verwendet werden, um das Objekt und die Generierung der Startmethode für den Eintrag vollständig anzugeben. Alle Objektversionen mit der angegebenen generation-marker, einschließlich der Live-Version, wenn es eine höhere Generierung gibt, werden in der Liste der Objekte zurückgegeben, ebenso wie Objekte, die lexikografisch größer als die marker.

lifecycle

Ein Abfragestringparameter, mit dem Sie die Richtlinien für die Lebenszyklusverwaltung für einen Bucket abrufen oder ändern können.

Gültige Werte
Beispiel /BUCKET_NAME?lifecycle
Details Optional für die folgenden Anfragen: PUT-Bucket, GET-Bucket. Beim Senden einer PUT-Anfrage müssen Sie ein XML-Dokument in den Anfragetext einfügen, das die Lebenszykluskonfiguration angibt. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

location

Ein Abfragestringparameter, mit dem Sie die Einschränkung location für einen Bucket abrufen können.

Gültige Werte
Beispiel /BUCKET_NAME?location
Details Optional für die folgenden Anfragen: GET-Bucket.

logging

Ein Abfragestringparameter, mit dem Sie die Logging-Konfiguration für einen Bucket abrufen oder ändern können.

Gültige Werte
Beispiel /BUCKET_NAME?logging
Details Optional für die folgenden Anfragen: PUT-Bucket, GET-Bucket. Beim Senden einer PUT-Anfrage müssen Sie ein XML-Dokument in den Anfragetext einfügen, das die Logging-Konfiguration angibt. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

Filzstift

Ein String, der angibt, wo eine Liste von Objekten gestartet werden soll.

Gültige Werte Ein beliebiger String.
Beispiel ?marker=test
Details Der Abfragestringparameter marker ist ein String aus Unicode-Zeichen, der angibt, nach welchem Objekt eine Liste von Objekten beginnen soll. Die Liste der zurückgegebenen Objekte ist lexikografisch größer als der marker.

Markierung

Ein Seitentoken, mit dem Sie nachfolgende Seiten von HMAC-Schlüsseln auflisten können.

Gültige Werte Ein String, der in einer vorherigen list-Antwort bereitgestellt wird, wenn IsTruncated true ist.
Beispiel ?Action=ListAccessKeys&Marker=AERPALERN/NEXT/TOKEN
Details Der Abfragestringparameter Marker ist ein Fortsetzungs-Token für die Navigation in großen Ergebnismengen beim Auflisten von HMAC-Schlüsseln für ein bestimmtes Projekt. WennIsTruncated isttrue in der vorherigen Version list antworten, verwenden Sie das bereitgestellteMarker Token in nachfolgender Formlist Anfragen bisIsTruncated ist false auf. Sie müssen Marker in Verbindung mit dem Abfrageparameter Action verwenden. Weitere Informationen finden Sie unter GET HMAC-Schlüssel.

Maximalwerte

Eine Ganzzahl, die die Anzahl der zurückgegebenen Objekte auf einer "Ergebnisseite" beschränkt.

Gültige Werte Beliebige Zahl größer als 0
Beispiel ?max-keys=100
Details Der Abfragestringparameter max-keys ist eine Ganzzahl, die die maximale Anzahl von Objekten angibt, die in einer Liste von Objekten zurückgegeben werden sollen. Wenn eine Anfrage mehr Objekte zurückgeben kann, als max-keys zulassen, enthält das Antwortelement IsTruncated einen True-Wert.

Max. Elemente

Eine Ganzzahl, die die Anzahl der auf einer einzelnen Ergebnisseite zurückgegebenen HMAC-Schlüssel begrenzt.

Gültige Werte Beliebige Zahl größer als 0
Beispiel ?Action=ListAccessKeys&MaxItems=100
Details Der Abfragestringparameter MaxItems ist eine Ganzzahl, die die maximale Anzahl von HMAC-Schlüsseln angibt, die auf einer einzelnen Ergebnisseite zurückgegeben werden. Wenn eine Anfrage mehr Schlüssel zurückgeben kann, als MaxItems zulässt, enthält das Antwortelement IsTruncated einen true-Wert. Sie müssen MaxItems in Verbindung mit dem Abfrageparameter Action verwenden. Der Dienst gibt möglicherweise weniger Ergebnisse zurück als das angegebene Maximum.

prefix

Ein String, der eine Liste von Objekten auf Objekte mit einem bestimmten Präfix beschränkt.

Gültige Werte Jedes gültige Präfix.
Beispiel ?prefix=/europe/france
Details Der Abfragestringparameter prefix ist ein String aus Unicode-Zeichen, der die Auflistung auf Objekte beschränkt, deren Namen mit dem angegebenen prefix-Wert beginnen. Sie können den Abfragestringparameter prefix zusammen mit dem Abfragestringparameter delimiter verwenden, um eine kleinere Teilmenge von Objekten zu erstellen.

Antwort auf Inhalt antworten

Ein Abfragestringparameter, mit dem die Inhaltsdisposition für authentifizierte GET-Anfragen überschrieben werden kann.

Gültige Werte URL-codierter Header, der anstelle des Inhalts-Dispositions des zugrunde liegenden Objekts zurückgegeben wird
Beispiel ?response-content-disposition=attachment%3B%20filename%3D%22foo%22
Details Ermöglicht authentifizierten GET-Anfragen, die in den Headern zurückgegebene Inhaltsdisposition zu überschreiben.

Weitere Informationen finden Sie in den Spezifikationen.

response-content-type

Ein Abfragestringparameter, der die Durchführung von Inhaltstypen für authentifizierte GET-Anfragen überschreibt.

Gültige Werte URL-codierter Header, der anstelle des Inhaltstyps des zugrunde liegenden Objekts zurückgegeben wird.
Beispiel ?response-content-type=text%2Fhtml
Details Ermöglicht authentifizierten GET-Anfragen, die in den Headern zurückgegebene Inhaltsdisposition zu überschreiben.

Weitere Informationen finden Sie in den Spezifikationen.

Status

Ein Abfragestringparameter, mit dem Sie einen HMAC-Schlüssel aktivieren oder deaktivieren können.

Gültige Werte Active, Inactive
Beispiel ?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive
Details Mit dem Abfragestringparameter Status können Sie den Status eines HMAC-Schlüssels zwischen Active und Inactive ändern. Sie müssen Status in Verbindung mit den Abfrageparameter Action und AccessKeyId verwenden.

storageClass

Ein Abfragestringparameter, mit dem Sie die Speicherklasse eines Buckets festlegen oder abrufen können.

Gültige Werte Im Anfragetext: STANDARD, NEARLINE, ARCHIVE, COLDLINE, MULTI_REGIONAL, REGIONAL,DURABLE_REDUCED_AVAILABILITY
Beispiel /BUCKET_NAME?storageClass
Details Optional für die folgenden Anfragen: GET Bucket, PUT Bucket. Bei Verwendung in einer GET Bucket-Anfrage wird die Speicherklasse des angegebenen Buckets im Antworttext zurückgegeben. Bei Verwendung in einer PUT Bucket-Anfrage sollte der Anfragetext ein <StorageClass>-Element enthalten, das die Speicherklasse angibt, die Sie dem Bucket zuweisen möchten. Weitere Informationen zum Festlegen der Speicherklasse eines Buckets mit der XML API finden Sie unter Bucket-Speicherklasse festlegen.

Taggen

Ein Abfragestringparameter, mit dem Sie die auf einen Bucket angewendeten Labels festlegen oder abrufen können.

Gültige Werte Innerhalb des Anfragetexts: ein Label, das als key:value-Paar angegeben wird
Beispiel /BUCKET_NAME?tagging
Details Optional für die folgenden Anfragen: GET Bucket, PUT Bucket. Bei Verwendung in einer GET Bucket-Anfrage werden die auf den angegebenen Bucket angewendeten Labels im Antworttext zurückgegeben. Bei Verwendung in einer PUT Bucket-Anfrage sollte der Anfragetext ein <Tagging>-Element enthalten, das die Labels angibt, die Sie auf den Bucket anwenden möchten. Weitere Informationen zum Anwenden von Labels mithilfe der XML API finden Sie unter Bucket-Labels festlegen.

Upload-ID

Ein Abfragestringparameter, der die Upload-ID für einen fortsetzbaren Upload angibt. upload_id ist Teil des Sitzungs-URI, Sie sollten jedoch den gesamten Sitzungs-URI speichern, da er den Anfrage-URI für nachfolgende fortsetzbare Uploads definiert. Der Sitzungs-URI wird aus dem Antwortheader Location abgerufen.

Gültige Werte Jede gültige Upload-ID.
Beispiel /?upload_id=tvA0ExBntDaOKdxL46u1NkHxNb...B2Uowrot HTTP/1.1
Details Eine Upload-ID läuft nach einer Woche ab. Starten Sie einen fortsetzbaren Upload, sobald Sie die Upload-ID erhalten haben, und setzen Sie einen unterbrochenen Upload kurz nach der Unterbrechung fort.

Wenn Sie eine abgelaufene Upload-ID in einer Anfrage verwenden, erhalten Sie den Statuscode "404 Nicht gefunden". In diesem Fall müssen Sie den fortsetzbaren Upload wieder initiieren, eine neue Upload-ID abrufen und den Upload unter Verwendung der neuen Upload-ID neu starten.

Die Upload-ID ist an den Ort gebunden, an dem sie erstellt wurde. Wenn Sie also an einem Standort einen anderen erstellen und ihn an einem anderen Standort verwenden, beeinträchtigt dies die Leistung.

Die Upload-ID ist ein Inhabertoken. Das bedeutet, dass die Inhaber dieses Tokens als Authentifizierungstoken fungieren. Achten Sie daher darauf, dass keine Upload-IDs hochgeladen werden.

Nutzername

Ein Abfragestringparameter, mit dem Sie das Dienstkonto ermitteln können, für das Sie einen HMAC-Schlüssel erstellen, aktualisieren oder auflisten möchten.

Gültige Werte Eine gültige E-Mail-Adresse für das Dienstkonto.
Beispiel /?Action=CreateAccessKey&UserName=serviceAccount@proj.iam.gserviceaccount.com
Details UserName ist erforderlich, um einen HMAC-Schlüssel zu erstellen und optional zum Aktualisieren eines Schlüssels oder zum Auflisten von Schlüsseln, die einem Projekt zugeordnet sind, zu gewähren. Sie müssen UserName in Verbindung mit dem Abfrageparameter Action verwenden.

Nutzerprojekt

Ein Abfragestringparameter, der eine Projekt-ID für die Abrechnung der mit der Anfrage verbundenen Zugriffsgebühren in Rechnung stellt.

Gültige Werte Jede gültige Projekt-ID.
Beispiel ?userProject=example-project
Details Dem in diesem Parameter angegebenen Projekt werden die Gebühren in Rechnung gestellt, die mit der Anfrage verknüpft sind. userProject wird beispielsweise bei Anfragen an Buckets verwendet, für die Sender bezahlt aktiviert ist.

Im Allgemeinen sollte XML-Anfragen, die eine Projekt-ID erfordern, im Header x-goog-user-project statt im Parameter userProject angegeben werden.

versioning

Ein Abfragestringparameter, mit dem Sie die Versionskonfiguration eines Buckets abrufen oder ändern können.

Gültige Werte
Beispiel /OBJECT_NAME?versioning
Details Optional für die folgenden Anfragen: PUT-Bucket, GET-Bucket. Wenn Sie eine PUT-Anfrage senden, müssen Sie ein XML-Dokument in den Anfragetext einfügen, das die zu konfigurierende Versionskonfiguration angibt. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

versions

Ein Abfragestringparameter, mit dem Sie die gesamte Generierung von Objekten in einem versionierten Bucket abrufen können.

Gültige Werte
Beispiel /BUCKET_NAME?versions=True
Details Optional für die folgenden Anfragen: GET-Bucket.

Websitekonfiguration

Ein Abfragestringparameter, mit dem Sie die Websitekonfiguration eines Buckets abrufen oder ändern können.

Gültige Werte
Beispiel /BUCKET_NAME?websiteConfig
Details Optional für die folgenden Anfragen: PUT-Bucket, GET-Bucket. Wenn Sie eine PUT-Anfrage senden, müssen Sie ein XML-Dokument in den Anfragetext einfügen, das die zu konfigurierende Websitekonfiguration angibt. Mit diesem Abfrageparameter können Sie keine zusätzlichen Unterressourcen verwenden.

X-Goog-Algorithmus

Ein Abfragestringparameter zum Bestimmen des V4-Signed URL-Algorithmus.

Gültige Werte GOOG4-RSA-SHA256
GOOG4-HMAC-SHA256
AWS4-HMAC-SHA256
Details Wird speziell für mit V4 signierte Anfragen wie Signierte URLs verwendet.

X-Goog-Anmeldedaten

Ein Abfragestringparameter, mit dem der verwendete Anmeldedatentyp ermittelt wird.

Gültige Werte Service_Account_Email/Date/Region/goog4_request
Google_HMAC_Access_Key_ID/Date/Region/goog4_request
AWS_HMAC_Access_Key_ID/Date/Region/aws4_request
Beispiel Mit einem Google-Dienstkonto: example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request
HMAC verwenden: GOOGTS7C7FUP3AIRVJTE2BCD%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request
Details Wird speziell für mit V4 signierte Anfragen wie Signierte URLs verwendet.

X-Goog-Date (Suchparameter)

Datum und Uhrzeit der Nutzung der signierten URL.

Gültige Werte Alle folgenden Datumsangaben: JJJJMMTT'T'HHMMSS'Z'
Beispiel ?X-Goog-Date=20181026T181309Z
Details Das verwendete Format ist das ISO 8601-Basisformat JJJJMMTT'T'HHMMSS'Z'.

X-Goog-Expires

Ein Abfragestringparameter, mit dem ermittelt wird, wie lange eine V4-signierte URL aktiv ist.

Gültige Werte 1 Sekunde bis zu 604.800 Sekunden
Beispiel ?X-Goog-Expires=900
Details Die Gültigkeitsdauer der signierten URL, gemessen in Sekunden ab dem Wert von X-Goog-Date (Abfrageparameter). Der Höchstwert beträgt 7 Tage oder 604.800 Sekunden.

X-Goog-SignedHeaders

Ein Abfragestringparameter, um die Header zu ermitteln, die in einer mit V4 signierten URL signiert sind.

Gültige Werte Der einzige erforderliche Header ist host. In dieser Liste müssen alle Header enthalten sein, die mit einer Signierte URL-Signatur von V4 signiert sind.
Beispiele ?X-Goog-SignedHeaders=host
?X-Goog-SignedHeaders=host,x-goog-acl
Details Header, die in jeder Anfrage enthalten waren, in der die signierte URL verwendet wurde.

X-Goog-Signatur

Ein Abfragestringparameter mit dem Wert einer 4-Signatur-URL-Signatur.

Gültige Werte Signatur der signierten URL.
Beispiel ?X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7
Details Der Authentifizierungsstring, der Anfragen mit dieser signierten URL Zugriff auf die angegebene Ressource ermöglicht hat.