מידע על תיקיות בקטגוריות עם מרחב שמות היררכי

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

סקירה כללית

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

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

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

מטא-נתונים של תיקיות

המטא-נתונים של תיקייה מכילים מידע מובנה על התיקייה. מידע מפורט על מטא-נתונים של תיקיות מופיע במאמר בנושא Folder resource במאמרי העזרה של Cloud Storage JSON API.

הרכיבים העיקריים של מטא-נתונים של תיקייה הם:

• ‫bucket: שם הקטגוריה שבה נמצאת התיקייה. לדוגמה, my-bucket.
• ‫id: מזהה ייחודי של התיקייה בתוך הדלי. לדוגמה, hns-bucket/dir1/.
• ‫kind: סוג המשאב. במקרה של תיקייה, הערך הזה הוא תמיד storage#folder.
• ‫name: שם התיקייה. לדוגמה, dir1/.
• ‫selfLink: כתובת URL שמפנה לתיקייה ב-Cloud Storage API.
• timeCreated: חותמת הזמן שבה נוצרה התיקייה. לדוגמה, 2023-05-05T16:32:08.878000+00:00.
• ‫updated: חותמת הזמן של העדכון האחרון של התיקייה. לדוגמה, 2024-05-06T16:32:08.878000+00:00.

פעולות בתיקייה

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

יצירת תיקייה

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

מידע על מתן שמות לתיקיות זמין בקטע שיקולים.

הצגת רשימה של תיקיות

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

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

הפעולה list folders מחזירה תוצאות בחלוקה לדפים. דף תשובות יחיד יכול להכיל עד 1,000 תיקיות.

אחזור המטא-נתונים של תיקייה

אפשר לאחזר את המאפיינים של תיקייה באמצעות הפעולה get folder metadata. הפעולה הזו מאחזרת מידע על משאב התיקייה עצמו, ולא על האובייקטים שהוא מכיל.

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

שינוי שם או העברה של תיקייה

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

פעולת שינוי השם של התיקייה מפעילה פעולה ממושכת.

במהלך פעולת שינוי שם של תיקייה, אפשר לקרוא את התיקיות שמשנים את השם שלהן ולראות אותן ברשימה, אבל אי אפשר להפעיל עליהן פעולות כתיבה.

ב-API בפורמט JSON וב-Google Cloud CLI, הפעולות של שינוי שם והעברה משתמשות באותה נקודת קצה של כתובת URL או באותה פקודה. במסוף Cloud de Confiance , האפשרויות Rename folder (שינוי שם התיקייה) ו-Move folder (העברת התיקייה) מוצגות כשתי אפשרויות נפרדות, אבל שתיהן מבצעות את אותה פעולה בעורף.

מחיקת תיקייה

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

אינטראקציות בין תיקיות לבין תיקיות מנוהלות משויכות

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

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

  לדוגמה, נניח שאתם יוצרים קטגוריה עם מרחב שמות היררכי בשם my-bucket. אם יוצרים בקטגוריה תיקייה מנוהלת בשם 2025/training-data/, מערכת Cloud Storage יוצרת באופן אוטומטי את תיקיית ההורה 2025/ ואת תיקיית היעד המשויכת training-data/ בקטגוריה.

• מחיקת תיקייה: כשמוחקים תיקייה שיש לה תיקייה מנוהלת משויכת, Cloud Storage מוחק גם את התיקייה המנוהלת המשויכת. הסיבה לכך היא שכאשר מוחקים תיקייה, מוחקים את הנתיב כולו. מכיוון שהנתיב כבר לא קיים, התיקייה המנוהלת שמשויכת אליו וכל כללי ה-IAM שמצורפים אליה נמחקים. בדליים שמופעל בהם מרחב שמות היררכי, לא יכולה להיות תיקייה מנוהלת ללא תיקייה משויכת.

  אם אין לכם את ההרשאות הנדרשות למחיקת התיקייה המנוהלת שמשויכת לתיקייה, פעולת המחיקה של התיקייה תיכשל. כדי לראות אילו הרשאות נדרשות למחיקת תיקיות מנוהלות, אפשר לעיין במאמר בנושא קבלת התפקידים הנדרשים לתיקיות מנוהלות.

• שינוי שם של תיקייה: כשמשנים את השם של תיקייה שמקושרת לתיקייה מנוהלת, Cloud Storage משנה גם את השם של התיקייה המנוהלת המקושרת.

מידע על הדרישות למתן שמות לתיקיות שמשויכות לתיקייה מנוהלת זמין במאמר בנושא מתן שמות לתיקיות.

לתשומת ליבכם

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

• שמות של אובייקטים ותיקיות: קטגוריות שמופעל בהן מרחב שמות היררכי תומכות בכל השמות התקינים של אובייקטים, כולל שמות שמתחילים או מסתיימים בלוכסנים (/) או שכוללים לוכסנים עוקבים. כל קו נטוי (/) בשם של אובייקט מייצג תיקייה. בטבלה הבאה מוצגות דוגמאות לקשר בין שמות של אובייקטים לבין המיקום שלהם בהיררכיית התיקיות:

  שם האובייקט	המיקום בהיררכיית התיקיות
  foo.txt	כל מאגר כולל תיקיית בסיס. האובייקט foo.txt נמצא מתחת לתיקיית השורש של הקטגוריה.
  dir1/foo.txt	האובייקט foo.txt נמצא בתיקייה ברמה העליונה שנקראת dir1/. התיקייה ברמה העליונה שונה מתיקיית הבסיס.
  dir1/	הקו הנטוי בסוף שמות של אובייקטים כמו dir1/ מציין שהאובייקט נמצא בתוך התיקייה. בדוגמה הזו, שם האובייקט dir1/ זהה לשם תיקיית ההורה dir1/.
  dir1//foo.txt	האובייקט foo.txt נמצא בתיקייה ברמה השנייה שנקראת dir1//, שהיא תיקיית צאצא של dir1/.

• עומק התיקייה המקסימלי: בקטגוריות שמופעל בהן מרחב שמות היררכי, העומק המקסימלי של התיקייה הוא 50. אפשר ליצור תיקיות עם עד 50 תיקיות צאצא מוערמות (לדוגמה, folder1/folder2/folder3/.../folder50/my-data.txt). עם זאת, אם לתיקייה יש תיקייה מנוהלת משויכת, יכולות להיות לה רק עד 15 תיקיות צאצא מוערמות.

• הגודל המקסימלי של שם התיקייה: 512 בייטים (בקידוד UTF-8).

• מידע רגיש או פרטים אישיים מזהים (PII): שמות של תיקיות גלויים באופן נרחב יותר מאשר מטא-נתונים של תיקיות. לדוגמה, שמות של תיקיות מופיעים בכתובות URL וברשימת התיקיות או האובייקטים בקטגוריה. אל תכללו מידע רגיש או פרטים אישיים מזהים (PII) בשמות של תיקיות.

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

• יצירה וניהול של תיקיות.
• שינוי שם של תיקייה.
• אופטימיזציה של ניהול התיקיות.