URL des Portals festlegen

Apigee bietet Ihnen ein Apigee Developer Services-Portal (oder einfach das Portal), 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: Auf „false“ (Standardeinstellung) setzen, um die Schaltfläche zu aktivieren, und auf „true“, um sie zu deaktivieren.
• features.devportalUrl: Legen Sie hier die URL des Entwicklerportals fest.

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 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 beim Festlegen vorhandene Attribute 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, name und properties angeben. Dieser Aufruf enthält die Property „foo“, die ursprünglich für die Organisation festgelegt wurde.