jrwren/azure-sdk-for-go

Microsoft Azure SDK for Go

Microsoft Azure SDK for Go

This is Microsoft Azure's core repository for hosting Go packages which offer a more convenient way of targeting Azure REST endpoints. Here, you'll find a mix of code generated by Autorest and hand maintained packages.

NOTE: This repository is under heavy ongoing development and should be considered a preview. Vendoring your dependencies is always a good idea, but it is doubly important if you're consuming this library.

Installation

• If you don't already have it, install the Go Programming Language.
• Go get the SDK:

$ go get -u github.com/Azure/azure-sdk-for-go

IMPORTANT: We highly suggest vendoring Azure SDK for Go as a dependency. For vendoring dependencies, Azure SDK for Go uses glide.

Versioning

SDK Versions

The tags in this repository are based on, but do not conform to SemVer.org's recommendations. For now, the "-beta" tag is an indicator that we are still in preview and still are planning on releasing some breaking changes.

In repositories that are children of this one, storage for example, we have adopted SemVer.org's recommendations.

Azure Versions

Azure services mostly do not use SemVer based versions. Rather, they use profiles identified by dates. One will often see this casually referred to as an "APIVersion". At the moment, our SDK only supports the most recent profiles. In order to lock to an API version, one must also lock to an SDK version. However, as discussed in #517, our objective is to reorganize and publish independent packages for each profile. In that way, we'll be able to have parallel support in a single SDK version for all APIVersions supported by Azure.

Documentation

• Azure SDK for Go Documentation is available at GoDoc.org.
• Azure REST APIs used by packages in this repository are documented at Microsoft Docs, Azure REST.
• Azure Services are discussed in detail at Microsoft Docs, Azure Services.

License

This project is published under Apache 2.0 License.

Contribute

If you would like to become an active contributor to this project please follow the instructions provided in Microsoft Azure Projects Contribution Guidelines.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.