Übersicht Konfigurationsbeispiele
Cross-Origin Resource Sharing (CORS) ermöglicht Interaktionen zwischen Ressourcen aus unterschiedlichen Quellen. Normalerweise wird dies verhindert, um böswilliges Verhalten zu unterbinden. Auf dieser Seite erfahren Sie, wie Sie eine CORS-Konfiguration für einen Cloud Storage-Bucket festlegen und die für einen Bucket festgelegte CORS-Konfiguration aufrufen. Unter Konfigurationsbeispiele für CORS finden Sie Beispiele für CORS-Konfigurationen, einschließlich der Konfiguration, mit der eine vorhandene Konfiguration in Ihrem Bucket deaktiviert wird.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die Rolle "Storage-Administrator" (roles/storage.admin
) für den Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Festlegen und Aufrufen der CORS-Konfiguration für einen Bucket benötigen.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Festlegen und Aufrufen von CORS-Konfigurationen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
storage.buckets.get
storage.buckets.update
Sie können diese Berechtigungen auch mit anderen vordefinierten Rollen oder benutzerdefinierten Rollen erhalten.
Informationen zum Zuweisen von Rollen für Buckets finden Sie unter IAM mit Buckets verwenden.
CORS-Konfiguration für einen Bucket festlegen
Die CORS-Konfiguration für einen Bucket erfolgt anhand der Angabe von Informationen wie HTTP-Methoden und Quelldomains. Diese identifizieren die Arten von Anfragen, die der Bucket akzeptieren kann.
Führen Sie die folgenden Schritte aus, um eine CORS-Konfiguration für den Bucket festzulegen:
Console
Sie können CORS nicht über die Google Cloud Console verwalten. Verwenden Sie stattdessen die gcloud CLI.
Befehlszeile
Erstellen Sie eine JSON-Datei mit der CORS-Konfiguration, die Sie anwenden möchten. In den Konfigurationsbeispielen finden Sie JSON-Beispieldateien.
Führen Sie den Befehl
gcloud storage buckets update
mit dem Flag--cors-file
aus.gcloud storage buckets update gs://BUCKET_NAME --cors-file=CORS_CONFIG_FILE
Dabei gilt:
BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.CORS_CONFIG_FILE
ist der Pfad zur JSON-Datei, die Sie in Schritt 1 erstellt haben.
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Im folgenden Beispiel wird eine CORS-Konfiguration für einen Bucket festgelegt:
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Erstellen Sie eine JSON-Datei mit der CORS-Konfiguration, die Sie anwenden möchten. In den Konfigurationsbeispielen finden Sie JSON-Beispieldateien.
Verwenden Sie
cURL
, um die JSON API mit einerPATCH
-Bucket-Anfrage aufzurufen:curl --request PATCH \ 'https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=cors' \ --header 'Authorization: Bearer $(gcloud auth print-access-token)' \ --header 'Content-Type: application/json' \ --data-binary @CORS_CONFIG_FILE
Wobei:
BUCKET_NAME
ist der Name des Buckets. Beispiel:my-bucket
CORS_CONFIG_FILE
ist der Pfad zur JSON-Datei, die Sie in Schritt 2 erstellt haben.
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Erstellen Sie eine XML-Datei mit der CORS-Konfiguration, die Sie anwenden möchten. In den Konfigurationsbeispielen finden Sie XML-Beispieldateien.
Verwenden Sie
cURL
, um die XML API mit einerPUT Bucket
-Anfrage aufzurufen, die auf?cors
beschränkt ist:curl -X PUT --data-binary @CORS_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME?cors"
Dabei gilt:
BUCKET_NAME
ist der Name des Buckets. Beispiel:my-bucket
PROJECT_ID
ist die ID des mit dem Bucket verknüpften Projekts. Beispiel:my-project
.CORS_CONFIG_FILE
ist der Pfad zu der XML-Datei, die Sie in Schritt 2 erstellt haben.
Wenn Sie die CORS-Konfiguration für einen Bucket entfernen möchten, legen Sie eine leere CORS-Konfiguration fest.
CORS-Konfiguration für einen Bucket ansehen
So rufen Sie die CORS-Konfiguration für einen Bucket auf:
Console
Sie können CORS nicht über die Google Cloud Console verwalten. Verwenden Sie stattdessen die gcloud CLI.
Befehlszeile
Führen Sie den Befehl gcloud storage buckets describe
mit dem Flag --format
aus.
gcloud storage buckets describe gs://BUCKET_NAME --format="default(cors_config)"
Dabei ist BUCKET_NAME
der Name des Buckets, dessen CORS-Konfiguration Sie aufrufen möchten. Beispiel: my-bucket
.
Clientbibliotheken
Wenn Sie sich die CORS-Konfiguration für einen Bucket mithilfe der Clientbibliotheken ansehen möchten, folgen Sie der Anleitung zum Aufrufen der Metadaten eines Buckets und suchen Sie in der Antwort nach dem CORS-Feld:
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die JSON API mit einerGET
-Bucket-Anfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=cors"
Dabei ist
BUCKET_NAME
der Name des Buckets, dessen CORS-Konfiguration Sie aufrufen möchten. Beispiel:my-bucket
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Verwenden Sie
cURL
, um die XML API mit einerGET
-Bucket-Anfrage aufzurufen, die auf?cors
beschränkt ist:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?cors"
Dabei ist
BUCKET_NAME
der Name des Buckets, dessen CORS-Konfiguration Sie aufrufen möchten. Beispiel:my-bucket
Nächste Schritte
- CORS-Konfigurationsbeispiele ansehen, einschließlich eines Beispiels, bei dem die CORS-Konfiguration für einen Bucket entfernt wird.
- Weitere Informationen zu CORS.
- Weitere Informationen zur Fehlerbehebung bei CORS-Anfragen