Step 8: Deploy and call a sample proxy

Stay organized with collections Save and categorize content based on your preferences.

What you're doing in this step

Follow the steps below to create and deploy a test API proxy. Finally, test the API proxy by sending an HTTP request to it.

Create and deploy an API proxy

The installation wizard does not automatically create and deploy an API proxy for you. You must create and deploy a proxy manually.

  1. Sign in to the Apigee UI.
  2. Be sure that your organization name is selected from the dropdown menu in the upper left corner of the UI. The organization name is the same as your Google Cloud project name.
  3. Click API Proxies in the main view.
  4. From the Select Environment drop-down list, select an environment.
  5. Click Create new.
  6. Click Reverse proxy (most common).
  7. In the Proxy details page, configure your proxy with the following settings:
    Parameter name Value
    Name hello-world
    Base path /hello-world
    Target (Existing API)
  8. Click Next.
  9. In the Common policies page, under Security: Authorization select Pass through (no authorization).
  10. Click Next.
  11. On the Summary page, under Optional Deployment, select the environment to deploy the proxy to.
  12. Click Create and deploy.

    Your new API proxy is created and deployed in the selected environment.

  13. 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 and follow the steps to deploy it manually.
  14. In the left navigation pane, select Admin > Environments > Groups.
  15. Copy the hostname for your environment group. You'll use this hostname to call the API proxy in the next steps.

Call the proxy with internal access

If you allowed internal access in Step 7: Configure access routing, follow the instructions in: Calling an API proxy with internal-only access.

Call the proxy with external access

If you allowed external access in Step 7: Configure access routing, follow these steps:

  1. Set up a DNS entry for your host. Here are two ways to accomplish this task:
    • 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 and the IP is, then point the record for to the address
    • Use Google Cloud DNS to map a URL to an IP address.
  2. Test the API proxy by sending the following request in a terminal window:
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \


    • The value of the Host header (YOUR_ENV_GROUP_HOSTNAME) is the hostname that you defined on the environment group in Step 6: Create an environment.

    A successful request returns the string: Hello, Guest!. If your request is not successful, see Troubleshooting.

Next steps