Ustawianie adresu URL portalu

Edge for Private Cloud w wersji 4.19.01

Apigee udostępnia portal usług dla programistów Apigee (lub po prostu portal), który możesz wykorzystać do utworzenia i uruchomienia własnej, dostosowanej witryny, która będzie udostępniać wszystkie te usługi społeczności programistów. Klienci Edge mogą tworzyć własny portal dla programistów w chmurze lub lokalnie. Więcej informacji znajdziesz w artykule Co to jest portal dla deweloperów?.

W interfejsie Edge na stronie Opublikuj > Deweloperzy znajduje się przycisk DevPortal, który po kliknięciu otwiera portal powiązany z organizacją. Domyślnie ten przycisk otwiera ten adres URL:

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

Gdzie orgname to nazwa organizacji.

Możesz ustawić ten adres URL jako inny, na przykład jeśli Twój portal ma rekord DNS, lub całkowicie wyłączyć przycisk. Aby sterować przyciskiem, użyj tych właściwości organizacji:

  • features.devportalDisabled: ustaw wartość false (fałsz, domyślnie), aby włączyć przycisk, lub wartość true (prawda), aby go wyłączyć.
  • features.devportalUrl: ustaw adres URL portalu dla deweloperów.

Te właściwości ustawiasz osobno dla każdej organizacji. Aby ustawić te właściwości, najpierw użyj tego wywołania interfejsu API, aby określić bieżące ustawienia usługi w organizacji:

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

To wywołanie zwraca obiekt opisujący organizację w formie:

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

Zwróć uwagę na wszystkie właściwości w obszarze properties obiektu. Gdy ustawisz właściwości w organizacji, wartość we właściwościach zastąpi wszystkie bieżące właściwości. Jeśli więc chcesz ustawić w organizacji wartości features.devportalDisabled lub features.devportalUrl, pamiętaj, aby podczas ich ustawiania skopiować wszystkie istniejące właściwości.

Aby ustawić właściwości w organizacji, użyj następującego wywołania 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"
        }
      ]
    }
  }'

W wywołaniu PUT musisz podać tylko te parametry: displayName, name i properties. Pamiętaj, że to wywołanie zawiera właściwość „foo”, która została pierwotnie skonfigurowana w organizacji.