עדכון סוגי סביבות בתשלום לפי שימוש

הדף הזה מתייחס ל-Apigee, אבל לא ל-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

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

תפקידים והרשאות נדרשים

כדי לקבל את ההרשאות שדרושות לעדכון סוג סביבה עם תשלום לפי שימוש, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

אדמין ארגוני ב-Apigee (apigee.organization.admin)
אדמין של סביבת Apigee‏ (apigee.environment.admin)

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

עדכון סוג הסביבה

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

‫Apigee במסוף Cloud

כדי לעדכן את הססוג של סביבת תשלום לפי שימוש קיימת באמצעות ממשק המשתמש של Apigee במסוף Google Cloud :

פותחים את הדף Apigee במסוף.
מעבר אל Apigee
בוחרים את הפרויקט עם הארגון והסביבות בתשלום לפי שימוש שרוצים לעדכן.
בוחרים באפשרות ניהול > סביבות כדי לפתוח את דף הרשימה סביבות.
בשורה של הסביבה שרוצים לערוך, לוחצים על פעולות ובוחרים באפשרות עריכה.
בתיבת הדו-שיח עריכת הסביבה, בוחרים אפשרות בקטע בחירת סוג הסביבה.
לוחצים על עדכון כדי לשמור את השינויים.
כדי לאשר את השינוי בסוג הסביבה, מרעננים את דף הרשימה Environments (סביבות).

Apigee API

כדי לעדכן את הסוג של סביבת תשלום לפי שימוש קיימת באמצעות Apigee API, משתמשים בפקודה הבאה:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"ENV_TYPE"}'

כאשר:

‫ORG_NAME הוא השם של הארגון שלכם ב-Apigee תשלום לפי שימוש.
‫ENV_NAME הוא השם של סביבת Apigee שרוצים לעדכן.
‫ENV_TYPE הוא סוג הסביבה המעודכן. האפשרויות הן BASE, ‏INTERMEDIATE או COMPREHENSIVE.

לדוגמה, כדי לשדרג סביבת Base בשם test-env ל-Comprehensive, משתמשים בפקודה הבאה:

curl "https://apigee.googleapis.com/v1/organizations/my-org/environments/test-env?updateMask=type" \
          -H "Authorization: Bearer $token" \
          -X PATCH \
          -H 'Content-Type: application/json' \
          -d '{"type":"COMPREHENSIVE"}'

אחרי שהפעולה מסתיימת, מריצים את הפקודה הבאה כדי לוודא שסוג הסביבה השתנה:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/ENV_NAME" -H "Authorization: Bearer $token"

הפקודה הזו מחזירה את אובייקט המשאב environment, שכולל את סוג הסביבה שנבחר.

הפניה לשגיאה

כשמשדרגים או מורידים את רמת הסביבה, הפעולה תיכשל אם הסביבה הקיימת מכילה משאבים שלא תואמים לסוג הסביבה שנבחר. מידע נוסף על התכונות הזמינות והמגבלות לפי סוג הסביבה זמין במאמר השוואה בין סוגי סביבות.

אם הפעולה נכשלת, תוצג שגיאה בפורמט הבא:

  {
    "error": {
      "code": "FAILED_PRECONDITION",
      "message": "environment type update invalid: ...<detailed message here >... :failed precondition",
      "status": "FAILED_PRECONDITION"
      }
  }

בטבלה הבאה מפורטות הודעות שגיאה אפשריות ופעולות שאפשר לבצע כדי לפתור את הבעיה ולשדרג או לשנמך את סוג הסביבה:

תנאי כשל	הודעת השגיאה	השלבים לפתרון הבעיה
חריגה ממספר הסביבות המקסימלי לכל ארגון	`cannot transfer active environments to INTERMEDIATE, will exceed limit` `cannot transfer active environments to BASE, will exceed limit`	מחיקה של סביבה אחת או יותר מהארגון.
Extensible proxy שנפרס בסביבה	`existing environment has an extensible API`	ביטול הפריסה של ה-proxy הניתן להרחבה מהסביבה.
תהליך עבודה משותף שנפרס בסביבה	`existing environment has a shared flow`	ביטול הפריסה של התהליך המשותף מהסביבה.
המספר המקסימלי של יחידות פריסת proxy לכל סביבה בכל אזור	`pdu count, 50, cannot exceed 20` `pdu count, 425, cannot exceed 50`	ביטול הפריסה ומחיקה של זרימות משותפות או שרתי proxy מהסביבה.
תוספים שמופעלים בסביבה	`Existing environment has an addon enabled`	משביתים את התוספים בסביבה.
התמיכה במספר אזורים מופעלת בסביבה	`instance attachment count, 2, cannot exceed 1 for BASE environment` `instance attachment count, 2, cannot exceed 1 for INTERMEDIATE environment`	מוחקים את הצירוף השני של המופע לסביבה.

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