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

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

איך מוצאים את השם, המספר והמזהה של הפרויקט

כדי לבצע פעולות במשאבים של Google Cloud , צריך לספק את פרטי הזיהוי של הפרויקט בכל בקשה. כל פרויקט מזוהה באמצעות מזהה הפרויקט ומספר הפרויקט.

המסוף

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

    לדף Welcome

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

    שם הפרויקט, מספר הפרויקט ומזהה הפרויקט מופיעים אחרי הכותרת Welcome.

gcloud

כדי למצוא את מספר הפרויקט, המזהה או השם, משתמשים בפקודה gcloud projects describe:

gcloud projects describe PROJECT_ID

כדי לאחזר רק את מספר הפרויקט כערך, משתמשים בדגל --format:

gcloud projects describe PROJECT_ID --format="value(projectNumber)"

איך מקבלים פרויקט קיים

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

כדי לגשת לפרטי הפרויקט, צריך להיות לכם סטטוס של Project Owner או הרשאות של תפקיד דפדפן (roles/browser).

gcloud

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud projects describe PROJECT_ID

‏Windows (PowerShell)

gcloud projects describe PROJECT_ID

Windows‏ (cmd.exe)

gcloud projects describe PROJECT_ID

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

ה-method של ה-HTTP וכתובת ה-URL: 

GET https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID

גוף בקשת JSON: 

{}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID" | Select-Object -Expand Content

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

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

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

כדי להציג את כל הפרויקטים שהם צאצאים ישירים של משאב, משתמשים ב-method ‏projects.list בגרסה 3 ומציינים את משאב ההורה בשאילתה:

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫FOLDER_ID: מזהה התיקייה Google Cloud

ה-method של ה-HTTP וכתובת ה-URL: 

GET https://cloudresourcemanager.googleapis.com/v3/projects

גוף בקשת JSON: 

{
    "parent": "folders/662951040570"
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects" | Select-Object -Expand Content

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

{
    "projectNumber": "464036093014",
    "projectId": "our-project-123",
    "lifecycleState": "ACTIVE",
    "name": "my project",
    "labels": {
        "mylabel": "prod"
    },
    "createTime": "2016-01-07T21:59:43.314Z"
}

חיפוש פרויקטים

כדי למצוא פרויקטים שתואמים לקריטריונים ספציפיים, כמו תחילית של שם המוצג או מצב ספציפי של מחזור חיים, משתמשים ב-method‏ projects.search או בפקודה gcloud alpha resource-manager projects search.

היקף החיפוש כולל את כל הפרויקטים שיש לכם בהם את ההרשאה resourcemanager.projects.get.

תחביר של שאילתות

אפשר לסנן את החיפוש באמצעות הדגל --query (gcloud) או הפרמטר query (API). מסנני החיפוש הנפוצים כוללים:

  • ‫displayName: השם הידידותי למשתמש של הפרויקט.
  • ‫state: מצב מחזור החיים של הפרויקט, לדוגמה, ACTIVE או DELETE_REQUESTED
  • ‫parent.type ו-parent.id: סינון התוצאות לפי ארגון או תיקייה ספציפיים.

הרשאות

אם מציינים הורה בשאילתה (לדוגמה, parent:folders/123), צריכות להיות לכם הרשאות resourcemanager.projects.list אצל ההורה הזה. אם יש לכם את ההרשאה הזו, כל הפרויקטים שמתחת להורה יוחזרו אחרי שהמסננים הנותרים יופעלו.

אם אין לכם את ההרשאה הזו, כל הפרויקטים שיש לכם בהם את ההרשאה resourcemanager.projects.get יוחזרו אחרי החלת שאר המסננים.

אם לא תציינו הורה, התוצאות יכללו את כל הפרויקטים שיש לכם בהם הרשאות resourcemanager.projects.get.

המסוף

אפשר לחפש פרויקטים בדף Manage resources:

  1. במסוף Google Cloud , נכנסים לדף Manage resources. מעבר לניהול משאבים
  2. בתיבה Filter, מזינים את המאפיין שלפיו רוצים לחפש, למשל name או ID.
  3. בוחרים את המאפיין מהרשימה הנפתחת ומזינים את הערך שרוצים לחפש.

gcloud

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud alpha projects search --query="name:z*"

‏Windows (PowerShell)

gcloud alpha projects search --query="name:z*"

Windows‏ (cmd.exe)

gcloud alpha projects search --query="name:z*"

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

The response contains the projects with names starting with 'z'

REST

ה-method של ה-HTTP וכתובת ה-URL: 

GET https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain

גוף בקשת JSON: 

{}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/projects:search?query=displayName%3ATokyo%2BRain" | Select-Object -Expand Content

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

{
      "projects": [
        {
          "name": "projects/951040570662",
          "parent": "folders/662951040570",
          "projectId": "tokyo-rain-123",
          "state": "ACTIVE",
          "displayName": "Tokyo Rain",
          "createTime": "2013-11-13T20:31:53.308Z",
          "updateTime": "2013-11-13T20:31:53.308Z",
          "etag": "BwWUlZ6XEfY="
        }
      ]
}

עדכון פרויקטים

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

המסוף

כדי לעדכן את השם או התוויות של פרויקט באמצעות מסוף Google Cloud :

  1. במסוף Google Cloud , נכנסים לדף Settings בקטע IAM & Admin.

    כניסה לדף IAM & Admin Settings

    שאר השלבים מופיעים במסוף Google Cloud .

  2. בחלק העליון של המסך, לוחצים על הרשימה הנפתחת לבחירת פרויקט.
  3. בחלון Select from שמופיע, לוחצים על הרשימה הנפתחת של הארגון ובוחרים את הארגון. אם אתם משתמשים בתקופת ניסיון בחינם, דלגו על השלב הזה כי רשימת הארגונים לא מופיעה.
  4. בוחרים את הפרויקט מהרשימה שמופיעה.
  5. כדי לשנות את שם הפרויקט, עורכים את Project name ולוחצים על Save.
  6. כדי להוסיף או לערוך תגים, עוברים לקטע תגים בדף ולוחצים על ניהול תגים. במאמר יצירה וניהול של תגים מוסבר איך מוסיפים או מעדכנים מפתחות וערכים של תגים.
  7. כדי לשנות תוויות, לוחצים על תוויות בתפריט הניווט הימני.

    מידע נוסף על שימוש בתוויות

gcloud

  1. מפעילים את Cloud Shell במסוף Google Cloud .

    הפעלת Cloud Shell

    בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

  2. כדי לעדכן את השם או התוויות של הפרויקט, משתמשים בפקודה gcloud alpha projects update:

    gcloud alpha projects update PROJECT_ID \
   --name=NAME \
   --update-labels=KEY=VALUE, ...

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

    • ‫PROJECT_ID: מזהה הפרויקט שרוצים לעדכן.
    • ‫NAME: השם החדש שרוצים להקצות לפרויקט.
    • ‫KEY: המפתח של התווית שרוצים לעדכן.
    • ‫VALUE: הערך של התווית שרוצים לעדכן.

    למידע נוסף ולדגלים נוספים שאפשר להשתמש בהם עם הפקודה הזו, קראו את המאמר Google Cloud CLI SDK.

REST

כדי לעדכן פרויקט:

  • מקבלים את האובייקט project באמצעות השיטה projects.get.

  • משנים את השדות שרוצים לעדכן.

  • מבצעים קריאה ל-method‏ projects.patch.

בדוגמה הבאה, השם המוצג של הפרויקט מתעדכן ל-myproject והתווית color מוגדרת ל-red:

בקשה:

PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NUMBER?updateMask=displayName,labels

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

תוכן בקשת JSON:

{
  "displayName": "myproject",
  "labels": {
    "color": "red"
  }
}

תשובה:

{
  "projects": [
    {
      "name": "projects/951054970012",
      "parent": "folders/662951040570",
      "projectId": "Osaka-rain-234",
      "state": "ACTIVE",
      "displayName": "myproject",
      "createTime": "2013-11-13T20:31:53.308Z",
      "updateTime": "2013-11-13T20:35:42.308Z",
      "etag": "BwWUlZ6XEfY=",
      "labels": {
        "color": "red"
      }
    }
  ]
}

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