בדף הזה מוסבר איך ליצור קטגוריה ב-Cloud Storage. אם לא צוין אחרת בבקשה, קטגוריות נוצרות עם סוג האחסון (storage class) Standard Storage שמוגדר כברירת מחדל, ועם משך שמירה של 7 ימים של מחיקה רכה.
אם אתם יוצרים קטגוריה בפעם הראשונה, כדאי לעיין במאמר אחסון אובייקטים באמצעות מסוף Cloud de Confiance או במאמר אחסון אובייקטים באמצעות Google Cloud CLI כדי לקבל הסבר מפורט יותר על המשימות שאפשר לבצע באמצעות Cloud Storage.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות ליצירת קטגוריה של Cloud Storage, צריך לבקש מהאדמין להקצות לכם את התפקיד ב-IAM 'אדמין לניהול אחסון' (roles/storage.admin) בפרויקט.
התפקיד המוגדר מראש הזה מכיל את ההרשאה הנדרשת ליצירת קטגוריה. כדי לראות את ההרשאות הנדרשות, מרחיבים את הקטע Required Permissions:
ההרשאות הנדרשות
storage.buckets.create-
storage.buckets.enableObjectRetention(נדרש רק אם מפעילים הגדרות שמירה של אובייקטים בקטגוריה) -
storage.buckets.list(נדרשת רק אם יוצרים קטגוריה באמצעות מסוף Cloud de Confiance ). -
resourcemanager.projects.get(נדרשת רק אם יוצרים קטגוריה באמצעות מסוף Cloud de Confiance )
יכול להיות שתוכלו לקבל את ההרשאות האלה גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים. במאמר תפקידי IAM ל-Cloud Storage מפורטים התפקידים השונים וההרשאות שמשויכות אליהם.
במאמר ניהול הגישה לפרויקטים מופיעות הוראות להקצאת תפקידים לפרויקטים.
יצירת קטגוריה חדשה
כדי ליצור קטגוריה עם הגדרות ספציפיות או הגדרות מתקדמות, מבצעים את השלבים הבאים.
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
- לוחצים על יצירה.
ממלאים את פרטי הקטגוריה בדף Create a bucket. אחרי כל אחד מהשלבים הבאים, לוחצים על המשך כדי לעבור לשלב הבא:
-
בקטע Get started (תחילת העבודה), מבצעים את הפעולות הבאות:
-
מזינים שם ייחודי בהיקף גלובלי שעומד בקריטריונים לשמות של קטגוריות.
-
כדי להוסיף תווית של דלי, לוחצים על חץ ההרחבה כדי להרחיב את הקטע Labels (תוויות), לוחצים על add_box Add label (הוספת תווית) ומציינים
keyו-valueבשביל התווית.
-
-
בקטע Choose where to store your data, מבצעים את הפעולות הבאות:
-
בוחרים סוג מיקום.
-
בתפריט הנפתח של סוג המיקום, בוחרים Location שבו נתוני האובייקטים בקטגוריה יישמרו באופן קבוע.
-
אם בוחרים את סוג המיקום בשני אזורים, אפשר גם להפעיל רפליקציה בקצב טורבו באמצעות תיבת הסימון הרלוונטית.
-
-
-
בקטע Choose how to store your data מבצעים את הפעולות הבאות:
-
בוחרים default storage class לקטגוריה או Autoclass לניהול אוטומטי של סוג האחסון (storage class) של נתוני הקטגוריה.
-
בקטע Optimize storage for data-intensive workloads: מבצעים את הפעולות הבאות:
-
כדי להפעיל מרחב שמות היררכי, בוחרים באפשרות הפעלת מרחב שמות היררכי בקטגוריה הזו.
- כדי להפעיל את Rapid Cache, בוחרים באפשרות
Enable Rapid Cache ופועלים לפי השלבים:
-
כדי ליצור מטמונים, לוחצים על Configure (הגדרה).
-
בתיבת הדו-שיח הגדרת הגדרות מטמון שמופיעה, לוחצים על החץ לתפריט הנפתח לצד האזורים שמופיעים ברשימה ובוחרים את האזורים שבהם רוצים ליצור מטמונים.
-
לוחצים על סיום.
-
-
-
-
בקטע Choose how to control access to objects, בוחרים אם הקטגוריה אוכפת public access prevention או לא, ואז בוחרים גישה אחידה ברמת הקטגוריה לאובייקטים של הקטגוריה.
-
בקטע Choose how to protect object data:
-
בוחרים באחת מהאפשרויות בקטע הגנה על נתונים שרוצים להגדיר לקטגוריה.
-
כדי לשנות את משך הזמן שבו מחיקה רכה שומרת אובייקטים אחרי המחיקה, מסמנים את התיבה Soft delete policy (מדיניות מחיקה רכה) ואז בוחרים באפשרות Set custom retention duration (הגדרת משך שמירה מותאם אישית). לאחר מכן, מציינים כמה זמן רוצים לשמור את האובייקטים שנמחקו.
כדי להשבית את המחיקה הרכה, למשל אם המאגר יכיל בעיקר נתונים זמניים לזמן קצר, מבטלים את הסימון בתיבת הסימון Soft delete policy (מדיניות מחיקה רכה).
-
כדי לבחור איך להצפין את נתוני האובייקט, לוחצים על החץ להרחבה עם התווית Data encryption (הצפנת נתונים) ופועלים לפי השלבים הבאים:
- בקטע Default encryption key type, בוחרים את מפתח ההצפנה שמוגדר כברירת מחדל לקטגוריה. אם בוחרים באפשרות מפתח Cloud KMS, צריך לספק מפתח של Cloud Key Management Service.
- בקטע Encryption enforcement rules, בשדה Key types, בוחרים אילו סוגי הצפנה לאפשר או להגביל לאובייקטים חדשים בדלי.
-
-
לוחצים על יצירה.
במאמר פתרון בעיות מוסבר איך מקבלים מידע מפורט על שגיאות בנושא פעולות ב-Cloud Storage שנכשלו ב Cloud de Confiance מסוף.
שורת הפקודה
-
במסוף Cloud de Confiance , מפעילים את Cloud Shell.
בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
בסביבת הפיתוח, מריצים את הפקודה
gcloud storage buckets create:gcloud storage buckets create gs://BUCKET_NAME --location=BUCKET_LOCATION
כאשר:
-
BUCKET_NAMEהוא השם שרוצים לתת לקטגוריה, בכפוף לדרישות למתן שמות. לדוגמה:my-bucket.
BUCKET_LOCATIONהוא המיקום של הקטגוריה. לדוגמה,U-FRANCE-EAST1.
אם הבקשה מבוצעת בהצלחה, הפקודה תחזיר את ההודעה הבאה:
Creating gs://BUCKET_NAME/...
מגדירים את הדגלים הבאים כדי לקבל שליטה טובה יותר ביצירת הקטגוריה:
-
--project: ציון מזהה הפרויקט או מספר הפרויקט שאליהם הקטגוריה תשויך. לדוגמה,my-project. -
--default-storage-class: ציון סוג האחסון של הקטגוריה שמוגדר כברירת מחדל. לדוגמה,STANDARD. -
--uniform-bucket-level-access: הפעלת גישה אחידה ברמת הקטגוריה בשביל הקטגוריה. -
--soft-delete-duration: מציינים את משך השמירה של מחיקה רכה, כלומר מספר הימים שבהם רוצים לשמור אובייקטים אחרי שהם נמחקים. לדוגמה,10d. -
--encryption-enforcement-file: מספקים קובץ שמגדיר אילו שיטות הצפנה מוגבלות או מותרות לאובייקטים חדשים בקטגוריה.
לדוגמה:
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID --default-storage-class=STORAGE_CLASS --location=BUCKET_LOCATION --uniform-bucket-level-access --soft-delete-duration=RETENTION_DURATION --encryption-enforcement-file=ENCRYPTION_ENFORCEMENT_FILE
רשימה מלאה של האפשרויות ליצירת קטגוריות באמצעות ה-CLI של gcloud מופיעה במאמר אפשרויות של
buckets create.-
ספריות לקוח
C++
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C++ API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
C#
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage C# API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Go
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Go API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Java
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Python
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Python API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Ruby
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Ruby API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
לפני שמריצים דוגמאות קוד, צריך להגדיר את משתנה הסביבה GOOGLE_CLOUD_UNIVERSE_DOMAIN לערך s3nsapis.fr.
Rust
Terraform
אפשר להשתמש במשאב של Terraform כדי ליצור קטגוריית אחסון.
ממשקי API ל-REST
API בפורמט JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ JSON עם ההגדרות של הקטגוריה, שחייבות לכלול
nameלקטגוריה. רשימה מלאה של ההגדרות מופיעה במאמרי העזרה של Buckets:Insert. ההגדרות הנפוצות שצריך לכלול בקובץ:{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
כאשר:
BUCKET_NAMEהוא השם שרוצים לתת לקטגוריה, בכפוף לדרישות למתן שמות. לדוגמה:my-bucket.
BUCKET_LOCATIONהוא המיקום שבו רוצים לאחסן את נתוני האובייקטים של הקטגוריה. לדוגמה,U-FRANCE-EAST1.
STORAGE_CLASSהוא סוג האחסון שמוגדר כברירת מחדל בקטגוריה. לדוגמה,STANDARD.
משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b?project=PROJECT_IDENTIFIER"
כאשר:
-
JSON_FILE_NAMEהוא השם של קובץ ה-JSON שיצרתם בשלב 2. -
PROJECT_IDENTIFIERהוא המזהה או המספר של הפרויקט שאליו הקטגוריה תשויך. לדוגמה,my-project.
-
API בפורמט XML
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ XML עם ההגדרות של הקטגוריה. רשימה מלאה של ההגדרות מופיעה במאמרי העזרה בנושא XML: Create a bucket. אלו ההגדרות הנפוצות שצריך לכלול:
<CreateBucketConfiguration> <StorageClass>STORAGE_CLASS</StorageClass> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> </CreateBucketConfiguration>
כאשר:
STORAGE_CLASSהוא סוג האחסון שמוגדר כברירת מחדל בקטגוריה. לדוגמה,STANDARD.
BUCKET_LOCATIONהוא המיקום שבו רוצים לאחסן את נתוני האובייקטים של הקטגוריה. לדוגמה,U-FRANCE-EAST1.
משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט XML:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.s3nsapis.fr/BUCKET_NAME"
כאשר:
-
XML_FILE_NAMEהוא השם של קובץ ה-XML שיצרתם בשלב 2. -
PROJECT_IDהוא מזהה הפרויקט שאליו הקטגוריה תשויך. לדוגמה,my-project. -
BUCKET_NAMEהוא השם שרוצים לתת לקטגוריה, בכפוף לדרישות למתן שמות. לדוגמה:my-bucket.
כשהבקשה מסתיימת בהצלחה, לא מוחזרת תגובה.
-
המאמרים הבאים
- הצגת רשימה של הקטגוריות בפרויקט.
- הסבר על המטא-נתונים המשויכים לקטגוריה.
- העברת קטגוריה או שינוי השם שלה
- מחיקת קטגוריה.
- העלאת אובייקט לקטגוריה.
- יצירה והגדרה של קטגוריות באופן הצהרתי באמצעות Kubernetes Config Connector, שמאפשר לכם לתאר משאבים באמצעות הכלים, ממשקי ה-API וההגדרות של Kubernetes. Cloud de Confiance by S3NS מידע נוסף זמין במאמרי העזרה של Config Connector API.