Como configurar o URL do portal

Edge para nuvem privada v4.18.05

A Apigee oferece o portal de serviços para desenvolvedores da Apigee (ou simplesmente o portal) que pode ser usado para criar e lançar seu próprio site personalizado e oferecer todos esses serviços à sua comunidade de desenvolvimento. Borda os clientes podem criar o próprio portal do desenvolvedor na nuvem ou no local. Consulte O que é um portal do desenvolvedor? para mais informações.

A interface do Edge mostra o botão DevPortal na página Publicar > Desenvolvedores que, quando clicado, abre o portal associado a uma organização. De padrão, esse botão abre o seguinte URL:

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

Em que orgname é o nome da organização.

Você pode definir esse URL como um URL diferente, por exemplo, se o portal tiver um registro DNS ou desativar o botão completamente. Use as seguintes propriedades da organização para controlar o botão:

• features.devportalDisabled: defina como "false" (padrão) para ativar o botão. true para desativá-la.
• features.devportalUrl: definido como o URL do portal do desenvolvedor.

Essas propriedades são definidas separadamente para cada organização. Para definir essas propriedades, primeiro use a seguinte chamada de API para determinar as configurações de propriedade atuais na organização:

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

Essa chamada retorna um objeto que descreve a organização no formato:

{
  "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"
}

Observe todas as propriedades existentes na área properties do objeto. Quando você define propriedades na organização, o valor nas propriedades substitui as propriedades atuais. Portanto, se você quiser definir features.devportalDisabled ou features.devportalUrl na organização, certifique-se de copiar quaisquer propriedades existentes ao defini-las.

Use a seguinte chamada PUT para definir propriedades na organização:

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"
        }
      ]
    }
  }'

Na chamada PUT, você só precisa especificar displayName, name e properties. Observe que esta chamada inclui o "foo" que foi definida originalmente na organização.