Ustawianie adresu URL portalu usług dla deweloperów

Edge for Private Cloud w wersji 4.16.09

Apigee udostępnia portal usług dla deweloperów, za pomocą którego możesz tworzyć i uruchamiać własną witrynę dostosowaną do potrzeb, aby udostępniać te wszystkie usługi swojej społeczności programistów. Klienci Edge mogą tworzyć własne portale dla deweloperó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 kontrolować dostępność przycisku, użyj tych właściwości organizacji:

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

Te właściwości ustawiasz osobno dla każdej organizacji. Aby skonfigurować te właściwości, użyj najpierw tego 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 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"
}

Zanotuj wszystkie dotychczasowe właściwości w obszarze właściwości obiektu. Gdy ustawisz właściwości organizacji, wartość w właściwościach zastąpi wszystkie dotychczasowe właściwości. Jeśli więc chcesz ustawić w organizacji opcję 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 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. Pamiętaj, że to wywołanie zawiera właściwość „foo”, która została pierwotnie skonfigurowana w organizacji.