URL des Portals für Entwicklerdienste festlegen

Edge for Private Cloud v. 4.16.05

Apigee bietet ein Entwicklerportal, mit dem Sie Ihre eigene benutzerdefinierte Website erstellen und starten können, um Ihrer Entwickler-Community alle diese Dienste zur Verfügung zu stellen. 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 auf der Seite Veröffentlichen > Entwickler die Schaltfläche DevPortal angezeigt. Wenn Sie darauf klicken, wird das mit einer Organisation verknüpfte Portal geöffnet. Standardmäßig wird über diese Schaltfläche die folgende URL geöffnet:

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

Dabei ist {orgname} der Name der Organisation.

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

• features.devportalDisabled: Legen Sie „false“ (Standard) fest, um die Schaltfläche zu aktivieren, und „true“, um sie zu deaktivieren.
• features.devportalUrl: Legen Sie die URL des Entwicklerportals fest.

Sie legen diese Attribute für jede Organisation separat fest. Wenn Sie diese Attribute festlegen möchten, verwenden Sie zuerst den folgenden API-Aufruf, um die aktuellen Attributeinstellungen 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 im folgenden Format 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 Attribute im Bereich properties 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 alle vorhandenen Attribute 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"}]
  }
}'

Im PUT-Aufruf müssen Sie nur displayName, name und properties angeben. Beachten Sie, dass dieser Aufruf das Attribut „foo“ enthält, das ursprünglich für die Organisation festgelegt wurde.