Panoramica Esempi di configurazione
La condivisione delle risorse tra origini (CORS) consente le interazioni tra le risorse di origini diverse, cosa che normalmente è vietata per evitare comportamenti dannosi. Usa questa pagina per scoprire come impostare una configurazione CORS configurazione su un bucket Cloud Storage e come visualizzare il file CORS su un bucket. Vedi Esempi di configurazione per CORS per configurazioni CORS di esempio, inclusa la configurazione che disattiva qualsiasi configurazione esistente nel bucket.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per impostare e visualizzare la configurazione CORS
su un bucket, chiedi all'amministratore di concederti il ruolo Amministratore Storage
(roles/storage.admin
) nel bucket.
Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e visualizzare CORS configurazioni. Per vedere con esattezza le autorizzazioni necessarie, espandi la sezione Sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.buckets.get
storage.buckets.update
Puoi ottenere queste autorizzazioni anche con altri ruoli predefiniti oppure 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, ad esempio HTTP e i domini di origine, che identificano i tipi di richieste può accettare.
Per impostare una configurazione CORS nel bucket:
Console
Non puoi gestire CORS utilizzando la console Google Cloud. Utilizza la con gcloud CLI.
Riga di comando
Crea un file JSON con la configurazione CORS che preferisci . Consulta gli esempi di configurazione per i file JSON di esempio.
Utilizza il comando
gcloud storage buckets update
con Flag--cors-file
:gcloud storage buckets update gs://BUCKET_NAME --cors-file=CORS_CONFIG_FILE
Dove:
BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.CORS_CONFIG_FILE
è il percorso del file JSON creato nel passaggio 1.
Librerie client
C++
Per ulteriori informazioni, consulta API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
L'esempio seguente imposta una configurazione CORS su un bucket:
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Crea un file JSON con la configurazione CORS che preferisci per applicare le modifiche. Consulta gli esempi di configurazione per i file JSON di esempio.
Utilizza
cURL
per chiamare l'API JSON con un RichiestaPATCH
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
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Crea un file XML con la configurazione CORS che preferisci. per applicare le modifiche. Consulta gli esempi di configurazione per i file XML di esempio.
Utilizza
cURL
per chiamare l'API XML con un RichiestaPUT Bucket
limitata all'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 associate al bucket. Ad esempio,my-project
.CORS_CONFIG_FILE
è il percorso del file XML creato nel passaggio 2.
Per rimuovere la configurazione CORS per un bucket, impostare 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 la con gcloud CLI.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con
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 utilizzando le librerie client, segui le istruzioni per visualizzare i metadati di un bucket e cerca Campo CORS nella risposta:
C++
Per ulteriori informazioni, consulta API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un RichiestaGET
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
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API XML con un 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 su un bucket.
- Scopri di più su CORS.
- Scopri come risolvere i problemi relativi alle richieste CORS.