Installieren des Azure SDK für GoInstall the Azure SDK for Go

Willkommen beim Azure SDK für Go!Welcome to the Azure SDK for Go! Mit diesem SDK können Sie Azure-Dienste über Ihre Go-Anwendungen verwalten und mit ihnen interagieren.The SDK allows you to manage and interact with Azure services from your Go applications.

Abrufen des Azure SDK für GoGet the Azure SDK for Go

Das Azure SDK für Go ist mit Go-Version 1.8 und höheren Versionen kompatibel.The Azure SDK for Go is compatible with Go versions 1.8 and higher. Bei Umgebungen mit Azure Stack-Profilen ist mindestens Go-Version 1.9 erforderlich.For environments using Azure Stack Profiles, Go version 1.9 is the minimum requirement. Falls Sie Go installieren müssen, befolgen Sie die Installationsanweisungen für Go.If you need to install Go, follow the Go installation instructions.

Sie können das Azure SDK für Go und seine Abhängigkeiten über go get herunterladen.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/...

Warnung

Schreiben Sie Azure in der URL unbedingt groß.Make sure that you capitalize Azure in the URL. Andernfalls können bei der Verwendung des SDK Importprobleme aufgrund der Groß-/Kleinschreibung auftreten.Doing otherwise can cause case-related import problems when working with the SDK. Azure muss außerdem in den Importanweisungen großgeschrieben werden.You also need to capitalize Azure in your import statements.

Einige Azure-Dienste verfügen über ein eigenes Go SDK und sind nicht im Kernpaket von Azure SDK für Go enthalten.Some Azure services have their own Go SDK and aren't included in the core Azure SDK for Go package. In der folgenden Tabelle sind die Dienste mit eigenen SDKs und deren Paketnamen aufgeführt.The following table lists the services with their own SDKs and their package names. Alle diese Pakete gelten als Vorschauversion.These packages are all considered to be in preview.

DienstService 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
SpeicherwarteschlangeStorage Queue github.com/Azure/azure-storage-queue-gogithub.com/Azure/azure-storage-queue-go
Event HubEvent 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

Durchführen des Vendorings für das Azure SDK für GoVendor the Azure SDK for Go

Das Vendoring für das Azure SDK für Go kann mit dep durchgeführt werden.The Azure SDK for Go may be vendored through dep. Das Vendoring wird aus Stabilitätsgründen empfohlen.For stability reasons, vendoring is recommended. Fügen Sie zur Verwendung von dep in Ihrem eigenen Projekt github.com/Azure/azure-sdk-for-go zum Abschnitt [[constraint]] in Gopkg.toml hinzu.To use dep in your own project, add github.com/Azure/azure-sdk-for-go to a [[constraint]] section of your Gopkg.toml. Fügen Sie beispielsweise den folgenden Eintrag hinzu, um das Vendoring für Version 14.0.0 durchzuführen: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"

Integrieren des Azure SDK für Go in Ihr ProjektInclude the Azure SDK for Go in your project

Importieren Sie beliebige Dienste, mit denen Sie interagieren, und die erforderlichen autorest-Module, um Azure-Dienste in Ihrem Go-Code zu nutzen.To use Azure services from your Go code, import any services you interact with and the required autorest modules. Sie erhalten eine vollständige Liste mit den verfügbaren Modulen von GoDoc für verfügbare Dienste und AutoRest-Pakete.You get a complete list of the available modules from GoDoc for available services and AutoRest packages. Die am häufigsten verwendeten Pakete, die Sie für go-autorest benötigen, sind:The most common packages you need from go-autorest are:

PaketPackage BESCHREIBUNGDescription
github.com/Azure/go-autorest/autorestgithub.com/Azure/go-autorest/autorest Objekte zur Verarbeitung der DienstclientauthentifizierungObjects for handling service client authentication
github.com/Azure/go-autorest/autorest/azuregithub.com/Azure/go-autorest/autorest/azure Konstanten für Interaktionen mit Azure-DienstenConstants for interactions with Azure services
github.com/Azure/go-autorest/autorest/adalgithub.com/Azure/go-autorest/autorest/adal Authentifizierungsmechanismen für den Zugriff auf Azure-DiensteAuthentication mechanisms for accessing Azure services
github.com/Azure/go-autorest/autorest/togithub.com/Azure/go-autorest/autorest/to Hilfsprogramme für die Typassertion für die Arbeit mit Azure SDK-DatenstrukturenType assertion helpers for working with Azure SDK data structures

Die Versionsangaben von Go-Paketen und Azure-Diensten sind voneinander unabhängig.Go packages and Azure services are versioned independently. Die Dienstversionen sind Teil des Modulimportpfads im Modul services.The service versions are part of the module import path, underneath the services module. Der vollständige Pfad für das Modul ist der Name des Diensts, gefolgt von der Version im Format YYYY-MM-DD, worauf erneut der Dienstname folgt.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. Beispiel für den Import der Version 2017-03-30 des Computediensts: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"

Es wird empfohlen, die aktuelle Version eines Diensts zu verwenden, wenn Sie mit der Entwicklung beginnen, und die Versionen konsistent zu halten.It's recommended that you use the latest version of a service when starting development and keep it consistent. Dienstanforderungen können sich zwischen Versionen ändern und zu Codefehlern führen, obwohl das Go SDK gar nicht aktualisiert wurde.Service requirements may change between versions that could break your code, even if there are no Go SDK updates during that time.

Wenn Sie eine gemeinsame Momentaufnahme aller Dienste benötigen, können Sie auch eine einzelne Profilversion wählen.If you need a collective snapshot of services, you can also select a single profile version. Das einzige gesperrte Profil ist derzeit Version 2017-03-09, die unter Umständen nicht über die aktuellen Features der Dienste verfügt.Right now, the only locked profile is version 2017-03-09, which may not have the latest features of services. Profile befinden sich unter dem Modul profiles, und die Version wird im Format YYYY-MM-DD angegeben.Profiles are located under the profiles module, with their version in the YYYY-MM-DD format. Dienste werden unter ihrer Profilversion gruppiert.Services are grouped under their profile version. Beispiel für den Import des Verwaltungsmoduls für Azure-Ressourcen aus dem Profil 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"

Warnung

Außerdem sind die Profile preview und latest verfügbar.There are also preview and latest profiles available. Ihre Verwendung ist nicht empfehlenswert.Using them is not recommended. Diese Profile sind fortlaufende Versionen, und das Dienstverhalten kann sich im Laufe der Zeit ändern.These profiles are rolling versions and service behavior may change at any time.

Nächste SchritteNext steps

Probieren Sie einen Schnellstart aus, um mit der Verwendung des Azure SDK für Go zu beginnen.To begin using the Azure SDK for Go, try out a quickstart.

Wenn Sie sofort mit anderen Diensten im Go SDK starten möchten, ist es ratsam, sich den verfügbaren Beispielcode anzusehen.If you want to get started with other services in the Go SDK immediately, take a look at some of the available sample code.