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

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

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

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

gcloud projects describe PROJECT_ID

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

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

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

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

gcloud projects describe PROJECT_ID

gcloud projects describe PROJECT_ID

gcloud projects describe PROJECT_ID

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

{}

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"

$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

{
    "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 ומציינים את משאב האב בשאילתה:

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

{
    "parent": "folders/662951040570"
}

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"

$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

{
    "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 alpha projects search --query="name:z*"

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

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

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