README
¶
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.
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.
Code samples
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 opencode@microsoft.com with any additional questions or comments.
Directories
¶
| Path | Synopsis |
|---|---|
|
arm
|
|
|
advisor
Package advisor implements the Azure ARM Advisor service API version 2017-04-19.
|
Package advisor implements the Azure ARM Advisor service API version 2017-04-19. |
|
analysisservices
Package analysisservices implements the Azure ARM Analysisservices service API version 2016-05-16.
|
Package analysisservices implements the Azure ARM Analysisservices service API version 2016-05-16. |
|
apimanagement
Package apimanagement implements the Azure ARM Apimanagement service API version .
|
Package apimanagement implements the Azure ARM Apimanagement service API version . |
|
apimdeployment
Package apimdeployment implements the Azure ARM Apimdeployment service API version 2016-07-07.
|
Package apimdeployment implements the Azure ARM Apimdeployment service API version 2016-07-07. |
|
appinsights
Package appinsights implements the Azure ARM Appinsights service API version .
|
Package appinsights implements the Azure ARM Appinsights service API version . |
|
authorization
Package authorization implements the Azure ARM Authorization service API version 2015-07-01.
|
Package authorization implements the Azure ARM Authorization service API version 2015-07-01. |
|
automation
Package automation implements the Azure ARM Automation service API version .
|
Package automation implements the Azure ARM Automation service API version . |
|
batch
Package batch implements the Azure ARM Batch service API version 2017-01-01.
|
Package batch implements the Azure ARM Batch service API version 2017-01-01. |
|
billing
Package billing implements the Azure ARM Billing service API version 2017-04-24-preview.
|
Package billing implements the Azure ARM Billing service API version 2017-04-24-preview. |
|
cdn
Package cdn implements the Azure ARM Cdn service API version 2016-10-02.
|
Package cdn implements the Azure ARM Cdn service API version 2016-10-02. |
|
cognitiveservices
Package cognitiveservices implements the Azure ARM Cognitiveservices service API version 2016-02-01-preview.
|
Package cognitiveservices implements the Azure ARM Cognitiveservices service API version 2016-02-01-preview. |
|
commerce
Package commerce implements the Azure ARM Commerce service API version 2015-06-01-preview.
|
Package commerce implements the Azure ARM Commerce service API version 2015-06-01-preview. |
|
compute
Package compute implements the Azure ARM Compute service API version 2016-04-30-preview.
|
Package compute implements the Azure ARM Compute service API version 2016-04-30-preview. |
|
consumption
Package consumption implements the Azure ARM Consumption service API version 2017-04-24-preview.
|
Package consumption implements the Azure ARM Consumption service API version 2017-04-24-preview. |
|
containerinstance
Package containerinstance implements the Azure ARM Containerinstance service API version 2017-08-01-preview.
|
Package containerinstance implements the Azure ARM Containerinstance service API version 2017-08-01-preview. |
|
containerregistry
Package containerregistry implements the Azure ARM Containerregistry service API version 2017-03-01.
|
Package containerregistry implements the Azure ARM Containerregistry service API version 2017-03-01. |
|
containerservice
Package containerservice implements the Azure ARM Containerservice service API version 2017-01-31.
|
Package containerservice implements the Azure ARM Containerservice service API version 2017-01-31. |
|
cosmos-db
Package cosmosdb implements the Azure ARM Cosmosdb service API version 2015-04-08.
|
Package cosmosdb implements the Azure ARM Cosmosdb service API version 2015-04-08. |
|
customer-insights
Package customerinsights implements the Azure ARM Customerinsights service API version 2017-01-01.
|
Package customerinsights implements the Azure ARM Customerinsights service API version 2017-01-01. |
|
datalake-analytics/account
Package account implements the Azure ARM Account service API version 2016-11-01.
|
Package account implements the Azure ARM Account service API version 2016-11-01. |
|
datalake-store/account
Package account implements the Azure ARM Account service API version 2016-11-01.
|
Package account implements the Azure ARM Account service API version 2016-11-01. |
|
devtestlabs
Package devtestlabs implements the Azure ARM Devtestlabs service API version 2016-05-15.
|
Package devtestlabs implements the Azure ARM Devtestlabs service API version 2016-05-15. |
|
disk
Package disk implements the Azure ARM Disk service API version 2016-04-30-preview.
|
Package disk implements the Azure ARM Disk service API version 2016-04-30-preview. |
|
dns
Package dns implements the Azure ARM Dns service API version 2016-04-01.
|
Package dns implements the Azure ARM Dns service API version 2016-04-01. |
|
documentdb
Package documentdb implements the Azure ARM Documentdb service API version 2015-04-08.
|
Package documentdb implements the Azure ARM Documentdb service API version 2015-04-08. |
|
eventgrid
Package eventgrid implements the Azure ARM Eventgrid service API version 2017-06-15-preview.
|
Package eventgrid implements the Azure ARM Eventgrid service API version 2017-06-15-preview. |
|
eventhub
Package eventhub implements the Azure ARM Eventhub service API version 2015-08-01.
|
Package eventhub implements the Azure ARM Eventhub service API version 2015-08-01. |
|
graphrbac
Package graphrbac implements the Azure ARM Graphrbac service API version .
|
Package graphrbac implements the Azure ARM Graphrbac service API version . |
|
hdinsight
Package hdinsight implements the Azure ARM Hdinsight service API version .
|
Package hdinsight implements the Azure ARM Hdinsight service API version . |
|
insights
Package insights implements the Azure ARM Insights service API version .
|
Package insights implements the Azure ARM Insights service API version . |
|
intune
Package intune implements the Azure ARM Intune service API version 2015-01-14-preview.
|
Package intune implements the Azure ARM Intune service API version 2015-01-14-preview. |
|
iothub
Package iothub implements the Azure ARM Iothub service API version 2016-02-03.
|
Package iothub implements the Azure ARM Iothub service API version 2016-02-03. |
|
keyvault
Package keyvault implements the Azure ARM Keyvault service API version 2015-06-01.
|
Package keyvault implements the Azure ARM Keyvault service API version 2015-06-01. |
|
logic
Package logic implements the Azure ARM Logic service API version 2016-06-01.
|
Package logic implements the Azure ARM Logic service API version 2016-06-01. |
|
machinelearning/commitmentplans
Package commitmentplans implements the Azure ARM Commitmentplans service API version 2016-05-01-preview.
|
Package commitmentplans implements the Azure ARM Commitmentplans service API version 2016-05-01-preview. |
|
machinelearning/webservices
Package webservices implements the Azure ARM Webservices service API version 2017-01-01.
|
Package webservices implements the Azure ARM Webservices service API version 2017-01-01. |
|
mediaservices
Package mediaservices implements the Azure ARM Mediaservices service API version 2015-10-01.
|
Package mediaservices implements the Azure ARM Mediaservices service API version 2015-10-01. |
|
mobileengagement
Package mobileengagement implements the Azure ARM Mobileengagement service API version 2014-12-01.
|
Package mobileengagement implements the Azure ARM Mobileengagement service API version 2014-12-01. |
|
monitor
Package monitor implements the Azure ARM Monitor service API version .
|
Package monitor implements the Azure ARM Monitor service API version . |
|
mysql
Package mysql implements the Azure ARM Mysql service API version 2017-04-30-preview.
|
Package mysql implements the Azure ARM Mysql service API version 2017-04-30-preview. |
|
network
Package network implements the Azure ARM Network service API version .
|
Package network implements the Azure ARM Network service API version . |
|
networkwatcher
Package networkwatcher implements the Azure ARM Networkwatcher service API version 2016-12-01.
|
Package networkwatcher implements the Azure ARM Networkwatcher service API version 2016-12-01. |
|
notificationhubs
Package notificationhubs implements the Azure ARM Notificationhubs service API version 2017-04-01.
|
Package notificationhubs implements the Azure ARM Notificationhubs service API version 2017-04-01. |
|
operationalinsights
Package operationalinsights implements the Azure ARM Operationalinsights service API version 2015-11-01-preview.
|
Package operationalinsights implements the Azure ARM Operationalinsights service API version 2015-11-01-preview. |
|
postgresql
Package postgresql implements the Azure ARM Postgresql service API version 2017-04-30-preview.
|
Package postgresql implements the Azure ARM Postgresql service API version 2017-04-30-preview. |
|
powerbiembedded
Package powerbiembedded implements the Azure ARM Powerbiembedded service API version 2016-01-29.
|
Package powerbiembedded implements the Azure ARM Powerbiembedded service API version 2016-01-29. |
|
recoveryservices
Package recoveryservices implements the Azure ARM Recoveryservices service API version 2016-06-01.
|
Package recoveryservices implements the Azure ARM Recoveryservices service API version 2016-06-01. |
|
recoveryservicesbackup
Package recoveryservicesbackup implements the Azure ARM Recoveryservicesbackup service API version 2016-12-01.
|
Package recoveryservicesbackup implements the Azure ARM Recoveryservicesbackup service API version 2016-12-01. |
|
recoveryservicessiterecovery
Package recoveryservicessiterecovery implements the Azure ARM Recoveryservicessiterecovery service API version 2016-08-10.
|
Package recoveryservicessiterecovery implements the Azure ARM Recoveryservicessiterecovery service API version 2016-08-10. |
|
redis
Package redis implements the Azure ARM Redis service API version 2016-04-01.
|
Package redis implements the Azure ARM Redis service API version 2016-04-01. |
|
relay
Package relay implements the Azure ARM Relay service API version 2016-07-01.
|
Package relay implements the Azure ARM Relay service API version 2016-07-01. |
|
resourcehealth
Package resourcehealth implements the Azure ARM Resourcehealth service API version 2015-01-01.
|
Package resourcehealth implements the Azure ARM Resourcehealth service API version 2015-01-01. |
|
resources/features
Package features implements the Azure ARM Features service API version 2015-12-01.
|
Package features implements the Azure ARM Features service API version 2015-12-01. |
|
resources/links
Package links implements the Azure ARM Links service API version 2016-09-01.
|
Package links implements the Azure ARM Links service API version 2016-09-01. |
|
resources/locks
Package locks implements the Azure ARM Locks service API version 2016-09-01.
|
Package locks implements the Azure ARM Locks service API version 2016-09-01. |
|
resources/managedapplications
Package managedapplications implements the Azure ARM Managedapplications service API version 2016-09-01-preview.
|
Package managedapplications implements the Azure ARM Managedapplications service API version 2016-09-01-preview. |
|
resources/policy
Package policy implements the Azure ARM Policy service API version 2016-12-01.
|
Package policy implements the Azure ARM Policy service API version 2016-12-01. |
|
resources/resources
Package resources implements the Azure ARM Resources service API version 2016-09-01.
|
Package resources implements the Azure ARM Resources service API version 2016-09-01. |
|
resources/subscriptions
Package subscriptions implements the Azure ARM Subscriptions service API version 2016-06-01.
|
Package subscriptions implements the Azure ARM Subscriptions service API version 2016-06-01. |
|
scheduler
Package scheduler implements the Azure ARM Scheduler service API version 2016-03-01.
|
Package scheduler implements the Azure ARM Scheduler service API version 2016-03-01. |
|
search
Package search implements the Azure ARM Search service API version 2015-08-19.
|
Package search implements the Azure ARM Search service API version 2015-08-19. |
|
servermanagement
Package servermanagement implements the Azure ARM Servermanagement service API version 2016-07-01-preview.
|
Package servermanagement implements the Azure ARM Servermanagement service API version 2016-07-01-preview. |
|
service-map
Package servicemap implements the Azure ARM Servicemap service API version 2015-11-01-preview.
|
Package servicemap implements the Azure ARM Servicemap service API version 2015-11-01-preview. |
|
servicebus
Package servicebus implements the Azure ARM Servicebus service API version 2015-08-01.
|
Package servicebus implements the Azure ARM Servicebus service API version 2015-08-01. |
|
servicefabric
Package servicefabric implements the Azure ARM Servicefabric service API version 2016-09-01.
|
Package servicefabric implements the Azure ARM Servicefabric service API version 2016-09-01. |
|
sql
Package sql implements the Azure ARM Sql service API version .
|
Package sql implements the Azure ARM Sql service API version . |
|
storage
Package storage implements the Azure ARM Storage service API version 2016-12-01.
|
Package storage implements the Azure ARM Storage service API version 2016-12-01. |
|
storageimportexport
Package storageimportexport implements the Azure ARM Storageimportexport service API version 2016-11-01.
|
Package storageimportexport implements the Azure ARM Storageimportexport service API version 2016-11-01. |
|
storsimple8000series
Package storsimple8000series implements the Azure ARM Storsimple8000series service API version 2017-06-01.
|
Package storsimple8000series implements the Azure ARM Storsimple8000series service API version 2017-06-01. |
|
streamanalytics
Package streamanalytics implements the Azure ARM Streamanalytics service API version .
|
Package streamanalytics implements the Azure ARM Streamanalytics service API version . |
|
trafficmanager
Package trafficmanager implements the Azure ARM Trafficmanager service API version 2015-11-01.
|
Package trafficmanager implements the Azure ARM Trafficmanager service API version 2015-11-01. |
|
web
Package web implements the Azure ARM Web service API version .
|
Package web implements the Azure ARM Web service API version . |
|
dataplane
|
|
|
keyvault
Package keyvault implements the Azure ARM Keyvault service API version 2016-10-01.
|
Package keyvault implements the Azure ARM Keyvault service API version 2016-10-01. |
|
Package management provides the main API client to construct other clients and make requests to the Microsoft Azure Service Management REST API.
|
Package management provides the main API client to construct other clients and make requests to the Microsoft Azure Service Management REST API. |
|
hostedservice
Package hostedservice provides a client for Hosted Services.
|
Package hostedservice provides a client for Hosted Services. |
|
location
Package location provides a client for Locations.
|
Package location provides a client for Locations. |
|
networksecuritygroup
Package networksecuritygroup provides a client for Network Security Groups.
|
Package networksecuritygroup provides a client for Network Security Groups. |
|
osimage
Package osimage provides a client for Operating System Images.
|
Package osimage provides a client for Operating System Images. |
|
storageservice
Package storageservice provides a client for Storage Services.
|
Package storageservice provides a client for Storage Services. |
|
testutils
Package testutils contains some test utilities for the Azure SDK
|
Package testutils contains some test utilities for the Azure SDK |
|
virtualmachine
Package virtualmachine provides a client for Virtual Machines.
|
Package virtualmachine provides a client for Virtual Machines. |
|
virtualmachinedisk
Package virtualmachinedisk provides a client for Virtual Machine Disks.
|
Package virtualmachinedisk provides a client for Virtual Machine Disks. |
|
virtualmachineimage
Package virtualmachineimage provides a client for Virtual Machine Images.
|
Package virtualmachineimage provides a client for Virtual Machine Images. |
|
virtualnetwork
Package virtualnetwork provides a client for Virtual Networks.
|
Package virtualnetwork provides a client for Virtual Networks. |
|
vmutils
Package vmutils provides convenience methods for creating Virtual Machine Role configurations.
|
Package vmutils provides convenience methods for creating Virtual Machine Role configurations. |
|
Package storage provides clients for Microsoft Azure Storage Services.
|
Package storage provides clients for Microsoft Azure Storage Services. |
Click to show internal directories.
Click to hide internal directories.