בדף הזה מוסבר איך להעלות אובייקטים לקטגוריות אחסון ב-Google Distributed Cloud (GDC) עם בידוד פיזי ואיך להוריד אובייקטים מהקטגוריות האלה.
לפני שמתחילים
מרחב שמות של פרויקט מנהל משאבי קטגוריות בשרת Management API. כדי לעבוד עם קטגוריות ואובייקטים, צריך פרויקט.
כדי לבצע את הפעולה הבאה, צריך גם הרשאות מתאימות ל-bucket. מידע נוסף זמין במאמר הענקת גישה לקטגוריות.
הנחיות למתן שמות לאובייקטים
כדי לתת שמות לאובייקטים:
- כשנותנים שמות לאובייקטים, משתמשים בתווים בקידוד UTF-8.
- האורך צריך להיות בין 1 ל-55 תווים.
- אל תכללו פרטים אישיים מזהים (PII).
העלאת אובייקטים לקטגוריות אחסון
המסוף
- בתפריט הניווט, לוחצים על Object Storage (אחסון אובייקטים).
- לוחצים על שם הקטגוריה שאליה רוצים להעלות את האובייקט.
- אופציונלי: אם רוצים ליצור תיקייה לאחסון האובייקט, לוחצים על יצירת תיקייה, מזינים שם לתיקייה ולוחצים על יצירה.
- לוחצים ישירות על העלאת קובץ, או עוברים לתיקייה שיצרתם ולוחצים על העלאת קובץ.
- בוחרים את הקובץ הרצוי ולוחצים על פתיחה.
- ממתינים להודעת האישור שההעלאה בוצעה בהצלחה.
gdcloud
כדי להעלות אובייקט, מריצים את הפקודות הבאות:
gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME
gdcloud storage mv s3://FULLY_QUALIFIED_SOURCE_BUCKET_NAME s3://FULLY_QUALIFIED_DESTINATION_BUCKET_NAME
בפקודות הבאות צריך להשתמש ב-FULLY_QUALIFIED_BUCKET_NAME. משתמשים בפקודה GET או DESCRIBE מהקטע הצגת ההגדרות של קטגוריה כדי לקבל את השם המוגדר במלואו של הקטגוריה.
הפקודה הבאה מעלה את כל קובצי הטקסט מהספרייה המקומית לקטגוריה:
gdcloud storage cp *.txt s3://FULLY_QUALIFIED_BUCKET_NAME
הפקודה הבאה מעלה כמה קבצים מהספרייה המקומית לקטגוריה:
gdcloud storage cp abc1.txt abc2.txt s3://FULLY_QUALIFIED_BUCKET_NAME
כדי להעלות תיקייה לקטגוריית אחסון, משתמשים באפשרות --recursive כדי להעתיק את כל עץ התיקיות. הפקודה הבאה מעלה את עץ הספרייה dir:
gdcloud storage cp DIRECTORY_NAME s3://FULLY_QUALIFIED_BUCKET_NAME --recursive
כדי להעלות אובייקטים גדולים, מבצעים העלאות מרובות חלקים, או משתמשים בהעלאות מרובות חלקים באופן אוטומטי כשרוצים להעלות קובץ שגדול מ-15MB. במקרה כזה, הקובץ יפוצל לכמה חלקים, וכל חלק יהיה בגודל של 15MB. החלק האחרון קטן יותר. כל חלק מועלה בנפרד ונבנה מחדש ביעד כשההעברה מסתיימת.
אם העלאה של חלק אחד נכשלת, אפשר להפעיל מחדש את ההעלאה בלי להשפיע על אף אחד מהחלקים האחרים שכבר הועלו.
יש שתי אפשרויות שקשורות להעלאות מרובות חלקים:
-
--disable-multipart: משבית את העלאות החלקיות לכל הקבצים. -
--multipart-chunk-size-mb=SIZE: מגדיר את הגודל של כל נתח בהעלאה מרובת חלקים.
קבצים שגדולים מ-SIZE מועלים אוטומטית כקבצים מרובי-חלקים עם ריבוי שרשורים. קבצים קטנים יותר מועלים באמצעות השיטה הרגילה. SIZE מצוין במגה-בייט. גודל ברירת המחדל של החלק הוא 15MB. גודל החלק המינימלי המותר הוא 5MB, והגודל המקסימלי הוא 5GB.
הורדת אובייקטים מקטגוריות אחסון
המסוף
- בתפריט הניווט, לוחצים על Object Storage (אחסון אובייקטים).
- לוחצים על שם הקטגוריה שמכילה את האובייקטים.
- מסמנים את התיבה לצד שם האובייקט שרוצים להוריד.
- לוחצים על הורדה.
gdcloud
כדי לאחזר אובייקטים מהקטגוריה:
gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/OBJECT LOCAL_FILE_TO_SAVE
כדי להוריד את כל קובצי הטקסט מקטגוריה לספרייה הנוכחית:
gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/*.txt .
כדי להוריד את קובץ הטקסט abc.txt מקטגוריה לספרייה הנוכחית:
gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt .
כדי להוריד גרסה ישנה יותר של הקובץ, צריך קודם לרשום את כל הגרסאות של הקובץ:
gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt --all-versions
פלט לדוגמה:
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
לאחר מכן, מורידים גרסה ספציפית של קובץ הטקסט abc.txt מהקטגוריה לספרייה הנוכחית:
gdcloud storage cp s3://FULLY_QUALIFIED_BUCKET_NAME/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .
שימוש ב-AEADKey מותאם אישית
כדי להתאים אישית יותר, אתם יכולים ליצור AEADKey משלכם ולהשתמש בו ישירות כשמצפינים אובייקטים בקטגוריה. כך יש לכם שליטה מלאה במפתח ההצפנה, בלי להשתמש בברירת המחדל. פועלים לפי ההוראות שבקטע יצירת מפתח כדי ליצור AEADKey חדש, ומוודאים שהוא נמצא באותו Namespace כמו הקטגוריה שבה רוצים להשתמש. לאחר מכן, בכל פעם ששולחים את הבקשה, מוודאים שהפרמטר HEADER מוגדר עם הערכים x-amz-server-side-encryption: SSE-KMS ו-x-amz-server-side-encryption-aws-kms-key-id: NAMESPACE_NAME/AEADKey_NAME