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

Edge for Private Cloud גרסה 4.19.01

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

בממשק המשתמש של 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 שהוגדר במקור בארגון.