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

Installez Alibaba Cloud SDK V1.0 pour Go, configurez vos identifiants et lancez votre premier appel d'API.

Notes sur la version du SDK

Alibaba Cloud SDK V1.0 pour Go nécessite Go 1.10 ou version ultérieure. La version V1.0 est une édition stable, prête pour la production et utilisée par de nombreux clients Alibaba Cloud.

Pour tout nouveau projet, privilégiez Alibaba Cloud SDK V2.0 pour Go (Darabonba SDK). La version V2.0 améliore considérablement la facilité d'utilisation et la maintenabilité. Si vous utilisez déjà la version V1.0, migrez vers la V2.0 dès que possible. Pour plus d'informations sur la migration, consultez Premiers pas avec Alibaba Cloud Darabonba SDK pour Go.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Go 1.10 ou version ultérieure installé. Exécutez go version pour le vérifier.

• Un compte Alibaba Cloud associé à une paire d'AccessKey.

Étape 1 : Installer le SDK

Initialisez un module Go pour votre projet :

go mod init example

Installez ensuite le SDK :

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

Étape 2 : Obtenir votre AccessKey

Le SDK authentifie les requêtes API au moyen d'une paire d'AccessKey :

• AccessKey ID : identifie l'appelant (équivalent d'un nom d'utilisateur).

• AccessKey Secret : signe les requêtes pour prouver l'identité de l'appelant (équivalent d'un mot de passe). Conservez cette valeur confidentielle.

Pour créer ou récupérer votre paire d'AccessKey :

1. Connectez-vous à la console de gestion Alibaba Cloud.

2. Cliquez sur votre avatar dans le coin supérieur droit et sélectionnez AccessKey Management.

3. Sur la page AccessKey Management, cliquez sur Create AccessKey.

4. Copiez l'AccessKey ID et l'AccessKey Secret. Vos identifiants se présentent comme suit :

   • AccessKey ID : LTAI5tExampleAccessKeyId

   • AccessKey Secret : ExampleAccessKeySecretAbcdef

5. Stockez ces identifiants dans un emplacement sécurisé.

   Avertissement

   Ne codez jamais vos identifiants en dur dans le code source et ne les validez pas dans un système de contrôle de version. Utilisez des variables d'environnement ou un gestionnaire de secrets pour injecter les identifiants lors de l'exécution.

Étape 3 : Lancer votre premier appel d'API

L'exemple suivant répertorie les instances Elastic Compute Service (ECS) dans la région cn-hangzhou. Tous les appels SDK suivent le même modèle : chargement des identifiants, création d'un client pour le service cible, construction d'une requête et traitement de la réponse.

Définissez vos identifiants comme variables d'environnement avant d'exécuter l'exemple :

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)
	}
}

Étapes suivantes

• Explorez les clients spécifiques aux services : le SDK inclut des clients pour ECS, OSS, RDS et d'autres services Alibaba Cloud dans github.com/aliyun/alibaba-cloud-sdk-go/services/.

• Migrez vers la V2.0 : le Darabonba SDK (V2.0) offre des améliorations majeures en termes de facilité d'utilisation et de maintenabilité. Pour obtenir des instructions de migration, reportez-vous au guide de démarrage rapide V2.0 mentionné dans la section des notes de version ci-dessus.