Menggunakan endpoint regional

Endpoint regional Cloud Scheduler memungkinkan Anda menyimpan traffic API dalam satu regionGoogle Cloud untuk membantu memenuhi persyaratan residensi data dan kedaulatan data. Saat Anda mengirim permintaan ke endpoint regional, TLS akan dihentikan, dan Cloud Scheduler akan memproses permintaan sepenuhnya dalam region yang ditentukan.

Endpoint regional Cloud Scheduler memiliki format https://cloudscheduler.REGION.rep.googleapis.com dengan REGION adalah wilayah yang didukung—misalnya, https://cloudscheduler.us-central1.rep.googleapis.com.

Untuk mengetahui informasi tentang cara menggunakan Private Service Connect untuk mengakses endpoint regional Cloud Scheduler secara pribadi dari dalam jaringan Virtual Private Cloud (VPC), lihat Tentang mengakses Google API regional dan multi-regional melalui endpoint.

Pembatasan dan batasan

Batasan dan pembatasan berikut berlaku saat Anda menggunakan endpoint regional Cloud Scheduler.

  • Endpoint regional hanya melayani resource di region-nya sendiri. Lokasi dalam nama resource harus cocok dengan region endpoint. Misalnya, Anda dapat mengirim permintaan untuk resource di projects/PROJECT_ID/locations/us-central1 ke cloudscheduler.us-central1.rep.googleapis.com. Permintaan untuk resource di region lain akan gagal.
  • Endpoint regional berlaku untuk permintaan yang dikirim ke Cloud Scheduler API. Zona waktu ini tidak mengubah cara Cloud Scheduler mengirim permintaan ke target tugas Anda. Jika tugas Anda berjalan di perimeter Kontrol Layanan VPC, lihat persyaratan untuk target tugas di Mengamankan cron job dengan Kontrol Layanan VPC.

Mengirim permintaan ke endpoint regional

Anda dapat mengirim permintaan ke endpoint regional menggunakan Google Cloud CLI, REST API, atau library klien Cloud Scheduler.

gcloud

Tetapkan properti api_endpoint_overrides/cloudscheduler ke endpoint regional, lalu jalankan perintah gcloud scheduler untuk resource di region tersebut:

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

Ganti REGION dengan region yang menawarkan endpoint regional—misalnya, us-central1.

Untuk menggunakan endpoint global default lagi, batalkan penetapan properti:

gcloud config unset api_endpoint_overrides/cloudscheduler

REST

Gunakan endpoint regional sebagai host URL permintaan. Misalnya, perintah berikut mencantumkan tugas di suatu region:

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

Ganti kode berikut:

  • REGION: region yang menawarkan endpoint regional—misalnya, us-central1.
  • PROJECT_ID: Project ID Google Cloud Anda.

Library klien

Tetapkan endpoint API saat Anda membuat klien. Contoh berikut membuat klien untuk 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"
  )
)

Langkah berikutnya