יצירה ועדכון של תוויות לפרויקטים

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

התוויות חלות על פרויקטים בלבד. אי אפשר להוסיף תוויות לתיקיות ולמשאבים של הארגון, ותוויות שאתם מוסיפים לפרויקט לא מועברות באופן אוטומטי למשאבים הצאצאים. כדי להוסיף או לעדכן תוויות במשאבי שירות ספציפיים, כמו מכונות של Compute Engine או קטגוריות של Cloud Storage, קראו את המאמר שירותים שתומכים בתוויות או את המאמרים בנושא המשאבים. לדוגמה, Pub/Sub תומך בתוויות לחיוב על תפוקה של נושאים ומינויים, אבל מק"טים של חיוב על תעבורת נתונים יוצאת לא תומכים בתוויות.

יצירת תוויות לפרויקטים

המסוף

כדי להוסיף תוויות לפרויקט אחד:

1. פותחים את הדף Labels במסוף Google Cloud .

   פתיחת הדף "תוויות"

2. בוחרים את הפרויקט מהתפריט הנפתח Select a project.

3. כדי להוסיף רשומת תווית חדשה, לוחצים על ‎+ Add label ומזינים מפתח וערך לכל תווית שרוצים להוסיף.

4. כשמסיימים להוסיף תוויות, לוחצים על שמירה.

כדי להוסיף תוויות לכמה פרויקטים בו-זמנית:

1. פותחים את הדף Manage resources במסוף Google Cloud .

   פתיחת הדף Manage resources

2. בדף Manage resources, בוחרים את הפרויקטים שרוצים להוסיף להם תוויות.

3. בחלונית המידע, בכרטיסייה Labels, לוחצים על ‎+ Add label ומזינים מפתח וערך לכל תווית שרוצים להוסיף.

4. כשמסיימים להוסיף תוויות, לוחצים על שמירה.

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

gcloud

כדי ליצור פרויקט חדש עם תוויות באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud projects create עם הדגל --labels:

gcloud projects create PROJECT_ID \
    --labels=KEY1=VALUE1,KEY2=VALUE2

כדי להוסיף תוויות לפרויקט קיים, משתמשים בפקודה gcloud projects update עם הדגל --update-labels:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

כאשר:

• ‫PROJECT_ID הוא המזהה של הפרויקט שרוצים ליצור או לעדכן.
• ‫KEY1=VALUE1 הוא צמד מפתח/ערך של התווית שרוצים להוסיף.

REST

כדי ליצור פרויקט חדש עם תווית, צריך לכלול את השדה labels כששולחים בקשת POST ל-method‏ projects.create:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "PROJECT_ID",
    "displayName": "PROJECT_NAME",
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects"

כדי להוסיף תוויות לפרויקט קיים, משתמשים ב-method‏ projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "environment": "development"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

עדכון תוויות של פרויקטים

המסוף

כדי לעדכן תוויות בפרויקט אחד:

1. פותחים את הדף Labels במסוף Google Cloud .

   פתיחת הדף "תוויות"

2. בוחרים את הפרויקט מהתפריט הנפתח Select a project.

3. מעדכנים את התוויות של הפרויקט:

   1. כדי לערוך תווית, לוחצים על הערך שרוצים לערוך ומבצעים את השינויים הרצויים.
   2. כדי למחוק תווית, מעבירים את העכבר מעל המפתח או הערך ולוחצים על .

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

כדי לעדכן תוויות של כמה פרויקטים בו-זמנית:

1. פותחים את הדף Manage resources במסוף Google Cloud .

   פתיחת הדף Manage resources

2. בדף Manage resources, בוחרים את הפרויקטים שרוצים לעדכן את התוויות שלהם.

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

   1. כדי לערוך תווית, לוחצים על הערך שרוצים לערוך ומבצעים את השינויים הרצויים.
   2. כדי למחוק תווית, מעבירים את העכבר מעל המפתח או הערך ולוחצים על .

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

gcloud

כדי לעדכן תוויות של פרויקט באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud projects update עם הדגל --update-labels,‏ --remove-labels או --clear-labels.

כדי להוסיף או לעדכן תוויות:

gcloud projects update PROJECT_ID \
    --update-labels=KEY1=VALUE1,KEY2=VALUE2

כדי להסיר תוויות ספציפיות:

gcloud projects update PROJECT_ID \
    --remove-labels=KEY1,KEY2

כדי להסיר את כל התוויות מפרויקט:

gcloud projects update PROJECT_ID \
    --clear-labels

REST

כדי לעדכן את התוויות של פרויקט באמצעות ה-API, שולחים בקשת PATCH ל-method‏ projects.patch:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "color": "red"
    }
  }' \
  "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"

כאשר PROJECT_ID הוא מזהה הפרויקט שרוצים לעדכן.