במדריך הזה מוסבר איך ליצור, להציג ולמחוק תיקיות מנוהלות.
לפני שמתחילים
כדי ליצור ולנהל תיקיות מנוהלות, צריך קודם להפעיל גישה אחידה ברמת הקטגוריה ולקבל את תפקידי ה-IAM הנדרשים.
הפעלת גישה אחידה ברמת הקטגוריה
אם עדיין לא עשיתם זאת, הפעילו גישה אחידה ברמת הקטגוריה.
קבלת התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות ליצירה ולניהול של תיקיות מנוהלות, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM אדמין של תיקיית אחסון (roles/storage.folderAdmin) בקטגוריה.
זהו תפקיד מוגדר מראש עם ההרשאות שנדרשות ליצירה ולניהול של תיקיות מנוהלות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי ליצור ולנהל תיקיות מנוהלות, נדרשות ההרשאות הבאות:
-
כדי ליצור תיקיות מנוהלות:
storage.managedFolders.create -
כדי לאמת תיקיות מנוהלות שנוצרו לאחרונה על ידי הצגתן:
storage.objects.list -
כדי להציג רשימה של תיקיות מנוהלות:
storage.managedFolders.list -
כדי לקבל תיקיות מנוהלות:
storage.managedFolders.get -
כדי להעביר תיקיות מנוהלות:
-
storage.managedFolders.delete(בקטגוריית המקור) -
storage.managedFolders.create(בקטגוריית היעד)
-
-
כדי למחוק תיקיות מנוהלות:
storage.managedFolders.delete
במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים בקטגוריות.
יצירת תיקייה מנוהלת
המסוף
כשמשתמשים במסוף Google Cloud , יוצרים תיקיות מנוהלות על ידי הפעלת הניהול בתיקיות או בתיקיות מדומות. בשלבים הבאים מוסבר איך ליצור תיקייה או תיקייה מדומה, ואז להפעיל את ניהול התיקיות:
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שרוצים ליצור בה תיקיות מנוהלות.
בדף Bucket details, לוחצים על Create folder כדי ליצור תיקייה חדשה. אם התיקייה שרוצים להמיר לתיקייה מנוהלת כבר קיימת, אפשר לדלג לשלב שבו מתואר איך לגשת לתפריט אפשרויות נוספות .
בשדה שם, מזינים שם לתיקייה. הנחיות לגבי שמות מופיעות במאמר שמות של תיקיות מנוהלות.
לוחצים על יצירה.
התיקייה החדשה שנוצרה מופיעה בחלונית סייר התיקיות.
בחלונית Folder browser, לוחצים על תפריט More options לצד התיקייה שרוצים להמיר לתיקייה מנוהלת, ואז לוחצים על Edit access.
מופיעה תיבת הדו-שיח Enable folder management?
לוחצים על Enable.
התיקייה תומר לתיקייה מנוהלת. יופיע החלונית הרשאות ל-
MANAGED_FOLDER_NAMEעם מדיניות ה-IAM בתיקייה לפי חשבון ראשי ותפקיד. כדי ליצור מדיניות IAM חדשה, אפשר לעיין במאמר בנושא הגדרת מדיניות IAM בתיקייה מנוהלת.
שורת הפקודה
כדי ליצור תיקייה מנוהלת, מריצים את הפקודה gcloud storage managed-folders create:
gcloud storage managed-folders create gs://BUCKET_NAME/MANAGED_FOLDER_NAME
כאשר:
BUCKET_NAMEהוא שם הקטגוריה שבה רוצים ליצור תיקייה מנוהלת. לדוגמה,my-bucket.
MANAGED_FOLDER_NAMEהוא שם התיקייה המנוהלת שרוצים ליצור. לדוגמה,my-managed-folder/.
כדי לוודא שהתיקייה המנוהלת נוצרה, מריצים את הפקודה gcloud storage managed-folders describe:
gcloud storage managed-folders describe gs://BUCKET_NAME/MANAGED_FOLDER_NAME
כאשר:
BUCKET_NAMEהוא שם הקטגוריה שבה יצרתם תיקייה מנוהלת.
MANAGED_FOLDER_NAMEהוא השם של התיקייה המנוהלת שיצרתם.
ספריות לקוח
C++
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
C#
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Go
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Go API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Java
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Python
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Python API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Ruby
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Ruby API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
ממשקי API ל-REST
API ל-JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשתPOSTManagedFolder:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -d '{ "name": "MANAGED_FOLDER_NAME" }' \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"כאשר:
BUCKET_NAMEהוא שם הקטגוריה שבה רוצים ליצור תיקייה מנוהלת. לדוגמה,my-bucket.
MANAGED_FOLDER_NAMEהוא השם של התיקייה המנוהלת שרוצים ליצור. לדוגמה,my-managed-folder/.
הצגת רשימה של תיקיות מנוהלות
המסוף
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
בחלונית Folder browser, משתמשים בtoggle node כדי להרחיב את רשימת התיקיות בתוך הקטגוריה.
רשימה שבה מוצגות התיקיות, התיקיות המדומות והתיקיות המנוהלות בדלי.
שורת הפקודה
כדי להציג רשימה של תיקיות מנוהלות, מריצים את הפקודה gcloud storage managed-folders list:
gcloud storage managed-folders list gs://BUCKET_NAME
כאשר:
-
BUCKET_NAMEהוא שם הקטגוריה שמכילה את התיקיות המנוהלות שרוצים להציג ברשימה. לדוגמה,my-bucket.
שימו לב שאפשר לציין גם נתיב לתיקייה במקום שם של מאגר. לדוגמה:
gcloud storage managed-folders list gs://my-bucket/folder/
ספריות לקוח
C++
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
C#
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Go
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Go API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Java
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Python
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Python API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Ruby
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Ruby API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
ממשקי API ל-REST
API ל-JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים בפקודה
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה לקריאת רשימה של תיקיות מנוהלות:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"
כאשר
BUCKET_NAMEהוא שם הקטגוריה שמכילה את התיקיות המנוהלות שרוצים להציג ברשימה. לדוגמה,my-bucket.
אחזור המטא-נתונים של תיקייה מנוהלת
שורת הפקודה
כדי לקבל את המטא-נתונים של תיקייה מנוהלת, מריצים את הפקודה gcloud storage managed-folders describe:
gcloud storage managed-folders describe gs://BUCKET_NAME/MANAGED_FOLDER_NAME
כאשר:
BUCKET_NAMEהוא שם הקטגוריה שמכילה את התיקיות המנוהלות שרוצים להציג ברשימה. לדוגמה,my-bucket.
MANAGED_FOLDER_NAMEהוא שם התיקייה המנוהלת שרוצים לאחזר את המטא-נתונים שלה.
ספריות לקוח
C++
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
C#
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Go
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Go API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Java
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Python
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Python API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Ruby
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Ruby API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
ממשקי API ל-REST
API ל-JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה לקבלת תיקיות מנוהלות:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME"
כאשר:
BUCKET_NAMEהוא שם הקטגוריה שמכילה את התיקיות המנוהלות שרוצים לאחזר. לדוגמה,my-bucket.
MANAGED_FOLDER_NAMEהוא שם התיקייה המנוהלת שמופיע כנתיב. לדוגמה,example-dir/. אם התיקייה המנוהלת היא תיקייה מקוננת, צריך להוסיף תו בריחה (escape) לתו הלוכסן (/) בנתיב של התיקייה המנוהלת. לדוגמה,example-dir1%2Fexample-dir2.
העברה של תיקייה מנוהלת
המסוף
יוצרים תיקייה מנוהלת חדשה בקטגוריית היעד.
מעתיקים את כללי מדיניות ה-IAM מהתיקייה המנוהלת המקורית בקטגוריית המקור לתיקייה המנוהלת החדשה בקטגוריית היעד.
מעתיקים את האובייקטים מהתיקייה המנוהלת המקורית בקטגוריית המקור לתיקייה המנוהלת החדשה בקטגוריית היעד.
מוחקים את התיקייה המנוהלת המקורית מקטגוריית המקור.
שורת הפקודה
כדי להעביר תיקיות מנוהלות ואת האובייקטים שהן מכילות, מריצים את הפקודה gcloud storage mv עם האפשרות --include-managed-folders:
gcloud storage mv --include-managed-folders gs://SOURCE_BUCKET_NAME/MANAGED_FOLDER_NAME gs://DESTINATION_BUCKET_NAME/MANAGED_FOLDER_NAME
כאשר:
SOURCE_BUCKETהוא השם של הקטגוריה המקורית. לדוגמה,my-source-bucket`.
DESTINATION_BUCKETהוא שם הקטגוריה שאליה רוצים להעביר את התיקייה המנוהלת. לדוגמה,my-destination-bucket.
MANAGED_FOLDER_NAMEהוא השם של התיקייה המנוהלת שרוצים להעביר. לדוגמה,my-managed-folder/.
ממשקי API ל-REST
API ל-JSON
כדי להעביר תיקיות מנוהלות מקטגוריה אחת לאחרת, מבצעים את השלבים הבאים:
יוצרים תיקייה מנוהלת חדשה בקטגוריית היעד.
מעתיקים את כללי מדיניות ה-IAM מהתיקייה המנוהלת המקורית בקטגוריית המקור לתיקייה המנוהלת החדשה בקטגוריית היעד.
מעתיקים את האובייקטים מהתיקייה המנוהלת המקורית בקטגוריית המקור לתיקייה המנוהלת החדשה בקטגוריית היעד.
מוחקים את התיקייה המנוהלת המקורית מקטגוריית המקור.
מחיקת תיקייה מנוהלת
המסוף
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על השם של הקטגוריה שמכילה את התיקייה המנוהלת שרוצים למחוק.
בדף Bucket details (פרטי מאגר), לוחצים על סמל האפשרויות הנוספות לצד התיקייה המנוהלת שרוצים למחוק.
לוחצים על מחיקת התיקייה.
כדי לאשר שרוצים למחוק את התיקייה המנוהלת, מקלידים
DELETEבשדה מחיקה.לוחצים על Delete.
התיקייה המנוהלת והתוכן שלה, כולל אובייקטים מאוחסנים ותיקיות מנוהלות אחרות, נמחקים מהקטגוריה שלכם ב-Cloud Storage.
שורת הפקודה
כדי למחוק תיקייה מנוהלת ואת האובייקטים שהיא מכילה, מריצים את הפקודה gcloud storage rm:
gcloud storage rm -r gs://BUCKET_NAME/MANAGED_FOLDER_NAME
כאשר:
BUCKET_NAMEהוא שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים למחוק. לדוגמה,my-bucket.
MANAGED_FOLDER_NAMEהוא השם של התיקייה המנוהלת שרוצים למחוק. לדוגמה,my-managed-folder/.
ספריות לקוח
C++
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
C#
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Go
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Go API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Java
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Python
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Python API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Ruby
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Ruby API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
ממשקי API ל-REST
API ל-JSON
כדי למחוק תיקייה מנוהלת, צריך קודם למחוק את האובייקטים בתוך התיקייה המנוהלת.
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשתDELETEManagedFolder:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME"
כאשר:
BUCKET_NAMEהוא שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים למחוק. לדוגמה,my-bucket.
MANAGED_FOLDER_NAMEהוא השם של התיקייה המנוהלת שרוצים למחוק. לדוגמה,my-managed-folder/.
כברירת מחדל, תיקיות מנוהלות צריכות להיות ריקות כדי שאפשר יהיה למחוק אותן. כדי למחוק תיקייה מנוהלת שלא ריקה, צריך לכלול את
allowNonEmpty=trueכפרמטר שאילתה בבקשה.
פתרון בעיות
במאמר לפתרון בעיות מוסבר איך ליצור ולנהל תיקיות מנוהלות.