Questa pagina è stata tradotta dall'API Cloud Translation.

Modifica di un proxy API (creazione di una revisione del proxy)

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Utilizza l'API o la UI di Apigee per modificare un proxy API. Quando modifichi un proxy API, puoi decidere cosa fare con le modifiche risultanti tra le seguenti opzioni:

Salva le modifiche sul server, ma non creare una nuova revisione. Questa operazione viene eseguita quando non vuoi eseguire il deployment delle modifiche salvate, ma vuoi solo assicurarti che non vadano perse se termini la sessione.

OR
Crea una nuova revisione del proxy API e esegui il deployment nel cluster. Non puoi eseguire il deployment delle modifiche a un proxy API senza creare una nuova revisione.

Nuovo editor proxy

Per modificare un proxy API e salvare le modifiche utilizzando il nuovo editor proxy:

Se utilizzi l'interfaccia utente di Apigee nella console Cloud: seleziona Sviluppo proxy > Proxy API.

Se utilizzi la UI di Apigee classica: seleziona Sviluppa > Proxy API e nel riquadro Proxy, seleziona l'ambiente per il proxy.
Seleziona il proxy da modificare dall'elenco dei proxy. L'interfaccia utente mostra la scheda Panoramica del proxy nell'editor dei proxy.
Fai clic sulla scheda Sviluppa.
Utilizza l'editor proxy per apportare le modifiche al proxy. Al termine delle modifiche, puoi eseguire una delle seguenti operazioni:
- Per salvare le modifiche, ma non creare una nuova revisione, fai clic sul pulsante Salva. (devi eseguire questa operazione periodicamente per assicurarti che le modifiche non vadano perse se termini la sessione).
- Per salvare le modifiche come nuova revisione (quando ti stai preparando a eseguire il deployment e il test), fai clic sul menu a discesa accanto al pulsante Salva e seleziona Salva come nuova revisione:
  
  L'interfaccia utente di Apigee salva le modifiche e genera una nuova revisione del proxy. Il nuovo bundle non viene eseguito nel runtime. Devi farlo esplicitamente, come descritto in Eseguire il deployment di un proxy API.

Editor proxy classico

Per modificare un proxy API e salvare le modifiche utilizzando l'editor proxy classico:

Accedi all'interfaccia utente di Apigee.
Fai clic su Proxy API nella visualizzazione principale.
In alternativa, puoi selezionare Sviluppa > Proxy API nel menu di navigazione a sinistra.
Seleziona l'ambiente contenente il proxy che vuoi modificare.

L'interfaccia utente di Apigee mostra un elenco di proxy API per l'ambiente selezionato:
Fai clic sul proxy che vuoi modificare. L'interfaccia utente mostra la scheda Panoramica per quel proxy in Proxy Editor:
Fai clic sulla scheda Sviluppa in alto a destra nella visualizzazione.
Utilizza l'editor del proxy per apportare le modifiche al proxy. Al termine delle modifiche, puoi eseguire una delle seguenti operazioni:
- Salva le modifiche, ma non creare una nuova revisione (opzione più comune; devi eseguire questa operazione periodicamente per assicurarti che le modifiche non vadano perse se termini la sessione).
- Salva le modifiche come nuova revisione (quando ti stai preparando a eseguire il deployment e il test).
Per salvare, ma non creare una nuova revisione, fai clic su Salva in alto a destra nell'interfaccia utente:

L'interfaccia utente di Apigee salva le modifiche in modo che tu possa uscire dalla pagina e riprendere a lavorare in un secondo momento.
Per salvare le modifiche come nuova revisione, fai clic sulla freccia menu a discesa accanto a Salva e seleziona Salva come nuova revisione:

L'interfaccia utente di Apigee salva le modifiche e genera un nuovo bundle proxy. Non esegue il deployment del nuovo bundle nel runtime; devi farlo esplicitamente, come descritto in Eseguire il deployment di un proxy API.
L'interfaccia utente mostra il messaggio Nuova revisione salvata:

Dopo aver creato una nuova revisione, in genere la esegui nel cluster, come descritto in Eseguire il deployment di un proxy API.

API Apigee

Modifica un proxy API per creare una revisione nella tua organizzazione Apigee inviando una richiesta POST alla seguente risorsa:

https://apigee.googleapis.com/v1/organizations/$ORG/apis

Devi definire il nome del proxy API utilizzando il parametro di query name. Limita i caratteri utilizzati nel nome a quanto segue: A-Za-z0-9._\-$ %

Se vuoi, puoi importare un pacchetto di configurazione di proxy API seguendo questi passaggi:

Imposta il parametro di query action su import
Imposta l'intestazione Content-type su multipart/form-data
Passa il nome del pacchetto di configurazione del proxy API nel file system locale

Il seguente esempio mostra come modificare un proxy API importando un bundle di configurazione del proxy API (helloworld-config.zip) nel file system locale utilizzando l'API.

export TOKEN=$(gcloud auth print-access-token)
export ORG=ORGANIZATION_NAME
curl "https://apigee.googleapis.com/v1/organizations/$ORG/apis?name=helloworld&action=import" \
  -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-type: multipart/form-data" \
  -F "file=@helloworld-config.zip"

dove $TOKEN è impostato sul tuo token di accesso OAuth 2.0, come descritto in Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl utilizzate in questo esempio, consulta Utilizzare curl. Per una descrizione delle variabili di ambiente utilizzate, consulta Impostazione delle variabili di ambiente per le richieste dell'API Apigee.

Di seguito è riportato un esempio di output della risposta:

{
  "basepaths": [
    "/helloworld"
  ],
  "configurationVersion": {
    "majorVersion": 4
  },
  "createdAt": "1559145292799",
  "displayName": "helloworld",
  "entityMetaDataAsProperties": {
    "bundle_type": "zip",
    "subType": "Proxy",
    "lastModifiedAt": "1559145292799",
    "createdAt": "1559145292799"
  },
  "lastModifiedAt": "1559145292799",
  "name": "helloworld",
  "policies": [
    "verify-api-key",
    "remove-query-param-apikey",
    "OAuth-v20-1"
  ],
  "proxies": [
    "default"
  ],
  "proxyEndpoints": [
    "default"
  ],
  "resourceFiles": {},
  "targetEndpoints": [
    "default"
  ],
  "targets": [
    "default"
  ],
  "type": "Application",
  "revision": "1",
  "description": "Hello world"
}

Per saperne di più sulla modifica di un proxy API, consulta il metodo apis.create nell'API Apigee. Per visualizzare tutti i metodi disponibili per i proxy API, consulta l'API Proxy API.