בדף הזה מוסבר איך לקרוא נתוני אובייקטים מהקטגוריות של Cloud Storage ישירות לזיכרון של האפליקציה, או באופן אינטראקטיבי בדפדפן האינטרנט או במסוף של שורת הפקודה. מומלץ לקרוא אובייקטים לזיכרון או באופן אינטראקטיבי כשרוצים להעביר בסטרימינג, לבדוק או לעבד נתונים באופן שמונע את התקורה של מעבד, קלט/פלט של דיסק וחביון שקשורים לכתיבת קבצים למערכת קבצים מקומית קבועה.
הוראות להורדת אובייקטים לאחסון מתמיד או לאחסון מקומי מופיעות במאמר הורדת אובייקטים. סקירה כללית של מושגים בנושא קריאות והורדות של אובייקטים מופיעה במאמר קריאות והורדות של אובייקטים.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לקריאת נתוני אובייקטים, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:
- צפייה באובייקט אחסון (
roles/storage.objectViewer) בקטגוריה - אדמין של אחסון (
roles/storage.admin) בפרויקט (נדרש רק לקריאת נתוני אובייקט באמצעות Cloud de Confiance המסוף)
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקיד 'צפייה באובייקט אחסון' (roles/storage.objectViewer) כולל את ההרשאה storage.objects.get, שנדרשת לקריאת אובייקטים. התפקיד Storage Admin (roles/storage.admin) מכיל את ההרשאות storage.buckets.list ו-storage.buckets.get, בנוסף להרשאה storage.objects.get. ההרשאות האלה נדרשות כדי להציג את רשימת הקטגוריות בפרויקט ולראות מידע על הקטגוריות. התפקיד 'אדמין לניהול אחסון' (roles/storage.admin) שכולל את ההרשאות האלה נדרש רק כשרוצים לקרוא אובייקטים באופן אינטראקטיבי באמצעות מסוף Cloud de Confiance .
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים בקטגוריות.
קריאת אובייקטים לזיכרון באופן פרוגרמטי
בקטע הזה מוסבר איך לקרוא נתוני אובייקט על ידי סטרימינג של בייטים של האובייקט ישירות לזיכרון האפליקציה.
ספריות לקוח
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
קריאת אובייקטים באופן אינטראקטיבי
בקטע הזה מוסבר איך לקרוא אובייקטים באופן אינטראקטיבי בCloud de Confiance חלון הדפדפן של המסוף או במסוף של שורת הפקודהstdout.
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על השם של הקטגוריה שאת התוכן שלה רוצים לראות.
בכרטיסייה Objects, לוחצים על שם האובייקט שרוצים לקרוא.
בדף Object details, לוחצים על כתובת ה-URL הציבורית או על כתובת ה-URL עם האימות של האובייקט כדי לקרוא את הנתונים שלו.
שורת הפקודה
כדי להזרים את מטען הבייטים של אובייקט ישירות לטרמינל stdout, משתמשים בפקודה gcloud storage cat:
gcloud storage cat gs://BUCKET_NAME/OBJECT_NAME
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: השם של הקטגוריה שמכילה את האובייקט שרוצים לקרוא. לדוגמה,my-bucket.
OBJECT_NAME: השם של האובייקט שרוצים לקרוא. לדוגמה,dog.png.
ממשקי API ל-REST
כדי לקרוא את הבייטים של אובייקט ולהפנות את זרם הפלט למסוף שלכם
stdout, פועלים לפי ההוראות הבאות.
API בפורמט JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשתobjects.getשכוללת את האפשרות-o -ואת פרמטר השאילתהalt=media:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o - \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את האובייקט שרוצים לקרוא. לדוגמה,my-bucket.
OBJECT_NAME: השם של האובייקט שרוצים לקרוא, בקידודי תווים שמתאימים לכתובות URL. לדוגמה,pets/dog.pngיותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא:pets%2Fdog.png.
API בפורמט XML
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט XML באמצעות בקשת אובייקטGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: השם של הקטגוריה שמכילה את האובייקט שרוצים לקרוא. לדוגמה,my-bucket.
OBJECT_NAME: השם של האובייקט שרוצים לקרוא, בקידודי תווים שמתאימים לכתובות URL. לדוגמה,pets/dog.pngיותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא:pets%2Fdog.png.