Impostazione dell'URL del portale

Apigee ti fornisce il portale Servizi per gli sviluppatori Apigee (o semplicemente, il portale) che puoi utilizzare per creare e lanciare il tuo sito web personalizzato per fornire tutti questi servizi alla tua community di sviluppo. I clienti perimetrali possono creare il proprio portale per sviluppatori, nel cloud o on-prem. Per ulteriori informazioni, consulta Che cos'è un portale per gli sviluppatori?.

La UI Edge mostra il pulsante DevPortal nella pagina Pubblica > Sviluppatori che, se selezionato, apre il portale associato a un'organizzazione. Per impostazione predefinita, questo pulsante apre il seguente URL:

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

Dove orgname è il nome dell'organizzazione.

Puoi impostare questo URL su un URL diverso, ad esempio se il tuo portale ha un record DNS, oppure disattivare completamente il pulsante. Utilizza le seguenti proprietà dell'organizzazione per controllare il pulsante:

  • features.devportalDisabled: imposta il valore su false (impostazione predefinita) per attivare il pulsante e su true per disabilitarlo.
  • features.devportalUrl: impostato sull'URL del portale per gli sviluppatori.

che puoi impostare separatamente per ogni organizzazione. Per impostare queste proprietà, devi prima utilizzare la seguente chiamata API per determinare le impostazioni attuali delle proprietà nell'organizzazione:

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

Questa chiamata restituisce un oggetto che descrive l'organizzazione nel 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"
}

Prendi nota di eventuali proprietà esistenti nell'area properties dell'oggetto. Quando imposti le proprietà nell'organizzazione, il valore nelle proprietà sovrascrive qualsiasi proprietà corrente. Pertanto, se vuoi impostare features.devportalDisabled o features.devportalUrl nell'organizzazione, assicurati di copiare tutte le proprietà esistenti quando le imposti.

Utilizza la seguente chiamata PUT per impostare le proprietà nell'organizzazione:

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

Nella chiamata PUT, devi specificare solo displayName, name e properties. Tieni presente che questa chiamata include la proprietà "foo" originariamente impostata nell'organizzazione.