‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

המסוף

נכנסים לדף Welcome במסוף Google Cloud .
לדף Welcome
בכלי לבחירת פרויקטים שבחלק העליון של הדף, בוחרים את הפרויקט.

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

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

gcloud

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

gcloud projects describe PROJECT_ID

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

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

מחליפים את PROJECT_ID במזהה הפרויקט שרוצים לראות.

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

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

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם 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

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם 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 projects search.

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

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

אפשר לסנן את החיפוש באמצעות הדגל --query ב-CLI של 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:

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

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="
        }
      ]
}

הסבר על חותמת הזמן של הגישה האחרונה

בעמודה Last accessed בדף Manage resources במסוף Google Cloud , מוצג המועד האחרון שבו נכנסתם לדף של משאב במסוף Google Cloud . חותמת הזמן Last accessed מתנהגת באופן הבא:

פעילות ספציפית למשתמש: חותמת הזמן עוקבת אחרי הפעילות בחשבון הספציפי שלכם במסוף Google Cloud , כך שמשתמשים שונים רואים תאריכים שונים לאותו משאב. אם לא ניגשתם למשאב במסוףGoogle Cloud , בעמודה יופיע קו מפריד (—).
עדכונים במסוף בלבד: כשנכנסים לדף של פרויקט ב- Google Cloud , חותמת הזמן מתעדכנת גם אם לא משנים את המשאבים הבסיסיים. גישה לפרויקט או למשאבים שלו דרך Google Cloud CLI, ספריות לקוח או ממשקי API בארכיטקטורת REST לא מעדכנת את חותמת הזמן של הגישה האחרונה.
תיקיות וארגונים: במשאב של תיקייה או ארגון, בעמודה מוצגת חותמת הזמן של הגישה האחרונה במשאב ובצאצאים הפעילים שלו.
משאבים בהמתנה למחיקה: בפרויקט שנמצא במצב מחזור החיים DELETE_REQUESTED, בעמודה מוצג זמן השינוי האחרון של הפרויקט. תיקיות וארגונים ברמה גבוהה יותר בהיררכיה לא כוללים משאבים שממתינים למחיקה בחותמות הזמן של Last accessed.
תצוגה במסוף בלבד: במסוף Google Cloud מאוחסנת חותמת הזמן של הגישה האחרונה לתצוגה בלבד, ואי אפשר לאחזר אותה באמצעות Cloud Resource Manager API או Google Cloud CLI. החותמת הזמן הזו שונה מהשדה updateTime במשאבים של פרויקטים, תיקיות וארגונים, שבו מתועד השינוי האחרון במטא-נתונים של המשאב.

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

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

המסוף

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

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

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

gcloud

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

הפעלת Cloud Shell

בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
כדי לעדכן את השם או התוויות של הפרויקט, משתמשים בפקודה 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"
      }
    }
  ]
}

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

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

המסוף

gcloud

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

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

REST

curl

PowerShell

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

REST

curl

PowerShell

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

המסוף

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

REST

curl

PowerShell

הסבר על חותמת הזמן של הגישה האחרונה

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

המסוף

gcloud

REST

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

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