Questa pagina descrive come attivare e disattivare i pagamenti a carico del richiedente, nonché come verificare se questa opzione è attivata in un bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per impostare e gestire la funzionalità Richiedente paga, chiedi all'amministratore di concederti il ruolo Amministratore Storage (roles.storage.Admin
) nel progetto che contiene il bucket.
Questo ruolo contiene le autorizzazioni necessarie per impostare e gestire i pagamenti a carico del richiedente. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
resourcemanager.projects.createBillingAssignment
- Questa autorizzazione è necessaria solo se non disponi di un account di fatturazione da utilizzare quando disattivi la funzionalità Richiedente paga. Per ulteriori informazioni, consulta la sezione Requisiti di utilizzo e accesso.
Potresti anche ottenere queste autorizzazioni con altri ruoli predefiniti o ruoli personalizzati.
Per istruzioni sulla concessione dei ruoli nei progetti, consulta Concedere o revocare un ruolo.
Impostare i pagamenti a carico del richiedente
Per attivare o disattivare i pagamenti a carico del richiedente in un bucket:
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, individua quello che vuoi impostare e la colonna Richiedente paga.
Il valore nella colonna indica lo stato attuale di Requester Pays per quel bucket.
Fai clic sullo stato attuale di Pagamenti a carico del richiedente per il bucket.
Nella finestra visualizzata, fai clic su Attiva o Disattiva, a seconda dello stato che vuoi impostare per Richiedente paga.
Se attivata, nella colonna Pagamenti a carico del richiedente del bucket vengono visualizzate una bolla verde e la dicitura On. Se disattivata, nella colonna vengono visualizzati un fumetto grigio e la dicitura 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 attivare Requester Pays o--no-requester-pays
per disattivarlo.
Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:
Updating gs://my-bucket/... Completed 1
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in 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 Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in 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 Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in 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 Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in 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 Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in 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 Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in 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 Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in 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 Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Il seguente esempio abilita i pagamenti a carico del richiedente in un bucket:
Il seguente esempio disabilita i pagamenti a carico del richiedente in un bucket:
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'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
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 che hai creato nel passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Crea un file XML che contenga le seguenti informazioni:
<BillingConfiguration> <RequesterPays>STATE</RequesterPays> </BillingConfiguration>
Dove STATE è
Enabled
oDisabled
.Utilizza
cURL
per chiamare l'API XML con una richiestaPUT
Bucket e il 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
.
Controllare se i pagamenti a carico del richiedente sono abilitati
Per verificare se i pagamenti a carico del richiedente sono abilitati in un bucket:
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, lo stato di pagamento a carico del richiedente di ogni bucket si trova nella colonna Pagamento 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
.
Se l'operazione ha esito positivo, la risposta è simile al seguente esempio:
requester_pays: true
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiestaGET
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
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con una richiestaGET
Bucket e il 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
.
Accedere ai bucket di 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 Requester Pays. Utilizza una procedura simile per eseguire altre richieste sul bucket Requester Pays o sugli oggetti al suo interno. Consulta i requisiti di accesso di Richiedente paga per le considerazioni preliminari.
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene l'oggetto che vuoi scaricare.
Nella finestra visualizzata, utilizza il menu a discesa per selezionare un progetto per la fatturazione.
Seleziona la casella di controllo per confermare di essere autorizzato a utilizzare il progetto selezionato ai fini della 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
Utilizza 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 contenente 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 Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere la gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'intestazione
Authorization
.Nella richiesta, includi il parametro di 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
, codificato come URLpets%2Fdog.png
.PROJECT_IDENTIFIER
è l'ID o il numero del progetto da fatturare. Ad esempio,my-project
.
API XML
Avere gcloud CLI installata e inizializzata, che ti consente di generare un token di accesso per l'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
, codificato come URLpets%2Fdog.png
.