הצגת רשימת נושאים

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

במאמר הזה מוסבר איך להציג רשימה של נושאים באמצעותGoogle Cloud המסוף או Managed Kafka API.

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

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

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

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

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

  • נותנים את ההרשאה הבאה במאגר הסכמות או בהקשר של ההורה: managedkafka.googleapis.com/subjects.list

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

הצגת רשימת הנושאים במרשם סכימות

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

המסוף

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

    כניסה לדף Schema registries

  2. לוחצים על השם של מאגר הסכימות שרוצים לראות את הפרטים שלו.

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

  4. אופציונלי: כדי לסנן את הנושאים שמוצגים, לוחצים על סינון. אפשר לסנן לפי המאפיינים הבאים:

    • שם
    • הקשר
    • מחיקה רכה (כן/לא)
  5. אופציונלי: כדי להציג או להסתיר עמודות, לוחצים על Column display options ובוחרים את העמודות שרוצים להציג או להסתיר.

REST

הבקשה צריכה להיות מאומתת באמצעות אסימון גישה בכותרת Authorization. כדי לקבל אסימון גישה ל-Application Default Credentials הנוכחיים: gcloud auth application-default print-access-token.

כדי להציג רשימה של נושאים ישירות מתחת למאגר סכימות, שולחים בקשת GET ל-URI הספציפי באמצעות השיטה projects.locations.schemaRegistries.schemas.subjects.list להקשר ברירת המחדל.

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects
Authorization: Bearer $(gcloud auth application-default print-access-token)

כדי להציג רשימה של נושאים בהקשר מסוים במאגר סכימות, שולחים בקשת GET ל-URI הספציפי באמצעות ה-method‏ projects.locations.schemaRegistries.contexts.schemas.subjects.list:

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/contexts/CONTEXT_ID/subjects?subjectPrefix=SUBJECT_PREFIX
Authorization: Bearer $(gcloud auth application-default print-access-token)

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

  • ‫PROJECT_ID (חובה): מזהה הפרויקט ב- Google Cloud.

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

  • ‫REGISTRY_ID (חובה): המזהה של מאגר הסכימות.

  • ‫CONTEXT_ID (אופציונלי): מזהה ההקשר (אם מפרטים נושאים בהקשר).

  • ‫SUBJECT_PREFIX (אופציונלי): ההקשר לסינון הנושאים, בפורמט :.{context}:. אם לא מציינים נושא, כל הנושאים במאגר מוחזרים. אם המדיניות מוגדרת למחרוזת ריקה, הנושאים מופיעים בהקשר שמוגדר כברירת מחדל.

אם הבקשה מצליחה, ה-API מחזיר קוד סטטוס 200 OK. גוף התגובה מכיל מערך JSON של שמות נושאים.

זוהי דוגמה לתגובה מוצלחת של נושאים במערך JSON עבור ההקשר שמוגדר כברירת מחדל:

[
  "orders-topic-key",
  "orders-topic-value",
  "user-profile-event"
]

נושאים בהקשרים שאינם ברירת מחדל מוחזרים בפורמט :.context:subject.

מידע נוסף מופיע במסמכי התיעוד של השיטה projects.locations.schemaRegistries.contexts.schemas.subjects/list.

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

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