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

אתם יכולים לראות את פרטי התיקיות, לעדכן את השמות המוצגים, להעביר תיקיות ולמחוק תיקיות מיותרות באמצעות מסוף Cloud de Confiance , ה-CLI של Google Cloud או Cloud Resource Manager API. ניהול התיקיות מאפשר לכם לארגן את המשאבים ולשמור על היררכיית המשאבים ב- Cloud de Confiance by S3NS ככל שהפרויקטים והצוותים מתפתחים.

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

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

המסוף

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

    לדף Manage resources

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

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

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

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

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

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

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

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

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

gcloud

כדי לקבל פרטים על תיקייה אחת, משתמשים בפקודה gcloud resource-manager folders describe:

gcloud resource-manager folders describe FOLDER_ID

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

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

gcloud resource-manager folders list \
    --organization=ORGANIZATION_ID

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

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

gcloud resource-manager folders list \
    --folder=FOLDER_ID

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

כדי להציג את רשימת הפרויקטים בארגון או בתיקייה, משתמשים בפקודה gcloud 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. פותחים את הדף Manage resources במסוף Cloud de Confiance .

    לדף Manage resources

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

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

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

gcloud

כדי לעדכן את השם המוצג של תיקייה, משתמשים בפקודה gcloud resource-manager folders update:

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

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

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

REST

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

  • ‫FOLDER_ID: מזהה התיקייה Cloud de Confiance by S3NS
  • ‫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. במסוף Cloud de Confiance , פותחים את הדף Manage resources.

    כניסה למסוף Cloud de Confiance

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

gcloud

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

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: השם המוצג של התיקייה שמועברת, לדוגמה "התיקייה המדהימה שלי".

התשובה של 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"
  }
}

מחיקת תיקיות

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

המסוף

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

    לדף Manage resources

    במסוף Cloud de Confiance , נכנסים לדף Manage resources.

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

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

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

gcloud

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

gcloud resource-manager folders delete FOLDER_ID

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

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

REST

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

  • ‫FOLDER_ID: מזהה התיקייה Cloud de Confiance by S3NS

ה-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 ימים, Cloud de Confiance by S3NS מסירה באופן סופי את התיקייה ואת המטא-נתונים שלה. אי אפשר לבטל את הפעולה הזו.

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

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

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

חיפוש

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

לדוגמה, כדי לחפש תיקיות עם השמות המוצגים שמתחילים ב-vij, כמו vijeta או vijay-folder, מריצים את הפקודה הבאה:

gcloud alpha resource-manager folders search --query="displayName:vij*"

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

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"

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

gcloud alpha resource-manager folders search

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