Extremos regionales

En esta página, se describe cómo usar extremos regionales para acceder a los recursos en Cloud Storage. El uso de extremos regionales te permite ejecutar tus cargas de trabajo de una manera que cumpla con los requisitos de residencia de datos y soberanía de datos, en los que el tráfico de solicitudes se enruta directamente a la región especificada en la extremo.

Descripción general

Los extremos regionales son extremos de solicitud que solo permiten que las solicitudes continúen si el recurso afectado existe en la ubicación especificada por el extremo. Por ejemplo, cuando usas el extremo https://storage.me-central2.rep.googleapis.com en una solicitud de eliminación de buckets, la solicitud solo continúa si el bucket se encuentra en ME-CENTRAL2.

A diferencia de los extremos globales, en los que las solicitudes se pueden procesar en una ubicación diferente desde donde reside el recurso, los extremos regionales garantizan que tus solicitudes solo se procesen dentro de la ubicación que especifica el extremo, donde reside el recurso. Los extremos regionales finalizan las sesiones de TLS en la ubicación que especifica el extremo para las solicitudes recibidas de Internet, otros recursos de Google Cloud (como las máquinas virtuales de Compute Engine), los servicios locales mediante la VPN o la interconexión, y nubes privadas virtuales (VPC).

Los extremos regionales garantizan la residencia de los datos, ya que garantizan que los datos en reposo y en tránsito de tu objeto no se quiten de la ubicación especificada por el extremo. Esta garantía excluye los metadatos de recursos, como los nombres de objetos y las políticas de IAM de los buckets. Para obtener más información, consulta Nota sobre los datos del servicio.

Ubicaciones admitidas

Puedes usar extremos regionales para mantener tus datos dentro de las siguientes ubicaciones:

Malama, Arabia Saudita (región ME-CENTRAL2)

Operaciones admitidas

Los extremos regionales solo se pueden usar para realizar operaciones que accedan o muten recursos dentro de la ubicación que especifica el extremo. Los extremos regionales no se pueden usar para realizar operaciones que accedan o muten recursos fuera de la ubicación que especifica el extremo.

Por ejemplo, cuando usas el extremo regional https://storage.me-central2.rep.googleapis.com, puedes leer objetos en buckets ubicados en ME-CENTRAL2 y copiar un objeto de un bucket de origen a un bucket de destino solo cuando ambos buckets se encuentran en ME-CENTRAL2. Si intentas leer o copiar un objeto fuera de ME-CENTRAL2, se mostrará un error.

Los extremos regionales se pueden usar para realizar operaciones de informes de inventario, objetos y buckets compatibles, siempre que las operaciones se realicen en recursos almacenados en la ubicación que especifica el extremo.

Para obtener una lista completa de las operaciones compatibles con Cloud Storage, expande la sección Operaciones admitidas:

Operaciones admitidas

Operaciones de objetos
- Crear objetos
- Componer objetos
- Copiar objetos¹
- Borrar objetos
- Obtener metadatos de objetos²
- Enumerar objetos
- Aplicar parches a objetos
- Reescribir objetos¹
- Actualizar objetos
Operaciones con buckets:
- Crear buckets
- Borrar buckets
- Obtener metadatos de bucket²
- Enumerar buckets
- Bloquear las políticas de retención de buckets
- Aplicar parches a buckets
- Actualizar buckets
Operaciones en las políticas de IAM
- Obtener políticas de IAM del bucket ²
- Actualizar políticas de IAM del bucket ²
- Probar políticas de IAM del bucket ²
Operaciones en LCAs
- Crear LCAs de objetos²
- Crear LCAs de objeto predeterminadas para un bucket ²
- Borrar LCAs de objetos²
- Borrar LCAs de objeto predeterminadas de un bucket²
- Obtener LCAs de objetos²
- Obtener LCAs de objeto predeterminadas de un bucket²
- Enumerar LCAs de objetos²
- Enumerar LCAs de objeto predeterminadas de un bucket²
- Aplicar parches de LCAs de objeto²
- Aplicar parches de LCAs de objeto predeterminadas para un bucket²
- Actualizar LCAs de objeto²
- Actualizar LCAs de objeto predeterminadas de un bucket²
Operaciones de Storage Insights
- Crea configuraciones de informes de inventario
- Borra configuraciones de informes de inventario
- Obtén informes de inventario
- Obtén configuraciones de informes de inventario
- Enumera informes de inventario
- Enumera configuraciones de informes de inventario
- Aplicar parches a las configuraciones de informes de inventario

¹Esta operación solo se realiza de forma correcta si los buckets de origen y destino se encuentran en la ubicación que especificó el extremo.

² Esta operación accede a los metadatos o los muta. No se garantiza el cumplimiento de los requisitos de soberanía y residencia de datos para esta operación.

Limitaciones y restricciones

Los extremos regionales no se pueden usar para realizar las siguientes operaciones:

Operaciones que acceden o mutan recursos fuera de la ubicación que especifica el extremo
Copiar o reescribir recursos de una ubicación a otra
Operaciones de claves HMAC
Operaciones de la cuenta de servicio
Operaciones de notificación de Pub/Sub

Operaciones de notificación de cambio de objeto

Operaciones por lotes de JSON

Ten en cuenta las siguientes restricciones cuando uses extremos regionales:

No puedes conectarte a extremos regionales mediante la TLS mutua (mTLS).
Los extremos regionales solo admiten HTTPS. HTTP no es compatible.
Los extremos regionales no admiten subdominios de buckets en la API de XML.

Herramientas para usar extremos regionales

Consola

Para usar extremos regionales para acceder a los recursos de Cloud Storage, usa las URLs jurisdiccionales de la consola de Google Cloud:

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

Línea de comandos

Si deseas configurar Google Cloud CLI para usarla con extremos regionales, completa los siguientes pasos:

Asegúrate de usar la versión 402.0.0 de Google Cloud CLI o una más reciente.
Configura la propiedad api_endpoint_overrides/storage en el extremo regional que deseas usar:
```
gcloud config set api_endpoint_overrides/storage https://storage.LOCATION.rep.googleapis.com/
```
Como alternativa, puedes establecer la variable de entorno CLOUDSDK_API_ENDPOINT_OVERRIDES_STORAGE como el extremo:
```
CLOUDSDK_API_ENDPOINT_OVERRIDES_STORAGE=https://storage.LOCATION.rep.googleapis.com/ gcloud ls gs://my-bucket
```

API de REST

API de JSON

Cuando realices solicitudes a extremos regionales, usa los URI siguientes:

Para las solicitudes generales a la API de JSON, sin incluir las cargas de objetos, usa el siguiente extremo y reemplaza LOCATION por una ubicación de bucket compatible:
```
https://storage.LOCATION.rep.googleapis.com
```
Por ejemplo, el siguiente extremo se usa para crear un bucket en la región ME-CENTRAL2:
```
https://storage.me-central2.rep.googleapis.com
```
Para cargas de objeto de la API de JSON, usa el extremo siguiente:
```
https://storage.LOCATION.rep.googleapis.com/upload/storage/v1/b/BUCKET_NAME/o
```
Reemplaza lo siguiente:
- LOCATION por una ubicación de bucket compatible.
- BUCKET_NAME por el nombre del bucket en el que deseas subir un objeto.
Por ejemplo, el siguiente extremo se usa para subir un objeto a un bucket en la región ME-CENTRAL2:
```
https://storage.me-central2.rep.googleapis.com/upload/storage/v1/b/my-example-bucket/o
```
Para descargas de objetos de la API de JSON, usa el extremo siguiente:
```
https://storage.LOCATION.rep.googleapis.com/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
```
Reemplaza lo siguiente:
- LOCATION por una ubicación de bucket compatible.
- BUCKET_NAME por el nombre del bucket que contiene el objeto que deseas descargar.
- OBJECT_NAME por el nombre del objeto que deseas descargar.

API de XML

Cuando realices solicitudes a extremos regionales, usa el siguiente extremo de estilo de ruta de acceso:

https://storage.LOCATION.rep.googleapis.com/BUCKET_NAME

Reemplaza lo siguiente:

LOCATION por una ubicación de bucket compatible.
BUCKET_NAME por el nombre de un bucket

Por ejemplo, la siguiente muestra se puede usar para subir un objeto a un bucket en la región ME-CENTRAL2:

https://storage.me-central2.rep.googleapis.com/my-example-bucket