Impostazione dell'URL del portale Servizi per gli sviluppatori

Edge per Private Cloud v4.18.01

Apigee ti offre un portale di servizi per sviluppatori che puoi utilizzare per creare e lanciare tuo sito web personalizzato per fornire tutti questi servizi alla tua comunità di sviluppo. I clienti di Edge possono creare il proprio portale per sviluppatori, in cloud o on-premise. Consulta la sezione Cos'è un portale per gli sviluppatori? per ulteriori informazioni.

L'interfaccia utente di Edge mostra il pulsante DevPortal nella pagina Pubblica > sviluppatori che, se fatto clic, apre il portale associato a un'organizzazione. Per impostazione predefinita, il pulsante apre il seguente URL:

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

dove {orgname} è il nome dell'organizzazione.

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

  • features.devportalDisabled: imposta il valore su false (valore predefinito) per attivare il pulsante e su true per disattivarlo.
  • features.devportalUrl: imposta all'URL del portale per gli sviluppatori.

Puoi impostare queste proprietà separatamente per ogni organizzazione. Per impostare queste proprietà, devi prima utilizza 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 seguente 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 proprietà per l'organizzazione, il valore nelle proprietà sovrascrive le proprietà correnti. Pertanto, se vuoi impostare features.devportalDisabled o features.devportalUrl nell'organizzazione, assicurati di copiare 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 "foo" impostata in origine sull'organizzazione.