Panoramica Esempi di configurazione
La condivisione delle risorse tra origini (CORS) consente le interazioni tra risorse di origini diverse, attività che in genere è vietata per prevenire comportamenti dannosi. Utilizza questa pagina per scoprire come impostare una configurazione CORS su un bucket Cloud Storage e come visualizzare il set di configurazione CORS in un bucket. Consulta gli esempi di configurazione per CORS per alcuni esempi di configurazioni CORS, inclusa quella che disabilita qualsiasi configurazione esistente nel bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per impostare e visualizzare la configurazione CORS in un bucket, chiedi all'amministratore di concederti il ruolo Amministratore Storage (roles/storage.admin
) per il bucket.
Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e visualizzare le configurazioni CORS. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
Puoi ottenere queste autorizzazioni anche con altri ruoli predefiniti o ruoli personalizzati.
Per informazioni sulla concessione dei ruoli nei bucket, consulta Utilizzare IAM con i bucket.
Imposta la configurazione CORS su un bucket
Puoi impostare una configurazione CORS su un bucket specificando informazioni, come metodi HTTP e domini di origine, che identificano i tipi di richieste che il bucket può accettare.
Per impostare una configurazione CORS sul tuo bucket:
Console
Non puoi gestire CORS utilizzando la console Google Cloud. Utilizza invece gcloud CLI.
Riga di comando
Crea un file JSON con la configurazione CORS che vuoi applicare. Consulta gli esempi di configurazione per alcuni file JSON di esempio.
Utilizza il comando
gcloud storage buckets update
con il flag--cors-file
:gcloud storage buckets update gs://BUCKET_NAME --cors-file=CORS_CONFIG_FILE
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.CORS_CONFIG_FILE
è il percorso del file JSON creato nel passaggio 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.
L'esempio seguente imposta una configurazione CORS 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.
L'esempio seguente imposta una configurazione CORS 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.
L'esempio seguente imposta una configurazione CORS 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.
L'esempio seguente imposta una configurazione CORS 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.
L'esempio seguente imposta una configurazione CORS 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.
L'esempio seguente imposta una configurazione CORS 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.
L'esempio seguente imposta una configurazione CORS 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.
L'esempio seguente imposta una configurazione CORS 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 con la configurazione CORS che vuoi applicare. Consulta gli esempi di configurazione per alcuni file JSON di esempio.
Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
di bucket: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
Dove:
BUCKET_NAME
è il nome del bucket. Ad esempio,my-bucket
.CORS_CONFIG_FILE
è il percorso del file JSON creato nel passaggio 2.
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 con la configurazione CORS che vuoi applicare. Consulta gli esempi di configurazione per alcuni file XML di esempio.
Utilizza
cURL
per chiamare l'API XML con una richiestaPUT Bucket
con ambito?cors
: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"
Dove:
BUCKET_NAME
è il nome del bucket. Ad esempio,my-bucket
.PROJECT_ID
è l'ID del progetto associato al bucket. Ad esempio,my-project
.CORS_CONFIG_FILE
è il percorso del file XML che hai creato nel passaggio 2.
Per rimuovere la configurazione CORS per un bucket, imposta una configurazione CORS vuota.
Visualizza la configurazione CORS per un bucket
Per visualizzare la configurazione CORS per un bucket:
Console
Non puoi gestire CORS utilizzando la console Google Cloud. Utilizza invece gcloud CLI.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con il flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(cors_config)"
Dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare la configurazione CORS. Ad esempio, my-bucket
.
Librerie client
Per visualizzare la configurazione CORS per un bucket che utilizza le librerie client, segui le istruzioni per visualizzare i metadati di un bucket e cerca il campo CORS nella risposta:
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
.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=cors"
Dove
BUCKET_NAME
è il nome del bucket di cui vuoi visualizzare la configurazione CORS. 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 richiestaGET
Bucket con ambito?cors
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?cors"
Dove
BUCKET_NAME
è il nome del bucket di cui vuoi visualizzare la configurazione CORS. Ad esempio,my-bucket
.
Passaggi successivi
- Esplora gli esempi di configurazione CORS, tra cui un esempio che rimuove la configurazione CORS da un bucket.
- Scopri di più su CORS.
- Scopri come risolvere i problemi delle richieste CORS.