Instale o SDK do Azure para linguagem GoInstall the Azure SDK for Go

Bem-vindo ao SDK do Azure para linguagem Go!Welcome to the Azure SDK for Go! O SDK permite gerenciar e interagir com os serviços do Azure em seus aplicativos Go.The SDK allows you to manage and interact with Azure services from your Go applications.

Obtenha o SDK do Azure para linguagem GoGet the Azure SDK for Go

O SDK do Azure para linguagem Go é compatível com as versões 1.8 e mais recentes da linguagem Go.The Azure SDK for Go is compatible with Go versions 1.8 and higher. Para ambientes usando Perfis do Azure Stack, a versão 1.9 do Go é o requisito mínimo.For environments using Azure Stack Profiles, Go version 1.9 is the minimum requirement. Se você precisar instalar a linguagem Go, siga as instruções de instalação da linguagem Go.If you need to install Go, follow the Go installation instructions.

Você pode obter o SDK do Azure para linguagem Go e suas dependências 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/...

Aviso

Certifique-se de que você coloca Azure em letra maiúscula na URL.Make sure that you capitalize Azure in the URL. Fazer o contrário pode causar problemas de importação relacionadas a caso ao trabalhar com o SDK.Doing otherwise can cause case-related import problems when working with the SDK. Você também precisa colocar Azure em maiúscula em suas instruções de importação.You also need to capitalize Azure in your import statements.

Alguns serviços do Azure têm seu próprio SDK do Go e não estão incluídos no pacote base de SDK do Azure para linguagem Go.Some Azure services have their own Go SDK and aren't included in the core Azure SDK for Go package. A tabela a seguir lista os serviços com seus próprios SDKs e os nomes de pacote.The following table lists the services with their own SDKs and their package names. Esses pacotes são considerados em versão prévia.These packages are all considered to be in preview.

ServiçoService PacotePackage
Armazenamento de BlobsBlob Storage github.com/Azure/azure-storage-blob-gogithub.com/Azure/azure-storage-blob-go
Armazenamento de ArquivosFile Storage github.com/Azure/azure-storage-file-gogithub.com/Azure/azure-storage-file-go
Fila de ArmazenamentoStorage Queue github.com/Azure/azure-storage-queue-gogithub.com/Azure/azure-storage-queue-go
Hub de eventoEvent Hub github.com/Azure/azure-event-hubs-gogithub.com/Azure/azure-event-hubs-go
Barramento de ServiçoService Bus github.com/Azure/azure-service-bus-gogithub.com/Azure/azure-service-bus-go

Fornecimento do SDK do Azure para linguagem GoVendor the Azure SDK for Go

O SDK do Azure para linguagem Go pode usar a funcionalidade de vendoring pelo dep.The Azure SDK for Go may be vendored through dep. Por motivos de estabilidade, é recomendado usar vendoring.For stability reasons, vendoring is recommended. Para usar dep em seu próprio projeto, adicione github.com/Azure/azure-sdk-for-go a uma seção [[constraint]] do seu 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. Por exemplo, para o vendor na versão 14.0.0, adicione a seguinte entrada: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"

Incluir o SDK do Azure para linguagem Go em seu projetoInclude the Azure SDK for Go in your project

Para usar os serviços do Azure a partir de seu código Go, importe todos os serviços com os quais você interage e os módulos autorest necessários.To use Azure services from your Go code, import any services you interact with and the required autorest modules. Você obterá uma lista completa dos módulos disponíveis do GoDoc para os serviços disponíveis e pacotes AutoRest.You get a complete list of the available modules from GoDoc for available services and AutoRest packages. Os pacotes mais comuns do go-autorest de que você precisa são:The most common packages you need from go-autorest are:

PacotePackage DESCRIÇÃODescription
github.com/Azure/go-autorest/autorestgithub.com/Azure/go-autorest/autorest Objetos para lidar com a autenticação de cliente de serviçoObjects for handling service client authentication
github.com/Azure/go-autorest/autorest/azuregithub.com/Azure/go-autorest/autorest/azure Constantes para interações com os serviços do AzureConstants for interactions with Azure services
github.com/Azure/go-autorest/autorest/adalgithub.com/Azure/go-autorest/autorest/adal Mecanismos de autenticação para acessar os serviços do AzureAuthentication mechanisms for accessing Azure services
github.com/Azure/go-autorest/autorest/togithub.com/Azure/go-autorest/autorest/to Digite os auxiliares de asserção para trabalhar com as estruturas de dados do SDK do AzureType assertion helpers for working with Azure SDK data structures

Os pacotes da linguagem Go e os serviços do Azure possuem controle de versão independente.Go packages and Azure services are versioned independently. As versões de serviço fazem parte do caminho de importação do módulo, sob o módulo services.The service versions are part of the module import path, underneath the services module. O caminho completo para o módulo é o nome do serviço, seguido da versão no formato YYYY-MM-DD, seguido do nome do serviço novamente.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. Por exemplo, para importar a versão 2017-03-30 do serviço de computação: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"

É recomendável que você use a versão mais recente de um serviço ao iniciar o desenvolvimento e mantenha-os consistentes.It's recommended that you use the latest version of a service when starting development and keep it consistent. Os requisitos de serviço podem ser alterados entre as versões o que poderia interromper o seu código, mesmo se não existem atualizações do SDK da linguagem Go durante esse período.Service requirements may change between versions that could break your code, even if there are no Go SDK updates during that time.

Se você precisar de um instantâneo coletivo dos serviços, você também pode selecionar uma versão de perfil.If you need a collective snapshot of services, you can also select a single profile version. Agora, o único perfil bloqueado é a versão 2017-03-09, que pode não ter os recursos mais recentes dos serviços.Right now, the only locked profile is version 2017-03-09, which may not have the latest features of services. Os perfis estão localizados no módulo profiles, com a versão no formato YYYY-MM-DD.Profiles are located under the profiles module, with their version in the YYYY-MM-DD format. Os serviços são agrupados em sua versão de perfil.Services are grouped under their profile version. Por exemplo, para importar o módulo de gerenciamento de recursos do Azure a partir do perfil 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"

Aviso

Os perfis preview e latest também estão disponíveis.There are also preview and latest profiles available. Porém, não é recomendado usá-los.Using them is not recommended. Esses perfis são versões progressivas, e o comportamento do serviço poderá mudar a qualquer momento.These profiles are rolling versions and service behavior may change at any time.

Próximas etapasNext steps

Para começar a usar o SDK do Azure para linguagem Go, experimente um início rápido.To begin using the Azure SDK for Go, try out a quickstart.

Se você quiser começar com outros serviços no SDK Go imediatamente, dê uma olhada em alguns códigos de exemplo disponíveis.If you want to get started with other services in the Go SDK immediately, take a look at some of the available sample code.