En esta página se explican los diferentes endpoints de solicitud que puede usar para acceder a Cloud Storage. Cloud Storage admite los protocolos HTTP/1.1, HTTP/2 y HTTP/3. Un endpoint es la ubicación donde se puede acceder a Cloud Storage, que se escribe como una URL.
Solicitudes típicas a la API
API JSON
Cuando hagas solicitudes a la API JSON directamente a Cloud Storage, utiliza los siguientes endpoints:
Para las solicitudes generales de la API JSON, excepto las subidas de objetos, utilice el siguiente endpoint y sustituya
PATH_TO_RESOURCE
por el valor adecuado:https://storage.s3nsapis.fr/storage/v1/PATH_TO_RESOURCE
Para subir objetos de la API JSON, usa el siguiente endpoint y sustituye
BUCKET_NAME
por el valor adecuado:https://storage.s3nsapis.fr/upload/storage/v1/b/BUCKET_NAME/o
En el caso de las solicitudes por lotes, usa el siguiente endpoint y sustituye
PATH_TO_RESOURCE
por el valor adecuado:https://storage.s3nsapis.fr/batch/storage/v1/PATH_TO_RESOURCE
Si quieres descargar objetos de la API JSON, puedes usar el siguiente endpoint (opcional), sustituyendo
BUCKET_NAME
yOBJECT_NAME
por los valores correspondientes:https://storage.s3nsapis.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
Los endpoints de la API JSON solo aceptan solicitudes HTTPS.
API XML
Cuando hagas solicitudes a la API XML directamente a Cloud Storage, usa el punto de conexión virtual hosted-style o path-style y sustituye BUCKET_NAME
y OBJECT_NAME
por los valores correspondientes:
Endpoint de estilo de alojamiento virtual:
https://BUCKET_NAME.storage.s3nsapis.fr/OBJECT_NAME
Endpoint de estilo de ruta:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Los endpoints de la API XML admiten el cifrado de capa de conexión segura (SSL), por lo que puede usar HTTP o HTTPS. Se recomienda usar HTTPS, sobre todo si te autenticas en Cloud Storage mediante OAuth 2.0.
Si las conexiones se realizan a través de un proxy, consulta el tema sobre solución de problemas para ver las prácticas recomendadas.
Codificar partes de la ruta de la URL
Además de las consideraciones generales sobre la asignación de nombres a los segmentos y a los objetos, para asegurar la compatibilidad entre las herramientas de Cloud Storage, debe codificar los siguientes caracteres cuando aparezcan en el nombre del objeto o en la cadena de consulta de una URL de solicitud:
!
, #
, $
, &
, '
, (
, )
, *
, +
, ,
, /
, :
, ;
, =
, ?
,
@
, [
, ]
y espacios.
Por ejemplo, si envías una solicitud de la API JSON GET
para el objeto llamado foo??bar
en el contenedor example-bucket
, la URL de la solicitud debe ser la siguiente:
GET https://storage.s3nsapis.fr/storage/v1/b/example-bucket/o/foo%3f%3fbar
Ten en cuenta que no todos los caracteres que se indican deben codificarse en todos los casos. Además, las bibliotecas de cliente, como las bibliotecas de cliente de Cloud Storage, suelen encargarse de la codificación, por lo que puedes transferir el nombre de objeto sin procesar cuando utilices estas herramientas.
Para obtener más información sobre el uso de la codificación de porcentaje, consulta la sección 3.3 Path de RFC 3986.
Endpoints de la consolaTrusted Cloud
Cuando usas la Trusted Cloud consola, accedes a diferentes recursos mediante las siguientes URLs:
Recurso | URL |
---|---|
Lista de tareas de un proyecto | https://console.cloud.s3nscloud.fr/storage/browser?project=PROJECT_ID |
Lista de objetos de un segmento | https://console.cloud.s3nscloud.fr/storage/browser/BUCKET_NAME |
Detalles de un objeto | https://console.cloud.s3nscloud.fr/storage/browser/_details/BUCKET_NAME/OBJECT_NAME |
Datos de un objeto | Consulta Descargas de exploradores autenticadas. |
gcloud endpoints
Los comandos gcloud storage
usan endpoints de la API JSON. La CLI de gcloud gestiona el uso de los endpoints en tu nombre.
Puntos finales de la biblioteca de cliente
Las bibliotecas de cliente de Cloud Storage gestionan los endpoints de solicitud automáticamente. También puedes definir el endpoint de la solicitud manualmente. Esto puede ser útil cuando quieras usar un endpoint específico o para hacer pruebas, como cuando quieras usar un emulador local:
C++
Para obtener más información, consulta la documentación de referencia de la API C++ de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
C#
Para obtener más información, consulta la documentación de referencia de la API C# de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
Go
Para obtener más información, consulta la documentación de referencia de la API Go de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
Java
Para obtener más información, consulta la documentación de referencia de la API Java de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
Node.js
Para obtener más información, consulta la documentación de referencia de la API Node.js de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
PHP
Para obtener más información, consulta la documentación de referencia de la API PHP de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
Python
Para obtener más información, consulta la documentación de referencia de la API Python de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
Ruby
Para obtener más información, consulta la documentación de referencia de la API Ruby de Cloud Storage.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Antes de ejecutar los ejemplos de código, asigna el valor s3nsapis.fr
a la variable de entorno GOOGLE_CLOUD_UNIVERSE_DOMAIN
.
Descargas en el navegador con autenticación
Las descargas en el navegador con autenticación usan la autenticación basada en cookies. La autenticación basada en cookies pide a los usuarios que inicien sesión en su cuenta de usuario para establecer su identidad. La cuenta especificada debe tener el permiso adecuado para descargar el objeto. Por ejemplo, si usas Identity and Access Management para controlar el acceso a tus objetos, la cuenta del usuario debe tener el permiso storage.objects.viewer
, que se concede en el rol Lector de objetos de Storage.
Para descargar un objeto mediante la autenticación basada en cookies, usa la siguiente URL y sustituye BUCKET_NAME
y OBJECT_NAME
por los valores correspondientes:
https://storage.cloud.google.com/BUCKET_NAME/OBJECT_NAME
Por ejemplo, si has compartido una imagen london.jpg
de tu contenedor
example-maps
, la URL sería la siguiente:
https://storage.cloud.google.com/example-maps/london.jpg
Una vez que hayas iniciado sesión correctamente, se te redirigirá al contenido solicitado. La URL de este contenido empieza por una secuencia alfanumérica y contiene la cadena /download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME
.
Es obligatorio usar HTTPS al realizar descargas autenticadas en el navegador. Se intenta usar la redirección HTTP a HTTPS.
Acceso a objetos públicos
Todas las solicitudes al URI storage.cloud.google.com
requieren autenticación. Esto se aplica incluso cuando allUsers
tienen permiso para acceder a un objeto. Si quiere que los usuarios descarguen objetos accesibles de forma anónima sin autenticarse, utilice el endpoint de estilo de ruta de la API XML:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Para obtener más información y ejemplos, consulta Acceder a datos públicos.
Compatibilidad con TLS mutuo
TLS mutuo (mTLS) es un protocolo estándar del sector para la autenticación mutua entre un cliente y un servidor. Cloud Storage admite los siguientes endpoints de mTLS:Solicitudes de la API JSON:
storage.mtls.s3nsapis.fr
Descargas de navegador autenticadas:
storage.mtls.cloud.google.com
Siguientes pasos
- Sube un archivo a Cloud Storage.
- Descargar un archivo de Cloud Storage.
- Alojar un sitio web estático.
- Consulta las opciones para controlar el acceso a tus datos.