URL des Portals für Entwicklerdienste festlegen

Edge for Private Cloud Version 4.17.05

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

In der Edge-Benutzeroberfläche wird die Schaltfläche DevPortal auf der Seite Publish > Developers (Veröffentlichen > Entwickler) angezeigt. Wenn sie angeklickt 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.

Sie können eine andere URL festlegen, z. B. wenn Ihr Portal einen DNS-Eintrag hat, oder die Schaltfläche vollständig deaktivieren. Verwenden Sie die folgenden Attribute der Organisation, um die Schaltfläche zu steuern:

• features.devportalDisabled: Setzen Sie diesen Wert auf „false“ (Standardeinstellung), um die Schaltfläche zu aktivieren, und auf „true“, um sie zu deaktivieren.
• features.devportalUrl: auf die URL des Entwicklerportals festlegen

Sie legen diese Eigenschaften für jede Organisation separat fest. Zum Festlegen dieser Attribute verwenden Sie zuerst den folgenden API-Aufruf, um die aktuellen Property-Einstellungen für die Organisation zu 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 der 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 Eigenschaften im properties-Bereich des Objekts. Wenn Sie Attribute für die Organisation festlegen, überschreibt der Wert in den Attributen alle aktuellen Attribute. Wenn Sie also features.devportalDisabled oder features.devportalUrl in der Organisation festlegen möchten, müssen Sie beim Festlegen vorhandene Properties kopieren.

Verwenden Sie den folgenden PUT-Aufruf, um Eigenschaften 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"}]
  }
}'

Im PUT-Aufruf müssen nur displayName, name und properties angegeben werden. Dieser Aufruf enthält die Property „foo“, die ursprünglich für die Organisation festgelegt wurde.