To Promote the API to another Environment

A tight integration of Anypoint Platform components extends the use of environments to API management. In this procedure, you change the environment of an API.

Note: You must have Manage APIs Configuration permission to promote an API. You can only promote an entity (Policies, Alerts, etc.) if you have View* permissions on source and Manage* permissions on destination (over each entity). See Setting permissions.

  1. In API Manager, in API Administration, click Promote From Environment.

  2. In Promote API From Environment, in Source Environment, select the environment of the API you want to promote.

  3. In API, select an API from the list of APIs in the source environment.

  4. In API Version, select the version of the API.

  5. In API instance label, optionally select the API instance name if you created any instances.

  6. Select or deselect things to include in the promotion: Policies, SLAs, Alerts, API Configuration.

  7. Click Promote.

Note: Promoting an API affects only the API definition, not the existing deployed applications subscribed to the API. After promoting an API, the API Name remains the same, but the API Version changes.

For existing applications that need to subscribe to a promoted API, you need to make following changes:

  1. Update the API Version.

  2. As each environment has a different client ID and secret, update the application’s client ID and secret.

In this topic: