Questa pagina descrive come configurare la funzionalità Pagamenti a carico del richiedente e fornisce un esempio di come effettuare una richiesta su un bucket in cui è abilitata la funzionalità Pagamenti a carico del richiedente.
Configurare i pagamenti a carico del richiedente
Le seguenti sezioni mostrano come attivare e disattivare i Pagamenti a carico del richiedente, nonché come verificare se i Pagamenti a carico del richiedente sono abilitati in un bucket.
Prerequisiti
Devi avere l'autorizzazione
storage.buckets.get
, che ti consente di ottenere lo stato dei pagamenti a carico del richiedente per un bucket ed è necessaria anche per abilitare e disabilitare i pagamenti a carico del richiedente con la console Google Cloud o Google Cloud CLI.Quando attivi o disattivi i Pagamenti a carico del richiedente, devi disporre dell'autorizzazione
storage.buckets.update
.Quando disabiliti i pagamenti a carico del richiedente, devi includere un progetto di fatturazione nella richiesta o disporre dell'autorizzazione
resourcemanager.projects.createBillingAssignment
. Per ulteriori informazioni, consulta Requisiti di utilizzo e accesso per i pagamenti a carico del richiedente.
Le autorizzazioni vengono concesse agli utenti tramite i ruoli. Ad esempio, agli utenti a cui è stato concesso il ruolo Amministratore archiviazione dispone di tutte le autorizzazioni storage.buckets
indicate sopra. I ruoli possono essere concessi al progetto che contiene il bucket.
Impostare i pagamenti a carico del richiedente
Per abilitare o disabilitare i pagamenti a carico del richiedente in un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, trova il bucket che vuoi impostare e individua la colonna Pagamenti a carico del richiedente.
Il valore nella colonna indica lo stato attuale dei pagamenti a carico del richiedente per quel bucket.
Fai clic sullo stato attuale di Pagamenti a carico del richiedente per il bucket desiderato.
Nella finestra visualizzata, fai clic su Attiva o Disattiva, a seconda dello stato che vuoi impostare per i Pagamenti a carico del richiedente.
Quando questa opzione è abilitata, viene visualizzata una bolla verde con l'indicazione On nella colonna Pagamenti a carico del richiedente per il bucket. Quando questa opzione è disattivata, nella colonna vengono visualizzati una bolla grigia con l'indicazione Off.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage buckets update
con il flag appropriato:
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.FLAG
è--requester-pays
per abilitare i pagamenti a carico del richiedente o "--no-requester-pays" per disabilitarlo.
In caso di esito positivo, la risposta sarà simile al seguente esempio:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Il seguente esempio abilita i pagamenti a carico del richiedente su un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file JSON contenente le seguenti informazioni:
{ "billing": { "requesterPays": STATE } }
Dove STATE è
true
ofalse
.Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
di bucket: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"
Dove:
JSON_FILE_NAME
è il percorso del file JSON creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Crea un file XML contenente le seguenti informazioni:
<BillingConfiguration> <RequesterPays>STATE</RequesterPays> </BillingConfiguration>
Dove STATE è
Enabled
oDisabled
.Utilizza
cURL
per chiamare l'API XML con una richiesta BucketPUT
e un parametro della stringa di querybilling
:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?billing"
Dove:
XML_FILE_NAME
è il percorso del file XML che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Verificare se la funzionalità Pagamenti a carico del richiedente è abilitata
Per verificare se i pagamenti a carico del richiedente sono abilitati in un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, lo stato Pagamenti a carico del richiedente di ogni bucket si trova nella colonna Pagamenti a carico del richiedente.
Se attivato, lo stato è verde e viene visualizzata la parola On.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con il flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(requester_pays)"
Dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare lo stato, Ad esempio, my-bucket
.
In caso di esito positivo, la risposta sarà simile al seguente esempio:
requester_pays: true
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiestaGET
di bucket:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=billing"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiesta BucketGET
e un parametro della stringa di querybilling
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?billing"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
Accedi ai bucket dei pagamenti a carico del richiedente
L'esempio seguente mostra come includere un progetto di fatturazione in modo da poter scaricare un oggetto archiviato in un bucket Pagamenti a carico del richiedente. Utilizza una procedura simile per eseguire altre richieste sul bucket Pagamenti a carico del richiedente o sugli oggetti al suo interno. Consulta i requisiti di accesso per i pagamenti a carico del richiedente per le considerazioni sui prerequisiti.
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto da scaricare.
Nella finestra visualizzata, utilizza il menu a discesa per selezionare un progetto per la fatturazione.
Seleziona la casella di controllo per confermare di avere l'autorizzazione a utilizzare il progetto selezionato a fini di fatturazione.
Fai clic su Salva.
Scarica l'oggetto come faresti normalmente.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud, consulta Risoluzione dei problemi.
Riga di comando
Usa il flag --billing-project
nella richiesta:
gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION --billing-project=PROJECT_IDENTIFIER
Dove:
BUCKET_NAME
è il nome del bucket che contiene l'oggetto che stai scaricando. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto che stai scaricando. Ad esempio,pets/dog.png
.SAVE_TO_LOCATION
è il percorso locale in cui salvi l'oggetto. Ad esempio,Desktop/Images
.PROJECT_IDENTIFIER
è l'ID o il numero del progetto da fatturare. Ad esempio,my-project
.
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Nella richiesta, includi il parametro della stringa di query
userProject
impostato sull'ID del progetto da fatturare: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"
Dove:
SAVE_TO_LOCATION
è la posizione in cui vuoi salvare l'oggetto. Ad esempio,Desktop/dog.png
.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che vuoi scaricare. Ad esempio,pets/dog.png
, con codifica URL comepets%2Fdog.png
.PROJECT_IDENTIFIER
è l'ID o il numero del progetto da fatturare. Ad esempio,my-project
.
API XML
Assicurati che gcloud CLI sia installato e inizializzatoper generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Nella richiesta, includi l'intestazione
x-goog-user-project
impostata sull'ID del progetto da fatturare: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"
Dove:
PROJECT_ID
è l'ID del progetto da fatturare. Ad esempio,my-project
.SAVE_TO_LOCATION
è la posizione in cui vuoi salvare l'oggetto. Ad esempio,Desktop/dog.png
.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che vuoi scaricare. Ad esempio,pets/dog.png
, con codifica URL comepets%2Fdog.png
.
Passaggi successivi
- Scopri di più sui Pagamenti a carico del richiedente.
- Rendi i dati disponibili pubblicamente.