הדף הזה מסביר איך משתמשים במאפיין רפליקציית טורבו בקטגוריה בשני אזורים.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות לשימוש ברפליקציה בקצב טורבו, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM 'אדמין לניהול אחסון' (roles/storage.admin) בקטגוריה.
התפקיד המוגדר מראש הזה מכיל את ההרשאות שנדרשות לשימוש בשכפול טורבו. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
storage.buckets.getstorage.buckets.updatestorage.buckets.list- ההרשאה הזו נדרשת רק אם אתם מתכננים להשתמש במסוףGoogle Cloud כדי לבצע את ההוראות שבדף הזה.
יכול להיות שתוכלו לקבל את ההרשאות האלה גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים בקטגוריות.
הגדרה של רפליקציית טורבו
כדי להפעיל או להשבית רפליקציית טורבו בקטגוריה קיימת, מבצעים את ההוראות הבאות:
המסוף
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על השם של הקטגוריה הרצויה.
לוחצים על הכרטיסייה Configuration.
בשורה Replication לוחצים על Edit.
החלון שמופיע מציין אם עומדים להפעיל רפליקציית טורבו או להשבית רפליקציית טורבו.
לוחצים על Save כדי לאשר את ההגדרה החדשה.
שורת הפקודה
משתמשים בפקודה gcloud storage buckets update עם הדגל --rpo:
gcloud storage buckets update gs://BUCKET_NAME --rpo=STATE
כאשר:
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket.
STATEהואASYNC_TURBOכדי להפעיל רפליקציית טורבו אוDEFAULTכדי להשבית רפליקציית טורבו.
אם הפעולה בוצעה ללא שגיאות, התשובה נראית כך:
Updating gs://my-bucket/... Completed 1
ספריות לקוח
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
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
הדוגמה הבאה מפעילה רפליקציית טורבו בקטגוריה:
הדוגמה הבאה מפעילה רפליקציה שהוגדרה כברירת מחדל בקטגוריה:
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
הדוגמה הבאה מפעילה רפליקציית טורבו בקטגוריה:
הדוגמה הבאה מפעילה רפליקציה שהוגדרה כברירת מחדל בקטגוריה:
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-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
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "rpo": "STATE" }
כאשר
STATEהואASYNC_TURBOלהפעלה של רפליקציית טורבו אוDEFAULTלהשבתה של רפליקציית טורבו.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של קטגורייתPATCH:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
כאשר:
-
JSON_FILE_NAMEהוא הנתיב לקובץ JSON שיצרתם בשלב 2. -
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket.
אם הבקשה מצליחה, לא מוחזרת תשובה.
-
API בפורמט XML
אי אפשר לנהל את המאפיין הזה באמצעות API בפורמט XML. במקום זה, משתמשים ב-API בפורמט JSON.
בדיקת סטטוס הרפליקציה של קטגוריה
כדי לבדוק את היעד להתאוששות מאסון (RPO) או את סטטוס הרפליקציה של קטגוריה, מבצעים את ההוראות הבאות:
המסוף
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שרוצים לאמת.
לוחצים על הכרטיסייה Configuration.
אם מופעלת רפליקציית טורבו בקטגוריה, Replication מוגדרת להיות Turbo.
שורת הפקודה
משתמשים בפקודה gcloud storage buckets describe עם הדגל --format:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(rpo)"
כאשר:
-
BUCKET_NAMEהוא שם הקטגוריה הרלוונטית. לדוגמה,my-bucket.
אם הפעולה בוצעה ללא שגיאות, התגובה אמורה להיות דומה לדוגמה הבאה:
rpo: ASYNC_TURBO
ספריות לקוח
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
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Java API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
Node.js
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage Node.js API.
כדי לבצע אימות ב-Cloud Storage, אתם צריכים להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
PHP
למידע נוסף, קראו את מאמרי העזרה של Cloud Storage PHP API.
כדי לבצע אימות ב-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
התקנה והפעלה של ה-CLI של gcloud, שמאפשרות ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשה של קטגורייתGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=rpo"
כאשר
BUCKET_NAMEהוא השם של הקטגוריה הרלוונטית. לדוגמה,my-bucket.התשובה תיראה כמו בדוגמה הבאה:
{ "name": "my-bucket", "projectNumber": "234...", ... "rpo": "ASYNC_TURBO" }
שימו לב למפתח
rpo. הערךASYNC_TURBOמציין שהופעלה רפליקציית טורבו. DEFAULTמציין שהופעלה הרפליקציה שהוגדרה כברירת המחדל. השדהrpoתמיד מופיע בקטגוריות של שני אזורים או מספר אזורים, אבל הוא חסר בקטגוריות של אזור יחיד.
API בפורמט XML
אי אפשר לנהל את המאפיין הזה באמצעות API בפורמט XML. במקום זה, משתמשים ב-API בפורמט JSON.
המאמרים הבאים
- מידע נוסף על רפליקציית טורבו.
- מידע נוסף על תמחור ברפליקציה בקצב טורבו
- מידע על מדדים למעקב אחרי הביצועים של דלי, כולל ביצועי השכפול.
- כאן אפשר לקרוא איך להשתמש בהתראות של Cloud Monitoring כדי ליצור מדיניות התראות על סמך מדדים שצוינו ולנהל את ההתראות שמשויכות למדדים האלה.