Pour développer avec le SDK Alibaba Cloud V1.0 pour .NET, intégrez le Core SDK ainsi que les SDK des différents services Alibaba Cloud en tant que dépendances.
Informations sur les dépendances du SDK V1.0 pour les produits cloud
Le SDK V1.0 pour .NET d'un service Alibaba Cloud fournit des objets de requête et de réponse pour les opérations API, ainsi qu'un objet de désérialisation (unmarshaller) pour sérialiser les valeurs de retour. L'exemple suivant montre comment ajouter le SDK Elastic Compute Service (ECS) en tant que dépendance :
.NET CLI
dotnet add package aliyun-net-sdk-ecs
# Specify the version using --version.
dotnet add package aliyun-net-sdk-ecs --version 4.24.18Package Manager
Install-Package aliyun-net-sdk-ecs
# Specify the version using -version.
Install-Package aliyun-net-sdk-ecs -Version 4.24.18PackageReference
<PackageReference Include="aliyun-net-sdk-ecs" Version="4.24.18" />
Paket CLI
paket add aliyun-net-sdk-ecs --version 4.24.18
F# Interactive
#r "nuget: aliyun-net-sdk-ecs, 4.24.18"
Le SDK V1.0 utilise le format de nommage aliyun-net-sdk-${Product name}. Pour plus d'informations sur le SDK V1.0 d'un produit cloud spécifique, consultez le SDK Center.
Dépendances du Core SDK
Le Core SDK gère les requêtes HTTP vers OpenAPI, l'authentification, les algorithmes de signature et la gestion des exceptions. Ajoutez la dépendance comme suit :
dotnet add package aliyun-net-sdk-coreUtiliser le SDK
1. Initialiser un client
Dans le SDK V1.0 pour .NET, tous les SDK de service Alibaba Cloud partagent la même bibliothèque centrale. Utilisez cette bibliothèque centrale pour initialiser un client SDK qui traite les requêtes API. L'exemple suivant montre comment initialiser un client. Pour plus d'informations sur les méthodes d'initialisation, consultez la rubrique Gérer les identifiants d'accès.
static void Main(string[] args)
{
IClientProfile profile = DefaultProfile.GetProfile(
// The region ID.
"<REGION_ID>",
// Obtain the AccessKey ID of the RAM user from an environment variable.
Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
// Obtain the AccessKey secret of the RAM user from an environment variable.
Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
DefaultAcsClient client = new DefaultAcsClient(profile);
}Si un seul client SDK gère plusieurs threads, des problèmes de sécurité peuvent survenir. Si plusieurs services Alibaba Cloud partagent le même profil, un accès non autorisé peut se produire. Nous vous recommandons d'utiliser plutôt le SDK V2.0 pour .NET.
2. Construire un objet de requête et envoyer une requête
Le SDK V1.0 pour .NET envoie les requêtes API via la bibliothèque centrale. Transmettez les paramètres de requête à l'aide de l'objet de requête du SDK de service, puis appelez le client initialisé pour envoyer la requête et recevoir un objet de réponse. L'exemple suivant utilise le SDK ECS pour interroger les informations des instances ECS.
Chaque opération API possède ses propres objets de requête et de réponse. Ils sont nommés selon les formats suivants :
${API}${Request}. Par exemple, un objet de requête peut être DescribeInstancesRequest.
${API}${Response}. Par exemple, un objet de réponse peut être DescribeInstancesResponse.
using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Ecs.Model.V20140526;
namespace AlibabaCloud.SDK.Sample
{
public class Sample
{
static void Main(string[] args)
{
IClientProfile profile = DefaultProfile.GetProfile(
// The region ID.
"<REGION_ID>",
// Obtain the AccessKey ID of the RAM user from an environment variable.
Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
// Obtain the AccessKey secret of the RAM user from an environment variable.
Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
DefaultAcsClient client = new DefaultAcsClient(profile);
// Create a request object.
DescribeInstancesRequest request = new DescribeInstancesRequest{
RegionId = "<REGION_ID>"
};;
// Send the request from the client and serialize the result into a Response object.
DescribeInstancesResponse response = client.GetAcsResponse(request);
System.Console.WriteLine(response.TotalCount);
}
}
}