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

Edge for Private Cloud גרסה 4.17.05

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

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