Utilizza endpoint regionali

Gli endpoint regionali di Cloud Scheduler ti consentono di mantenere il traffico API all'interno di una singola regioneGoogle Cloud per soddisfare i requisiti di residenza dei datie sovranità dei dati. Quando invii una richiesta a un endpoint regionale, la terminazione TLS e Cloud Scheduler elaborano la richiesta interamente all'interno della regione specificata.

Gli endpoint regionali di Cloud Scheduler hanno il formato https://cloudscheduler.REGION.rep.googleapis.com, dove REGION è una regione supportata, ad esempio https://cloudscheduler.us-central1.rep.googleapis.com.

Per informazioni sull'utilizzo di Private Service Connect per accedere privatamente agli endpoint regionali di Cloud Scheduler dall'interno di una rete Virtual Private Cloud (VPC), consulta Informazioni sull'accesso alle API di Google regionali e multiregionali tramite endpoint.

Limitazioni e restrizioni

Quando utilizzi gli endpoint regionali di Cloud Scheduler, si applicano le seguenti limitazioni.

  • Un endpoint regionale gestisce solo le risorse nella propria regione. La località nel nome della risorsa deve corrispondere alla regione dell'endpoint. Ad esempio, puoi inviare richieste di risorse in projects/PROJECT_ID/locations/us-central1 a cloudscheduler.us-central1.rep.googleapis.com. Le richieste di risorse in altre regioni non vanno a buon fine.
  • Gli endpoint regionali si applicano alle richieste inviate all'API Cloud Scheduler. Non modificano il modo in cui Cloud Scheduler invia le richieste ai target dei job. Se i job vengono eseguiti in un perimetro dei Controlli di servizio VPC, consulta i requisiti per i target dei job in Proteggi i cron job con i Controlli di servizio VPC.

Invia richieste a un endpoint regionale

Puoi inviare richieste a un endpoint regionale utilizzando Google Cloud CLI, l'API REST o le librerie client di Cloud Scheduler.

gcloud

Imposta la proprietà api_endpoint_overrides/cloudscheduler sull'endpoint regionale, quindi esegui i comandi gcloud scheduler per le risorse in quella regione:

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

Sostituisci REGION con una regione che offre endpoint regionali, ad esempio us-central1.

Per utilizzare di nuovo l'endpoint globale predefinito, annulla l'impostazione della proprietà:

gcloud config unset api_endpoint_overrides/cloudscheduler

REST

Utilizza l'endpoint regionale come host dell'URL della richiesta. Ad esempio, il comando seguente elenca i job in una regione:

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

Sostituisci quanto segue:

  • REGION: una regione che offre endpoint regionali, ad esempio us-central1.
  • PROJECT_ID: il tuo ID progetto Google Cloud .

Librerie client

Imposta l'endpoint API quando crei il client. Gli esempi seguenti creano un client per us-central1:

Vai 

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"
  )
)

Passaggi successivi