הצגת רשימה של כל מאגרי הסכימות

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

אפשר להציג רשימה של מאגרי הסכימות בפרויקט. במאמר הזה מוסבר איך להציג רשימה של מאגרי סכימות באמצעותGoogle Cloud המסוף, Google Cloud CLI או Managed Kafka API.

תפקידים והרשאות נדרשים

כדי לקבל את ההרשאות שנדרשות להצגת רשימת מאגרי הסכימות, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) בפרויקט ובמיקום שלכם. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות להצגת רשימת מאגרי סכימות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי להציג רשימה של מאגרי סכימות, נדרשות ההרשאות הבאות:

• נותנים את ההרשאה הבאה במיקום ההורה: managedkafka.schemaRegistries.list

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

רשימת מרשמי הסכימות

כדי להציג ברשימה את כל מאגרי הסכימות בפרויקט:

המסוף

1. נכנסים לדף Schema registries במסוף Google Cloud .

   מעבר למרשמי סכימות

   בדף מוצגת רשימה של מאגרי סכימות בפרויקט. הרשימה כוללת עמודות עם המאפיינים הבאים:

   • ‫Name: המזהה הייחודי של מאגר הסכימות.
   • ‫Region: Google Cloud האזור שבו מתארח מאגר הסכימות.

gcloud

1. התקינו את ה-CLI של Google Cloud. אחר כך, מאתחלים את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

   gcloud init

   אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

2. מריצים את הפקודה gcloud beta managed-kafka schema-registries list:

gcloud beta managed-kafka schema-registries list \
    --location=LOCATION \

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

• ‫LOCATION (נדרש): האזור Google Cloud שעבורו רוצים להציג את רשימת המאגרים של סכימות.

לדוגמה, כדי להציג את כל מאגרי הסכימות במיקום us-central1, מריצים את הפקודה הבאה:

gcloud beta managed-kafka schema-registries list --location=us-central1

פלט לדוגמה:

NAME             LOCATION
sr_docs      us-central1
sr_docs23    us-central1
sr23wert     us-central1

REST

כדי לראות את רשימת מאגרי הסכימות, משתמשים בשיטה projects.locations.schemaRegistries.list.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

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

ה-method של ה-HTTP וכתובת ה-URL:

GET https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "schemaRegistries": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID",
      "contexts": [
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/.",
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/CONTEXT_NAME"
      ]
    }
}

אובייקט ה-JSON שמוחזר כולל רשימה של מאגרי סכימות שנמצאו במיקום שצוין. אם פרמטר השאילתה view הוא SCHEMA_REGISTRY_VIEW_FULL, התשובה כוללת גם את ההקשרים שמשויכים לכל מאגר סכימות.

‫Apache Kafka®‎ הוא סימן מסחרי רשום של The Apache Software Foundation או של השותפים העצמאיים שלה בארצות הברית או במדינות אחרות.