הגדרת כתובת ה-URL של הפורטל

Edge for Private Cloud גרסה 4.18.05

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

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

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

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

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

• features.devportalDisabled: מוגדר כ-False (ברירת מחדל) כדי להפעיל את הלחצן ו כדי להשבית אותה.
• 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" שהוגדר במקור בארגון.