הצגה, עדכון ומחיקה של תיקיות

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

הצגת רשימת תיקיות ופרטי תיקיות

כדי להציג רשימה של תיקיות או מטא-נתונים של תיקייה ספציפית, כמו השם לתצוגה, מזהה ההורה ומצב מחזור החיים, צריך לקבל את התפקיד 'צפייה בתיקייה' (roles/resourcemanager.folderViewer) או 'צפייה בארגון' (roles/resourcemanager.organizationViewer).

המסוף

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

    פתיחת הדף Manage resources

  2. רשימת המשאבים מציגה את ההיררכיה שלכם כטבלה. בוחרים את משאב הארגון.

  3. לוחצים על החץ לצד שם הארגון כדי להרחיב את תצוגת העץ ולראות את תיקיות המשנה שלו.

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

  5. משתמשים בסרגל Filter בחלק העליון של רשימת המשאבים כדי לחפש משאבים לפי שם, מזהה או תווית.

שימוש בכלי לבחירת פרויקטים

בעזרת בורר הפרויקטים שבסרגל הניווט העליון, אפשר להחליף את ההקשר הפעיל לפרויקט או לתיקייה ספציפיים.

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

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

  3. מעיינים בהיררכיה או מחפשים את הפרויקט או התיקייה שאליהם רוצים לעבור. כשלוחצים על משאב בכלי לבחירת משאבים, ההקשר הגלובלי משתנה ומשפיע על המשאבים שמוצגים בדפים אחרים של השירות (כמו Compute Engine או Cloud Storage).

gcloud

כדי לקבל פרטים על תיקייה מסוימת, משתמשים בפקודה resource-manager folders describe.

gcloud resource-manager folders describe FOLDER_ID

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

כדי להציג את רשימת תיקיות הצאצא של משאב ארגוני, משתמשים בפקודה resource-manager folders list.

gcloud resource-manager folders list \
    --organization ORGANIZATION_ID

מחליפים את ORGANIZATION_ID במזהה של משאב הארגון שרוצים לראות רשימה של תיקיות צאצא שלו.

כדי לראות את רשימת תיקיות הצאצא של משאב תיקייה, משתמשים בפקודה resource-manager folders list.

gcloud resource-manager folders list \
    --folder FOLDER_ID

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

כדי לפרסם את הפרויקטים במשאב ארגון או תיקייה, או בתיקייה, משתמשים בפקודה projects list עם הארגומנט filter.

gcloud projects list \
    --filter=" parent.id: 'RESOURCE_ID' "

מחליפים את RESOURCE_ID במזהה של הארגון או של משאב התיקייה שרוצים לראות רשימה של פרויקטים שמשויכים אליו.

REST

בקשת curl לקבלת תיקיות:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID

מחליפים את FOLDER_NAME בשם התיקייה, למשל folders/123.

בקשת curl לרשימת תיקיות:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME

מחליפים את PARENT_NAME בשם של משאב ההורה שמתחתיו אתם יוצרים את התיקייה, כמו organizations/123 או folders/123.

עדכון תיקיות

כדי לעדכן את השם המוצג של תיקייה, צריך להיות לכם תפקיד עריכה (roles/resourcemanager.folderEditor) או תפקיד Folder Admin (roles/resourcemanager.folderAdmin) בתיקייה.

המסוף

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

    פתיחת הדף Manage resources

  2. לוחצים על החץ לצד שם הארגון כדי להרחיב את תצוגת העץ ולראות את תיקיות המשנה שלו.

  3. בשורה של התיקייה שרוצים לעדכן, לוחצים על התפריט פעולות בסוף השורה ואז על הגדרות.

  4. מזינים את השם החדש של התיקייה ולוחצים על שמירה.

gcloud

כדי לעדכן את השם לתצוגה של תיקייה:

gcloud resource-manager folders update FOLDER_ID --display-name="NEW_DISPLAY_NAME"

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

  • ‫FOLDER_ID: המזהה של התיקייה שרוצים לעדכן.
  • ‫NEW_DISPLAY_NAME: השם המוצג החדש של התיקייה.

REST

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

  • ‫FOLDER_ID: Google Cloud מזהה התיקייה
  • ‫NEW_DISPLAY_NAME: השם המוצג החדש של התיקייה

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

PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName

גוף בקשת JSON: 

{
  "displayName": "NEW_DISPLAY_NAME"
}

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

curl

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

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

PowerShell

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

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

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

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

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "displayName": "NEW_DISPLAY_NAME",
    "operationType": "UPDATE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

העברת תיקייה לתיקייה אחרת

כדי להעביר תיקייה לתיקייה אחרת, צריך הרשאה resourcemanager.folders.move גם לתיקיית המקור וגם לתיקיית היעד.

המסוף

תהליך העברת תיקיות לתיקיות אחרות במסוף דומה להעברת פרויקטים.

  1. במסוף Google Cloud , פותחים את הדף 'ניהול משאבים'.

    פתיחת מסוף Google Cloud

  2. בוחרים את המשאב הארגוני מהתפריט הנפתח ארגון בפינה הימנית העליונה של הדף.
  3. לוחצים על השורה של התיקייה כדי לבחור אותה מתוך רשימת הפרויקטים והתיקיות.
  4. לוחצים על תפריט האפשרויות (סמל האליפסה האנכית) בשורה ואז על העברה.
  5. לוחצים על עיון כדי לבחור את התיקייה שאליה רוצים להעביר את התיקייה.
  6. לוחצים על Move.

gcloud

כדי להעביר תיקייה למשאב הארגון, מריצים את הפקודה הבאה ב-CLI של Google Cloud:

gcloud resource-manager folders move FOLDER_ID \
    --organization=PARENT_ID

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

  • ‫FOLDER_ID: המזהה של התיקייה שרוצים להעביר.
  • ‫PARENT_ID: המזהה של משאב הארגון הראשי.

כדי להעביר תיקייה לתוך תיקייה אחרת:

gcloud resource-manager folders move FOLDER_ID \
    --folder=PARENT_ID

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

  • ‫FOLDER_ID: המזהה של התיקייה שרוצים להעביר.
  • ‫PARENT_ID: המזהה של משאב הארגון או התיקייה ברמת ההורה.

REST

קובץ ה-JSON של הבקשה:

request_json= '{
   destinationParent: "folders/DESTINATION_FOLDER_ID"
}'

בקשת ה-curl להעברת תיקייה:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token} \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders/DISPLAY_NAME:move

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

  • ‫DESTINATION_FOLDER_ID: המזהה של התיקייה שאליה מעבירים תיקייה אחרת, לדוגמה 98765.
  • ‫DISPLAY_NAME: השם המוצג של התיקייה שמועברת, לדוגמה My Awesome Folder.

התשובה של Move Folder:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  }
}

בקשת ה-curl של Get Operation:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890

התגובה של Get Operation:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "folders/98765",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-20T00:54:44.295Z"
  }
}

מחיקת תיקיות

כדי למחוק תיקייה, עליך להיות בעל תפקיד Folder Editor (roles/resourcemanager.folderEditor) או תפקיד Folder Admin (roles/resourcemanager.folderAdmin) בתיקייה.

המסוף

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

    פתיחת הדף Manage resources

    במסוף Google Cloud , עוברים לדף Manage resources.

  2. לוחצים על החץ לצד שם הארגון כדי להרחיב את תצוגת העץ ולראות את תיקיות המשנה שלו.

  3. בשורה של התיקייה שרוצים למחוק, לוחצים על התפריט פעולות בסוף השורה ואז על מחיקה.

  4. בתיבת הדו-שיח לאישור, מקלידים את המזהה או השם של התיקייה כדי לאשר את המחיקה ולוחצים על מחיקה.

gcloud

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

gcloud resource-manager folders delete FOLDER_ID

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

  • ‫FOLDER_ID: המזהה של התיקייה שרוצים למחוק.

REST

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

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

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

DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID

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

curl

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

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"

PowerShell

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

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID" | Select-Object -Expand Content

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

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "operationType": "DELETE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

מידע נוסף

כשמוחקים תיקייה, היא עוברת למצב של מחיקה רכה למשך תקופת שמירה של 30 יום, לפני שהיא נמחקת סופית, או מחיקה קשה.

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

מצב מחיקה סופית: אחרי 30 יום, Google Cloud התיקייה והמטא-נתונים שלה נמחקים סופית. אי אפשר לבטל את הפעולה הזו.

ביטול מחיקה: אם מחקתם תיקייה בטעות, תוכלו לשחזר אותה תוך 30 יום באמצעות הפקודה gcloud resource-manager folders undelete או ה-API.

דרישות מוקדמות ומגבלות

  • התיקייה צריכה להיות ריקה: אי אפשר למחוק תיקייה שעדיין מכילה פרויקטים פעילים או תיקיות משנה. קודם צריך להעביר או למחוק את כל משאבי הצאצא.
  • הרשאות נדרשות: כדי למחוק תיקייה או לבטל את המחיקה שלה, צריך להיות לכם תפקיד עורך תיקיות (roles/resourcemanager.folderEditor) או Folder Admin (roles/resourcemanager.folderAdmin).

כדי לחפש תיקיות שתואמות לשאילתה שצוינה, משתמשים ב-gcloud alpha resource-manager folders search ומעבירים את התנאי בדגל --query. היקף החיפוש הוא כל התיקיות שלמשתמש יש הרשאת צפייה בהן.

gcloud alpha resource-manager folders search --query="name:vij*"
<table output showing the folders with names starting from vij eg. vijeta, vijay-folder>

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"
<table output showing folders for which delete has been requested>

אפשר להציג את כל התיקיות שלמשתמש יש הרשאת צפייה בהן באמצעות הפקודה gcloud folders search.

gcloud folders search
<table output showing all viewable folders>

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