ביצוע קריאה לספק סוגים בהגדרה

בדף הזה מוסבר איך להשתמש בספק סוגים שיצרתם באמצעות Deployment Manager. הוא לא מתאר איך ליצור ספק סוגים. כאן מוסבר איך ליצור ספק סוגים.

לפני שמתחילים

  • אם רוצים להשתמש בדוגמאות לשורת הפקודה במדריך הזה, צריך להתקין את כלי שורת הפקודה`gcloud`.
  • כדי להשתמש בדוגמאות ל-API במדריך הזה, צריך להגדיר גישה ל-API.

גישה לספקי סוגים

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

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

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

שימוש בספק סוגים

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

type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]

  • אם ה-API הזה מגובה על ידי מפרט OpenAPI, ‏ [COLLECTION] יהיה מזהה REST לנתיב למשאב. לדוגמה:

    type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people

  • אם ה-API מגובה על ידי מסמך Discovery של Google, ‏[COLLECTION] הוא נתיב המשאבים שמוביל למשאב הרצוי ב-API. לדוגמה, כדי ליצור מפתח לחשבון שירות, האוסף יהיה:

    type: my-project/example-type-provider:projects.serviceAccounts.keys

עכשיו ממשיכים להגדיר את הסוג לפי הדרישות של ה-API הבסיסי:

resources:
- name: Jane
  type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
  properties:
  - displayName: Jane
    email: jane@example.com
    ...

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