Azure APIM git integration json file format

Han Shih 施學翰 146 Reputation points
2021-11-11T05:35:25.027+00:00

According to the document, I am able update my APIs with pull&push commands.

I wonder if there is any document providing the information about the rule of "how to edit these files?"
I only find the information about folder structure.

The reason why I asking this is that I currently use YAML files to update API specs, and now I want to find a way to keep the track of API specs modifications.

Then I find this document, however, the file format is quite different from the YAML files.
So I want to know if the files I pulled from APIM follow some kind of rules that is widely used by developers? Or it is just a special format for Azure APIM only?

Azure API Management
Azure API Management
An Azure service that provides a hybrid, multi-cloud management platform for APIs.
1,086 questions
{count} votes

Accepted answer
  1. Pramod Valavala 14,546 Reputation points Microsoft Employee
    2021-12-07T13:41:51.887+00:00

    @Han Shih 施學翰 I'm unsure if the schema for it is published but it is a custom format which is kind of a consolidated object of all the relevant properties for an API like authentication settings, revisions, operations, schemas, etc.

    Since the YAML files that you use are OpenAPI Files, you could instead export the OpenAPI Spec before/after deployment and use this to keep track of changes.

    Also, you might want to explore the CI/CD using ARM Templates doc for the official recommendation for controlled development and deployment.

    No comments

0 additional answers

Sort by: Most helpful