Endpoint di richiesta

Questa pagina spiega 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.googleapis.com/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.googleapis.com/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.googleapis.com/batch/storage/v1/PATH_TO_RESOURCE

  • Se vuoi, per i download di oggetti API JSON, puoi utilizzare il seguente endpoint, sostituendo BUCKET_NAME e OBJECT_NAME con i valori appropriati:

    https://storage.googleapis.com/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.googleapis.com/OBJECT_NAME

  • Endpoint in stile percorso: 

    https://storage.googleapis.com/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 a Cloud Storage utilizzando OAuth 2.0.

gRPC

Puoi utilizzare gRPC, un framework RPC universale open source ad alte prestazioni sviluppato da Google, per interagire con Cloud Storage. I client gRPC si connettono a un endpoint di servizio. Per serviziGoogle Cloud come Cloud Storage, in genere si tratta di un indirizzo DNS sul dominio googleapis.com (ad esempio storage.googleapis.com) e utilizza porte sicure standard come 443. L'utilizzo di gRPC può migliorare le prestazioni e le funzionalità di streaming efficienti.

Per utilizzare gRPC per interagire con Cloud Storage, devi abilitarlo nelle librerie client di Cloud.

Abilita gRPC in una libreria client utilizzando uno dei seguenti linguaggi supportati:

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:

!, #, $, &, ', (, ), *, +,