Ustawianie adresu URL portalu usług dla deweloperów

Edge for Private Cloud wer. 4.17.05

Apigee udostępnia portal usług dla programistów, w którym możesz utworzyć i uruchomić własną, dostosowaną witrynę, w której będziesz udostępniać wszystkie te usługi swojej społeczności programistów. Klienci Edge mogą tworzyć własne portale dla programistów (w chmurze lub lokalnie). Więcej informacji znajdziesz w artykule Co to jest portal dla deweloperów?.

W interfejsie użytkownika Edge na stronie Opublikuj > Programiści wyświetla się przycisk DevPortal. Kliknięcie go powoduje otwarcie portalu powiązanego 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 na inny adres URL, na przykład jeśli 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 (fałsz), aby włączyć przycisk, lub wartość true (prawda), aby go wyłączyć.
  • features.devportalUrl: ustaw adres URL portalu dla programistów.

Te właściwości ustawia się oddzielnie dla każdej organizacji. Aby skonfigurować te właściwości, najpierw musisz użyć poniższego wywołania interfejsu API w celu określenia bieżących ustawień 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 formularzu:

{
  "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ępuje wszystkie obecne właściwości. Dlatego, jeśli chcesz ustawić w organizacji features.devportalDisabled lub features.devportalUrl, skopiuj wszystkie istniejące właściwości podczas ich konfigurowania.

Aby ustawić usługi w 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 tylko określić właściwości displayName, name i properties. Pamiętaj, że to wywołanie zawiera właściwość „foo”, która została pierwotnie ustawiona w organizacji.