Questa pagina mostra configurazioni di esempio per la condivisione delle risorse tra origini (CORS). Quando imposti una configurazione CORS su un bucket, consenti le interazioni tra risorse di origini diverse, attività che in genere è vietata per evitare comportamenti dannosi.
Configurazione CORS di base
Supponiamo che tu abbia un sito web dinamico a cui gli utenti possono accedere da your-example-website.appspot.com
. Hai un file immagine ospitato in un bucket Cloud Storage denominato your-example-bucket
. Vuoi utilizzare
l'immagine sul tuo sito web, quindi devi applicare una configurazione CORS a
your-example-bucket
che consenta ai browser degli utenti di richiedere risorse
dal bucket. In base alla seguente configurazione, le richieste preflight
valide per un'ora e le richieste del browser andate a buon fine restituiscono il valore Content-Type
della risorsa nella risposta.
Riga di comando
Comando gcloud di esempio
gcloud storage buckets update gs://example_bucket --cors-file=example_cors_file.json
File JSON di esempio contenente la configurazione CORS
[ { "origin": ["http://your-example-website.appspot.com"], "method": ["GET"], "responseHeader": ["Content-Type"], "maxAgeSeconds": 3600 } ]
Per saperne di più su come impostare una configurazione CORS utilizzando Google Cloud CLI, consulta la documentazione di riferimento di gcloud storage buckets update
.
API REST
API JSON
{ "cors": [ { "origin": ["http://your-example-website.appspot.com"], "method": ["GET"], "responseHeader": ["Content-Type"], "maxAgeSeconds": 3600 } ] }
Per il formato generalizzato di un file di configurazione CORS, consulta la rappresentazione delle risorse dei bucket per JSON.
API XML
<?xml version="1.0" encoding="UTF-8"?> <CorsConfig> <Cors> <Origins> <Origin>http://your-example-website.appspot.com</Origin> </Origins> <Methods> <Method>GET</Method> </Methods> <ResponseHeaders> <ResponseHeader>Content-Type</ResponseHeader> </ResponseHeaders> <MaxAgeSec>3600</MaxAgeSec> </Cors> </CorsConfig>
Per il formato generalizzato di un file di configurazione CORS, consulta Formato di configurazione CORS per XML.
Rimuovi le impostazioni CORS da un bucket
Per rimuovere le impostazioni CORS da un bucket, fornisci un file di configurazione CORS vuoto.
Riga di comando
Quando utilizzi il comando gcloud storage buckets update
con il flag --clear-cors
, rimuovi la configurazione CORS da un bucket:
gcloud storage buckets update gs://BUCKET_NAME --clear-cors
Dove BUCKET_NAME è il nome del bucket di cui vuoi rimuovere la configurazione CORS.
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 rimuove qualsiasi configurazione CORS esistente da 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 rimuove qualsiasi configurazione CORS esistente da 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 rimuove qualsiasi configurazione CORS esistente da 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 rimuove qualsiasi configurazione CORS esistente da 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 rimuove qualsiasi configurazione CORS esistente da 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 rimuove qualsiasi configurazione CORS esistente da 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 rimuove qualsiasi configurazione CORS esistente da 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 rimuove qualsiasi configurazione CORS esistente da un bucket:
API REST
API JSON
Se impostata su un bucket, la configurazione seguente rimuove tutte le impostazioni CORS da un bucket:
{ "cors": [] }
Per il formato generalizzato di un file di configurazione CORS, consulta la rappresentazione delle risorse dei bucket per JSON.
API XML
Se impostata su un bucket, la configurazione seguente rimuove tutte le impostazioni CORS da un bucket:
<CorsConfig></CorsConfig>
Per il formato generalizzato di un file di configurazione CORS, consulta Formato di configurazione CORS per XML.
Passaggi successivi
- Scopri di più sulla condivisione delle risorse tra origini (CORS).
- Imposta e visualizza la configurazione CORS su un bucket.