יצירה וניהול של תגים למשאבים ב-Certificate Manager

במדריך הזה מוסבר איך ליצור ולנהל תגים במשאבים של Certificate Manager. ב-Certificate Manager נעשה שימוש במשאבים הבאים שתומכים בתגי מנהל המשאבים:

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

מידע על התגים

תג הוא צמד מפתח/ערך שאפשר לצרף למשאב ב-Google Cloud. אתם יכולים להשתמש בתגים כדי להגדיר תנאי לאישור או לדחייה של כללי מדיניות אם תג ספציפי מצורף או לא מצורף למשאב. לדוגמה, אתם יכולים להתנות את מתן התפקידים ב-IAM בהתאם לתגים. לסקירה כללית על התגים

כדי לצרף תגים למשאבים, יוצרים משאב של קישור תגים שמקשר את הערך ל Google Cloud משאב.

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

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

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

  • ‫Tag Viewer (roles/resourcemanager.tagViewer) במשאבים שהתגים מצורפים אליהם
  • כדי להציג ולנהל תגים ברמת הארגון: צפייה בארגון (roles/resourcemanager.organizationViewer) באותו ארגון
  • יצירה, עדכון ומחיקה של הגדרות תגים: Tag Administrator (roles/resourcemanager.tagAdmin) on the resource you're creating, updating, or deleting tags for
  • צירוף והסרה של תגים ממשאבים: Tag User (roles/resourcemanager.tagUser) on the tag value and the resources that you are attaching or removing the tag value to

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

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

כדי לצרף תגים למשאבים ב-Certificate Manager, צריך את התפקיד 'עריכה' ב-Certificate Manager (roles/certificatemanager.editor).

יצירת מפתחות וערכים של תגים

כדי לצרף תג, צריך ליצור תג ולהגדיר את הערך שלו. במאמרים יצירת תג והוספת ערך תג מוסבר איך יוצרים מפתחות וערכים של תגים.

הוספת תגים במהלך יצירת משאבים

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

gcloud

כדי להוסיף תגים במהלך יצירת משאב, משתמשים בפקודה gcloud certificate-manager certificates create.

gcloud certificate-manager certificates create CERT_NAME \
    --domains=DOMAIN \
    --project=PROJECT_ID \
    --tags=TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2

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

  • ‫CERT_NAME: שם האישור.
  • ‫DOMAIN: השם של דומיין היעד.
  • ‫PROJECT_ID: המזהה של Google Cloud פרויקט היעד.
  • ‫TAGKEY1 ו-TAGKEY2: המפתחות של התגים לצירוף לאישור.
  • ‫TAGVALUE1 ו-TAGVALUE2: הערכים של התגים לצירוף לאישור.

    כדי לציין כמה תגים, מפרידים ביניהם באמצעות פסיק, לדוגמה, TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2

הוספת תגים למשאבים קיימים

כדי להוסיף תג למשאבים קיימים ב-Certificate Manager:

gcloud

כדי לצרף תג למשאב של Certificate Manager, צריך ליצור משאב של קישור תגים באמצעות הפקודה gcloud resource-manager tags bindings create:

      gcloud resource-manager tags bindings create \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION

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

  • ‫TAGVALUE_NAME: המזהה הקבוע או השם ממרחב השמות של ערך התג שמצרפים למשאב – לדוגמה, tagValues/567890123456.
  • ‫RESOURCE_ID הוא המזהה המלא של המשאב, כולל שם הדומיין של ה-API, כדי לזהות את סוג המשאב (//certificatemanager.googleapis.com/). לדוגמה, כדי לצרף תג ל-projects/PROJECT_ID/locations/global/trustConfigs/TRUST_CONFIG_ID, המזהה המלא הוא //certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/trustConfigs/TRUST_CONFIG_ID.
  • ‫LOCATION: המיקום של המשאב. אם מצרפים תג למשאב גלובלי, כמו תיקייה או פרויקט, לא צריך להשתמש בדגל הזה. אם מצרפים תג למשאב אזורי או למשאב של תחום מוגדר, צריך לציין את המיקום – לדוגמה, us-central1 (אזור) או us-central1-a (תחום).

הצגת רשימת תגים שמצורפים למשאבים

אפשר לראות רשימה של קישורי תגים שמצורפים ישירות למשאב Certificate Manager או שהוא קיבל בירושה.

gcloud

כדי לקבל רשימה של התאמות תגים שצורפו למשאב, משתמשים בפקודה gcloud resource-manager tags bindings list:

      gcloud resource-manager tags bindings list \
          --parent=RESOURCE_ID \
          --location=LOCATION

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

  • ‫RESOURCE_ID הוא המזהה המלא של המשאב, כולל שם הדומיין של ה-API, כדי לזהות את סוג המשאב (//certificatemanager.googleapis.com/). לדוגמה, כדי לצרף תג ל-projects/PROJECT_ID/locations/global/trustConfigs/TRUST_CONFIG_ID, המזהה המלא הוא //certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/trustConfigs/TRUST_CONFIG_ID.
  • ‫LOCATION: המיקום של המשאב. אם אתם צופים בתג שמצורף למשאב גלובלי, כמו תיקייה או פרויקט, אל תכללו את הדגל הזה. אם צופים בתג שמצורף למשאב אזורי או למשאב של תחום זמינות, צריך לציין את המיקום – לדוגמה, us-central1 (אזור) או us-central1-a (תחום זמינות).

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

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //certificatemanager.googleapis.com/projects/123/trustConfigs?trust_config_id=demo-trust-config

ניתוק תגים ממשאבים

אפשר לנתק תגים שצורפו ישירות למשאב של Certificate Manager. אפשר לדרוס תגים שעברו בירושה על ידי צירוף תג עם אותו מפתח וערך שונה, אבל אי אפשר לנתק אותם.

gcloud

כדי למחוק קישור תג, משתמשים בפקודה gcloud resource-manager tags bindings delete:

      gcloud resource-manager tags bindings delete \
          --tag-value=TAGVALUE_NAME \
          --parent=RESOURCE_ID \
          --location=LOCATION

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

  • ‫TAGVALUE_NAME: המזהה הקבוע או השם ממרחב השמות של ערך התג שמצורף – לדוגמה, tagValues/567890123456.
  • ‫RESOURCE_ID הוא המזהה המלא של המשאב, כולל שם הדומיין של ה-API, כדי לזהות את סוג המשאב (//certificatemanager.googleapis.com/). לדוגמה, כדי לצרף תג ל-projects/PROJECT_ID/locations/global/trustConfigs/TRUST_CONFIG_ID, המזהה המלא הוא //certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/trustConfigs/TRUST_CONFIG_ID.
  • ‫LOCATION: המיקום של המשאב. אם מצרפים תג למשאב גלובלי, כמו תיקייה או פרויקט, לא צריך להשתמש בדגל הזה. אם מצרפים תג למשאב אזורי או למשאב של תחום מוגדר, צריך לציין את המיקום – לדוגמה, us-central1 (אזור) או us-central1-a (תחום).

מחיקת מפתחות וערכים של תגים

כשמסירים הגדרה של מפתח או ערך של תג, צריך לוודא שהתג מנותק מהמשאב של Certificate Manager. לפני שמוחקים את הגדרת התג עצמה, צריך למחוק את הקבצים הקיימים של התגים, שנקראים tag bindings. הוראות למחיקת מפתחות תגים וערכי תגים מופיעות במאמר מחיקת תגים.

תנאים ותגים בניהול הזהויות והרשאות הגישה (IAM)

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

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