Regionale Endpunkte verwenden

Mit regionalen Cloud Scheduler-Endpunkten können Sie den API-Traffic innerhalb einer einzelnenGoogle Cloud -Region halten, um die Anforderungen an den Datenstandort und die Datenhoheit zu erfüllen. Wenn Sie eine Anfrage an einen regionalen Endpunkt senden, wird die TLS-Terminierung durchgeführt und Cloud Scheduler verarbeitet die Anfrage vollständig innerhalb der angegebenen Region.

Regionale Cloud Scheduler-Endpunkte haben das Format https://cloudscheduler.REGION.rep.googleapis.com, wobei REGION eine unterstützte Region ist, z. B. https://cloudscheduler.us-central1.rep.googleapis.com.

Informationen zum Verwenden von Private Service Connect für den privaten Zugriff auf regionale Cloud Scheduler-Endpunkte innerhalb eines VPC-Netzwerks (Virtual Private Cloud) finden Sie unter Über Endpunkte auf regionale und multiregionale Google APIs zugreifen.

Limits und Einschränkungen

Für die Verwendung regionaler Cloud Scheduler-Endpunkte gelten die folgenden Einschränkungen.

  • Ein regionaler Endpunkt stellt nur die Ressourcen in seiner eigenen Region bereit. Der Standort im Ressourcennamen muss mit der Region des Endpunkts übereinstimmen. Sie können beispielsweise Anfragen für Ressourcen in projects/PROJECT_ID/locations/us-central1 an cloudscheduler.us-central1.rep.googleapis.com senden. Anfragen für Ressourcen in anderen Regionen schlagen fehl.
  • Regionale Endpunkte gelten für Anfragen, die an die Cloud Scheduler API gesendet werden. Sie ändern nicht, wie Cloud Scheduler Anfragen an Ihre Jobziele sendet. Wenn Ihre Jobs in einem VPC Service Controls-Perimeter ausgeführt werden, finden Sie die Anforderungen für Jobziele unter Cronjobs mit VPC Service Controls sichern.

Anfragen an einen regionalen Endpunkt senden

Sie können Anfragen an einen regionalen Endpunkt über die Google Cloud CLI, die REST API oder die Cloud Scheduler-Clientbibliotheken senden.

gcloud

Legen Sie das Attribut api_endpoint_overrides/cloudscheduler auf den regionalen Endpunkt fest und führen Sie dann gcloud scheduler-Befehle für Ressourcen in dieser Region aus:

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

Ersetzen Sie REGION durch eine Region, die regionale Endpunkte bietet, z. B. us-central1.

Wenn Sie wieder den globalen Standardendpunkt verwenden möchten, heben Sie die Festlegung des Attributs auf:

gcloud config unset api_endpoint_overrides/cloudscheduler

REST

Verwenden Sie den regionalen Endpunkt als Host der Anfrage-URL. Mit dem folgenden Befehl werden beispielsweise die Jobs in einer Region aufgelistet:

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

Ersetzen Sie Folgendes:

  • REGION: eine Region, die regionale Endpunkte bietet, z. B. us-central1.
  • PROJECT_ID: Projekt-ID in Google Cloud .

Clientbibliotheken

Legen Sie den API-Endpunkt fest, wenn Sie den Client erstellen. In den folgenden Beispielen wird ein Client für us-central1 erstellt:

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

Nächste Schritte