Ustawianie adresu URL portalu usług dla deweloperów

Edge dla chmury prywatnej w wersji 4.16.09

Apigee udostępnia portal usług dla programistów, za pomocą którego możesz utworzyć i uruchomić własną, dostosowaną witrynę, aby udostępniać wszystkie te usługi społeczności programistów. Klienci Edge mogą utworzyć własny portal dla programistów w chmurze lub lokalnie. Więcej informacji znajdziesz w artykule Co to jest portal dla programistów?

W interfejsie Edge na stronie Opublikuj > Deweloperzy wyświetla 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ć inny adres URL, na przykład jeśli Twój portal ma rekord DNS, lub całkowicie wyłączyć przycisk. Aby kontrolować przycisk, użyj tych właściwości organizacji:

• features.devportalDisabled: ustaw wartość false (domyślnie), aby włączyć przycisk, lub true, aby go wyłączyć.
• features.devportalUrl: ustaw adres URL portalu dla programistó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 właściwości 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 istniejące 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. Dlatego jeśli chcesz ustawić features.devportalDisabled lub features.devportalUrl w organizacji, pamiętaj, aby skopiować wszystkie istniejące właściwości podczas ich ustawiania.

Aby ustawić właściwości organizacji, użyj tego 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 displayName, name i properties. Zwróć uwagę, że to wywołanie zawiera właściwość „foo”, która została pierwotnie ustawiona w organizacji.