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

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

סקירה כללית

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

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

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

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

• ‫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.

לתשומת ליבכם

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

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

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

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

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

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

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

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

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

נסו בעצמכם

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

להתנסות ב-Cloud Storage בחינם