תיקיות מנוהלות

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

‫IAM לתיקיות מנוהלות

כשמחילים מדיניות IAM על תיקייה מנוהלת, הגישה שניתנת במדיניות חלה על כל אובייקט בקטגוריה שמשתמש בנתיב של התיקייה המנוהלת כקידומת בשם האובייקט. לדוגמה, אם נותנים לחשבון משתמש את התפקיד "צפייה באובייקט אחסון" (roles/storage.objectViewer) בתיקייה מנוהלת בשם example-managed-folder/, חשבון המשתמש יכול לצפות בכל אובייקט בנתיב example-managed-folder, כמו example-managed-folder/dog.png או example-managed-folder/cat.jpeg. כשמגדירים תיקיות מנוהלות בתצוגת עץ, ההרשאות שניתנות באמצעות כללי מדיניות IAM חלות באופן מצטבר.

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

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

מידע נוסף על תיקיות מנוהלות זמין בדפים הבאים:

שמות של תיקיות מנוהלות

השם שאתם נותנים לתיקייה מנוהלת צריך לעמוד בדרישות הבאות:

  • שמות של תיקיות מנוהלות יכולים להכיל כל רצף של תווי Unicode תקפים, באורך 1 עד 1,024 בייטים בקידוד UTF-8.

  • שמות של תיקיות מנוהלות לא יכולים להכיל תו של חזרה לתחילת השורה או תו של מעבר שורה.

  • שמות של תיקיות מנוהלות חייבים להסתיים ב-/. שם של תיקייה מנוהלת יכול להכיל עד 15 תווים מסוג /. במילים אחרות, אפשר להוסיף תיקיות מנוהלות עד לעומק של 15 רמות.

  • שמות של תיקיות מנוהלות לא יכולים להתחיל ב-.well-known/acme-challenge/.

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

מומלץ מאוד ששמות התיקיות המנוהלות לא יכללו:

  • תווי בקרה שהם לא חוקיים ב-XML 1.0 ‏(‎#x7F–#x84 ו-‎ #x86–#x9F): התווים האלה גורמים לבעיות בהצגת רשימות באמצעות XML כשאתם מנסים להציג את רשימת התיקיות המנוהלות.

  • התווים [, ], * או ?: Google Cloud CLI מפרש את התווים האלה כתווים כלליים לחיפוש. לכן אם כוללים אותם בשמות של תיקיות מנוהלות, קשה או בלתי אפשרי לבצע פעולות עם תווים כלליים לחיפוש באמצעות הכלי. בנוסף, * ו-? הם לא תווים תקינים לשמות קבצים ב-Windows.

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

לתשומת ליבכם

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

  • אפשר ליצור תיקיות מנוהלות במקום תיקיות מדומות. כלומר, אתם יכולים ליצור תיקייה מנוהלת ולקרוא לה על שם הקידומת של האובייקט, כל עוד אין כבר תיקייה מנוהלת עם השם הזה. לדוגמה, אתם יכולים ליצור תיקייה מנוהלת בשם my-folder/, גם אם יש לכם אובייקט קיים בשם my-folder/object.txt. שימו לב שמדיניות ה-IAM בתיקייה המנוהלת my-folder/ תחול על כל האובייקטים עם הקידומת my-folder/.

  • אפשר ליצור תיקיות צאצא מנוהלות לפני שיוצרים את תיקיית ההורה המנוהלת. לדוגמה, אפשר ליצור תיקייה מנוהלת בשם my-folder-A/my-folder-B/ בלי ליצור קודם תיקייה מנוהלת בשם my-folder-A/.

  • כברירת מחדל, אי אפשר למחוק תיקייה מנוהלת לא ריקה שמכילה אובייקטים או תיקיות צאצא מנוהלות אחרות. אפשר לעקוף את הכלל הזה כשמשתמשים בפרמטר allowNonEmpty בבקשת API בפורמט JSON של Delete ManagedFolder.

  • השמות של התיקיות המנוהלות מופיעים בהודעות שגיאה וב-Cloud Audit Logs כשבקשה למחיקת תיקייה עם תיקייה מנוהלת באותו נתיב נכשלת, גם בלי הרשאות storage.managedFolders.get או storage.managedFolders.list מפורשות.

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