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

Edge for Private Cloud גרסה 4.17.05

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

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

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"
}

שימו לב למאפיינים הקיימים באזור המאפיינים של האובייקט. כשמגדירים מאפיינים בארגון, הערך בנכסים מחליף את כל הנכסים הקיימים. לכן, אם רוצים להגדיר בארגון את 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" שהוגדר במקור בארגון.