Skip to content

Latest commit

 

History

History
45 lines (29 loc) · 2.34 KB

6 - Versions.md

File metadata and controls

45 lines (29 loc) · 2.34 KB
Raw

Exercise 6: Publish a new version

In this final exercise, we will create and publish a new version of an API in Azure API Management.

Why use API versions

Versions are often used when breaking changes are introduced to an API. Some examples that validate new versions may include:

  • Changes in the format of the response for one or more operations
  • Removal of operations or other key components
  • Changes in the response type of an operation
  • Release-based versions, such as alpha or beta, which are available for a limited time

Learn more about versions in Azure API Management.

Steps

Create a new version

  1. Navigate to your API Management service in the Azure portal.
  2. Go to APIs and select an existing API.
  3. Open the context menu by selecting ... next to the API name and choose + Add version.
  4. Follow the steps from the "Choose a versioning scheme" section of the official "Add multiple versions" tutorial to configure the scheme.

Associate the version with a product

You can associate an API version with products at the time the version is created, or at a later time if necessary. To associate an API with products after the creation of a version, follow these steps:

  1. Select Products from the menu of your API Management instance in the Azure portal.
  2. Select one of the existing products in the list.
  3. Click Add API from the menu at the top of the product overview.
  4. Select the API with the version that you just created.
  5. Click Select

Related resources

Next step

Congratulations! 🥳 😎 🎉

You have just completed the whole serverless APIs workshop and you now know how to build and manage APIs with serverless technologies. Navigate to the main readme file to explore more resources.