Alibaba Cloud SDK:Get started with Alibaba Cloud SDK V1.0 for Go

Instale o Alibaba Cloud SDK V1.0 para Go, configure as credenciais e faça sua primeira chamada de API.

Notas sobre a versão do SDK

O Alibaba Cloud SDK V1.0 para Go requer Go 1.10 ou posterior. A V1.0 é uma versão estável e pronta para produção, usada por muitos clientes da Alibaba Cloud.

Se você estiver iniciando um novo projeto, use o Alibaba Cloud SDK V2.0 para Go (Darabonba SDK). A V2.0 oferece melhorias significativas em usabilidade e manutenibilidade. Caso já use a V1.0, migre para a V2.0 assim que possível. Para obter orientações sobre a migração, consulte Primeiros passos com o Alibaba Cloud Darabonba SDK para Go.

Pré-requisitos

Antes de começar, verifique se você tem:

• Go 1.10 ou posterior instalado. Execute go version para verificar.

• Uma conta Alibaba Cloud com um par de AccessKey.

Etapa 1: Instale o SDK

Inicialize um módulo Go para seu projeto:

go mod init example

Em seguida, instale o SDK:

go get github.com/aliyun/alibaba-cloud-sdk-go/sdk

Etapa 2: Obter seu AccessKey

O SDK autentica solicitações de API usando um par de AccessKey:

• AccessKey ID: identifica o chamador (semelhante a um nome de usuário).

• AccessKey Secret: assina solicitações para comprovar a identidade do chamador (semelhante a uma senha). Mantenha este valor em sigilo.

Para criar ou recuperar seu par de AccessKey:

1. Faça login no Alibaba Cloud Management Console.

2. Clique em seu avatar no canto superior direito e selecione AccessKey Management.

3. Na página AccessKey Management, clique em Create AccessKey.

4. Copie o AccessKey ID e o AccessKey Secret. Suas credenciais serão semelhantes ao exemplo abaixo:

   • AccessKey ID: LTAI5tExampleAccessKeyId

   • AccessKey Secret: ExampleAccessKeySecretAbcdef

5. Armazene as credenciais em um local seguro.

   Aviso

   Nunca codifique credenciais diretamente no código-fonte nem as envie para sistemas de controle de versão. Use variáveis de ambiente ou um gerenciador de segredos para injetar as credenciais durante a execução.

Etapa 3: Fazer sua primeira chamada de API

O exemplo a seguir lista as instâncias do Elastic Compute Service (ECS) na região cn-hangzhou. Todas as chamadas do SDK seguem o mesmo padrão: carregar credenciais, criar um cliente para o serviço de destino, construir a solicitação e tratar a resposta.

Defina suas credenciais como variáveis de ambiente antes de executar o exemplo:

export ALIBABA_CLOUD_ACCESS_KEY_ID=<your-access-key-id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<your-access-key-secret>

package main

import (
	"fmt"
	"log"
	"os"

	"github.com/aliyun/alibaba-cloud-sdk-go/services/ecs"
)

func main() {
	// Load credentials from environment variables
	accessKeyID := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
	accessKeySecret := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")

	// Create an ECS client for the cn-hangzhou region
	client, err := ecs.NewClientWithAccessKey("cn-hangzhou", accessKeyID, accessKeySecret)
	if err != nil {
		log.Fatalf("Failed to create ECS client: %v", err)
	}

	// Build and send the DescribeInstances request
	request := ecs.CreateDescribeInstancesRequest()
	request.Scheme = "https"

	response, err := client.DescribeInstances(request)
	if err != nil {
		log.Fatalf("DescribeInstances failed: %v", err)
	}

	// Print instance IDs and names
	fmt.Printf("Total instances: %d\n", response.TotalCount)
	for _, instance := range response.Instances.Instance {
		fmt.Printf("  ID: %s  Name: %s\n", instance.InstanceId, instance.InstanceName)
	}
}

Próximos passos

• Explore os clientes específicos de cada serviço: o SDK inclui clientes para ECS, OSS, RDS e outros serviços da Alibaba Cloud em github.com/aliyun/alibaba-cloud-sdk-go/services/.

• Migre para a V2.0: o Darabonba SDK (V2.0) traz melhorias expressivas de usabilidade e manutenibilidade. Consulte o guia de primeiros passos da V2.0, vinculado na seção de notas sobre a versão do SDK acima, para obter instruções detalhadas sobre a migração.