שימוש בנקודות קצה אזוריות

נקודות קצה אזוריות של Cloud Scheduler מאפשרות לשמור את תנועת הנתונים של ה-API בGoogle Cloud אזור אחד, כדי לעמוד בדרישות שנוגעות למיקום אחסון הנתונים ולריבונות הנתונים. כששולחים בקשה לנקודת קצה אזורית, סיום TLS מתבצע ו-Cloud Scheduler מעבד את הבקשה באופן מלא באזור שצוין.

נקודות הקצה האזוריות של Cloud Scheduler הן בפורמט https://cloudscheduler.REGION.rep.googleapis.com, כאשר REGION הוא אזור נתמך, לדוגמה https://cloudscheduler.us-central1.rep.googleapis.com.

במאמר מידע על גישה ל-Google APIs אזוריים ורב-אזוריים דרך נקודות קצה מוסבר איך משתמשים ב-Private Service Connect כדי לגשת באופן פרטי לנקודות קצה אזוריות של Cloud Scheduler מתוך רשת של ענן וירטואלי פרטי (VPC).

מגבלות והגבלות

כשמשתמשים בנקודות קצה אזוריות של Cloud Scheduler, חלות המגבלות וההגבלות הבאות.

• נקודת קצה אזורית משרתת רק את המשאבים באזור שלה. המיקום בשם המשאב חייב להתאים לאזור של נקודת הקצה. לדוגמה, אתם יכולים לשלוח בקשות למשאבים ב-projects/PROJECT_ID/locations/us-central1 אל cloudscheduler.us-central1.rep.googleapis.com. בקשות למשאבים באזורים אחרים נכשלות.
• נקודות קצה אזוריות חלות על בקשות שנשלחות ל-Cloud Scheduler API. הם לא משנים את האופן שבו Cloud Scheduler שולח בקשות ליעדי המשימות. אם המשימות פועלות בהיקף של VPC Service Controls, קראו את הדרישות ליעדי משימות במאמר אבטחת משימות cron באמצעות VPC Service Controls.

שליחת בקשות לנקודת קצה אזורית

אתם יכולים לשלוח בקשות לנקודת קצה אזורית באמצעות Google Cloud CLI, ה-API בארכיטקטורת REST או ספריות הלקוח של Cloud Scheduler.

gcloud

מגדירים את המאפיין api_endpoint_overrides/cloudscheduler לנקודת הקצה האזורית, ואז מריצים את הפקודות של gcloud scheduler למשאבים באותו אזור:

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

מחליפים את REGION באזור שמציע נקודות קצה אזוריות, לדוגמה us-central1.

כדי להשתמש שוב בנקודת הקצה הגלובלית שמוגדרת כברירת מחדל, מבטלים את ההגדרה של המאפיין:

gcloud config unset api_endpoint_overrides/cloudscheduler

REST

משתמשים בנקודת הקצה האזורית כמארח של כתובת ה-URL לבקשה. לדוגמה, הפקודה הבאה מציגה את המשימות באזור:

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

מחליפים את מה שכתוב בשדות הבאים:

• ‫REGION: אזור שמציע נקודות קצה אזוריות, לדוגמה us-central1.
• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

ספריות לקוח

מגדירים את נקודת הקצה ל-API כשיוצרים את הלקוח. בדוגמאות הבאות נוצר לקוח ל-us-central1:

המשך

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

המאמרים הבאים

• מיקומים של Cloud Scheduler
• גישה לממשקי Google API אזוריים ובמספר אזורים דרך נקודות קצה