Как задать URL портала Developer Services

Edge for Private Cloud версии 4.16.05

Apigee предоставляет портал Developer Services, который можно использовать для создания и запуска собственного сайта, чтобы предоставлять все эти услуги сообществу разработчиков. Клиенты Edge могут создать собственный портал для разработчиков в облаке или локально. Дополнительную информацию вы найдете в разделе Что такое портал для разработчиков?.

В интерфейсе Edge на странице Publish (Публикация) > Developers (Разработчики) есть кнопка DevPortal, при нажатии на которую открывается портал, связанный с организацией. По умолчанию эта кнопка открывает следующий URL:

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

где {orgname} – название организации.

Вы можете указать другой 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, которое изначально было задано для организации.