בדף הזה מוסבר איך להוריד אובייקטים מהקטגוריות שלכם ב-Cloud Storage לאחסון מתמיד. אפשר גם להוריד אובייקטים לזיכרון.
התפקידים הנדרשים
כדי לקבל את ההרשאות הנדרשות להורדת אובייקטים, צריך לבקש מהאדמין להקצות לכם את התפקיד 'צפייה באובייקט אחסון' (roles/storage.objectViewer) בקטגוריה. אם אתם מתכננים להשתמש במסוףCloud de Confiance , אתם צריכים לבקש מהאדמין להקצות לכם את התפקיד 'אדמין לניהול אחסון' (roles/storage.admin) בקטגוריה.
התפקידים האלה מכילים את ההרשאות שנדרשות להורדת אובייקטים. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
storage.buckets.list- ההרשאה הזו נדרשת רק כדי להשתמש במסוף Cloud de Confiance כדי לבצע את המשימות שמתוארות בדף הזה.
storage.objects.getstorage.objects.list- ההרשאה הזו נדרשת רק כדי להשתמש במסוף Cloud de Confiance כדי לבצע את המשימות שמתוארות בדף הזה.
יכול להיות שתוכלו לקבל את ההרשאות האלה גם בתפקידים מוגדרים מראש או בתפקידים בהתאמה אישית אחרים.
במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים בקטגוריות.
הורדת אובייקט מקטגוריה
להורדת אובייקט מקטגוריה:
המסוף
- במסוף Cloud de Confiance , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את האובייקט שרוצים להוריד.
הדף Bucket details נפתח עם הכרטיסייה Objects שנבחרה.
עוברים אל האובייקט, שעשוי להיות בתיקייה.
לוחצים על הסמל Download שמשויך לאובייקט.
מיקום ההורדה של האובייקט נקבע לפי הגדרות הדפדפן.
במאמר פתרון בעיות מוסבר איך מקבלים מידע מפורט על שגיאות בנושא פעולות ב-Cloud Storage שנכשלו במסוף Cloud de Confiance .
שורת הפקודה
משתמשים בפקודה gcloud storage cp:
gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
כאשר:
BUCKET_NAMEהוא שם הקטגוריה שמכילה את האובייקט שאתם מורידים. לדוגמה,my-bucket.
OBJECT_NAMEהוא שם האובייקט שמורידים. לדוגמה,pets/dog.png.
SAVE_TO_LOCATIONהוא הנתיב המקומי שבו שומרים את האובייקט. לדוגמה,Desktop/Images.
אם הפעולה בוצעה ללא שגיאות, התגובה אמורה להיות דומה לדוגמה הבאה:
Completed files 1/1 | 164.3kiB/164.3kiB
אם ההורדה נעצרה לפני שהסתיימה, מריצים את אותה פקודת cp כדי להמשיך את ההורדה מהמקום שבו היא נעצרה.
ספריות לקוח
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.
ממשקי API ל-REST
API ל-JSON
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של אובייקטGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
כאשר:
-
SAVE_TO_LOCATIONהוא הנתיב למיקום שבו רוצים לשמור את האובייקט. למשל,Desktop/dog.png. -
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)" \ -o "SAVE_TO_LOCATION" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
כאשר:
-
SAVE_TO_LOCATIONהוא הנתיב למיקום שבו רוצים לשמור את האובייקט. למשל,Desktop/dog.png. -
BUCKET_NAMEהוא שם הקטגוריה שמכילה את האובייקט שאתם מורידים. לדוגמה,my-bucket. -
OBJECT_NAMEהוא השם של האובייקט שמורידים, בקידודי תווים שמתאימים לכתובות URL. לדוגמה,pets/dog.pngיותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא:pets%2Fdog.png.
-
כדי להוריד בצורה יעילה יותר את כל האובייקטים בקטגוריה או בספריית משנה, משתמשים בפקודה gcloud storage cp או בספריית לקוח:
gcloud storage cp --recursive gs://BUCKET_NAME/FOLDER_NAME .
הורדת חלק של אובייקט
אם ההורדה נעצרה לפני שהסתיימה, תוכלו לבקש להוריד רק את החלק מהאובייקט שעוד לא ירד כדי להמשיך מהמקום שבו היא נעצרה. כדי להוריד חלק מאובייקט:
המסוף
במסוף Cloud de Confiance אין תמיכה בהורדת חלקים של אובייקט. במקום זאת, צריך להשתמש ב-CLI של gcloud.
שורת הפקודה
Google Cloud CLI מנסה באופן אוטומטי להמשיך הורדות שנקטעו, חוץ מאשר במקרים של הורדות בסטרימינג. אם ההורדה נקטעת, קובץ זמני שירד באופן חלקי יופיע בהיררכיית היעד. צריך להריץ את אותה פקודת cp כדי להמשיך את ההורדה מהנקודה שבה היא נעצרה.
בסיום ההורדה, הקובץ הזמני נמחק ומוחלף בתוכן שהורדתם. הקבצים הזמניים מאוחסנים כברירת מחדל בספריית הבית של המשתמש בניתוב .config/gcloud/surface_data/storage/tracker_files, אבל אתם יכולים לשנות את הגדרת המיקום. אפשר להריץ את הפקודה gcloud config get storage/tracker_files_directory כדי לראות את המיקום שבו מאוחסנים הקבצים הזמניים או לשנות אותו.
ספריות לקוח
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.
ממשקי API ל-REST
API בפורמט JSON
כדי להוריד חלק של אובייקט, צריך להשתמש בכותרת Range בבקשה.
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של אובייקטGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
כאשר:
-
FIRST_BYTEהוא הבייט הראשון בטווח הבייטים שרוצים להוריד. לדוגמה,1000. -
LAST_BYTEהוא הבייט האחרון בטווח הבייטים שרוצים להוריד. לדוגמה,1999. -
SAVE_TO_LOCATIONהוא הנתיב למיקום שבו רוצים לשמור את האובייקט. למשל,Desktop/dog.png. -
BUCKET_NAMEהוא שם הקטגוריה שמכילה את האובייקט שאתם מורידים. לדוגמה,my-bucket. -
OBJECT_NAMEהוא השם של האובייקט שמורידים, בקידודי תווים שמתאימים לכתובות URL. לדוגמה,pets/dog.pngיותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא:pets%2Fdog.png.
-
API בפורמט XML
כדי להוריד חלק של אובייקט, צריך להשתמש בכותרת Range בבקשה.
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט XML באמצעות בקשת אובייקטGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
כאשר:
-
FIRST_BYTEהוא הבייט הראשון בטווח הבייטים שרוצים להוריד. לדוגמה,1000. -
LAST_BYTEהוא הבייט האחרון בטווח הבייטים שרוצים להוריד. לדוגמה,1999. -
SAVE_TO_LOCATIONהוא הנתיב למיקום שבו רוצים לשמור את האובייקט. למשל,$HOME/Desktop/dog.png. -
BUCKET_NAMEהוא שם הקטגוריה שמכילה את האובייקט שאתם מורידים. לדוגמה,my-bucket. -
OBJECT_NAMEהוא השם של האובייקט שמורידים, בקידודי תווים שמתאימים לכתובות URL. לדוגמה,pets/dog.pngיותאם לקידודי התווים שמתאימים לכתובות URL באופן הבא:pets%2Fdog.png.
-