Como configurar o URL do portal dos Serviços do desenvolvedor

Edge for Private Cloud v. 4.17.01

A Apigee oferece um portal de serviços para desenvolvedores que pode ser usado para criar e lançar sua site personalizado para fornecer 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 exibe o botão DevPortal no menu Publicar > Developers que, quando clicada, 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 a botão:

  • features.devportalDisabled: Defina como falso (padrão) para ativar o botão e como verdadeiro para desativá-lo.
  • features.devportalUrl: definido ao 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 as propriedades existentes na área properties do objeto. Quando você define propriedades na organização, o valor em propriedades substitui todas 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.