דף זה מסביר כיצד משנים את סוג האחסון של אובייקט בתוך קטגוריה באמצעות שכתוב האובייקט.
- במאמר ניהול מחזור החיים של אובייקטים מוסבר כיצד לשנות מחלקות של אחסון אובייקטים בלי לשכתב אובייקטים.
- במאמר התכונה Autoclass מוסבר כיצד אפשר לנהל באופן אוטומטי את מחלקות האחסון של האובייקטים ב-Cloud Storage.
ההרשאות הנדרשות
מסוף
אי אפשר להגדיר סוג אחסון של אובייקטים בודדים דרך מסוף Google Cloud. במקום זאת, השתמשו בשורת הפקודה.
שורת הפקודה
על מנת להשלים את המדריך באמצעות כלי שורת הפקודה, דרושות הרשאות IAM מתאימות. אם האובייקט שאליו אתם רוצים לגשת נמצא בפרויקט שלא אתם יצרתם, יכול להיות שתצטרכו לבקש מבעלי הפרויקט לתת לכם תפקיד עם ההרשאות הנדרשות.
לרשימת ההרשאות הנדרשות לפעולות ספציפיות, קראו את המאמר הרשאות IAM לפקודות gsutil.
רשימת התפקידים הרלוונטיים מופיעה במאמר תפקידים ב-Cloud Storage. לחלופין, אפשר ליצור תפקיד בהתאמה אישית עם הרשאות ספציפיות ומוגבלות.
ספריות לקוח
על מנת להשלים את המדריך בספריות הלקוח של Cloud Storage, אתם צריכים הרשאות IAM מתאימות. אם האובייקט שאליו אתם רוצים לגשת נמצא בפרויקט שלא אתם יצרתם, יכול להיות שתצטרכו לבקש מבעלי הפרויקט לתת לכם תפקיד שמכיל את ההרשאות הנדרשות.
אם לא צוין אחרת, בקשות לספריית לקוח נשלחות דרך API ב-JSON ומחייבות את ההרשאות שמפורטות בהרשאות IAM עבור שיטות JSON. כדי לראות אילו שיטות של API ב-JSON מופעלות כששולחים בקשות באמצעות ספריית לקוח, צריך לרשום ביומן את הבקשות הגולמיות.
במאמר התפקידים ב-Cloud Storage מופיעה רשימת התפקידים הרלוונטיים ב-IAM. לחלופין, אפשר ליצור תפקיד בהתאמה אישית עם הרשאות ספציפיות ומוגבלות.
ממשקי API ל-REST
ב-API מסוג JSON:
על מנת להשלים את המדריך באמצעות API ב-JSON, אתם צריכים הרשאות IAM מתאימות. אם האובייקט שאתם רוצים לקבל גישה אליו נמצא בפרויקט שלא אתם יצרתם, יכול להיות שתצטרכו לבקש מבעלי הפרויקט לתת לכם תפקיד שמכיל את ההרשאות הנדרשות.
לרשימת ההרשאות הדרושות לפעולות ספציפיות, ראו את המאמר הרשאות IAM עבור שיטות JSON.
רשימת התפקידים הרלוונטיים מופיעה במאמר תפקידים ב-Cloud Storage. לחלופין, אפשר ליצור תפקיד בהתאמה אישית עם הרשאות ספציפיות ומוגבלות.
שינוי סיווג אחסון האובייקט
על מנת לשנות את סיווג האחסון של אובייקט, יש לבצע את השלבים הבאים:
מסוף
אי אפשר להגדיר סוג אחסון של אובייקטים בודדים דרך מסוף Google Cloud. במקום זאת, השתמשו בשורת הפקודה.
שורת הפקודה
gcloud
השתמש בפקודה gcloud storage objects update
עם הדגל --storage-class
. לדוגמה:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --storage-class=STORAGE_CLASS
כאשר:
BUCKET_NAME
שם הקטגוריה שמכילה את האובייקט שאת המחלקה שלו רוצים לשנות. לדוגמה,my-bucket
.OBJECT_NAME
זהו שם האובייקט שאת המחלקה שלו רוצים לשנות. לדוגמה,pets/dog.png
STORAGE_CLASS
הוא סוג האחסון החדש של האובייקט. לדוגמה,nearline
gsutil
השתמש בדגל -s
בפקודה gsutil rewrite
. לדוגמה:
gsutil rewrite -s STORAGE_CLASS gs://BUCKET_NAME/OBJECT_NAME
כאשר:
STORAGE_CLASS
הוא סוג האחסון החדש של האובייקט. לדוגמה,nearline
BUCKET_NAME
שם הקטגוריה שמכילה את האובייקט שאת המחלקה שלו רוצים לשנות. לדוגמה,my-bucket
.OBJECT_NAME
זהו שם האובייקט שאת המחלקה שלו רוצים לשנות. לדוגמה,pets/dog.png
ספריות לקוח
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
למידע נוסף, ניתן לקרוא את מסמכי העזר של ה- API Javaב-Cloud Storage.
כדי לבצע אימות ב-Cloud Storage, צריך להגדיר אתApplication Default Credentials. למידע נוסף, ראו הגדרת אימות עבור סביבת פיתוח מקומית.
Node.js
למידע נוסף, ניתן לך לקרוא את חומרי העזר של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, צריך להגדיר אתApplication Default Credentials. למידע נוסף, ראו הגדרת אימות עבור סביבת פיתוח מקומית.
PHP
למידע נוסף, ניתן לקרוא את מסמכי העזר של ה- API PHPב-Cloud Storage.
כדי לבצע אימות ב-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:
- מקבלים אסימון גישה להרשאה מ-OAuth 2.0 Playground. מגדירים את ה-Playground לשימוש בפרטי כניסה משלכם ל-OAuth. ההוראות מפורטות במאמר אימות API.
ליצור קובץ JSON שמכיל את הפרטים הבאים:
{ "storageClass": "STORAGE_CLASS" }
כאשר:
STORAGE_CLASS
הוא סוג האחסון החדש של האובייקט. לדוגמה,nearline
השתמש ב-
cURL
על מנת להפעיל אתJSON API עם אובייקטPOST
, מבקשים:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME/rewriteTo/b/BUCKET_NAME/o/OBJECT_NAME"
כאשר:
JSON_FILE_NAME
הוא הנתיב לקובץ ה-JSON שיצרת בשלב 2.OAUTH2_TOKEN
הוא אסימון הגישה שיצרתם בשלב 1.BUCKET_NAME
זהו שם הקטגוריה שמכילה את האובייקט המקורי. לדוגמה:my-bucket
.OBJECT_NAME
הוא שם האובייקט עם קידוד כתובת URL. לדוגמה,pets/dog.png
, כתובת ה-URL מקודדת בצורהpets%2Fdog.png
.
ממשק API בשפת XML
- מקבלים אסימון גישה להרשאה מ-OAuth 2.0 Playground. מגדירים את ה-Playground לשימוש בפרטי כניסה משלכם ל-OAuth. ההוראות מפורטות במאמר אימות API.
משתמשים ב-
cURL
על מנת לקרוא ל-API ב-XML באמצעות בקשת אובייקטPUT
:curl -X PUT --data-binary @OBJECT \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: OBJECT_CONTENT_TYPE" \ -H "x-goog-storage-class: STORAGE_CLASS" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
כאשר:
OBJECT
הוא הנתיב המקומי לאובייקט שאת סוג האחסון שלו רוצים לשנות (צריך להעלות מחדש את האובייקט באמצעות ה-API ב-XML כשמשנים את סוג האחסון). למשל,Desktop/dog.png
.OAUTH2_TOKEN
הוא אסימון הגישה שיצרתם בשלב 1.OBJECT_CONTENT_TYPE
הוא סוג התוכן של האובייקט. לדוגמה,image/png
STORAGE_CLASS
הוא סוג האחסון החדש של האובייקט. לדוגמה,nearline
BUCKET_NAME
הוא שם הקטגוריה שמכילה את האובייקט שאתם כותבים. לדוגמה,my-bucket
.OBJECT_NAME
הוא השם עם קידוד כתובת ה-URL של האובייקט שאתם כותבים. לדוגמה,pets/dog.png
, כתובת ה-URL מקודדת בצורהpets%2Fdog.png
.
המאמרים הבאים
- למידע נוסף על סוגי אחסון זמינים.
- שינוי סוג האחסון של אובייקטים באמצעות ניהול מחזור החיים של אובייקטים.
- תכונות נוספות של מחזור החיים של הנתונים ב-Cloud Storage.
- מידע נוסף על מטא-נתונים של אובייקט.
- בקישור הבא מוסבר איך להשתמש בבקשת תנאים מוקדמים על מנת למנוע מרוץ תהליכים.