Usar endpoints regionais

Os endpoints regionais do Cloud Scheduler permitem manter o tráfego da API em uma única região doGoogle Cloud para ajudar a atender aos requisitos de residência de dados e soberania de dados. Quando você envia uma solicitação para um endpoint regional, o término de TLS ocorre, e o Cloud Scheduler processa a solicitação inteiramente dentro da região especificada.

Os endpoints regionais do Cloud Scheduler têm o formato https://cloudscheduler.REGION.rep.googleapis.com, em que REGION é uma região com disponibilidade, por exemplo, https://cloudscheduler.us-central1.rep.googleapis.com.

Para informações sobre como usar o Private Service Connect para acessar os endpoints regionais do Cloud Scheduler de maneira particular em uma rede de nuvem privada virtual (VPC), consulte Sobre o acesso a APIs do Google regionais e multirregionais por endpoints.

Limitações e restrições

As limitações e restrições a seguir se aplicam quando você usa endpoints regionais do Cloud Scheduler.

  • Um endpoint regional atende apenas aos recursos da própria região. O local no nome do recurso precisa corresponder à região do endpoint. Por exemplo, é possível enviar solicitações de recursos em projects/PROJECT_ID/locations/us-central1 para cloudscheduler.us-central1.rep.googleapis.com. As solicitações de recursos em outras regiões falham.
  • Os endpoints regionais se aplicam às solicitações enviadas à API Cloud Scheduler. Eles não mudam como o Cloud Scheduler envia solicitações para os destinos do job. Se os jobs forem executados em um perímetro do VPC Service Controls, consulte os requisitos para destinos de jobs em Proteger jobs cron com o VPC Service Controls.

Enviar solicitações para um endpoint regional

É possível enviar solicitações para um endpoint regional usando a Google Cloud CLI, a API REST ou as bibliotecas de cliente do Cloud Scheduler.

gcloud

Defina a propriedade api_endpoint_overrides/cloudscheduler como o endpoint regional e execute os comandos gcloud scheduler para recursos nessa região:

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

Substitua REGION por uma região que ofereça endpoints regionais, por exemplo, us-central1.

Para usar o endpoint global padrão novamente, remova a propriedade:

gcloud config unset api_endpoint_overrides/cloudscheduler

REST

Use o endpoint regional como o host do URL de solicitação. Por exemplo, o comando a seguir lista os jobs em uma região:

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

Substitua:

  • REGION: uma região que oferece endpoints regionais, por exemplo, us-central1.
  • PROJECT_ID: o ID do projeto Google Cloud .

Bibliotecas de cliente

Defina o endpoint de API ao criar o cliente. Os exemplos a seguir criam um 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"
  )
)

A seguir