sdk

README

Azure SDK for Go

This repository is for active development of the Azure SDK for Go. For consumers of the SDK you can follow the links below to visit the documentation you are interested in

• Overview of Azure SDK for Go
• SDK Reference
• Code Samples for Azure Go SDK
• Azure REST API Docs
• General Azure Docs

New Releases

A new set of management libraries for Go that follow the Azure SDK Design Guidelines for Go are now available. These new libraries provide a number of core capabilities that are shared amongst all Azure SDKs, including the intuitive Azure Identity library, an HTTP Pipeline with custom policies, error-handling, distributed tracing, and much more. Those new libraries can be identified by locating them under the /sdk directory in the repo, and you can find the corresponding references here.

To get started, please follow the quickstart guide here. To see the benefits of migrating to the new libraries, please visit this migration guide that shows how to transition from older versions of libraries.

You can find the most up to date list of all of the new packages on this page as well as our official releases page

Previous Versions

Previous Go SDK packages are located under /services folder, and you can see the full list on this page. They might not have the same feature set as the new releases but they do offer wider coverage of services.

Getting Started

For instructions and documentation on how to use our Azure SDK for Go, we have provided quick-start tutorials for both new and previous releases.

• Quickstart tutorial for new releases. Documentation is also available at each readme file of the individual module (Example: Readme for Compute Module)
• Quickstart tutorial for previous versions

Other Azure Go Packages

Azure provides several other packages for using services from Go, listed below. If a package you need isn't available please open an issue and let us know.

Service	Import Path/Repo
Storage - Blobs	github.com/Azure/azure-storage-blob-go
Storage - Files	github.com/Azure/azure-storage-file-go
Storage - Queues	github.com/Azure/azure-storage-queue-go
Service Bus	github.com/Azure/azure-service-bus-go
Event Hubs	github.com/Azure/azure-event-hubs-go
Application Insights	github.com/Microsoft/ApplicationInsights-go

Packages that are still in public preview can be found under the services/preview directory. Please be aware that since these packages are in preview they are subject to change, including breaking changes, outside of a major semver bump.

Samples

More code samples for using the management library for Go SDK can be found in the following locations

• Go SDK Code Samples Repo
• Example files under each package. For example, examples for Network packages can be found here

Reporting security issues and security bugs

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

Need help?

• File an issue via Github Issues
• Check previous questions or ask new ones on StackOverflow using azure and go tags.

Community

• Chat with us in the #Azure SDK channel on the Gophers Slack. Sign up here first if necessary.

Contribute

See CONTRIBUTING.md.

Documentation

Overview

Package sdk provides Go packages for managing and using Azure services.

GitHub repo: https://github.com/Azure/azure-sdk-for-go

Official documentation: https://docs.microsoft.com/azure/go

API reference: https://godoc.org/github.com/Azure/azure-sdk-for-go

Samples: https://github.com/Azure-Samples/azure-sdk-for-go-samples