Introduction to deployments

This page applies to Apigee and Apigee hybrid.

A deployment is an API hub entity that describes where an API is hosted. For example, a deployment could represent an Apigee API proxy, an API deployed to Google Cloud API Gateway, or APIs deployed to other Google Cloud services or non-Google Cloud services.

You can associate an API version with multiple deployments to model scenarios such as dev, staging, user acceptance testing (UAT), and production deployments corresponding to a given version.

You can also associate multiple versions with a deployment in cases where multiple versions of an API (or potentially different APIs) are deployed together.

A deployment entity includes metadata such as name, display name, description, associated versions, and so on. The following three attributes specify details about the deployed API and are required to create a deployment in API hub:

Overview of deployments.
Figure 1. A deployment entity includes a deployment type, a resource URI, and endpoint URLs.
  • Deployment type: Specifies the type of deployment, such as Apigee, Apigee Hybrid, Apigee Edge Private Cloud, and others.
  • Resource URI: A URI to the deployment resource. For example, if the deployment resource is an Apigee API proxy, then this field must specify the URI to the management user interface of the proxy.
  • Endpoints: The endpoints on which the actual deployment of the API is listening to requests. For example, this field could be a list of IP addresses or hostnames.

For details on creating and managing deployments, see Manage deployments.