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

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

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

המסוף

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

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

    פתיחת הדף Labels

  2. בתפריט הנפתח Select a project (בחירת פרויקט), בוחרים את הפרויקט הרצוי.

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

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

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

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

    כניסה לדף Manage resources

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

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

  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 לשיטה 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"

כדי להוסיף תוויות לפרויקט קיים, משתמשים בשיטה 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 .

    פתיחת הדף Labels

  2. בתפריט הנפתח Select a project (בחירת פרויקט), בוחרים את הפרויקט הרצוי.

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

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

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

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

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

    כניסה לדף Manage resources

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

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

    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 למתודה 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 הוא מזהה הפרויקט שרוצים לעדכן.