URL des Portals für Entwicklerdienste festlegen

Edge for Private Cloud Version 4.17.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?.

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 auch 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 Attribute der Organisation, um die Schaltfläche zu 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: Legen Sie die URL des Entwicklerportals fest.

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 folgendem 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 Properties im Bereich Properties des Objekts. Wenn Sie Attribute für die Organisation festlegen, werden alle aktuellen Attribute durch den Wert in „Properties“ überschrieben. 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 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"}]
  }
}'

Dabei 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.