כשמבצעים קריאה ל-API של Compute Engine שמשנה משאב, המערכת מוסיפה רשומה לרשימת הפעולות. לדוגמה, כשמבצעים עדכון במכונה וירטואלית שמשנה את הנתונים, או כשמתרחש אירוע במארח שמשנה את המצב של מכונה וירטואלית, נוצרות פעולות. בדף הזה מוסבר איך אפשר לראות רשימה של פעולות ב-Compute Engine באמצעות מסוףGoogle Cloud , Google Cloud CLI או REST.
חשוב לזכור שהשלמת הפעולות עשויה להימשך זמן מה, ולכן יכול להיות שתראו פעולות שלא הושלמו. אם אתם רוצים לראות את הסטטוס הסופי של פעולות שלא הושלמו, לא מומלץ להציג את הפעולות שוב ושוב. במקום זאת, כדאי להמתין עד שהפעולות יסתיימו.
לפני שמתחילים
-
אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות.
אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים האלה:
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
המסוף
כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים Google Cloud ולממשקי ה-API, לא צריך להגדיר אימות.
gcloud
-
התקינו את ה-CLI של Google Cloud. אחר כך, מאתחלים את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
gcloud initאם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
- הגדרת אזור ותחום כברירת מחדל
REST
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.
התקינו את ה-CLI של Google Cloud.
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .
תקופת השמירה של פעולות
כשמריצים שאילתות על פעולות, חשוב לזכור שפעולות שהושלמו מוסרות אוטומטית ממסד הנתונים אחרי תקופה מסוימת.
ב-Compute Engine, פעולות שהושלמו נשמרות לפחות למשך תקופת השמירה המינימלית של שעה אחת, ולכל היותר למשך תקופת השמירה המקסימלית של 14 ימים. למרות שבפרויקטים רבים יש תקופת שמירה לפעולות שהושלמו שהיא ארוכה יותר מהמינימום של שעה אחת, לא מומלץ להסתמך על תקופת השמירה הנוספת.
חשוב לזכור: תקופות השמירה לא חלות על פעולות שנמחקו על ידי המשתמשים באמצעות שיטת Operations.delete.
צפייה בפעולות
כדי לראות רשימה של פעולות בפרויקט:
המסוף
נכנסים לדף Operations במסוף Google Cloud .
כדי לראות פרטים נוספים על פעולה מסוימת, לוחצים על סיכום הפעולה. לדוגמה, כדי לראות את פרטי ההעברה של המכונה הווירטואלית
my-instance, לוחצים על הפעולה Automatically migrate an instance.
gcloud
כדי לראות רשימה של פעולות בפרויקט באמצעות gcloud compute, משתמשים בפקודת המשנה operations list.
כדי לראות את רשימת הפעולות באזור מסוים, מוסיפים את הדגל --filter.
gcloud compute operations list --filter="zone:(ZONE)"
מחליפים את ZONE באזור שבו רוצים לראות רשימה של פעולות. לדוגמה, כדי לראות את רשימת הפעולות ב-us-cental1-c, מריצים את הפקודה הבאה:
gcloud compute operations list --filter="zone:(us-central1-c)"
הפלט אמור להיראות כך:
NAME TYPE TARGET HTTP_STATUS STATUS TIMESTAMP
systemevent-1543845145000... compute.instances.migrateOnHostMaintenance us-central1-c/instances/my-instance 200 DONE 2018-12-03T05:52:25.000-08:00
REST
צריך לציין בקשות API לפעולות ברמה הגלובלית, ברמת האזור או ברמת האזור. מיגרציה פעילה, עצירה של מכונה וירטואלית והפעלה מחדש אוטומטית הן פעולות ברמת האזור.
לפעולות באזורים, שולחים בקשת GET ל-method zoneOperations.list.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט של הבקשה הזו -
ZONE: האזור של הבקשה
משאירים את גוף הבקשה ריק.
הדוגמה הבאה היא של פלט לבקשת פעולה באזור. בפלט הזה מוצגים פרטים על העברת מארח.
{
"kind": "compute#operation",
"id": "3216798767364213712",
"name": "systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b",
"zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c",
"operationType": "compute.instances.migrateOnHostMaintenance",
"targetLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/instances/my-instance",
"targetId": "3070988523247098025",
"status": "DONE",
"statusMessage": "Instance migrated during Compute Engine maintenance.",
"user": "system",
"progress": 100,
"insertTime": "2018-12-03T05:52:25.000-08:00",
"startTime": "2018-12-03T05:52:25.000-08:00",
"endTime": "2018-12-03T05:52:25.000-08:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/operations/systemevent-1543845145000-57c1e7574b840-a195b637-5ff74d9b"
}