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 solicitudes a la API de JSON generales, sin incluir cargas de objetos, usa el extremo siguiente y reemplaza [VALUES_IN_BRACKETS] con los valores correctos:

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

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

    https://www.googleapis.com/batch/storage/v1/[PATH_TO_RESOURCE]

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

API de XML

  • Para todas las solicitudes de la API de XML, puedes usar cualquiera de los extremos siguientes y reemplazar [VALUES_IN_BRACKETS] con los valores correctos:

    https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]
    https://[BUCKET_NAME].storage.googleapis.com/[OBJECT_NAME]

De manera opcional para cargas y descargas, Cloud Storage ofrece extremos de la API de XML dedicados. Estos extremos de carga y descarga proporcionan un beneficio de rendimiento pequeño cuando se transfieren grandes cantidades de datos.

  • Para las cargas, puedes usar cualquiera de los extremos siguientes si reemplazas [VALUES_IN_BRACKETS] con los valores correctos:

    https://storage-upload.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]
    https://[BUCKET_NAME].storage-upload.googleapis.com/[OBJECT_NAME]
  • Para descargas, puedes usar cualquiera de los extremos siguientes si reemplazas [VALUES_IN_BRACKETS] con los valores correctos:

    https://storage-download.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]
    https://[BUCKET_NAME].storage-download.googleapis.com/[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 un HTTP o un HTTPS. Se recomienda usar un HTTPS, en especial si realizas una autenticación en Cloud Storage con OAuth 2.0.

Para obtener más información sobre conexiones a través de un proxy, consulta el Tema solución de problemas para consultar las recomendaciones.

Redireccionamiento CNAME

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

c.storage.googleapis.com.

Por ejemplo, digamos que tu dominio es example.com y quieres que los mapas de viajes 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 DNS que redireccione solicitudes de travel-maps.example.com al URI de Cloud Storage. Para lograrlo, publica el registro CNAME siguiente 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 de 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 permisos correctos 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] con los valores correctos:

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

Por ejemplo, si compartes una imagen london.jpg de tu depósito example-maps, la URL debe ser:

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

Recomendamos usar HTTPS cuando se realizan descargas de navegador autenticadas, sin embargo, HTTP también es compatible. Para obtener más información sobre descargas de navegador autenticadas, consulta Autenticación basada en cookies.

Acceso a objetos públicos

Todas las solicitudes al URI storage.cloud.google.com requieren autenticación. Eso también se aplica cuando allUsers tienen permiso para acceder a un objeto. Si quieres que los usuarios descarguen objetos accesibles de manera anónima sin autenticación, usa el URI storage.googleapis.com documentado en Solicitudes directas de la API. Para obtener más detalles y ejemplos, consulta Accede a datos públicos.

Pasos siguientes

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.