הגדרת כתובת ה-URL של פורטל השירותים למפתחים

Edge for Private Cloud גרסה 4.18.01

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

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

http://live-{orgname).devportal.apigee.com

כאשר {orgname} הוא שם הארגון.

אפשר להגדיר את כתובת ה-URL הזו ככתובת URL אחרת, למשל אם לפורטל יש רשומת DNS, או להשבית את הלחצן לגמרי. כדי לשלוט בלחצן, משתמשים במאפיינים הבאים של הארגון:

• features.devportalDisabled: הגדרה של false (ברירת המחדל) מפעילה את הלחצן, והגדרה של true משביתה אותו.
• features.devportalUrl: מוגדר ככתובת ה-URL של פורטל המפתחים.

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

curl -H "Content-Type:application/json" \
-u adminEmail:pword -X GET \
http://<ms-IP>:8080/v1/organizations/{orgname}

הקריאה הזו מחזירה אובייקט שמתאר את הארגון בצורה הבאה:

{
  "createdAt" : 1428676711119,
  "createdBy" : "me@my.com",
  "displayName" : "orgname",
  "environments" : [ "prod" ],
  "lastModifiedAt" : 1428692717222,
  "lastModifiedBy" : "me@my.com",
  "name" : "organme",
  "properties" : {
    "property" : [{
      "name" : "foo",
      "value" : "bar"}]
  },
  "type" : "paid"
}

שימו לב למאפיינים הקיימים באזור properties של האובייקט. אחרי שמגדירים בנכסים בארגון, הערך בנכסים מחליף את כל הנכסים הנוכחיים. לכן, אם רוצים להגדיר את features.devportalDisabled או את features.devportalUrl בארגון, צריך להעתיק את כל הנכסים הקיימים כשמגדירים אותם.

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

curl -H "Content-Type:application/json" \
-u adminEmail:pword -X PUT \
http://<ms-IP>:8080/v1/organizations/{orgname} \
-d '{
  "displayName" : "orgname",
  "name" : "orgname",
  "properties" : {
    "property" : [ {
      "name" : "foo",
      "value" : "bar"},
    {
      "name": "features.devportalUrl",
      "value": "http://dev-orgname.devportal.apigee.com/"},
    {
      "name": "features.devportalDisabled",
      "value": "false"}]
  }
}'

בקריאה ל-PUT, צריך לציין רק את displayName,‏ name ו-properties. שימו לב שהקריאה הזו כוללת את הנכס foo שהוגדר במקור בארגון.