# .NET SDK调用示例
本文以调用RabbitMQ的查询所有实例列表（ListInstancesDetails）接口为例，介绍华为云.NET SDK的使用方法。
#### 前提条件
- 已获取华为云账号对应的Access Key（AK）和Secret Access Key（SK），具体操作请参见[新增访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_05_0003.html#section1)。
- 运行SDK的环境已安装[.NET Framework 4.7.2](https://dotnet.microsoft.com/download/dotnet-framework)及以上版本，或[.NET 8.0](https://dotnet.microsoft.com/download/dotnet)及以上版本。
 
#### 安装SDK
.NET支持通过如下方式安装华为云.NET SDK。以3.1.213版本的.NET SDK为例，最新的SDK版本信息可通过[SDK中心](https://console.huaweicloud.com/apiexplorer/#/sdkcenter?language=.NET)查看获取。
- **使用.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示例代码](https://support.huaweicloud.com/sdkreference-rabbitmq/rabbitmq-sdk-002.html)。
- 本示例中仅提供了基本的接口参数配置说明，更多的进阶配置请参见SDK的[用户手册](https://github.com/huaweicloud/huaweicloud-sdk-net-v3/blob/master/README_CN.md#用户手册-top)。
- 如果把认证用的AK/SK直接写到代码中会有较大的安全风险，建议在配置文件或环境变量中以密文存放AK/SK，使用时解密，确保安全。本示例中把AK和SK保存为环境变量CLOUD_SDK_AK和CLOUD_SDK_SK，具体操作请参见[环境变量](https://github.com/huaweicloud/huaweicloud-sdk-net-v3/blob/master/README_CN.md#3322-环境变量-top)。
  ```
  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);
              }
          }
      }
  }
  ```
  
