更新时间:2026-11-18 GMT+08:00
分享

.NET SDK调用示例

本文以调用RabbitMQ的查询所有实例列表(ListInstancesDetails)接口为例,介绍华为云.NET SDK的使用方法。

前提条件

安装SDK

.NET支持通过如下方式安装华为云.NET SDK。以3.1.213版本的.NET SDK为例,最新的SDK版本信息可通过SDK中心查看获取。

  • 使用.NET CLI安装SDK
    dotnet add package HuaweiCloud.SDK.Core --version 3.1.213
    dotnet add package HuaweiCloud.SDK.Rabbitmq --version 3.1.213
  • 使用Package Manager安装SDK
    Install-Package HuaweiCloud.SDK.Core -Version 3.1.213
    Install-Package HuaweiCloud.SDK.Rabbitmq -Version 3.1.213

使用SDK

以下是一个完整的.NET示例,演示如何使用华为云.NET SDK调用查询所有实例列表(ListInstancesDetails)接口。

  • 如果需要获取其他接口的SDK示例,请参见获取SDK示例代码。
  • 本示例中仅提供了基本的接口参数配置说明,更多的进阶配置请参见SDK的用户手册。
  • 如果把认证用的AK/SK直接写到代码中会有较大的安全风险,建议在配置文件或环境变量中以密文存放AK/SK,使用时解密,确保安全。本示例中把AK和SK保存为环境变量CLOUD_SDK_AK和CLOUD_SDK_SK,具体操作请参见环境变量。
    using System;
    using System.Collections.Generic;
    using HuaweiCloud.SDK.Core;
    using HuaweiCloud.SDK.Core.Auth;
    using HuaweiCloud.SDK.Rabbitmq;
    using HuaweiCloud.SDK.Rabbitmq.V2;
    using HuaweiCloud.SDK.Rabbitmq.V2.Model;
    namespace ListInstancesDetailsSolution
    {
        class Program
        {
            static async Task Main(string[] args)
            {
                // ==================== 初始化客户端 ==================== 
                // 从环境变量获取AK/SK,运行前需要提前把AK/SK设置为环境变量
                string ak = Environment.GetEnvironmentVariable("CLOUD_SDK_AK");
                string sk = Environment.GetEnvironmentVariable("CLOUD_SDK_SK");
                const string projectId = "195e********4a708ad9f9********1d";
    
                // 配置认证凭证
                var config = HttpConfig.GetDefaultConfig();
                config.IgnoreSslVerification = true;
                var auth = new BasicCredentials(ak, sk, projectId);
    
                // 初始化客户端
                var client = RabbitmqAsyncClient.NewBuilder()
                        .WithCredential(auth)
                        .WithRegion(RabbitmqRegion.ValueOf("cn-north-4"))
                        .WithHttpConfig(config)
                        .Build();
    
                // ==================== 构造请求对象 ==================== 
                // 使用SDK中提供的Request对象封装请求参数
                var req = new ListInstancesDetailsRequest
                {
                    Engine = ListInstancesDetailsRequest.EngineEnum.FromValue("rabbitmq")
                };
    
                // ==================== 发起请求并处理响应 ==================== 
                // 通过异步客户端调用对应API发起请求,调用成功将返回Response对象,调用失败将抛出对应异常
                try
                {
                    var resp = await client.ListInstancesDetails(req);
                    var respStatusCode = resp.HttpStatusCode;
                    Console.WriteLine(respStatusCode);
                }
                catch (RequestTimeoutException requestTimeoutException)
                {
                    Console.WriteLine(requestTimeoutException.ErrorMessage);
                }
                catch (ServiceResponseException clientRequestException)
                {
                    Console.WriteLine(clientRequestException.HttpStatusCode);
                    Console.WriteLine(clientRequestException.RequestId);
                    Console.WriteLine(clientRequestException.ErrorCode);
                    Console.WriteLine(clientRequestException.ErrorMsg);
                }
                catch (ConnectionException connectionException)
                {
                    Console.WriteLine(connectionException.ErrorMessage);
                }
            }
        }
    }

相关文档