ניהול תגים

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

מידע על התגים

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

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

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

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

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

• Tag Viewer (roles/resourcemanager.tagViewer) במשאבים שהתגים מצורפים אליהם
• צפייה בתגים וניהול שלהם ברמת הארגון: Organization Viewer (roles/resourcemanager.organizationViewer) בארגון
• יצירה, עדכון ומחיקה של הגדרות תגים: Tag Administrator (roles/resourcemanager.tagAdmin) במשאב שבו יוצרים, מעדכנים או מוחקים תגים
• הוספה והסרה של תגים ממשאבים: משתמש בתגים (roles/resourcemanager.tagUser) בערך התג ובמשאבים שאתם מוסיפים להם את ערך התג או מסירים מהם את ערך התג

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

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

כדי לצרף תגים למשאבים של Datastream, צריך את התפקיד אדמין Datastream‏ (roles/datastream.admin) או תפקיד אחר שכולל את ההרשאות הבאות:

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

• datastream.connectionProfiles.createTagBinding
• datastream.connectionProfiles.deleteTagBinding
• datastream.connectionProfiles.listTagBindings
• datastream.connectionProfiles.listEffectiveTags
• datastream.streams.createTagBinding
• datastream.streams.deleteTagBinding
• datastream.streams.listTagBindings
• datastream.streams.listEffectiveTags
• datastream.privateConnections.createTagBinding
• datastream.privateConnections.deleteTagBinding
• datastream.privateConnections.listTagBindings
• datastream.privateConnections.listEffectiveTags

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

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

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

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

המסוף

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

כניסה ל-Datastream

2. בוחרים את הדף של המשאב שרוצים להוסיף לו תג. לדוגמה, כדי לצרף תג לפרופיל חיבור, נכנסים לדף Connection profiles.
3. ‫לוחצים על Tags (תגים).
4. אם הארגון לא מופיע בחלונית Tags, לוחצים על Select scope. בוחרים את הארגון ולוחצים על Open.
5. לוחצים על הוספת תג.
6. בוחרים מהרשימה את המפתח של התג שרוצים לצרף. אפשר לסנן את הרשימה על ידי הקלדת מילות מפתח.
7. בוחרים מהרשימה את הערך של התג שרוצים לצרף. אפשר לסנן את הרשימה על ידי הקלדת מילות מפתח.
8. לוחצים על Save.
9. בתיבת הדו-שיח Confirm, לוחצים על Confirm כדי לצרף את התג.

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

gcloud

כדי לצרף תג לסטרימינג, לפרופיל חיבור או לחיבור פרטי, צריך ליצור משאב של קישור תגים באמצעות הפקודה 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 כדי לזהות את סוג המשאב (//datastream.googleapis.com/). לדוגמה, כדי לצרף תג ל-projects/PROJECT_NAME/streams/STREAM_NAME, המזהה המלא הוא: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
• ‫LOCATION: המיקום של המשאב. אם אתם מצרפים תג למשאב גלובלי, כמו תיקייה או פרויקט, אל תשתמשו בדגל הזה. אם אתם מצרפים תג למשאב אזורי או למשאב של תחום מוגדר, אתם צריכים לציין את המיקום – לדוגמה, us-central1 (אזור) או us-central1-a (תחום מוגדר).

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

אתם יכולים לראות רשימה של קישורי תגים שמצורפים ישירות לחיבור הפרטי, לפרופיל החיבור או ל-stream, או שהם ירשו אותם.

המסוף

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

כניסה ל-Datastream

2. בוחרים את הדף של המשאב שרוצים לראות את התגים שלו. לדוגמה, כדי לראות את התגים של פרופיל החיבור, נכנסים לדף Connection profiles.

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

gcloud

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

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

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

• ‫RESOURCE_ID הוא המזהה המלא של המשאב, כולל שם הדומיין של ה-API כדי לזהות את סוג המשאב (//datastream.googleapis.com/). לדוגמה, כדי לצרף תג ל-projects/PROJECT_NAME/streams/STREAM_NAME, המזהה המלא הוא: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
• ‫LOCATION: המיקום של המשאב. אם אתם צופים בתג שמצורף למשאב גלובלי, כמו תיקייה או פרויקט, השמיטו את הדגל הזה. אם אתם צופים בתג שמצורף למשאב אזורי או למשאב של תחום מוגדר, אתם צריכים לציין את המיקום – לדוגמה, us-central1 (אזור) או us-central1-a (תחום מוגדר).

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

name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
          tagValue: tagValues/567890123456
          resource: //datastream.googleapis.com/projects/project-abc/streams/stream-xyz<
      

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

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

המסוף

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

כניסה ל-Datastream

2. בוחרים את הדף של המשאב שממנו רוצים להסיר תג. לדוגמה, כדי להסיר תג מפרופיל חיבור, נכנסים לדף Connection profiles.
3. ‫לוחצים על Tags (תגים).
4. בחלונית Tags, ליד התג שרוצים לנתק, לוחצים על Delete item.
5. לוחצים על Save.
6. בתיבת הדו-שיח Confirm, לוחצים על Confirm כדי לנתק את התג.

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

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 כדי לזהות את סוג המשאב (//datastream.googleapis.com/). לדוגמה, כדי לצרף תג ל-projects/PROJECT_NAME/streams/STREAM_NAME, המזהה המלא הוא: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
• ‫LOCATION: המיקום של המשאב. אם אתם מצרפים תג למשאב גלובלי, כמו תיקייה או פרויקט, אל תשתמשו בדגל הזה. אם אתם מצרפים תג למשאב אזורי או למשאב של תחום מוגדר, אתם צריכים לציין את המיקום – לדוגמה, us-central1 (אזור) או us-central1-a (תחום מוגדר).

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

כשמסירים הגדרה של מפתח או ערך של תג, חשוב לוודא שהתג מנותק מה-stream, מפרופיל החיבור או מהחיבור הפרטי. כדי למחוק את הגדרת התג, קודם צריך למחוק את התגים שמצורפים למשאבים (שנקראים "קישורי תגים"). כדי למחוק מפתחות וערכים של תגים, קראו את המאמר מחיקת תגים.

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

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

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

• שירותים אחרים שתומכים בתגים
• במאמר תגים ובקרת גישה מוסבר איך משתמשים בתגים עם IAM.