URL des Portals für Entwicklerdienste festlegen

Edge for Private Cloud Version 4.16.09

Apigee bietet ein Developer Services-Portal, mit dem Sie Ihre eigene benutzerdefinierte Website erstellen und starten können, um all diese Dienste für Ihre Entwickler-Community bereitzustellen. Edge-Kunden können ihr eigenes Entwicklerportal erstellen, entweder in der Cloud oder lokal. Weitere Informationen finden Sie unter „Was ist ein Entwicklerportal?“.

Die Edge-Benutzeroberfläche zeigt die Schaltfläche DevPortal (DevPortal) auf der Seite Publish > Developers (Veröffentlichen > Entwickler) an. Wenn darauf geklickt wird, wird das mit einer Organisation verknüpfte Portal geöffnet. Standardmäßig wird mit dieser Schaltfläche die folgende URL geöffnet:

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

Dabei ist {orgname} der Name der Organisation.

Du kannst für diese URL eine andere URL festlegen, z. B. wenn dein Portal einen DNS-Eintrag hat, oder die Schaltfläche vollständig deaktivieren. Mit den folgenden Properties der Organisation können Sie die Schaltfläche steuern:

  • features.devportalDisabled: Legen Sie den Wert auf „false“ (Standardeinstellung), um die Schaltfläche zu aktivieren, oder auf „true“, um sie zu deaktivieren.
  • features.devportalUrl: Geben Sie hier die URL des Entwicklerportals an.

Sie legen diese Eigenschaften für jede Organisation separat fest. Um diese Eigenschaften festzulegen, müssen Sie zuerst die aktuellen Property-Einstellungen der Organisation mit dem folgenden API-Aufruf ermitteln:

curl -H "Content-Type:application/json" \
-u adminEmail:pword -X GET \
http://<ms-IP>:8080/v1/organizations/{orgname}

Dieser Aufruf gibt ein Objekt zurück, das die Organisation in folgender Form beschreibt:

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

Notieren Sie sich alle vorhandenen Properties im Bereich Properties des Objekts. Wenn Sie Eigenschaften für die Organisation festlegen, werden alle aktuellen Eigenschaften durch den Wert in den Eigenschaften überschrieben. Wenn Sie also features.devportalDisabled oder features.devportalUrl in der Organisation festlegen möchten, müssen Sie alle vorhandenen Properties kopieren, wenn Sie sie festlegen.

Verwenden Sie den folgenden PUT-Aufruf, um Attribute für die Organisation festzulegen:

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"}]
  }
}'

Dabei müssen Sie nur displayName, name und properties angeben. Dieser Aufruf enthält die Property "foo", die ursprünglich für die Organisation festgelegt wurde.