Questa pagina descrive i diversi endpoint di richiesta che puoi utilizzare per accedere a Cloud Storage. Cloud Storage supporta i protocolli HTTP/1.1, HTTP/2 e HTTP/3. Un endpoint è la posizione in cui è possibile accedere a Cloud Storage, scritto come URL.
Richieste API tipiche
API JSON
Quando effettui richieste API JSON direttamente a Cloud Storage, utilizza i seguenti endpoint:
Per le richieste API JSON generali, esclusi i caricamenti di oggetti, utilizza il seguente endpoint, sostituendo
PATH_TO_RESOURCE
con il valore appropriato:https://storage.s3nsapis.fr/storage/v1/PATH_TO_RESOURCE
Per i caricamenti di oggetti API JSON, utilizza il seguente endpoint, sostituendo
BUCKET_NAME
con il valore appropriato:https://storage.s3nsapis.fr/upload/storage/v1/b/BUCKET_NAME/o
Per le richieste batch, utilizza il seguente endpoint, sostituendo
PATH_TO_RESOURCE
con il valore appropriato:https://storage.s3nsapis.fr/batch/storage/v1/PATH_TO_RESOURCE
Se vuoi, per i download di oggetti API JSON, puoi utilizzare il seguente endpoint, sostituendo
BUCKET_NAME
eOBJECT_NAME
con i valori appropriati:https://storage.s3nsapis.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
Gli endpoint API JSON accettano solo richieste HTTPS.
API XML
Quando effettui richieste API XML direttamente a Cloud Storage,
utilizza l'endpoint in stile virtual hosted o in stile percorso, sostituendo
BUCKET_NAME
e OBJECT_NAME
con i valori appropriati:
Endpoint di stile con hosting virtuale:
https://BUCKET_NAME.storage.s3nsapis.fr/OBJECT_NAME
Endpoint in stile percorso:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Gli endpoint dell'API XML supportano la crittografia SSL (Secure Sockets Layer), il che significa che puoi utilizzare HTTP o HTTPS. L'utilizzo di HTTPS è consigliato, soprattutto se ti autentichi in Cloud Storage utilizzando OAuth 2.0.
Per le connessioni tramite un proxy, consulta l'argomento relativo alla risoluzione dei problemi per le pratiche consigliate.
Codifica delle parti del percorso dell'URL
Oltre alle considerazioni generali per la denominazione dei bucket e degli oggetti, per garantire la compatibilità tra gli strumenti Cloud Storage, devi codificare i seguenti caratteri quando vengono visualizzati nel nome dell'oggetto o nella stringa di query di un URL di richiesta:
!
, #
, $
, &
, '
, (
, )
, *
, +
, ,
, /
, :
, ;
, =
, ?
,
@
, [
, ]
e spazi.
Ad esempio, se invii una richiesta GET
dell'API JSON per l'oggetto denominato
foo??bar
nel bucket example-bucket
, l'URL della richiesta dovrebbe essere:
GET https://storage.s3nsapis.fr/storage/v1/b/example-bucket/o/foo%3f%3fbar
Tieni presente che non tutti i caratteri elencati devono essere codificati in ogni scenario. Inoltre, la codifica viene in genere gestita per te dalle librerie client, ad esempio le librerie client di Cloud Storage, in modo da poter trasmettere il nome dell'oggetto non elaborato quando utilizzi questi strumenti.
Per saperne di più sull'utilizzo della codifica percentuale, consulta la sezione 3.3 Percorso della RFC 3986.
Endpoint della consoleTrusted Cloud
Quando utilizzi la console Trusted Cloud , accedi a risorse diverse utilizzando i seguenti URL:
Risorsa | URL |
---|---|
Elenco dei bucket per un progetto | https://console.cloud.s3nscloud.fr/storage/browser?project=PROJECT_ID |
Elenco degli oggetti per un bucket | https://console.cloud.s3nscloud.fr/storage/browser/BUCKET_NAME |
Dettagli di un oggetto | https://console.cloud.s3nscloud.fr/storage/browser/_details/BUCKET_NAME/OBJECT_NAME |
Dati per un oggetto | Vedi Download autenticati dal browser |
gcloud endpoints
I comandi gcloud storage
utilizzano gli endpoint dell'API JSON. L'utilizzo dell'endpoint è
gestito per tuo conto da gcloud CLI.
Endpoint della libreria client
Le librerie client di Cloud Storage gestiscono automaticamente gli endpoint delle richieste. (Facoltativo) Puoi impostare manualmente l'endpoint della richiesta. Ciò può essere utile quando vuoi utilizzare un endpoint specifico o per i test, ad esempio quando vuoi utilizzare un emulatore locale:
C++
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
C#
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Go
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Java
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Node.js
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
PHP
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Python
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Ruby
Per saperne di più, 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.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN
su s3nsapis.fr
.
Download autenticati dal browser
I download autenticati dal browser utilizzano l'autenticazione basata sui cookie. L'autenticazione basata sui cookie
chiede agli utenti di accedere al proprio account utente per stabilire la propria
identità. L'account specificato deve disporre dell'autorizzazione appropriata per scaricare l'oggetto. Ad esempio, se utilizzi Identity and Access Management per controllare l'accesso ai tuoi
oggetti, l'account dell'utente deve disporre dell'autorizzazione storage.objects.viewer
,
che viene concessa nel ruolo Visualizzatore oggetti Storage.
Per scaricare un oggetto utilizzando l'autenticazione basata sui cookie, utilizza il seguente URL,
sostituendo BUCKET_NAME
e
OBJECT_NAME
con i valori appropriati:
https://storage.cloud.google.com/BUCKET_NAME/OBJECT_NAME
Ad esempio, se hai condiviso un'immagine london.jpg
dal tuo bucket
example-maps
, l'URL sarà:
https://storage.cloud.google.com/example-maps/london.jpg
Dopo aver eseguito l'accesso, viene visualizzato il contenuto richiesto. L'URL
di questi contenuti inizia con una sequenza alfanumerica e contiene la
stringa /download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME
L'utilizzo di HTTPS è obbligatorio quando si eseguono download autenticati del browser; i tentativi di utilizzo del reindirizzamento HTTP a HTTPS.
Accesso agli oggetti pubblici
Tutte le richieste all'URI storage.cloud.google.com
richiedono l'autenticazione. Ciò
vale anche quando allUsers
ha l'autorizzazione per accedere a un oggetto. Se vuoi che gli utenti scarichino oggetti accessibili in modo anonimo senza autenticarsi, utilizza l'endpoint in stile percorso dell'API XML:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Per dettagli ed esempi, vedi Accesso ai dati pubblici.
Supporto di mutual TLS
TLS reciproco (mTLS) è un protocollo standard di settore per l'autenticazione reciproca tra un client e un server. Cloud Storage supporta i seguenti endpoint mTLS reciproca:Richieste API JSON:
storage.mtls.s3nsapis.fr
Download autenticati del browser:
storage.mtls.cloud.google.com
Passaggi successivi
- Carica un file su Cloud Storage.
- Scarica un file da Cloud Storage.
- Ospita un sito web statico.
- Scopri le opzioni per controllare l'accesso ai tuoi dati.