בדף הזה מוסבר איך ליצור קטגוריה של Cloud Storage. אם לא צוין אחרת בבקשה, קטגוריות נוצרות עם סוג האחסון (storage class) Standard Storage שמוגדר כברירת מחדל, ועם משך שמירה של שבעה ימים למחיקה זמנית.
אם אתם יוצרים קטגוריה בפעם הראשונה, כדאי לעיין במאמר אחסון אובייקטים באמצעות מסוף 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.
ממלאים את פרטי הקטגוריה בדף Create a bucket. אחרי כל אחד מהשלבים הבאים, לוחצים על Continue כדי להמשיך לשלב הבא:
-
בקטע Get started (תחילת העבודה), מבצעים את הפעולות הבאות:
-
מזינים שם ייחודי בהיקף גלובלי שעומד בקריטריונים לשמות של קטגוריות.
-
כדי להוסיף תווית של דלי, לוחצים על חץ ההרחבה כדי להרחיב את הקטע Labels (תוויות), לוחצים על add_box Add label (הוספת תווית) ומציינים
keyו-valueבשביל התווית.
-
-
בקטע Choose where to store your data מבצעים את הפעולות הבאות:
-
בוחרים סוג מיקום.
-
בתפריט הנפתח של סוג המיקום, בוחרים מיקום שבו נתוני האובייקטים בקטגוריה יישמרו באופן קבוע.
-
אם בוחרים את סוג המיקום בשני אזורים, אפשר גם להפעיל רפליקציה בקצב טורבו באמצעות תיבת הסימון הרלוונטית.
-
-
-
בקטע Choose how to store your data, מבצעים את הפעולות הבאות:
-
בוחרים default storage class לקטגוריה או Autoclass לניהול אוטומטי של סוג האחסון (storage class) של נתוני הקטגוריה.
-
בקטע Optimize storage for data-intensive workloads:
-
כדי להפעיל מרחב שמות היררכי, בוחרים באפשרות Enable Hierarchical namespace on this bucket.
- כדי להפעיל את Rapid Cache, בוחרים באפשרות Enable Rapid Cache ופועלים לפי השלבים הבאים:
-
כדי ליצור מטמונים, לוחצים על הגדרה.
-
בתיבת הדו-שיח הגדרת הגדרות מטמון שמופיעה, לוחצים על החץ לתפריט הנפתח לצד האזורים שמופיעים ברשימה ובוחרים את האזורים שבהם רוצים ליצור מטמונים.
-
לוחצים על סיום.
-
-
-
-
בקטע Choose how to control access to objects:
-
בוחרים אם הקטגוריה אוכפת מניעת גישה ציבורית.
-
בוחרים מודל בקרת גישה לאובייקטים של הקטגוריה. מומלץ לבחור באפשרות Uniform כדי להפעיל גישה אחידה ברמת הקטגוריה.
-
כדי להגדיר סינון לפי כתובת IP עבור הקטגוריה:
בקטע IP filtering, לוחצים על Configure.
-
כדי לאפשר גישה מכתובות IP ציבוריות:
- לוחצים על אינטרנט ציבורי.
-
בשדה Allowed IP range(s), מציינים טווח אחד או יותר של כתובות IPv4 או טווחי CIDR של IPv6 שרוצים לאפשר. לדוגמה,
192.0.2.0/24או2001:db8::/32.כדי לא לאבד את הגישה לדלי, צריך לכלול את כתובת ה-IP שלכם.
-
כדי לאפשר גישה מרשתות VPC:
- לוחצים על VPC network(s) (רשתות VPC).
-
מבצעים את הפעולות הבאות לכל רשת:
- לוחצים על Add VPC network.
-
בקטע New VPC network (רשת VPC חדשה), מציינים את הפרטים הבאים:
- בשדה Project ID, מזינים את מזהה הפרויקט.
- בשדה שם הרשת, מזינים את שם הרשת.
-
בשדה Allowed IP range(s) (טווח כתובות IP מותרות), מזינים טווח CIDR אחד או יותר של IPv4 או IPv6, כמו
192.0.2.0/24או2001:db8::/32.כדי שלא תיחסמו מהבאקט, צריך לכלול את כתובת ה-IP שלכם.
- לוחצים על סיום.
-
כדי לאפשר לסוכני שירות מהימנים Cloud de Confiance ולרשתות VPC מארגונים אחרים לעקוף את ההגדרה של סינון כתובות ה-IP, צריך לבצע את הפעולות הבאות:
- לוחצים על הגדרות נוספות.
-
בקטע Google Cloud service agent access, בוחרים באחת מהאפשרויות הבאות:
- Allow service agent access: מאפשר לשירותים של Cloud de Confiance כמו BigLake, Storage Insights, Vertex AI ו-BigQuery לעקוף את אימות סינון ה-IP כשהם צריכים לגשת לקטגוריה הזו.
- דחיית הגישה של סוכני שירות: אוכפת את כללי סינון כתובות ה-IP עבור סוכני שירות של Cloud de Confiance .
- בקטע Cross-organization VPC access, מבצעים אחת מהפעולות הבאות:
- כדי לאפשר גישה מרשתות VPC ספציפיות שנמצאות בארגונים Cloud de Confiance שונים, לוחצים על המתג למצב Allow (אישור).
- כדי לחסום את הגישה מרשתות VPC מחוץ לארגון ב- Cloud de Confiance , לוחצים על המתג כדי להעביר אותו למצב דחייה (מצב ברירת המחדל).
- לוחצים על בדיקה ואז על שמירה.
-
-
בקטע Choose how to protect object data:
-
בוחרים את האפשרויות שרוצים להגדיר לקטגוריה בקטע הגנה על נתונים.
-
כדי לשנות את משך הזמן שבו האובייקטים נשמרים אחרי המחיקה באמצעות מחיקה רכה, מסמנים את התיבה Soft delete policy ובוחרים באפשרות Set custom retention duration. לאחר מכן, מציינים את משך הזמן שרוצים לשמור אובייקטים שנמחקו.
כדי להשבית את המחיקה הרכה, למשל אם הקטגוריה תכיל בעיקר נתונים זמניים לטווח קצר, מבטלים את הסימון בתיבה המדיניות בנושא מחיקת נתונים רכה.
-
כדי לבחור איך להצפין את נתוני האובייקט, לוחצים על החץ להרחבה שנקרא Data encryption ומבצעים את הפעולות הבאות:
- בקטע Default encryption key type, בוחרים את מפתח ההצפנה שמוגדר כברירת מחדל לקטגוריה. אם בוחרים באפשרות Cloud KMS key, צריך לספק מפתח של Cloud Key Management Service.
- בקטע Encryption enforcement rules, בשדה Key types בוחרים אילו סוגי הצפנה לאפשר או להגביל לאובייקטים חדשים בקטגוריה.
-
-
לוחצים על יצירה.
במאמר פתרון בעיות מוסבר איך מקבלים מידע מפורט על שגיאות בנושא פעולות ב-Cloud Storage שנכשלו במסוף Cloud de Confiance .
שורת הפקודה
-
מפעילים את Cloud Shell במסוף Cloud de Confiance .
בחלק התחתון של 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, שמאפשר לתאר משאבי Cloud de Confiance by S3NS באמצעות הכלים, ממשקי ה-API וההגדרות של Kubernetes. מידע נוסף זמין במאמרי העזרה של Config Connector API.