Solicita extremos

En esta página, se explican los diferentes extremos de solicitud (URI) que puedes usar para acceder a Cloud Storage.

Solicitudes a la API típicas

Cuando realizas solicitudes directamente a una de las API de Cloud Storage, usa los URI siguientes:

API de JSON

  • Para las solicitudes a la API de JSON generales, sin incluir las cargas de objetos, usa el siguiente extremo y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

    https://storage.googleapis.com/storage/v1/[PATH_TO_RESOURCE]
  • Para cargas de objetos con la API de JSON, usa el extremo siguiente y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

    https://storage.googleapis.com/upload/storage/v1/b/[BUCKET_NAME]/o
  • Para las solicitudes por lotes, usa el siguiente extremo y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

    https://storage.googleapis.com/batch/storage/v1/[PATH_TO_RESOURCE]
  • De manera opcional, para las descargas de objetos de la API de JSON, puedes usar el siguiente extremo y reemplazar [VALUES_IN_BRACKETS] por los valores adecuados:

    https://storage.googleapis.com/download/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]?alt=media

Los extremos de la API de JSON solo aceptan solicitudes HTTPS.

API de XML

  • Para las solicitudes a la API de XML típicas, puedes usar los extremos de estilo de alojamiento virtual o de estilo de ruta de acceso y reemplazar [VALUES_IN_BRACKETS] por los valores adecuados siguientes:

    Estilo de alojamiento virtual:

    https://[BUCKET_NAME].storage.googleapis.com/[OBJECT_NAME]
    Estilo de ruta de acceso:
    https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]

De manera opcional para las cargas y descargas, en Cloud Storage se ofrecen extremos de API de XML dedicados. Con estos extremos de carga y descarga, se puede obtener un pequeño beneficio de rendimiento cuando se transfieren grandes cantidades de datos.

  • Para las cargas, puedes usar los extremos de estilo de alojamiento virtual o de estilo de ruta de acceso y reemplazar [VALUES_IN_BRACKETS] por los valores adecuados siguientes:

    Estilo de alojamiento virtual:

    https://[BUCKET_NAME].storage-upload.googleapis.com/[OBJECT_NAME]
    Estilo de ruta de acceso:
    https://storage-upload.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]

  • En el caso de las descargas, puedes usar los extremos de estilo de alojamiento virtual o de estilo de ruta de acceso y reemplazar [VALUES_IN_BRACKETS] por los valores adecuados siguientes:

    Estilo de alojamiento virtual:

    https://[BUCKET_NAME].storage-download.googleapis.com/[OBJECT_NAME]
    Estilo de ruta de acceso:
    https://storage-download.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]

Todos los extremos de la API de XML son compatibles con la encriptación de la capa de conexión segura (SSL), lo que significa que puedes usar HTTP o HTTPS. Se recomienda usar HTTPS, en especial si realizas la autenticación en Cloud Storage con OAuth 2.0.

Para obtener más información sobre conexiones a través de un proxy, consulta las prácticas recomendadas en Solución de problemas.

Codifica partes de la ruta de acceso del URI

Además de las consideraciones generales para la definición de nombres de depósitos y de objetos, a fin de garantizar la compatibilidad entre las herramientas de Cloud Storage, debes codificar los siguientes caracteres cuando aparezcan en el nombre del objeto o en la string de consulta del URI de una solicitud:

!, #, $, &, ', (, ), *, +, ,, /, :, ;, =, ?, @, [, ] y caracteres de espacio.

Por ejemplo, si envías una solicitud GET para la API de JSON correspondiente al objeto llamado foo??bar en el depósito example-bucket, tu URI de solicitud debe ser el siguiente:

GET https://storage.googleapis.com/storage/v1/b/example-bucket/o/foo%3f%3fbar

Ten en cuenta que no todos los caracteres enumerados deben estar codificados en todos los casos: por ejemplo, el carácter / debe estar codificado solo cuando se reescriba o se copie con la API de JSON y solo para el objeto de origen en dicha reescritura o copia.

Si deseas obtener más información sobre el uso de la codificación en porcentajes para los URI, consulta la sección 3.3 Ruta de acceso en la RFC 3986. Ten en cuenta que, por lo general, el control de la codificación se lleva a cabo en las bibliotecas cliente, como las bibliotecas cliente de Cloud Storage, para que puedas pasarles el nombre del objeto sin procesar.

Extremos de Cloud Console

Cuando usas Cloud Console, puedes acceder a diferentes recursos medianre las siguientes URL:

Recurso URL
Lista de depósitos para un proyecto https://console.cloud.google.com/storage/browser?project=[PROJECT_ID]
Lista de objetos para un depósito https://console.cloud.google.com/storage/browser/[BUCKET_NAME]
Detalles de un objeto https://console.cloud.google.com/storage/browser/_details/[BUCKET_NAME]/[OBJECT_NAME]

Redireccionamientos CNAME

Un redireccionamiento de CNAME es un registro DNS especial que te permite usar URI de tu propio dominio a fin de acceder a recursos en Cloud Storage a través de la API de XML sin revelar los URI reales de la API. Para hacerlo, se debe agregar el siguiente URI a la parte del nombre del host de tu registro CNAME:

c.storage.googleapis.com.

Por ejemplo, supongamos que tu dominio es example.com y que deseas que los mapas de viaje estén disponibles para tus clientes. Puedes crear un depósito en Cloud Storage llamado travel-maps.example.com y, luego, crear un registro CNAME en el DNS que redireccione las solicitudes de travel-maps.example.com al URI de Cloud Storage. Para hacerlo, publica el siguiente registro CNAME en DNS:

NAME                      TYPE     DATA
travel-maps.example.com   CNAME    c.storage.googleapis.com.

Cuando hagas esto, tus clientes podrán usar la URL siguiente para acceder a un mapa de París:

http://travel-maps.example.com/paris.jpg

El servicio de registro de tu dominio debe contar con una forma para que administres tu dominio, incluido un registro de recurso CNAME. Por ejemplo, si usas Google Domains, las instrucciones para agregar un registro de recurso se pueden encontrar en la página de ayuda de Google Domains, en la sección desplegable Registros de recursos.

Descargas autenticadas del navegador

Las descargas autenticadas del navegador usan una autenticación basada en cookies. La autenticación basada en cookies les pide a los usuarios que accedan a su Cuenta de Google para establecer su identidad. La Cuenta de Google especificada debe tener los permisos adecuados para acceder al recurso, otorgados a través de las políticas de IAM o las listas de control de acceso, a fin de realizar la descarga en el navegador.

Para descargar un objeto con la autenticación basada en cookies, usa la URL siguiente y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

https://storage.cloud.google.com/[BUCKET_NAME]/[OBJECT_NAME]

Por ejemplo, si compartiste una imagen london.jpg de tu depósito example-maps, la URL sería la siguiente:

https://storage.cloud.google.com/example-maps/london.jpg

Se requiere el uso de HTTPS cuando se realizan descargas autenticadas del navegador; los intentos de usar HTTP redireccionan a HTTPS. Para obtener más información sobre las descargas autenticadas del navegador, consulta la autenticación basada en cookies.

Acceso a objetos públicos

Todas las solicitudes al URI storage.cloud.google.com requieren autenticación. Esto se aplica incluso cuando allUsers tiene permiso para acceder a un objeto. Si quieres que los usuarios descarguen objetos accesibles de forma anónima sin necesidad de autenticarse, usa el URI storage.googleapis.com documentado en Solicitudes a la API típicas. Para obtener más detalles y ejemplos, consulta Accede a datos públicos.

Próximos pasos