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

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

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

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

המסוף

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

    מעבר לדף Welcome

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

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

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

כדי לקבל את המטא-נתונים המפורטים של פרויקט ספציפי 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"
}

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

כדי למצוא פרויקטים שתואמים לקריטריונים ספציפיים, כמו קידומת של שם לתצוגה או מצב ספציפי של מחזור חיים, משתמשים בשיטה 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.

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. כדי לשנות את שם הפרויקט, עורכים את שם הפרויקט ולוחצים על שמירה.
  6. כדי להוסיף או לערוך תגים, עוברים לקטע Tags (תגים) בדף ולוחצים על Manage tags (ניהול תגים). מידע על הוספה או עדכון של מפתחות וערכים של תגים זמין במאמר יצירה וניהול של תגים.
  7. כדי לשנות תוויות, לוחצים על תוויות בסרגל הניווט הימני.

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

gcloud

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

    הפעלת 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"
      }
    }
  ]
}

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