Revision

• Revisions allow you to make changes to your APIs in a controlled and safe way
• When you want to make changes, create a new revision
• You can then edit and test API without disturbing your API consumers -> when you’re ready, you then make your revision current
• Links:
  • https://docs.microsoft.com/en-us/azure/api-management/api-management-get-started-revise-api

Version

• Versions allow you to present groups of related APIs to your developers
• You can use versions to handle breaking changes in your API safely
• Clients can choose to use your new API version when they’re ready, while existing clients continue to use an older version
• Versions are differentiated through a version identifier and a versioning scheme allows clients to identify which version of an API they want to use
• Links:
  • https://docs.microsoft.com/en-us/azure/api-management/api-management-versions

Creating revision

• Go to resource groups: https://portal.azure.com/#blade/HubsExtension/BrowseResourceGroups
• Select resource group > API Management service
• APIs section > APIs
• Click ‘・・・’ of target API > Add revision
• Enter description > Create
• Select target revision from top dropdown and make changes to that revision as you need

Making a revision current

• Go to resource groups: https://portal.azure.com/#blade/HubsExtension/BrowseResourceGroups
• Select resource group > API Management service
• APIs section > APIs
• Select target API > Revisions tab
• Click ‘・・・’ of target revision > Make current

Creating version

• Go to resource groups: https://portal.azure.com/#blade/HubsExtension/BrowseResourceGroups
• Select resource group > API Management service
• APIs section > APIs
• Click ‘・・・’ of target API > Add version

Creating version from a revision

• Go to resource groups: https://portal.azure.com/#blade/HubsExtension/BrowseResourceGroups
• Select resource group > API Management service
• APIs section > APIs
• Select target API > Revisions tab
• Click ‘・・・’ of target revision > Create version from this revision