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:
Die XML API verwendet die folgenden (benutzerdefinierten) HTTP-Header:
Die XML API verwendet die folgenden Abfragestringparameter:
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:
|
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 |
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 Wenn es als Teil einer fortsetzbaren Upload-Anfrage verwendet wird, wird Bytebereiche sind einschließend. Das heißt, 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 Wird als Teil einer Antwort zurückgegeben, die mit einem fortsetzbaren Upload verknüpft ist, gibt Bytebereiche sind einschließen. Beispiel: |
Ü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: |
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 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 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 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 Wenn Sie Wenn Sie Wenn Sie ein Objekt kopieren, um das Quellobjekt neu zu schreiben, müssen Sie |
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
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 Sie können einen
|
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 |
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 |
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. |