בדף הזה מוסבר איך לבדוק ולנהל פעולות ארוכות ב-Certificate Manager.
כשבקשה לשינוי נתונים ב-Certificate Manager, כמו יצירה, עדכון או מחיקה של משאב, לא נכשלת באופן מיידי, ה-API מחזיר פעולה ממושכת (LRO). הפעולות האלה עוקבות אחרי הסטטוס של משימות עיבוד שלוקח יותר זמן להשלים. כברירת מחדל, פקודות המוטציה של gcloud ממתינות לסיום הפעולה, אלא אם מציינים את הדגל --async.
אתם יכולים להשתמש באוסף projects.locations.operations כדי לבדוק את סטטוס הפעולות.
ההרשאות הנדרשות
כדי לנהל פעולות ארוכות בפרויקט היעד, אתם צריכים את ההרשאה שמתאימה למשימה שאתם רוצים לבצע:
-
certificatemanager.operations.get: אחזור פרטים של פעולה ספציפית. -
certificatemanager.operations.list: רשימה של כל הפעולות במיקום נתון. -
certificatemanager.operations.delete: מחיקת משאב של פעולה שהושלמה (API בלבד).
איך מקבלים פרטים על פעולה ממושכת
כשמבצעים קריאה שמתחילה פעולה, כמו יצירת אישור, התגובה מכילה שם פעולה בפורמט: projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID.
כדי לבדוק אם הפעולה הושלמה, מבקשים פרטים על פעולת היעד. אם התשובה מכילה את הערך "done": false או לא כוללת את השדה "done", הפעולה עדיין מתבצעת. בודקים שוב את הסטטוס עד שמוצגת התשובה "done": true.
gcloud
כדי לתאר פעולה ממושכת, משתמשים בפקודה certificate-manager
operations describe:
gcloud certificate-manager operations describe OPERATION_ID \
--location="LOCATION"
מחליפים את מה שכתוב בשדות הבאים:
-
OPERATION_ID: מזהה הפעולה. -
LOCATION: מיקום היעד Google Cloud . מיקום ברירת המחדל הואglobal.
API
כדי לקבל פרטים על פעולה ממושכת, שולחים בקשת GET ל-method projects.locations.operations.get:
GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: מיקום היעד Google Cloud . מיקום ברירת המחדל הואglobal. -
OPERATION_ID: מזהה הפעולה.
הצגת רשימה של פעולות ממושכות
אתם יכולים להציג רשימה של פעולות כדי למצוא מזהי פעולות ולעקוב אחרי שינויים פעילים בפרויקט.
gcloud
כדי להציג רשימה של פעולות במיקום מסוים, משתמשים בפקודה certificate-manager
operations list:
gcloud certificate-manager operations list \
--location="LOCATION"
מחליפים את מה שכתוב בשדות הבאים:
-
LOCATION: מיקום היעד Google Cloud . מיקום ברירת המחדל הואglobal.
API
כדי להציג רשימה של פעולות במיקום מסוים, שולחים בקשת GET ל-method projects.locations.operations.list:
GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: מיקום היעד Google Cloud . מיקום ברירת המחדל הואglobal.
מחיקת פעולה ממושכת שהסתיימה
אם אתם לא צריכים יותר את התוצאה של משאב פעולה שהושלמה, אתם יכולים למחוק אותו. כשמוחקים פעולה שהושלמה, רק הרשומה של הפעולה נמחקת. השינויים שבוצעו בפעולה לא מבוטלים או נהפכים.
אי אפשר למחוק פעולות באמצעות פקודות gcloud. במקום זאת, צריך להשתמש ב-API בארכיטקטורת REST.
API
כדי למחוק פעולה שהושלמה, שולחים בקשת DELETE ל-method projects.locations.operations.delete:
DELETE https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: מיקום היעד Google Cloud . מיקום ברירת המחדל הואglobal. -
OPERATION_ID: מזהה הפעולה.
מדיניות שמירת נתונים
Certificate Manager שומר ומוחק באופן אוטומטי פעולות LRO שהושלמו, בהתאם לכללים הבאים, לפי סדר העדיפות:
- לפני פחות משעה: אם הפעולה הושלמה לפני פחות משעה, Certificate Manager שומר את הפעולה.
- לפני יותר משבוע: אם הפעולה הושלמה לפני יותר משבוע, מנהל האישורים מוחק אותה.
- מגבלה מקסימלית: אם פעולה הסתיימה בין שעה אחת לשבוע אחד לפני כן, Certificate Manager שומר עד 5,000 מהפעולות האחרונות שהושלמו בכל פרויקט ומוחק את כל הפעולות הישנות יותר שהושלמו.
הדוגמאות הבאות מראות איך הכללים האלה חלים:
- אם בפרויקט יש 10,000 פעולות שהושלמו וכולן בוצעו לפני פחות משעה, Certificate Manager ישמור את כל 10,000 הפעולות.
- אם בפרויקט יש 1,000 פעולות שהושלמו לפני יותר משבוע, Certificate Manager ימחק את כל 1,000 הפעולות.
- אם בפרויקט יש 10,000 פעולות שהושלמו, וכולן בוצעו בין שעה לשבוע לפני כן, מנהל האישורים ישמור רק את 5,000 הפעולות האחרונות.