בדף הזה מוסבר איך לנהל משימות והעברות קיימות.
כדי ליצור העברה חדשה, אפשר לעיין במאמר בנושא יצירת העברות.
עריכת הגדרות העברה
אפשר לערוך את המאפיינים הבאים של העברה קיימת:
- תיאור של עבודת ההעברה
- פרטי הכניסה למקור ב-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
כדי לערוך הגדרות של העברה, משתמשים בשיטה 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
כדי להריץ העברת נתונים, משתמשים בשיטה 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
כדי להציג את הפרטים של עבודת העברה, משתמשים בשיטה transferJobs.get כדי להחזיר מידע על עבודת העברה ספציפית, כמו מזהה הפעולה שלה.
ספריות לקוח
משאב TransferJob מוחזר כשמשתמשים ב-transferJobs.create.
אחרי שיוצרים את העבודה, אפשר לבדוק את הסטטוס של ההעברה באמצעות transferJobs.get. אם הפעולה של העברת העבודות התחילה, הפונקציה מחזירה TransferJob עם שדה latestOperationName מאוכלס. אחרת, אם הפעולה של העברת העבודה לא התחילה, השדה latestOperationName יהיה ריק.
כדי לבדוק את הסטטוס של משימת העברה
REST
שליחת בקשה באמצעות transferJobs get:GET https://storagetransfer.googleapis.com/v1/{jobName="name"}
המשך
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
כדי להשהות עבודת העברה, משתמשים בשיטה 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 מוצג.
לוחצים על השבתת העבודה. מופיעה תיבת הדו-שיח להשבית את עבודת ההעברה?.
קוראים את תיבת הדו-שיח ולוחצים על אישור כדי לאשר את השבתת המשרה.
בראש הדף פרטי המשרה מוצגת הודעה שמזכירה לכם שהמשרה מושבתת.
REST
משתמשים בשיטה transferJobs.patch כדי להגדיר את הסטטוס של משימת ההעברה לערך DISABLED.
מחיקת משימת העברה
אפשר למחוק משימות העברה שכבר לא צריך. כשמוחקים עבודה, קורה הדבר הבא:
- מפסיק את כל ההעברות הקיימות שכלולות בעבודה.
- מפסיק את כל ההעברות החוזרות שכלולות בעבודה.
- מוחק את פרטי ההגדרה של המשימה.
מחיקת עבודה היא פעולה בלתי הפיכה. אחרי שמוחקים את עבודת ההעברה, היא מוסרת מרשימת עבודות ההעברה. פרטי העברת העבודות נמחקים לחלוטין מ-Storage Transfer Service אחרי 30 ימים.
לחלופין, אפשר להשבית את עבודת ההעברה. במקרה כזה, העבודה תמשיך להופיע בדף עבודות ותוכלו להפעיל אותה מחדש או לשנות אותה.
CLI של gcloud
כדי למחוק עבודת העברה, משתמשים ב-gcloud transfer jobs delete.
gcloud transfer jobs delete JOB_NAME
מסוף Google Cloud
כדי למחוק עבודת העברה:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
מסמנים את התיבה לצד העברת הנתונים שרוצים למחוק.
לוחצים על מחיקת המשרה.
מופיעה תיבת הדו-שיח Delete transfer job? (האם למחוק את משימת ההעברה?).
קוראים את ההודעה בתיבת הדו-שיח, מקלידים את השם שהוקצה אוטומטית לעבודה בשדה ולוחצים על מחיקה כדי לאשר את מחיקת העבודה.
המשרה תוסר מהדף משרות.
REST
כדי למחוק עבודת העברה באמצעות API בארכיטקטורת REST, אפשר לעיין בהפניה אל transferJobs.delete.
הצגת פרטי השגיאה
אם נתקלתם בשגיאות במהלך הפעלת העברה, תוכלו לראות את פרטי השגיאה כדי לנסות לפתור אותה.
כדי לראות את פרטי השגיאה של הרצת העברת נתונים:
נכנסים לדף Storage Transfer Service במסוף Google Cloud .
לוחצים על התיאור של עבודת ההעברה. הדף Job details מוצג.
כדי להציג את פרטי המשימה, מבצעים אחת מהפעולות הבאות:
הפעלת העבודה האחרונה: לוחצים על הלחצן הצגת פרטי השגיאה או על הקישור עיון בפרטי השגיאה. יוצג הדף פרטי השגיאה.
היסטוריה של הרצת משימות:
לוחצים על זמן ההתחלה של הרצת המשימה.
יוצג הדף Run details.
לוחצים על הקישור הצגת פרטי השגיאה.
יוצג הדף Error details.
כדי להציג פרטים נוספים על כל שגיאה שמוצגת, לוחצים על expand_more הרחבה.
כדי לסנן שגיאות, מזינים את המאפיינים לסינון בשדה Enter property name or value.
כשמציבים את הסמן בשדה, מוצג תפריט נפתח עם אפשרויות רלוונטיות שיעזרו לכם ליצור את המסנן.