Auf dieser Seite erfahren Sie, wie Sie die Funktion "Sender bezahlt" einrichten. Anhand eines Beispiels wird veranschaulicht, wie Sie eine Anfrage für einen Bucket erstellen, in dem die Funktion "Sender bezahlt" aktiviert ist.
„Anforderer bezahlt” einrichten
In den folgenden Abschnitten erfahren Sie, wie Sie "Sender bezahlt" ein- und ausschalten und wie Sie überprüfen, ob die Funktion in einem Bucket aktiviert ist.
Vorbereitung
Für die Abfrage des Status von "Anfragesteller bezahlt" eines Buckets müssen Sie die Berechtigung
storage.buckets.get
haben. Außerdem benötigen Sie diese Berechtigung, um "Anfragesteller bezahlt" mit der Google Cloud Console oder der Google Cloud CLI aktivieren bzw. deaktivieren zu können.Wenn Sie "Sender bezahlt" aktivieren oder deaktivieren, benötigen Sie die Berechtigung
storage.buckets.update
.Wenn Sie "Anforderer bezahlt" deaktivieren, müssen Sie entweder in Ihre Anfrage ein Abrechnungsprojekt einfügen oder die Berechtigung
resourcemanager.projects.createBillingAssignment
haben. Weitere Informationen finden Sie unter "Anforderer bezahlt" unter Anforderungen für Zugriff und Verwendung.
Berechtigungen werden Nutzern mithilfe von Rollen gewährt. Nutzer mit der Rolle Storage-Administrator haben beispielsweise alle oben genannten Berechtigungen vom Typ storage.buckets
. Rollen können für das Projekt zugewiesen werden, das den Bucket enthält.
"Anforderer bezahlt" einstellen
So aktivieren oder deaktivieren Sie "Anforderer bezahlt" für einen Bucket:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Wählen Sie in der Bucket-Liste den gewünschten Bucket aus und suchen Sie die Spalte Anforderer bezahlt.
Der Wert in der Spalte gibt den aktuellen Status der Funktion "Anforderer bezahlt" für diesen Bucket an.
Klicken Sie auf den aktuellen Status von "Anforderer bezahlt" für den gewünschten Bucket.
Klicken Sie im angezeigten Fenster auf Aktivieren oder Deaktivieren, je nachdem, welchen Status Sie für „Anforderer bezahlt“ festlegen möchten.
Wenn die Option aktiviert ist, werden in der Spalte Anforderer bezahlt für den Bucket ein grünes Infofeld und Ein angezeigt. Wenn die Option deaktiviert ist, werden in der Spalte ein graues Infofeld und das Wort Aus angezeigt.
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Befehlszeile
Führen Sie den gcloud storage buckets update
-Befehl mit dem geeigneten Flag aus.
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dabei gilt:
BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.FLAG
ist entweder--requester-pays
, um "Anforderer bezahlt" zu aktivieren, oder `--no-requester-pays, um es zu deaktivieren.
Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:
Updating gs://my-bucket/... Completed 1
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
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 eine lokale Entwicklungsumgebung einrichten.
Im folgenden Beispiel wird die Funktion "Anforderer bezahlt" für einen Bucket aktiviert:
Im folgenden Beispiel wird "Anforderer bezahlt" für einen Bucket deaktiviert:
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:
{ "billing": { "requesterPays": STATE } }
Dabei ist STATE entweder
true
oderfalse
.Verwenden Sie
cURL
, um die JSON API mit einerPATCH
-Bucket-Anfrage aufzurufen:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=billing"
Dabei gilt:
JSON_FILE_NAME
ist der Pfad für die JSON-Datei, die Sie in Schritt 2 erstellt haben.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Erstellen Sie eine XML-Datei, die folgende Information enthält:
<BillingConfiguration> <RequesterPays>STATE</RequesterPays> </BillingConfiguration>
Dabei ist STATE entweder
Enabled
oderDisabled
.Verwenden Sie
cURL
, um die XML API mit einerPUT
-Bucket-Anfrage und dem Abfragestringparameterbilling
aufzurufen:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?billing"
Dabei gilt:
XML_FILE_NAME
ist der Pfad für die XML-Datei, die Sie in Schritt 2 erstellt haben.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.
Prüfen, ob „Anforderer bezahlt” aktiviert ist
So überprüfen Sie, ob die Funktion "Sender bezahlt" für einen Bucket aktiviert ist:
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Der "Anforderer bezahlt"-Status jedes Buckets wird in der Bucket-Liste in der Spalte Anforderer bezahlt angezeigt.
Bei aktivierter Funktion ist der Status grün und das Wort Ein wird angezeigt.
Befehlszeile
Führen Sie den Befehl gcloud storage buckets describe
mit dem Flag --format
aus.
gcloud storage buckets describe gs://BUCKET_NAME --format="default(requester_pays)"
Dabei ist BUCKET_NAME
der Name des Buckets, dessen Status Sie aufrufen möchten. Beispiel: my-bucket
.
Wenn der Vorgang erfolgreich war, sieht die Antwort in etwa so aus:
requester_pays: true
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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.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=billing"
Dabei ist
BUCKET_NAME
der Name des entsprechenden Buckets. Beispiel:my-bucket
.
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Verwenden Sie
cURL
, um die XML API mit einerGET
-Bucket-Anfrage und dem Abfragestringparameterbilling
aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?billing"
Dabei ist
BUCKET_NAME
der Name des entsprechenden Buckets. Beispiel:my-bucket
.
Auf „Anforderer bezahlt”-Buckets zugreifen
Im folgenden Beispiel wird gezeigt, wie Sie ein Abrechnungsprojekt einbinden, damit Sie ein Objekt herunterladen können, das in einem "Sender bezahlt"-Bucket gespeichert ist. Auf dieselbe Art können Sie auch andere Anfragen für den "Anforderer bezahlt"-Bucket oder darin enthaltene Objekte ausführen. Weitere Voraussetzungen finden Sie im Abschnitt "Anforderer bezahlt" unter Anforderungen für Zugriff und Verwendung.
Console
- Wechseln Sie in der Cloud Console zur Seite Cloud Storage-Buckets.
Klicken Sie in der Liste der Buckets auf den Bucket, der das Objekt enthält, das Sie herunterladen möchten.
Wählen Sie im daraufhin angezeigten Fenster aus dem Drop-down-Menü ein Projekt für die Abrechnung aus.
Klicken Sie auf das Kästchen, um zu bestätigen, dass Sie berechtigt sind, das ausgewählte Projekt für Abrechnungszwecke zu verwenden.
Klicken Sie auf Speichern.
Unter Fehlerbehebung erfahren Sie, wie Sie detaillierte Fehlerinformationen zu fehlgeschlagenen Cloud Storage-Vorgängen in der Google Cloud Console abrufen.
Befehlszeile
Verwenden Sie das Flag --billing-project
in Ihrer Anfrage:
gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION --billing-project=PROJECT_IDENTIFIER
Dabei gilt:
BUCKET_NAME
ist der Name des Buckets mit dem Objekt, das Sie herunterladen. Beispiel:my-bucket
.OBJECT_NAME
ist der Name des Objekts, das Sie herunterladen. Beispiel:pets/dog.png
.SAVE_TO_LOCATION
ist der lokale Pfad, unter dem Sie Ihr Objekt speichern. Beispiel:Desktop/Images
.PROJECT_IDENTIFIER
ist die ID oder Nummer des Projekts, das abgerechnet wird. Beispiel:my-project
.
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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung 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 eine lokale Entwicklungsumgebung einrichten.
REST APIs
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Fügen Sie in der Anfrage der ID des Abrechnungsprojekts den Header
userProject
hinzu:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media&userProject=PROJECT_IDENTIFIER"
Wobei:
SAVE_TO_LOCATION
ist der Standort, an dem Sie Ihr Objekt speichern möchten. Beispiel:Desktop/dog.png
.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.OBJECT_NAME
ist der URL-codierte Name des Objekts, das Sie herunterladen möchten. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.PROJECT_IDENTIFIER
ist die ID oder Nummer des Projekts, das abgerechnet wird. Beispiel:my-project
.
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header
Authorization
zu generieren.Alternativ können Sie mit dem OAuth 2.0 Playground ein Zugriffstoken erstellen und in den Header
Authorization
einfügen.Fügen Sie in der Anfrage der ID des Abrechnungsprojekts den Header
x-goog-user-project
hinzu:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-user-project: PROJECT_ID" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Wobei:
PROJECT_ID
ist die ID des Projekts, das abgerechnet werden soll. Beispiel:my-project
.SAVE_TO_LOCATION
ist der Standort, an dem Sie Ihr Objekt speichern möchten. Beispiel:Desktop/dog.png
.BUCKET_NAME
ist der Name des entsprechenden Buckets. Beispiel:my-bucket
.OBJECT_NAME
ist der URL-codierte Name des Objekts, das Sie herunterladen möchten. Beispiel:pets/dog.png
, URL-codiert alspets%2Fdog.png
.
Nächste Schritte
- Weitere Informationen zu Anforderer bezahlt.
- Daten öffentlich verfügbar machen.