URL des Portals festlegen

Edge for Private Cloud v4.19.01

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 Eigenschaften der Organisation steuern Sie die Schaltfläche:

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

Diese Eigenschaften legen Sie für jede Organisation separat fest. Um diese Eigenschaften festzulegen, Verwenden Sie den folgenden API-Aufruf, um die aktuellen Property-Einstellungen in der 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 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 die vorhandenen Eigenschaften 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 features.devportalDisabled oder features.devportalUrl in der Organisation festlegen möchten, müssen Sie alle vorhandenen 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 Sie nur displayName angeben, name und properties. Beachten Sie, dass dieser Aufruf das Ereignis „foo“ die ursprünglich für die Organisation festgelegt wurde.