URL des Portals festlegen

Edge for Private Cloud v4.18.05

Apigee stellt Ihnen das Apigee Developer Services-Portal (oder einfach das Portal) zur Verfügung, 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 für diese URL eine andere URL festlegen, z. B. wenn Ihr Portal einen DNS-Eintrag hat, oder Schaltfläche vollständig deaktivieren. Mit den folgenden Properties der Organisation können Sie die Schaltfläche steuern:

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

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, Achten Sie darauf, dass Sie alle vorhandenen Eigenschaften 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"
        }
      ]
    }
  }'

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.