בדף הזה מוסבר איך לנהל משימות ופעולות העברה קיימות.
כדי ליצור משימת העברה חדשה, אפשר לעיין במאמר יצירת העברות.
עריכה של הגדרות העברה
אפשר לערוך את המאפיינים הבאים של העברה קיימת:
- תיאור משימת ההעברה
- פרטי כניסה למקור ב-Microsoft Azure Blob Storage או ב-Amazon S3
- מסננים שהוחלו על משימת ההעברה
- אפשרויות להחלפה או למחיקה של קבצים
- לוח הזמנים של משימת ההעברה
CLI של gcloud
כדי לערוך הגדרת העברה קיימת, משתמשים בפקודה gcloud transfer jobs update.
gcloud transfer jobs update \
JOB_NAME \
[options]
אלה המשתנים:
JOB_NAME הוא השם הייחודי של המשימה שרוצים לעדכן.
כדי לראות את האפשרויות שאפשר לעדכן, מריצים את הפקודה
gcloud transfer jobs update --help.
לדוגמה, כדי לעדכן את המקור והיעד של משימה ולהסיר את התיאור שלה, מריצים את הפקודה הבאה:
gcloud transfer jobs update \
JOB_NAME \
--source=gs://new-bucket-1 \
--destination=gs://new-bucket-2 \
--clear-description
מסוף Google Cloud
כדי לערוך משימת העברה, מבצעים את הפעולות הבאות:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של משימת ההעברה. הדף Job details מוצג.
לוחצים על הגדרה. ההגדרות של משימת ההעברה מוצגות.
כדי לשנות פריט, לוחצים על עריכה לצד הפריט.
כדי להתחיל משימה עם השינויים, לוחצים על התחלת הרצה.
REST
כדי לערוך הגדרות העברה, משתמשים ב-method transferJobs.patch.
הרצה של משימת העברה מהגדרות קיימות
אתם יכולים להריץ משימת העברה קיימת. כך אפשר להתחיל משימות שלא מתוזמנות, או להתחיל משימה מחוץ ללוח הזמנים שלה.
CLI של gcloud
כדי להריץ העברה מהגדרה קיימת, משתמשים ב-gcloud transfer jobs run:
gcloud transfer jobs run JOB_NAME
אפשר לציין את הדגל האופציונלי --no-async כדי לחסום משימות אחרות במסוף עד להשלמת פעולת ההעברה.
מסוף Google Cloud
כדי להפעיל העברה מהגדרה קיימת:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של משימת ההעברה. הדף Job details מוצג.
כדי להתחיל משימת העברה, לוחצים על Start a run.
REST
כדי להריץ משימת העברה, משתמשים ב-method transferJobs.run.
מעקב אחרי משימת העברה
CLI של gcloud
כדי לעקוב אחרי ההתקדמות של משימה בזמן אמת, משתמשים ב-gcloud transfer jobs monitor.
gcloud transfer jobs monitor JOB_NAME
התגובה מציגה את הפעולה הנוכחית, את שעת ההתחלה של המשימה ואת כמות הנתונים שהועברו. גם בייטים שדילגתם עליהם ושגיאות נספרים.
Cloud Monitoring
במאמר מעקב אחרי משימות העברה מוסבר איך משתמשים ב-Cloud Monitoring עם Storage Transfer Service.
הצגת פרטי משימת ההעברה
CLI של gcloud
כדי לראות את פרטי משימת ההעברה, משתמשים ב-gcloud transfer jobs describe:
gcloud transfer jobs describe JOB_NAME
כדי לראות את הפעולה האחרונה של המשימה, מעבירים את הערך של latestOperationName לפקודה operations describe:
gcloud transfer operations describe OPERATION_NAME
כדי להציג את כל פעולות ההעברה של משימה, משתמשים בפקודה gcloud transfer operations list:
gcloud transfer operations list --job-names=JOB_NAME
כדי להציג פעולות של כמה משימות, אפשר להזין אותן כרשימה מופרדת בפסיקים בתור הערך של --job-names. משמיטים את --job-names כדי להציג פעולות של כל המשימות.
מסוף Google Cloud
אפשר לראות את פרטי המשימה הבאים במסוף Google Cloud :
- השם ותיאור המשרה
- סוג המקור והמיקום שלו
- מיקום היעד
- תדירות המשימה
- נתונים סטטיסטיים של המשימה
כדי לראות את פרטי משימת ההעברה:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של משימת ההעברה. הדף Job details מוצג.
כדי להציג את הפרטים של הרצה מסוימת, לוחצים על שעת התחלה של הרצת המשימה. אלה פרטי המשרה שזמינים:
- סטטוס ההעברה
- שעות התחלה וסיום
- משך
- התקדמות
- הנתונים הועברו
- מספר השגיאות
- נתונים שהמערכת דילגה עליהם
- הערכת מהירות ממוצעת
REST
כדי לראות את הפרטים של משימת העברה, משתמשים ב-method transferJobs.get כדי להחזיר מידע על משימת העברה ספציפית, כמו מזהה הפעולה שלה.
ספריות לקוח
כשמשתמשים ב-transferJobs.create, מוחזר משאב TransferJob.
אחרי שיוצרים את המשימה, אפשר לבדוק את סטטוס ההעברה באמצעות transferJobs.get. אם הפעולה של משימת ההעברה התחילה, הפונקציה מחזירה TransferJob שמכיל שדה latestOperationName מאוכלס. אחרת, אם הפעולה של משימת ההעברה לא התחילה, השדה latestOperationName ריק.
כדי לבדוק את הסטטוס של משימת העברה
REST
בקשה באמצעות transferJobs.get:GET https://storagetransfer.googleapis.com/v1/transferJobs/JOB_NAME?projectId=PROJECT_ID
המשך
Java
מחפשים דוגמאות ישנות יותר? המדריך להעברת נתונים (מיגרציה) של Storage Transfer Service
Node.js
Python
מחפשים דוגמאות ישנות יותר? המדריך להעברת נתונים (מיגרציה) של Storage Transfer Service
השהיה של משימת העברה
אתם יכולים להשהות העברה שמתבצעת כרגע. כשמשהים את ההעברה, מצב המשימה נשמר ואפשר לבטל את ההשהיה מאוחר יותר. כשההעברה מושהית, לוח הזמנים לא יפעיל את המשימה שוב.
CLI של gcloud
כדי להשהות משימת העברה, מעבירים את שם הפעולה הנוכחי של המשימה אל gcloud transfer operations pause.
gcloud transfer operations pause OPERATION_NAME
כדי להמשיך משימת העברה שהושהתה, ולהפעיל אותה מחדש מאותה נקודה שבה היא הושהתה, משתמשים ב-gcloud transfer operations resume.
gcloud transfer operations resume OPERATION_NAME
מסוף Google Cloud
כדי להשהות משימת העברה:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של משימת ההעברה. הדף Job details מוצג.
לוחצים על השהיית ההרצה. הסטטוס של הפעולה הנוכחית מוצג כ-Paused.
כדי להמשיך משימת העברה שהושהתה, ולהפעיל אותה מחדש מאותה נקודה שבה היא הושהתה, פועלים לפי השלבים הבאים.
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של משימת ההעברה. הדף Job details מוצג.
לוחצים על המשך ההרצה.
הסטטוס של הפעולה הנוכחית מוצג כבתהליך.
REST
כדי להשהות משימת העברה, משתמשים ב-method transferOperations.pause.
השבתה של משימת העברה
השבתה של משימת העברה מונעת ממנה להתחיל פעולות מתוזמנות נוספות, או פעולות שהופעלו ידנית מהמסוף. היא לא מונעת הפעלה ידנית של משימה באמצעות ה-API או באמצעות הפקודה jobs run gcloud.
CLI של gcloud
כדי להשבית משימת העברה, מעדכנים את הסטטוס של המשימה ל-disabled.
gcloud transfer jobs update JOB_NAME --status=disabled
כדי להפעיל מחדש משימה, מגדירים את --status=enabled.
מסוף Google Cloud
כדי להשבית משימת העברה:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של משימת ההעברה. הדף Job details מוצג.
לוחצים על Disable job. מופיעה תיבת הדו-שיח Disable transfer job?.
קוראים את תיבת הדו-שיח ולוחצים על Confirm כדי לאשר את השבתת המשימה.
בחלק העליון של הדף Job details מופיעה הודעה שמזכירה שהמשימה מושבתת.
REST
משתמשים ב-method transferJobs.patch כדי להגדיר את ה-status של משימת ההעברה ל-DISABLED.
מחיקה של משימת העברה
אתם יכולים למחוק משימות העברה שאתם לא צריכים יותר. כשמוחקים משימה:
- עוצרת את כל ההעברות הקיימות שהן חלק מהמשימה.
- הפעולה הזו מפסיקה את כל ההעברות החוזרות שהן חלק מהמשימה.
- מוחק את פרטי ההגדרות של המשימה.
אי אפשר לבטל מחיקה של משימה. אחרי שמוחקים את משימת ההעברה, היא מוסרת מרשימת משימות ההעברה. פרטי משימת ההעברה נמחקים לגמרי מ-Storage Transfer Service אחרי 30 יום.
לחלופין, אפשר להשבית את משימת ההעברה, כך שהמשימה תישאר רשומה בדף Jobs ותוכלו להפעיל אותה מחדש או לשנות אותה.
CLI של gcloud
כדי למחוק משימת העברה, משתמשים ב-gcloud transfer jobs delete.
gcloud transfer jobs delete JOB_NAME
מסוף Google Cloud
כדי למחוק משימת העברה:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
מסמנים את התיבה לצד משימת ההעברה שרוצים למחוק.
לוחצים על מחיקת המשרה.
מופיעה תיבת הדו-שיח Delete transfer job?.
קוראים את תיבת הדו-שיח, מאשרים את מחיקת המשימה על ידי הקלדת השם שהוקצה לה באופן אוטומטי בשדה, ולוחצים על Delete.
המשימה תוסר מהדף Jobs.
REST
כדי למחוק משימת העברה באמצעות ה-API בארכיטקטורת REST, עיינו במאמר העזר transferJobs.delete.
לצפייה בפרטי השגיאה
אם נתקלתם בשגיאות במהלך הרצת העברה, אתם יכולים לראות את פרטי השגיאה כדי לפתור אותה.
כדי לראות את פרטי השגיאה של הרצת משימת העברה:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של משימת ההעברה. הדף Job details מוצג.
כדי להציג את פרטי המשימה, מבצעים אחת מהפעולות הבאות:
הפעלת המשימה האחרונה: לוחצים על הכפתור See error details או על הקישור View error details. הדף Error details נפתח.
היסטוריית הרצת המשימות:
לוחצים על שעת התחלה של הרצת המשימה.
הדף Run details מוצג.
לוחצים על הקישור הצגת פרטי השגיאה.
הדף Error details מוצג.
כדי להציג פרטים נוספים על כל שגיאה שמופיעה, לוחצים על expand_more Expand more.
כדי לסנן שגיאות, מזינים את המאפיינים לסינון בשדה Enter property name or value.
כשמציבים את הסמן בשדה, מוצג תפריט נפתח עם אפשרויות רלוונטיות שיעזרו לכם ליצור את המסנן.