Per creare e implementare un proxy API di test, segui i passaggi riportati di seguito. Infine,
testa il proxy API inviandogli una richiesta HTTP.
Creazione e deployment di un proxy API
Autorizzazioni richieste per questa attività
La creazione e il deployment dei proxy richiedono un insieme minimo di autorizzazioni.
Se hai il ruolo Amministratore organizzazione Apigee, puoi completare questa attività.
Per scoprire altri ruoli che puoi utilizzare, consulta
Ruoli Apigee.
Il processo di provisioning per Apigee non crea
e non esegue automaticamente il deployment di un proxy API. Devi creare e implementare un proxy manualmente.
UI Apigee nella console Cloud
Per creare ed eseguire il deployment del tuo primo proxy:
Nella console Google Cloud , vai alla pagina Sviluppo proxy > Proxy API.
Assicurati che il nome della tua organizzazione sia selezionato dal selettore di progetti
nel riquadro Google Cloud. Il nome dell'organizzazione è lo stesso
del nome del tuo Google Cloud progetto.
Fai clic su + Crea.
Viene visualizzata la pagina Crea un proxy.
Nella casella Modello proxy, seleziona Reverse proxy (il più comune).
In Passaggio 1: dettagli del proxy, configura il proxy con i seguenti valori:
Nome parametro
Valore
Nome proxy
hello-world
Percorso base
/hello-world
Target (API esistente)
mocktarget.apigee.net
Fai clic su Avanti.
Nel passaggio 2: implementa (facoltativo):
Deployment environments (ambienti di deployment): facoltativo. Utilizza le caselle di controllo
per selezionare uno o più ambienti in cui eseguire il deployment del proxy.
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.
Service account: facoltativo. Collega un account di servizio al tuo deployment per consentire al proxy di accedere ai servizi Google Cloud, come specificato nel ruolo e nelle autorizzazioni del account di servizio.
Fai clic su Crea.
Il nuovo proxy API viene creato e sottoposto a deployment nell'ambiente selezionato.
Si apre la pagina Riepilogo proxy del proxy appena creato.
Un segno di spunta verde in Stato indica che il
proxy è stato implementato correttamente. Se il proxy non è stato eseguito il deployment, consulta
Deployment di un proxy API e segui i passaggi per eseguirlo manualmente.
Nel riquadro di navigazione a sinistra, seleziona
Gestione > Ambienti > Gruppi di ambienti.
Copia il nome host per il gruppo di ambienti. Utilizzerai questo
nome host per chiamare il proxy API nei passaggi successivi.
Apigee classico
Per creare ed eseguire il deployment del tuo primo proxy:
Assicurati che il nome della tua organizzazione sia selezionato dal menu a discesa
nell'angolo in alto a sinistra dell'interfaccia utente. Il nome dell'organizzazione è lo stesso del nome del tuo progetto Google Cloud.
Fai clic su Proxy API nella visualizzazione principale.
Dall'elenco a discesa Seleziona ambiente,
seleziona un ambiente.
Fai clic su Crea nuova.
Fai clic su Reverse proxy (il più comune).
Nella pagina Dettagli proxy, configura il proxy con i
seguenti valori:
Nome parametro
Valore
Nome
hello-world
Percorso base
/hello-world
Target (API esistente)
https://mocktarget.apigee.net
Fai clic su Avanti.
Nella pagina Norme comuni, in Sicurezza:
Autorizzazione seleziona Pass-through (nessuna autorizzazione).
Fai clic su Avanti.
Nella pagina Riepilogo, in Deployment facoltativo,
seleziona l'ambiente in cui eseguire il deployment del proxy.
Fai clic su Crea ed esegui il deployment.
Il nuovo proxy API viene creato
e sottoposto a deployment nell'ambiente selezionato.
Fai clic su Vai all'elenco dei proxy. Un segno di spunta verde in
Stato indica che il proxy è stato implementato correttamente. Se
il proxy non è stato eseguito il deployment, consulta
Deployment di un proxy API e segui i passaggi per eseguirlo manualmente.
Nel riquadro di navigazione a sinistra, seleziona Amministrazione > Ambienti > Gruppi.
Fai clic su Visualizza nella console Google Cloud .
Copia il nome host per il gruppo di ambienti. Utilizzerai questo
nome host per chiamare il proxy API nei passaggi successivi.
Configura una voce DNS per l'host. Ecco due modi per svolgere
questa attività:
Nel registrar, crea un record A che indirizzi il nome host del gruppo di ambienti all'IP mostrato nella pagina della procedura guidata in Configura DNS. Ad esempio, se il tuo
nome host è sales.example.com e l'IP è 10.23.0.2, punta il
record per sales.example.com all'indirizzo 10.23.0.2.
Utilizza Cloud DNS di Google per mappare un URL a un indirizzo IP.
Testa il proxy API inviando la seguente richiesta in una finestra del terminale:
[[["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-05 UTC."],[[["\u003cp\u003eThis page provides instructions for creating and deploying a test API proxy in Apigee or Apigee hybrid environments, which can be done using either the Apigee UI in the Cloud console or the classic Apigee UI.\u003c/p\u003e\n"],["\u003cp\u003eCreating and deploying API proxies requires specific permissions, notably the Apigee Org Admin role, but alternative roles are detailed in the Apigee roles documentation.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves configuring a reverse proxy with a specified name, base path, and target API, then optionally deploying it to selected environments, with the created proxy being displayed in the Proxy Summary page.\u003c/p\u003e\n"],["\u003cp\u003eAfter deployment, you can test the API proxy by sending an HTTP request to it, either with internal or external access, by setting up a DNS entry and using the provided \u003ccode\u003ecurl\u003c/code\u003e command with the correct environment group hostname.\u003c/p\u003e\n"],["\u003cp\u003eThe page also suggests several next steps, such as taking a tour of Apigee tutorials for learning about guarding against traffic spikes and getting a detailed view of the request/response flow.\u003c/p\u003e\n"]]],[],null,["# Recommended next steps\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nWhat you're doing in this step\n------------------------------\n\n\nFollow the steps below to create and deploy a test API proxy. Finally,\ntest the API proxy by sending an HTTP request to it.\n\nCreate and deploy an API proxy\n------------------------------\n\n#### Permissions required for this task\n\n\nCreating and deploying proxies requires a minimum set of permissions.\nIf you have the Apigee Org Admin role, you can complete this task.\nTo learn about other roles you can employ, see\n[Apigee roles](/apigee/docs/api-platform/system-administration/apigee-roles).\n\nThe provisioning process for Apigee does not automatically create\nand deploy an API proxy for you. You must create and deploy a proxy manually. \n\n### Apigee UI in the Cloud console\n\nTo create and deploy your first proxy:\n\n1. In the Google Cloud console, go to the **Proxy development \\\u003e API proxies** page.\n\n [Go to API proxies](https://console.cloud.google.com/apigee/proxies)\n2. Be sure that your organization name is selected from the project picker in the **Google Cloud** pane. The organization name is the same as your Google Cloud project name.\n3. Click **+ Create** .\n\n The **Create a proxy** page opens.\n4. In the **Proxy template** box, select **Reverse proxy (most common)**.\n5. In **Step 1: Proxy details** , configure your proxy with the following values:\n\n6. Click **Next**.\n7. In **Step 2: Deploy (optional)** :\n - **Deployment environments** : Optional. Use the checkboxes to select one or more environments in which to deploy your proxy. If you prefer not to deploy the proxy at this point, leave the **Deployment environments** field empty. You can always deploy the proxy later.\n - **Service Account**: Optional. Attach a service account to your deployment to enable your proxy to access Google Cloud services, as specified in the service account's role and permissions.\n8. Click **Create** .\n\n Your new API proxy is created and deployed in the selected environment.\n | **Note:**The proxy is not fully deployed instantaneously. It can take up to a minute for the proxy to deploy.\n9. The **Proxy summary** page for your newly created proxy opens. A green check mark under **Status** indicates that the proxy was successfully deployed. If the proxy is not deployed, see [Deploying an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new) and follow the steps to deploy it manually.\n10. In the left navigation pane, select **Management \\\u003e Environments \\\u003e Environment Groups**.\n11. Copy the hostname for your environment group. You'll use this hostname to call the API proxy in the next steps.\n\n### Classic Apigee\n\nTo create and deploy your first proxy:\n\n1. Sign in to the [Apigee UI](https://apigee.google.com).\n2. Be sure that your organization name is selected from the drop-down menu in the upper left corner of the UI. The organization name is the same as your Google Cloud project name.\n3. Click **API Proxies** in the main view.\n4. From the **Select Environment** drop-down list, select an environment.\n5. Click **Create new**.\n6. Click **Reverse proxy (most common)**.\n7. In the **Proxy details** page, configure your proxy with the following values:\n\n8. Click **Next**.\n9. In the **Common policies** page, under **Security:\n Authorization** select **Pass through (no authorization)**.\n10. Click **Next**.\n11. On the **Summary** page, under **Optional Deployment**, select the environment in which to deploy the proxy.\n12. Click **Create and deploy** .\n\n Your new API proxy is created\n and deployed in the selected environment.\n | **Note:**The proxy is not fully deployed instantaneously. It can take up to a minute for the proxy to deploy.\n13. Click **Go to proxy list** . A green check mark under **Status** indicates that the proxy was successfully deployed. If the proxy is not deployed, see [Deploying an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new) and follow the steps to deploy it manually.\n14. In the left navigation pane, select **Admin \\\u003e Environments \\\u003e Groups**.\n15. Click **View in Google Cloud console**.\n16. Copy the hostname for your environment group. You'll use this hostname to call the API proxy in the next steps.\n17. Close the Google Cloud console.\n\nCall the proxy with internal access\n-----------------------------------\n\nIf you allowed *internal* access in\n[Step 4: Customize access routing](/apigee/docs/api-platform/get-started/configure-routing), follow the instructions in:\n[Calling an API proxy with internal-only access](/apigee/docs/api-platform/get-started/accessing-internal-proxies).\n\nCall the proxy with external access\n-----------------------------------\n\n\nIf you allowed *external* access in\n[Step 4: Customize access routing](/apigee/docs/api-platform/get-started/configure-routing), follow these steps:\n\n1. Set up a DNS entry for your host. Here are two ways to accomplish this task:\n - At your registrar, create an A record pointing your environment group hostname to the IP shown on the wizard page under **Configure DNS** . For example, if your hostname is `sales.example.com` and the IP is 10.23.0.2, then point the record for `sales.example.com` to the address `10.23.0.2`.\n - Use Google [Cloud DNS](/dns/docs) to map a URL to an IP address.\n 2. Test the API proxy by sending the following request in a terminal window: **Note:** DNS changes are published immediately, but may take time to propagate. Because of this delay, you may have to wait up to an hour before you can call the sample proxy. \n\n ```\n curl -v -H \"Host:YOUR_ENV_GROUP_HOSTNAME\" \\\n https://YOUR_INSTANCE_IP_OR_DNS/hello-world\n ```\n\n Where:\n - The value of the `Host` header (\u003cvar translate=\"no\"\u003eYOUR_ENV_GROUP_HOSTNAME\u003c/var\u003e) is the hostname from the **Environments \\\u003e Environment Groups** page.\n\n A successful request returns the string: `Hello, Guest!`.\n If your request is not successful, see [Troubleshooting](/apigee/docs/api-platform/get-started/troubleshooting-install).\n\nNext steps\n----------\n\n- [Take a tour](/apigee/docs/api-platform/get-started/tutorials) of the Apigee tutorials, including:\n - [Guarding against sudden\n traffic spikes](/apigee/docs/api-platform/tutorials/add-spike-arrest).\n - [Getting a detailed view of\n the request/response flow](/apigee/docs/api-platform/tutorials/view-with-trace)."]]
