ECS .NET V2.0 SDK调用示例 - 云服务器 ECS

本文以调用查询一台或多台ECS实例的详细信息（DescribeInstances）接口为例，为您介绍.NET V2.0 SDK的安装和使用。

前提条件

由于阿里云账号（主账号）拥有资源的所有权限，其AccessKey一旦泄露风险巨大，所以建议您使用满足最小化权限需求的RAM用户的AccessKey。具体操作方式请参见创建AccessKey。
给RAM用户授予操作云服务器ECS相关资源的权限。本文提供的示例代码为查询示例，所以选择AliyunECSReadonlyAccess系统权限策略，您在使用的时候可以根据业务需求进行自定义授权。
1. 使用自定义权限策略。
  关于如何创建自定义权限策略，请参见创建自定义权限策略和授权信息。
  云服务器ECS依据最佳实践提供了一些自定义权限策略示例，您可以参考这些示例以快速创建符合自身业务需求的自定义权限策略，具体详情请参见云服务器ECS自定义权限策略参考。
2. 使用系统权限策略。
  云服务器ECS支持的所有系统权限策略及其对应的权限描述，请参见云服务器 ECS系统权限策略参考。
在环境变量中配置AccessKey，具体操作步骤请参见在Linux、macOS和Windows系统配置环境变量。

安装SDK

.NET V2.0 SDK安装方式请参见SDK中心，您可以直接从下方提供的安装方式中选择适合您的方法，以完成ECS SDK的安装：

.NET CLI

dotnet add package AlibabaCloud.SDK.Ecs20140526 --version 4.3.1

Package Manager

Install-Package AlibabaCloud.SDK.Ecs20140526 -Version 4.3.1

PackageReference

<PackageReference Include="AlibabaCloud.SDK.Ecs20140526" Version="4.3.1" />

Paket CLI

paket add AlibabaCloud.SDK.Ecs20140526 --version 4.3.1

F# Interactive

#r "nuget: AlibabaCloud.SDK.Ecs20140526, 4.3.1"

使用SDK

1. 初始化客户端

阿里云SDK支持多种访问凭据用于初始化客户端，例如AccessKey和STS Token等，更多方式请参见管理访问凭证。本示例以通过AccessKey初始化客户端为例。

namespace ecs
{
    public class Sample
    {
        static void Main(string[] args)
        {
            var ecsConfig = new AlibabaCloud.OpenApiClient.Models.Config
            {
                // 从环境变量中获取AccessKey ID值。
                AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // 从环境变量中获取AccessKey Secret值。
                AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
                Endpoint = "ecs.cn-hangzhou.aliyuncs.com"
            };
            var escClient = new AlibabaCloud.SDK.Ecs20140526.Client(ecsConfig);
        }
    }
}

2. 构建接口的请求对象

在构建请求对象之前，请查看该接口的API文档获取参数信息。

说明

请求对象命名规则：{API名称}Request，例如DescribeInstances该接口的请求对象为DescribeInstancesRequest。

// 构造请求对象
var describeInstancesRequest = new AlibabaCloud.SDK.Ecs20140526.Models.DescribeInstancesRequest
{
    RegionId = "cn-hangzhou"
};

3. 发起调用

通过客户端调用OpenAPI时，支持设置运行时参数，例如超时配置、代理配置等，更多信息请查看进阶配置。

说明

接口返回对象命名规则：{API名称}Response，例如DescribeInstances该接口的返回对象为DescribeInstancesResponse。

// 创建运行时配置对象
var runtimeOptions = new RuntimeOptions();
// 发起请求  
var describeInstancesResponse = escClient.DescribeInstancesWithOptions(describeInstancesRequest, runtimeOptions);

4. 异常处理

.NET SDK将异常进行了细致的分类，主要划分为以下几个Exception：

TeaUnretryableException：该异常主要是因为网络问题造成，一般是网络问题造成达到最大重试次数后抛出，可以通过exception.getLastRequest来查询错误发生时的请求信息。
TeaException：在SDK的请求中主要以业务报错为主的异常。

建议采取合理的措施来处理异常，比如合理地传播异常、记录日志、尝试恢复等，以确保系统的健壮性和稳定性。

5. 完整示例

using AlibabaCloud.TeaUtil.Models;
using Tea;

namespace ecs
{
    public class Sample
    {
        static void Main(string[] args)
        {
            var ecsConfig = new AlibabaCloud.OpenApiClient.Models.Config
            {
                // 从环境变量中获取AccessKey ID值。
                AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                // 从环境变量中获取AccessKey Secret值。
                AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
                Endpoint = "ecs.cn-hangzhou.aliyuncs.com"
            };

            var escClient = new AlibabaCloud.SDK.Ecs20140526.Client(ecsConfig);
            
            // 构造请求对象
            var describeInstancesRequest = new AlibabaCloud.SDK.Ecs20140526.Models.DescribeInstancesRequest
            {
                RegionId = "cn-hangzhou"
            };
            // 创建运行时配置对象
            var runtimeOptions = new RuntimeOptions();
            try
            {
                // 发起请求  
                var describeInstancesResponse =
                    escClient.DescribeInstancesWithOptions(describeInstancesRequest, runtimeOptions);
                Console.WriteLine(describeInstancesResponse.ToMap());
            }
            catch (TeaUnretryableException error)
            {
                // 此处仅做打印展示，请谨慎对待异常处理，在工程项目中切勿直接忽略异常。
                Console.WriteLine(error);
            }
            catch (TeaException error)
            {
                // 此处仅做打印展示，请谨慎对待异常处理，在工程项目中切勿直接忽略异常。
                // 错误 message
                Console.WriteLine(error.Message);
            }
            catch (Exception error)
            {
                // 此处仅做打印展示，请谨慎对待异常处理，在工程项目中切勿直接忽略异常。
                Console.WriteLine(error);
            } 
        }
    }
}

云服务器 ECS：ECS .NET V2.0 SDK调用示例