הצגת פעולות ב-Compute Engine

כשמבצעים קריאה ל-API של Compute Engine שמשנה משאב, ‏ Compute Engine מוסיף רשומה לרשימת הפעולות. לדוגמה, כשמבצעים עדכון במכונה וירטואלית שמשנה את הנתונים, או כשמתרחש אירוע במארח שמשנה את המצב של מכונה וירטואלית, נוצרות פעולות. בדף הזה מוסבר איך אפשר לראות רשימה של פעולות ב-Compute Engine באמצעות Google Cloud המסוף,‏ Google Cloud CLI או REST.

חשוב לזכור שהשלמת הפעולות עשויה להימשך זמן מה, ולכן יכול להיות שתראו פעולות לא שלמות. אם רוצים לראות את הסטטוס הסופי של פעולות לא שלמות, לא מומלץ להציג את הפעולות שוב ושוב. במקום זאת, כדאי להמתין עד שהפעולות יסתיימו.

לפני שמתחילים

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Google Cloud

    gcloud

    1. התקינו את ה-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.

הצגת פעולות

כדי לראות רשימה של פעולות בפרויקט:

המסוף

  1. נכנסים לדף Operations במסוף Google Cloud .

    מעבר אל 'פעולות'

  2. כדי לראות פרטים נוספים על פעולה מסוימת, לוחצים על סיכום הפעולה. לדוגמה, כדי לראות את פרטי ההעברה של מכונת my-instance VM, לוחצים על הפעולה העברה אוטומטית של מופע.

דף הפעולות שבו מוצגת מיגרציה פעילה. פרטים על מיגרציה פעילה.

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"
}