Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza
documentazione di Apigee Edge.
Ora che hai testato il tuo nuovo proxy, sei quasi pronto per aggiungere un criteri. Prima di farlo, però, modifica l'endpoint di destinazione del proxy in che restituisce alcuni dati.
Ricorda che nel Passaggio 1: crea un proxy API, imposti
endpoint di destinazione (nel campo API esistente) a https://mocktarget.apigee.net
.
Supponiamo che l'endpoint non abbia restituito dati interessanti. Poi puoi modificare
endpoint a uno che restituisce alcuni file XML utili. In questa sezione viene spiegato come fare.
Nuovo editor proxy
Puoi modificare l'endpoint di destinazione di un proxy nella visualizzazione Sviluppo dell'Editor proxy. Per aprire la vista Sviluppo:
- Seleziona Sviluppo > Proxy API e, nel riquadro Proxy, seleziona l'ambiente per il proxy.
- Nell'elenco dei proxy, seleziona il proxy myproxy, che hai creato in Passaggio 1: crea un proxy API.
- Fai clic sulla scheda Sviluppo per aprire la vista Sviluppo:
Vista Sviluppo
Nel riquadro sinistro della visualizzazione Sviluppo, puoi:
- Cerca testo nel proxy nel campo Cerca nel proxy.
- Aggiungi nuovi criteri.
- Aggiungi endpoint proxy e di destinazione.
- Aggiungi altre risorse.
Se non desideri visualizzare il riquadro a sinistra, puoi comprimerlo facendo clic sull'icona
pulsante di chiusura .
Nel riquadro a destra della visualizzazione Sviluppo vengono visualizzati gli editor visivi e di testo per il proxy:
- L'editor visivo offre una visualizzazione grafica del flusso di richiesta e risposta.
- L'editor di testo consente di modificare il codice XML per il proxy o la destinazione.
Note:
- Puoi fare clic e trascinare il divisore tra i due editor verso l'alto o verso il basso per espanderlo nell'area di visualizzazione di uno dei due editor.
- Puoi espandere l'area di visualizzazione l'editor visivo facendo clic sul pulsante di attivazione/disattivazione sul lato destro dell'editor di testo, che chiude il riquadro. Fai clic sul pulsante di attivazione/disattivazione per riaprire il riquadro dell'editor di testo.
Cambia l'endpoint di destinazione
Per modificare l'endpoint di destinazione del proxy:
- Nel riquadro Revisione proxy, seleziona Endpoint di destinazione > predefinita.
Viene visualizzato un diagramma dell'endpoint di destinazione nell'editor visivo:
Sotto l'editor visivo, nell'editor di testo viene visualizzato il codice XML per l'endpoint di destinazione:
Nell'editor di testo, cambia
<URL>
inhttps://mocktarget.apigee.net/xml
. Aggiungi "/xml" all'URL esistente.Il nuovo URL è visualizzato di seguito:
... <HTTPTargetConnection> <Properties/> <URL>https://mocktarget.apigee.net/xml</URL> </HTTPTargetConnection> ...
- Fai clic sulla freccia accanto a Salva in alto a destra in Editor proxy, e seleziona Salva come nuova revisione.
- Per eseguire il deployment delle modifiche, fai clic su Esegui il deployment.
- Nella finestra di dialogo Esegui il deployment, seleziona la revisione e l'ambiente in cui eseguire il deployment. fai clic su Esegui il deployment.
Editor proxy classico
Per modificare l'endpoint di destinazione del proxy:
- Accedi all'UI di Apigee.
- Seleziona Sviluppo > Proxy API.
- Seleziona il tuo proxy dall'elenco per visualizzare i dettagli del proxy API. Se il proxy non è presente nell'elenco, verifica assicurati di aver selezionato l'organizzazione giusta, come descritto in Passare da un'organizzazione all'altra.
Fai clic sulla scheda Sviluppo:
Si aprirà l'editor proxy API. L'Editor proxy consente di visualizzare la struttura proxy API e configurarne il flusso. (un flusso è solo il percorso graduale intrapreso da una richiesta proxy API attraverso la piattaforma Apigee. Altri tutorial tratteranno il concetto di flussi.)
- Nel riquadro Navigatore, seleziona Endpoint di destinazione >
predefinita > PreFlow:
Apigee visualizza le impostazioni dell'endpoint nel riquadro Codice:
<TargetEndpoint name="default"> <Description/> <FaultRules/> <PreFlow name="PreFlow"> <Request/> <Response/> </PreFlow> <PostFlow name="PostFlow"> <Request/> <Response/> </PostFlow> <Flows/> <HTTPTargetConnection> <Properties/> <URL>https://mocktarget.apigee.net</URL> </HTTPTargetConnection> </TargetEndpoint>
L'endpoint di destinazione viene definito dall'
<HTTPTargetConnection>
. Modifica l'URL in
"https://mocktarget.apigee.net/xml"
. (Aggiungi "/xml" all'URL esistente).Il nuovo URL restituisce un piccolo blocco di XML nel corpo della risposta.
La configurazione dell'endpoint ora dovrebbe essere simile alla seguente:
... <HTTPTargetConnection> <Properties/> <URL>https://mocktarget.apigee.net/xml</URL> </HTTPTargetConnection> ...
Per salvare le modifiche apportate alla configurazione del proxy, fai clic sul pulsante Salva. .
Apigee salva le modifiche in una nuova revisione del proxy.
- Per eseguire il deployment della nuova revisione, seleziona Esegui il deployment in: test e fai clic su Esegui il deployment 2.
- Nella finestra di dialogo di conferma, fai clic su Esegui il deployment.
In caso di errore, Apigee salverà le modifiche, ma non eseguirà il deployment del proxy. Nella in caso di errore:
- Correggi la configurazione del proxy. Apigee può fornire indicazioni sulla sintassi sotto forma di popup.
- Esegui manualmente il deployment delle modifiche all'ambiente
test
facendo clic su Implementazione > test se Apigee non ne esegue automaticamente il deployment.
Puoi verificare se il deployment della revisione del proxy è stato eseguito correttamente visualizzando il lo stato di revisione del deployment accanto all'elenco a discesa Deployment. Ad esempio:
Testa il proxy
Puoi testare le modifiche inviando una richiesta al tuo proxy, proprio come hai fatto nella
Chiama il proxy API. Nell'esempio seguente si presuppone che
il proxy è denominato myproxy
:
curl https://YOUR_ENV_GROUP_HOSTNAME/myproxy
dove YOUR ENV_GROUP_HOSTNAME
è il nome host del gruppo di ambienti. Consulta:
Trova il nome host del gruppo di ambienti.
Questa volta, l'endpoint fittizio restituisce XML nel corpo della risposta:
<?xml version="1.0" encoding="UTF-8"?> <root> <city>San Jose</city> <firstName>John</firstName> <lastName>Doe</lastName> <state>CA</state> </root>
Ora che il proxy API restituisce i dati XML, nel passaggio successivo aggiungerai un criterio che converte il codice da XML in JSON.
1 2 3 4 (SUCCESSIVO) Passaggio 5: aggiungere un criterio