Recommended next steps

This page applies to Apigee and Apigee hybrid.

View Apigee Edge documentation.

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

Permissions required for this task

Creating and deploying proxies requires a minimum set of permissions. If you have the Apigee Org Admin role, you can complete this task. To learn about other roles you can employ, see Apigee roles.

The provisioning process for Apigee does not automatically create and deploy an API proxy for you. You must create and deploy a proxy manually.

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.

Apigee UI in the Cloud console

To create and deploy your first proxy:

1. Open the Apigee UI in Cloud console in a browser.
2. 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.
3. In the left navigation pane, click Proxy development > API proxies.
4. Click + Create.

   The Create a proxy page opens.

5. In the Proxy template box, select Reverse proxy (most common).
6. In Step 1: Proxy details, configure your proxy with the following values:

   Parameter name	Value
   Proxy name	hello-world
   Base path	/hello-world
   Target (Existing API)	mocktarget.apigee.net

7. Click Next.
8. In Step 2: Deploy (optional):
   • 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.
   • 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.
9. Click Create.

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

   Note: The proxy is not fully deployed instantaneously. It can take up to a minute for the proxy to deploy.
10. 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 and follow the steps to deploy it manually.
11. In the left navigation pane, select Management > Environments > Environment Groups.
12. Copy the hostname for your environment group. You'll use this hostname to call the API proxy in the next steps.

Apigee UI

To create and deploy your first proxy:

1. Sign in to the Apigee UI.
2. 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.
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 values:

   Parameter name	Value
   Name	hello-world
   Base path	/hello-world
   Target (Existing API)	https://mocktarget.apigee.net

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 in which to deploy the proxy.
12. Click Create and deploy.

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

    Note: The proxy is not fully deployed instantaneously. It can take up to a minute for the proxy to deploy.
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. Click View in Google Cloud console.
16. Copy the hostname for your environment group. You'll use this hostname to call the API proxy in the next steps.
17. Close the Google Cloud console.

Call the proxy with internal access

If you allowed internal access in Step 4: Customize 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 4: Customize 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 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.
   • 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:
   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.

   curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
     https://YOUR_INSTANCE_IP_OR_DNS/hello-world

   Where:

   • The value of the Host header (YOUR_ENV_GROUP_HOSTNAME) is the hostname from the Environments > Environment Groups page.

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

Next steps

• Take a tour of the Apigee tutorials, including:
  • Guarding against sudden traffic spikes.
  • Getting a detailed view of the request/response flow.