Configura la localidad de los datos con extremos regionales

En esta página, se describen los extremos de servicio globales y regionales para el plano de control de Secure Source Manager.

Un extremo de servicio es una URL base que especifica la dirección de red de un servicio de API. El plano de control de Secure Source Manager tiene extremos globales y regionales.

• Extremo global: De forma predeterminada, Secure Source Manager envía solicitudes de API al extremo global, securesourcemanager.googleapis.com. Los extremos globales no garantizan que los datos en tránsito permanezcan en una ubicación específica y pueden recuperar datos de Secure Source Manager desde cualquier región admitida. Es posible que tus datos se procesen fuera de la región en la que se almacenan.

• Extremo regional: Es un extremo de servicio que aplica restricciones regionales y garantiza que los datos en tránsito permanezcan en una ubicación específica. Un extremo regional solo permite que las solicitudes continúen si el recurso afectado existe en la ubicación especificada por el extremo. Los extremos regionales usan el siguiente formato:

  securesourcemanager.LOCATION.rep.googleapis.com

  Para obtener una lista de las regiones compatibles, consulta Ubicaciones.

Considera usar extremos regionales en las siguientes situaciones:

• Almacenas datos en varias ubicaciones y deseas optimizar la latencia, la confiabilidad y la disponibilidad.

• Debes cumplir con las políticas o reglamentaciones de localidad de datos que exigen que proceses tus datos en la misma ubicación en la que se almacenan.

Comandos compatibles

Puedes usar extremos regionales para ejecutar comandos para instancias, ubicaciones y operaciones.

Especifica un extremo regional

gcloud

Puedes anular el extremo global con un extremo regional para los comandos de Secure Source Manager.

Asegúrate de usar la versión 402.0.0 de Google Cloud CLI o una más reciente.

Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:

• LOCATION: Es la región en la que se encuentra la instancia.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud config set api_endpoint_overrides/securesourcemanager https://securesourcemanager.LOCATION.rep.googleapis.com

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud config set api_endpoint_overrides/securesourcemanager https://securesourcemanager.LOCATION.rep.googleapis.com

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud config set api_endpoint_overrides/securesourcemanager https://securesourcemanager.LOCATION.rep.googleapis.com

REST

Usa el extremo regional en tus comandos en lugar del extremo global. Por ejemplo, el siguiente comando enumera los detalles de todos los repositorios en una región especificada para una instancia especificada.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• LOCATION: Es la región en la que se encuentra la instancia.
• INSTANCE_ID: El nombre de la instancia.
• PROJECT_ID: Es el ID del proyecto en el que se encuentra la instancia.

Método HTTP y URL:

GET https://securesourcemanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?instance_id=INSTANCE_ID

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?instance_id=INSTANCE_ID"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://securesourcemanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?instance_id=INSTANCE_ID" | Select-Object -Expand Content

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Terraform

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform. Para obtener más información, consulta la documentación de referencia del proveedor de Terraform.

Usa la anulación de la API para establecer el extremo regional.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

• LOCATION: Es la región en la que se encuentra la instancia.

provider "google" {
  secure_source_manager_custom_endpoint = "https://securesourcemanager.LOCATION.rep.googleapis.com/v1/"
}

Bibliotecas cliente

Consulta Bibliotecas cliente de Secure Source Manager para obtener instrucciones para instalar bibliotecas cliente y configurar la autenticación.

Cada biblioteca cliente proporciona una forma de anular el extremo predeterminado con un extremo regional.

• C++: Usa la struct EndpointOption. La documentación de la biblioteca cliente de Secure Source Manager incluye un ejemplo que anula el extremo predeterminado con el extremo de Acceso privado a Google, pero puedes usar el mismo enfoque para establecer un extremo regional como predeterminado.

• Go: Usa la opción del cliente endpoint. Consulta la sección Endpoint Override de la documentación de la biblioteca cliente de Go para obtener más información y un ejemplo.

• Python: Usa el parámetro api_endpoint de la clase ClientOptions para anular el extremo predeterminado con un extremo regional. Consulta la documentación de ClientOptions para obtener más información y ejemplos.

¿Qué sigue?

• Consulta las ubicaciones admitidas.