README.md

Azure REST API Specifications

This repository is the canonical source for REST API specifications for Microsoft Azure.

Directory Structure

The structure of the directory should strictly follow these rules:

• The top level folder must be the service name
• The second level must be the API versions
• The third level must be the format of the specification
• The fourth level must be the specifications

The structure should appear like so:

.
├── arm-authorization
│   └── 2015-01-01
│       └── swagger
│           └── authorization.json
├── arm-compute
│   └── 2015-06-15
│       └── swagger
│           └── service.json
├── arm-features
│   └── 2014-08-01-preview
│       └── swagger
│           └── features.json
├── arm-network
│   └── 2015-05-01-preview
│       └── swagger
│           └── service.json
├── arm-resources
│   └── 2014-04-01-preview
│       └── swagger
│           └── service.json
├── arm-storage
│   └── 2015-05-01-preview
│       └── swagger
│           └── service.json
├── arm-subscriptions
│   └── 2014-04-01-preview
│       └── swagger
│           └── service.json
├── arm-web
├── documentation
└── readme.md

At this point, the specifications are expected to be in swagger format.

Creating the Swagger Specification for Azure

This document will help you understand how AutoRest converts Swagger in to code.

How to validate your swagger

• You can use this json schema validator
  • In the upper left box, paste the swagger schema from here
  • In the lower left box, paste your swagger json
  • Upon clicking the validate button, you should either see errors or success.

Generating Code from Specifications

If you are interested in generating code from these specifications, please check out AutoRest. There you will find the code generator as well as instructions on how to use it.

How to Contribute

Please contribute to services you know and love. The curation of these specifications will ensure that we have great documentation and even better client library support for our Azure Services. If you have any questions, please reach out to the autoresteng dl.

Submitting changes

Please send a GitHub Pull Request to Azure REST API Specs with a clear list of what you've done (read more about pull requests). When you send a pull request, we will love you forever if you include additions to the documentation for your given service. We can always use more documentation and beautiful markdown. Please follow make sure all of your commits are atomic (one feature per commit).

Always write a clear log message for your commits. One-line messages are fine for small changes, but bigger changes should look like this:

$ git commit -m "A brief summary of the commit
>
> A paragraph describing what changed and its impact."

Please be kind with your pull requests and ensure you keeping them as focused and cohesive as possible. Keep your pull request free of merge commits, code review fixes and anything that may take away from the essence of your contribution. Use the git tools you have available to you, such as amend, rebase, etc.