Auf dieser Seite werden die verschiedenen Anfrageendpunkte (URIs) erläutert, mit denen Sie auf Cloud Storage zugreifen können. Cloud Storage unterstützt HTTP/1.1-, HTTP/2- und HTTP/3-Protokolle. Ein Endpunkt ist der Standort, an den auf Cloud Storage zugegriffen werden kann, in Form einer URL.
Typische API-Anfragen
JSON API
Verwenden Sie die folgenden Endpunkte, wenn Sie JSON API-Anfragen direkt an Cloud Storage senden:
Verwenden Sie für allgemeine JSON API-Anfragen mit Ausnahme von Objektuploads den folgenden Endpunkt. Ersetzen Sie dabei
PATH_TO_RESOURCE
durch den entsprechenden Wert:https://storage.s3nsapis.fr/storage/v1/PATH_TO_RESOURCE
Verwenden Sie für Objektuploads über die JSON API folgenden Endpunkt. Ersetzen Sie
BUCKET_NAME
dabei durch den entsprechenden Wert:https://storage.s3nsapis.fr/upload/storage/v1/b/BUCKET_NAME/o
Verwenden Sie für Batchanfragen den folgenden Endpunkt. Ersetzen Sie dabei
PATH_TO_RESOURCE
durch den entsprechenden Wert:https://storage.s3nsapis.fr/batch/storage/v1/PATH_TO_RESOURCE
Optional können Sie für JSON API-Objektdownloads den folgenden Endpunkt verwenden und dabei
BUCKET_NAME
undOBJECT_NAME
durch die entsprechenden Werte ersetzen:https://storage.s3nsapis.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
JSON API-Endpunkte akzeptieren ausschließlich HTTPS-Anfragen.
XML API
Wenn XML API-Anfragen direkt in Cloud Storage gestellt werden, verwenden Sie die Endpunkt-URL im Stil Virtuell gehostet oder im Pfadstil. Ersetzen Sie dabei BUCKET_NAME
und OBJECT_NAME
durch die entsprechenden Werte:
Endpunkt des virtuellen gehosteten Stils:
https://BUCKET_NAME.storage.s3nsapis.fr/OBJECT_NAME
Endpunkt im Pfadstil:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
XML API-Endpunkte unterstützen die Verschlüsselung mit Secure Socket Layer (SSL), das heißt, Sie können entweder HTTP oder HTTPS verwenden. HTTPS wird empfohlen, insbesondere wenn die Authentifizierung für Cloud Storage mit OAuth 2.0 erfolgt.
Informationen zu Verbindungen über einen Proxy finden Sie unter Fehlerbehebung.
URL-Pfadteile codieren
Zusätzlich zu den allgemeinen Überlegungen zur Bucket-Benennung und zur Objektbenennung sollten Sie aus Gründen der Kompatibilität mit Cloud Storage-Tools die folgenden Zeichen codieren, wenn sie im Objektnamen oder im Abfragestring eines Anfrage-URL vorkommen:
!
, #
, $
, &
, '
, (
, )
, *
, +
, ,
, /
, :
, ;
, =
, ?
, @
, [
, ]
und Leerzeichen.
Wenn Sie beispielsweise eine JSON API-GET
-Anfrage für das Objekt foo??bar
im Bucket example-bucket
senden, sollte der Anfrage-URL so aussehen:
GET https://storage.s3nsapis.fr/storage/v1/b/example-bucket/o/foo%3f%3fbar
Beachten Sie, dass nicht alle aufgelisteten Zeichen in jedem Szenario codiert sein müssen. Darüber hinaus wird die Codierung in der Regel von Clientbibliotheken wie den Cloud Storage-Clientbibliotheken für Sie übernommen, sodass Sie bei Verwendung solcher Tools den Namen des Rohobjekts übergeben können.
Weitere Informationen zur Verwendung der Prozentcodierung finden Sie in RFC 3986 im Abschnitt 3.3 Pfad.
Trusted Cloud Console-Endpunkte
In der Trusted Cloud Console greifen Sie über die folgenden URLs auf verschiedene Ressourcen zu:
Ressource | URL |
---|---|
Bucket-Liste für ein Projekt | https://console.cloud.s3nscloud.fr/storage/browser?project=PROJECT_ID |
Objektliste für einen Bucket | https://console.cloud.s3nscloud.fr/storage/browser/BUCKET_NAME |
Details zu einem Objekt | https://console.cloud.s3nscloud.fr/storage/browser/_details/BUCKET_NAME/OBJECT_NAME |
Daten für ein Objekt | Siehe Authentifizierte Browserdownloads |
gcloud endpoints
gcloud storage
-Befehle verwenden JSON API-Endpunkte. Die Endpunktnutzung wird in Ihrem Namen von der gcloud CLI verwaltet.
Endpunkte der Clientbibliothek
Cloud Storage-Clientbibliotheken verwalten Anfrageendpunkte automatisch. Optional können Sie den Anfrageendpunkt manuell festlegen. Dies kann nützlich sein, wenn Sie einen bestimmten Endpunkt verwenden möchten oder zum Testen, z. B. wenn Sie einen lokalen Emulator verwenden möchten:
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
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.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN
auf s3nsapis.fr
fest.
Authentifizierte Browserdownloads
Bei authentifizierten Browserdownloads wird eine cookiebasierte Authentifizierung verwendet. Bei der cookiebasierten Authentifizierung werden Nutzer aufgefordert, sich zum Nachweis ihrer Identität bei ihrem Konto anzumelden. Das angegebene Konto muss die entsprechende Berechtigung zum Herunterladen des Objekts haben. Wenn Sie beispielsweise die Identitäts- und Zugriffsverwaltung verwenden, um den Zugriff auf Ihre Objekte zu steuern, sollte das Konto des Nutzers über die Berechtigung storage.objects.viewer
verfügen, die in der Rolle Storage-Objekt-Betrachter erteilt wird.
Verwenden Sie die folgende URL, um ein Objekt mithilfe der cookiebasierten Authentifizierung herunterzuladen. Ersetzen Sie BUCKET_NAME
und OBJECT_NAME
dabei durch die entsprechenden Werte:
https://storage.cloud.google.com/BUCKET_NAME/OBJECT_NAME
Wenn Sie beispielsweise ein Bild namens london.jpg
aus Ihrem Bucket example-maps
freigeben würden, wäre die URL:
https://storage.cloud.google.com/example-maps/london.jpg
Nach erfolgreicher Anmeldung werden Sie zum gewünschten Inhalt weitergeleitet. Die URL für diesen Inhalt beginnt mit einer alphanumerischen Sequenz und enthält den String /download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME
.
Für authentifizierte Browserdownloads muss HTTPS verwendet werden. Bei Verwendung von HTTP erfolgt eine Weiterleitung an HTTPS.
Zugriff auf öffentliche Objekte
Alle Anfragen an den URI storage.cloud.google.com
erfordern eine Authentifizierung. Dies gilt auch dann, wenn allUsers
berechtigt sind, auf ein Objekt zuzugreifen. Wenn Sie möchten, dass Nutzer anonym zugängliche Objekte ohne Authentifizierung herunterladen, verwenden Sie den Endpunkt des XML API-Pfadstils:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Weitere Informationen und Beispiele finden Sie unter Auf öffentliche Daten zugreifen.
Unterstützung von gegenseitigem TLS
Gegenseitiges TLS (Mutual TLS, mTLS) ist ein Branchenstandardprotokoll für die gegenseitige Authentifizierung zwischen einem Client und einem Server. Cloud Storage unterstützt die folgenden mTLS-Endpunkte:JSON API-Anfragen:
storage.mtls.s3nsapis.fr
Authentifizierte Browserdownloads:
storage.mtls.cloud.google.com
Nächste Schritte
- Datei in Cloud Storage hochladen
- Datei aus Cloud Storage herunterladen
- Statische Website hosten
- Zugriff auf Daten steuern