Usa extremos regionales

Los extremos regionales de Cloud Scheduler te permiten mantener el tráfico de la API dentro de una sola región deGoogle Cloud para ayudar a cumplir con los requisitos de residencia de datos y soberanía de los datos. Cuando envías una solicitud a un extremo regional, TLS finaliza y Cloud Scheduler procesa la solicitud por completo dentro de la región especificada.

Los extremos regionales de Cloud Scheduler tienen el formato https://cloudscheduler.REGION.rep.googleapis.com, en el que REGION es una región admitida, por ejemplo, https://cloudscheduler.us-central1.rep.googleapis.com.

Para obtener información sobre cómo usar Private Service Connect para acceder a los extremos regionales de Cloud Scheduler de forma privada desde una red de nube privada virtual (VPC), consulta Información sobre el acceso a las APIs de Google regionales y multirregionales a través de extremos.

Limitaciones y restricciones

Se aplican las siguientes limitaciones y restricciones cuando usas los extremos regionales de Cloud Scheduler.

  • Un extremo regional solo entrega los recursos de su propia región. La ubicación en el nombre del recurso debe coincidir con la región del extremo. Por ejemplo, puedes enviar solicitudes de recursos en projects/PROJECT_ID/locations/us-central1 a cloudscheduler.us-central1.rep.googleapis.com. Las solicitudes de recursos en otras regiones fallan.
  • Los extremos regionales se aplican a las solicitudes enviadas a la API de Cloud Scheduler. No cambian la forma en que Cloud Scheduler envía solicitudes a los destinos de tu trabajo. Si tus trabajos se ejecutan en un perímetro de Controles del servicio de VPC, consulta los requisitos para los destinos de trabajos en Protege los trabajos cron con Controles del servicio de VPC.

Envía solicitudes a un extremo regional

Puedes enviar solicitudes a un extremo regional con Google Cloud CLI, la API de REST o las bibliotecas cliente de Cloud Scheduler.

gcloud

Configura la propiedad api_endpoint_overrides/cloudscheduler en el extremo regional y, luego, ejecuta los comandos gcloud scheduler para los recursos de esa región:

gcloud config set api_endpoint_overrides/cloudscheduler \
    https://cloudscheduler.REGION.rep.googleapis.com/
gcloud scheduler jobs list --location=REGION

Reemplaza REGION por una región que ofrezca extremos regionales, por ejemplo, us-central1.

Para volver a usar el extremo global predeterminado, anula la configuración de la propiedad:

gcloud config unset api_endpoint_overrides/cloudscheduler

REST

Usa el extremo regional como el host de la URL de la solicitud. Por ejemplo, con el siguiente comando, se enumeran los trabajos de una región:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://cloudscheduler.REGION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/jobs"

Reemplaza lo siguiente:

  • REGION: Es una región que ofrece extremos regionales, por ejemplo, us-central1.
  • PROJECT_ID: Es el ID del proyecto de Google Cloud .

Bibliotecas cliente

Establece el extremo de API cuando crees el cliente. En los siguientes ejemplos, se crea un cliente para us-central1:

Go

import (
scheduler "cloud.google.com/go/scheduler/apiv1"
"google.golang.org/api/option"
)

client, err := scheduler.NewCloudSchedulerClient(ctx,
option.WithEndpoint("cloudscheduler.us-central1.rep.googleapis.com:443"))

Java 

import com.google.cloud.scheduler.v1.CloudSchedulerClient;
import com.google.cloud.scheduler.v1.CloudSchedulerSettings;

CloudSchedulerSettings settings =
  CloudSchedulerSettings.newBuilder()
      .setEndpoint("cloudscheduler.us-central1.rep.googleapis.com:443")
      .build();
try (CloudSchedulerClient client = CloudSchedulerClient.create(settings)) {
// Send requests for resources in us-central1.
}

Python 

from google.api_core.client_options import ClientOptions
from google.cloud import scheduler_v1

client = scheduler_v1.CloudSchedulerClient(
  client_options=ClientOptions(
      api_endpoint="cloudscheduler.us-central1.rep.googleapis.com"
  )
)

¿Qué sigue?