Bucket-CORS abrufen

Zum Auflisten der CORS-Konfiguration eines Buckets senden Sie eine GET-Anfrage, die für einen Bucket gilt, und den Abfragestringparameter cors verwenden. Die CORS-Konfiguration wird in einem XML-Dokument im Antworttext zurückgegeben.

Weitere Informationen zur CORS-Konfiguration finden Sie unter Cross-Origin Resource Sharing (CORS) konfigurieren.

Abfragestringparameter

Parameter	Beschreibung	Erforderlich
cors	Hiermit können Sie die CORS-Konfiguration eines vorhandenen Buckets aufrufen.	Nein

Informationen zu den Parametern, die Sie beim Erstellen und Verwenden signierter URLs angeben müssen, finden Sie unter Stringparameter für signierte URLs.

Anfrageheader

Siehe Allgemeine Anfrageheader.

Anfragetextelemente

Die Anfrage enthält kein XML-Dokument im Anfragetext.

Anfragesyntax

Die folgende Syntax gilt für GET-Bucket-Anfragen, die den Abfragestringparameter cors verwenden.

GET /?cors HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

Antwortheader

Die Anfrage kann je nach verwendetem Anfrage-Header eine Vielzahl von Antwort-Headern zurückgeben.

Antworttextelemente

Die folgenden Antworttextelemente sind nur anwendbar, wenn Sie die CORS-Konfiguration des Buckets mit dem Abfragestringparameter cors abrufen.

Element	Beschreibung
CorsConfig	Container für einen oder mehrere Cors-Konfigurationscontainer. Wenn Sie mehrere Cors-Konfigurationen angeben, werden die Cors-Konfigurationen in der Reihenfolge ausgewertet, die im CorsConfig-Container aufgeführt ist. Die erste Cors-Konfiguration stimmt mit dem Ursprung und der Methode der Anfrage überein, anhand derer die CORS-Antwortheader festgelegt werden, die der Antwort hinzugefügt werden sollen. auf.
Cors	Container für eine CORS-Konfiguration, die auf den Bucket angewendet werden soll Sie können in jedem Cors-Container mehrere Ursprünge und mehrere Methoden angeben. Eine Übereinstimmung wird gefunden, wenn die Ursprung von Anfragen mit einem der Ursprünge im Cors-Container übereinstimmt und die Anfragemethode mit einer der Methoden im Cors-Container übereinstimmt.
Origins	Container für die Ursprünge, die für die Cross-Origin Resource Sharing mit diesem Cloud Storage zulässig sind.
Origin	Ein Ursprung, der für die Freigabe von ursprungsübergreifenden Ressourcen mit diesem Cloud Storage-Bucket zulässig ist. z. B. https://origin1.example.com.
Methods	Container für ein oder mehrere HTTP-Methodenelemente, die die von dieser CORS-Konfiguration unterstützten Methoden angeben.
Method	In dieser Konfiguration verwendete HTTP-Methode. Gültige Werte sind DELETE, GET, HEAD, POST und PUT. OPTIONS wird als Preflight-Anfrage interpretiert. Sie müssen diese Methode daher nicht in der CORS-Konfiguration angeben.
ResponseHeaders	Optionaler Container für mindestens ein ResponseHeader-Element
ResponseHeader	Gibt einen Antwort-Header an, den der User-Agent über mehrere Quellen hinweg freigeben darf.
MaxAgeSec	Ein Wert, der die Anzahl von Sekunden angibt, die der User-Agent die Antwort im Cache speichern darf. Dieses Element ist optional. Wenn nicht angegeben, verwendet der Dienst einen Standardwert. Wenn mehr als einmal angegeben wurde, wird das letzte Element ohne Rückmeldung akzeptiert. Der Wert wird im Header Access-Control-Max-Age als Antwort auf Preflight-Anfragen zurückgegeben.