Ora che hai configurato Google Cloud e l'interfaccia utente di Apigee e hai installato e configurato il runtime, puoi scoprire come funzionano insieme.
1. Creare un nuovo proxy API utilizzando l'interfaccia utente di Apigee
Questa sezione descrive come creare un nuovo proxy API nell'interfaccia utente utilizzando la procedura guidata Proxy API.
Apigee nella console Cloud
Per creare un nuovo proxy API utilizzando Apigee nella console Cloud:
Seleziona la tua organizzazione dal menu a discesa nell'angolo in alto a sinistra.
Seleziona Sviluppo proxy > Proxy API nella visualizzazione principale.
Fai clic su Crea.Viene avviata la procedura guidata per i proxy API.
Seleziona Proxy inverso (il più comune).
Viene visualizzata la visualizzazione Dettagli proxy.
Configura il proxy con le seguenti impostazioni:
Nome del proxy: inserisci myproxy. I passaggi rimanenti di questa sezione presuppongono
che questo sia l'ID del tuo proxy.
Percorso di base: impostato automaticamente su / seguito dal nome del proxy, che in questo esempio è /myproxy. Il percorso
di base fa parte dell'URL utilizzato per inviare richieste all'API. Apigee utilizza l'URL per associare e instradare le richieste in entrata al proxy API corretto.
(Facoltativo) Descrizione:inserisci una descrizione per il nuovo proxy API, ad esempio "Test di Apigee Hybrid con un proxy semplice".
Destinazione (API esistente): inserisci "https://mocktarget.apigee.net". Questo definisce l'URL di destinazione invocato da Apigee su una richiesta al proxy API. Il servizio mocktarget è ospitato su Apigee e restituisce dati semplici. Non richiede una chiave API o un token di accesso.
I dettagli del proxy API dovrebbero avere il seguente aspetto:
Fai clic su Avanti.
In Esegui il deployment (facoltativo), hai la possibilità di selezionare uno o più ambienti in cui eseguire il deployment del proxy nel campo Ambienti di deployment.
Se preferisci non eseguire il deployment del proxy in questo
momento, lascia vuoto il campo Ambienti di deployment. Puoi sempre eseguire il deployment
del proxy in un secondo momento.
Fai clic su Crea.
Apigee genera il proxy (a volte chiamato bundle del proxy).
Apigee mostra la visualizzazione Riepilogo proxy.
Se hai scelto di eseguire il deployment del proxy, nella sezione Deployment viene visualizzato il numero di Revisione, che è 1 al primo deployment. La colonna Stato mostra gli ambienti in cui è stato eseguito il deployment del proxy con un indicatore di stato verde.
Sotto, la sezione Revisioni mostra tutte le revisioni apportate a questo proxy. Se
fai clic su uno degli elementi VISTA nella colonna Riepilogo endpoint, viene visualizzata la sezione Endpoint:
Endpoint proxy: il percorso base impostato per il proxy, che in questo esempio è /myproxy.
Endpoint target: il percorso base impostato per il target, che in questo
esempio è https://mocktarget.apigee.net.
Apigee classica
Per creare un nuovo proxy API utilizzando Apigee Classic:
Seleziona la tua organizzazione dal menu a discesa nell'angolo in alto a sinistra.
Seleziona Sviluppa > Proxy API nella visualizzazione principale.
Fai clic su Crea nuovo.Viene avviata la procedura guidata Proxy API.
Seleziona Proxy inverso (il più comune).
Viene visualizzata la visualizzazione Dettagli proxy.
Configura il proxy con le seguenti impostazioni:
Nome del proxy: inserisci "myproxy". I passaggi rimanenti di questa sezione presuppongono
che questo sia l'ID del tuo proxy.
Percorso base del proxy: impostato automaticamente su "/myproxy". Il percorso base del proxy fa parte dell'URL utilizzato per inviare richieste all'API. Apigee utilizza l'URL per associare e instradare le richieste in entrata al proxy API corretto.
(Facoltativo) Descrizione:inserisci una descrizione per il nuovo proxy API, ad esempio "Test di Apigee Hybrid con un proxy semplice".
Destinazione (API esistente): inserisci "https://mocktarget.apigee.net". Questo definisce l'URL di destinazione invocato da Apigee su una richiesta al proxy API. Il servizio mocktarget è ospitato su Apigee e restituisce dati semplici. Non richiede una chiave API o un token di accesso.
I dettagli del proxy API dovrebbero avere il seguente aspetto:
Fai clic su Avanti.
Nella schermata Regole comuni, seleziona Passa (nessuna autorizzazione) come opzione di sicurezza.
Fai clic su Avanti.
Nella schermata Riepilogo, seleziona un ambiente in cui eseguire il deployment del proxy e
fai clic su Crea ed esegui il deployment.
Hybrid genera il proxy (a volte chiamato bundle del proxy) e lo esegue nell'ambiente selezionato.
Fai clic su Vai all'elenco di proxy.
Apigee mostra la visualizzazione Proxy, che mostra un elenco di proxy API. Il nuovo proxy dovrebbe essere visualizzato con un indicatore di stato verde, a indicare che è stato implementato.
2. Chiama il proxy API
Quando l'interfaccia utente indica che il proxy è stato disegnato, puoi provare a chiamarlo utilizzando cURL o il client REST di tua scelta.
Ad esempio:
Trova l'indirizzo IP esterno e la porta del gateway di ingresso Apigee con il seguente comando:
kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
L'output dovrebbe avere il seguente aspetto:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
apigee-ingressgateway-prod-hybrid-37a39bd LoadBalancer 192.0.2.123 233.252.0.123 15021:32049/TCP,80:31624/TCP,443:30723/TCP 16h
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThis content guides users through creating a new API proxy in either the Apigee in Cloud console or the classic Apigee UI, utilizing the API Proxy Wizard.\u003c/p\u003e\n"],["\u003cp\u003eThe created API proxy, named "myproxy," is configured with a base path and a target URL (https://mocktarget.apigee.net), and can be optionally deployed to specific environments.\u003c/p\u003e\n"],["\u003cp\u003eOnce deployed, the API proxy can be called using tools like cURL, and successful calls will return an HTTP 200 response code along with a "Hello, Guest!" message.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves setting up environment variables, finding the external IP and port of the Apigee ingress gateway, and then using those values to formulate a cURL command to test the proxy.\u003c/p\u003e\n"],["\u003cp\u003eThe document indicates that this is the successful completion of the Apigee Hybrid set up, and then provides links to learn more about API Proxies.\u003c/p\u003e\n"]]],[],null,["# Step 2: Deploy an API proxy\n\n| You are currently viewing version 1.13 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nNow that you've configured and the Apigee UI, and installed and configured the\nruntime, you're ready to see how it all works together.\n\n1. Create a new API proxy using the Apigee UI\n---------------------------------------------\n\nThis section describes how to create a new API proxy in the UI using the API Proxy Wizard.\n**Note:** There is a new version of the Apigee UI, which is integrated with the Google Cloud console. The new UI is called *Apigee in Cloud console*. The instructions in the first two tabs below explain how to use either Apigee in Cloud console or classic Apigee UI. \n\n### Apigee in the Cloud console\n\nTo create a new API proxy using Apigee in the Cloud console:\n\n1. Open [Apigee UI in Cloud console](https://console.cloud.google.com/apigee) in a browser.\n2. Select your organization from the dropdown menu in the upper left corner.\n3. Select **Proxy development \\\u003e API proxies** in the main view.\n4. Click **Create**.The API Proxy Wizard starts.\n5. Select **Reverse proxy** (most common).\n\n The **Proxy details** view is displayed.\n6. Configure your proxy with the following settings:\n - **Proxy name:** Enter **myproxy**. The remaining steps in this section assume that this is your proxy's ID.\n - **Base path:** Automatically set to **/** followed by the proxy name, which in this example is **/myproxy** . The **Base\n path** is part of the URL used to make requests to your API. Apigee uses the URL to match and route incoming requests to the proper API proxy.\n - (Optional)**Description:** Enter a description for your new API proxy, such as \"Testing Apigee hybrid with a simple proxy\".\n - **Target (Existing API):** Enter \"https://mocktarget.apigee.net\". This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n\n Your API proxy's details should look like the following:\n\n7. Click **Next**.\n8. Under **Deploy (optional)** , you have the option to select one or more environments in which to deploy your proxy, in the **Deployment environments** field. If you prefer not to deploy the proxy at this point, leave the **Deployment environments** field empty. You can always deploy the proxy later.\n9. Click **Create** . Apigee generates the proxy (sometimes referred to as *the proxy bundle* ).\n\n \u003cbr /\u003e\n\nApigee displays the **Proxy summary** view.\nIf you chose to deploy the proxy, the **Deployments** section displays the **Revision**\nnumber, which is 1 when you first deploy. The **Status** column displays the\nenvironments in which the proxy is deployed with a green status indicator.\n\nBelow that, the **Revisions** section shows all revisions made to this proxy. By\nclicking on one of the **VIEW** items in the **Endpoint summary** column, the\n**Endpoint** section displays:\n\n- **Proxy endpoints** : The basepath you set for the proxy, which is this example is `/myproxy`.\n- **Target endpoints** : The basepath you set for the target, which in this example is `https://mocktarget.apigee.net`.\n\n### Classic Apigee\n\nTo create a new API proxy using Classic Apigee:\n\n1. Open [Apigee UI](https://apigee.google.com) in a browser.\n2. Select your organization from the dropdown menu in the upper left corner.\n3. Select **Develop \\\u003e API Proxies** in the main view.\n4. Click **Create New**.The API Proxy Wizard starts.\n5. Select **Reverse proxy** (most common).\n\n The **Proxy details** view is displayed.\n6. Configure your proxy with the following settings:\n - **Proxy Name:** Enter \"myproxy\". The remaining steps in this section assume that this is your proxy's ID.\n - **Proxy Base Path:** Automatically set to \"/myproxy\". The **Proxy Base\n Path** is part of the URL used to make requests to your API. Apigee uses the URL to match and route incoming requests to the proper API proxy.\n - (Optional)**Description:** Enter a description for your new API proxy, such as \"Testing Apigee hybrid with a simple proxy\".\n - **Target (Existing API):** Enter \"https://mocktarget.apigee.net\". This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n\n Your API proxy's details should look like the following:\n\n7. Click **Next**.\n8. On the **Common policies** screen, select **Pass through (no authorization)** as the security option.\n9. Click **Next**.\n10. On the **Summary** screen, select an environment to deploy your proxy to and click **Create and Deploy** .\n\n Hybrid generates the proxy (sometimes referred to as *the proxy bundle*) and deploys it to the environment you selected.\n11. Click **Go to proxy list** .\n\n Apigee displays the **Proxies** view, which displays a list of API proxies. Your\n new proxy should display with a green status indicator, meaning that it has been deployed.\n\n2. Call the API proxy\n---------------------\n\nWhen the UI indicates your proxy is deployed, you can try calling it using cURL or the REST\nclient of your choice.\nFor example:\n\n1. Make sure your `DOMAIN` environment variable is set to the domain name you used for the hostname for your environment group in [Project and org\n setup - Step 3: Create an environment group](/apigee/docs/hybrid/v1.13/precog-add-environment). \n\n ```\n echo $DOMAIN\n ```\n2. Find the external IP address and port of the Apigee ingress gateway with the following command:\n\n ```\n kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway\n ```\n\n\n Your output should look something like: \n\n ```\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n apigee-ingressgateway-prod-hybrid-37a39bd LoadBalancer 192.0.2.123 233.252.0.123 15021:32049/TCP,80:31624/TCP,443:30723/TCP 16h\n ```\n3. Export your external IP and port to variables: \n\n export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS\n export INGRESS_PORT=\u003cvar translate=\"no\"\u003ePORT_NUMBER\u003c/var\u003e\n\n4. Call the API proxy: \n\n ```\n curl -H Host:$DOMAIN --resolve \\\n $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS \\\n https://$DOMAIN:$INGRESS_PORT/myproxy -k -v\n ```\n\n\n For example: \n\n ```\n curl -v -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k -v\n ```\n5. A successful call to the proxy returns an HTTP 200 response code and the following output.\u003cbr /\u003e\n\n ```\n Hello, Guest!\n ```\n\n\nTo learn more about building and deploying API proxies, see [Build your first proxy overview](/apigee/docs/api-platform/get-started/get-started).\n| **Congratulations!**\n|\n| You've successfully installed Apigee hybrid. To learn more about building and deploying\n| API proxies, see [Introduction to API proxy building](/apigee/docs/api-platform/fundamentals/build-simple-api-proxy).\n\n*[Google Cloud]: Google Cloud"]]
