Installera Azure SDK för GoInstall the Azure SDK for Go

Välkommen till Azure SDK för Go!Welcome to the Azure SDK for Go! Med detta SDK kan du hantera och interagera med Azure-tjänster från Go-program.The SDK allows you to manage and interact with Azure services from your Go applications.

Hämta Azure SDK för GoGet the Azure SDK for Go

Azure SDK för Go är kompatibel med Go-version 1.8 och senare.The Azure SDK for Go is compatible with Go versions 1.8 and higher. För miljöer med Azure Stack-profiler är Go-versionen 1.9 minimikravet.For environments using Azure Stack Profiles, Go version 1.9 is the minimum requirement. Följ installationsanvisningarna om du behöver installera Go.If you need to install Go, follow the Go installation instructions.

Du kan hämta Azure SDK för Go och dess beroenden via go get.You can download the Azure SDK for Go and its dependencies via go get.

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

Varning

Kontrollera att du använder versaler för Azure i webbadressen.Make sure that you capitalize Azure in the URL. Om du inte gör det kan det orsaka importproblem när du arbetar med SDK.Doing otherwise can cause case-related import problems when working with the SDK. Du måste även använda versaler för Azure i importinstruktioner.You also need to capitalize Azure in your import statements.

Vissa Azure-tjänster har sitt eget Go-SDK och ingår inte i Azure SDK for Go-grundpaketet.Some Azure services have their own Go SDK and aren't included in the core Azure SDK for Go package. Följande tabell innehåller en lista över tjänsterna med egna SDK:er och deras paketnamn.The following table lists the services with their own SDKs and their package names. Alla dessa paket anses utgöra en förhandsversion.These packages are all considered to be in preview.

TjänstService PaketPackage
Blob StorageBlob Storage github.com/Azure/azure-storage-blob-gogithub.com/Azure/azure-storage-blob-go
File StorageFile Storage github.com/Azure/azure-storage-file-gogithub.com/Azure/azure-storage-file-go
LagringsköStorage Queue github.com/Azure/azure-storage-queue-gogithub.com/Azure/azure-storage-queue-go
HändelsehubbEvent Hub github.com/Azure/azure-event-hubs-gogithub.com/Azure/azure-event-hubs-go
Service BusService Bus github.com/Azure/azure-service-bus-gogithub.com/Azure/azure-service-bus-go
Application InsightsApplication Insights github.com/Microsoft/ApplicationInsights-gogithub.com/Microsoft/ApplicationInsights-go

Vendoring i Azure SDK för GoVendor the Azure SDK for Go

Du kan utföra vendoring för Azure SDK för Go via dep.The Azure SDK for Go may be vendored through dep. Vendoring rekommenderas av stabilitetsskäl.For stability reasons, vendoring is recommended. Om du vill använda dep i ditt projekt lägger du till github.com/Azure/azure-sdk-for-go i ett [[constraint]]-avsnitt i din Gopkg.toml.To use dep in your own project, add github.com/Azure/azure-sdk-for-go to a [[constraint]] section of your Gopkg.toml. Om du till exempel vill utföra vendoring för version 14.0.0 lägger du till följande post:For example, to vendor on version 14.0.0, add the following entry:

[[constraint]]
name = "github.com/Azure/azure-sdk-for-go"
version = "14.0.0"

Ta med Azure SDK för Go i ditt projektInclude the Azure SDK for Go in your project

Om du vill använda Azure-tjänster från din Go-kod importerar du alla tjänster som du interagerar med samt de nödvändiga autorest-modulerna.To use Azure services from your Go code, import any services you interact with and the required autorest modules. Du får en fullständig lista över tillgängliga moduler från GoDoc för tillgängliga tjänster och AutoRest-paket.You get a complete list of the available modules from GoDoc for available services and AutoRest packages. De vanligaste paketen som du behöver från go-autorest är:The most common packages you need from go-autorest are:

PaketPackage BeskrivningDescription
github.com/Azure/go-autorest/autorestgithub.com/Azure/go-autorest/autorest Objekt för hantering av tjänstklientautentiseringObjects for handling service client authentication
github.com/Azure/go-autorest/autorest/azuregithub.com/Azure/go-autorest/autorest/azure Konstanter för interaktioner med Azure-tjänsterConstants for interactions with Azure services
github.com/Azure/go-autorest/autorest/adalgithub.com/Azure/go-autorest/autorest/adal Autentiseringsmekanismer för åtkomst till Azure-tjänsterAuthentication mechanisms for accessing Azure services
github.com/Azure/go-autorest/autorest/togithub.com/Azure/go-autorest/autorest/to Ange kontrollhjälp för att arbeta med Azure SDK-datastrukturerType assertion helpers for working with Azure SDK data structures

Versioner av Go-paket och Azure-tjänster är oberoende av varandra.Go packages and Azure services are versioned independently. Tjänstversionerna är en del av importsökvägen för modulen nedanför modulen services.The service versions are part of the module import path, underneath the services module. Den fullständiga sökvägen för modulen är namnet på tjänsten, följt av versionen i formatet YYYY-MM-DD, följt av namnet på tjänsten igen.The full path for the module is the name of the service, followed by the version in YYYY-MM-DD format, followed by the service name again. Så här importerar du till exempel versionen 2017-03-30 av beräkningstjänsten:For example, to import the 2017-03-30 version of the Compute service:

import "github.com/Azure/azure-sdk-for-go/services/compute/mgmt/2017-03-30/compute"

Vi rekommenderar att du använder den senaste versionen av en tjänst när du börjar utveckla och är konsekvent.It's recommended that you use the latest version of a service when starting development and keep it consistent. Tjänstekrav kan ändras från en version till nästa och det kan bryta din kod, även om det inte förekommer Go SDK-uppdateringar under den tiden.Service requirements may change between versions that could break your code, even if there are no Go SDK updates during that time.

Du kan även välja en enskild profilversion om du behöver en kollektiv ögonblicksbild av tjänsterna.If you need a collective snapshot of services, you can also select a single profile version. Just nu är den enda låsta profilen version 2017-03-09, som kanske inte har de senaste funktionerna för tjänsterna.Right now, the only locked profile is version 2017-03-09, which may not have the latest features of services. Profilerna finns under modulen profiles med versionerna i formatet YYYY-MM-DD.Profiles are located under the profiles module, with their version in the YYYY-MM-DD format. Tjänsterna är grupperade under profilversionerna.Services are grouped under their profile version. Så här importerar du till exempel hanteringsmodulen för Azure-resurser från profilen 2017-03-09:For example, to import the Azure Resources management module from the 2017-03-09 profile:

import "github.com/Azure/azure-sdk-for-go/profiles/2017-03-09/resources/mgmt/resources"

Varning

Även profilerna preview och latest är tillgängliga.There are also preview and latest profiles available. Vi rekommenderar inte att du använder dem.Using them is not recommended. De här profilerna är löpande versioner och tjänstbeteendet kan därför ändras när som helst.These profiles are rolling versions and service behavior may change at any time.

Nästa stegNext steps

Testa att använda en snabbstart om du vill börja använda Azure SDK för Go.To begin using the Azure SDK for Go, try out a quickstart.

Om du vill komma igång med andra tjänster i Go SDK direkt så kan du ta en titt på några av de tillgängliga exempelkoderna.If you want to get started with other services in the Go SDK immediately, take a look at some of the available sample code.