欢迎使用阿里云开发者工具套件(SDK)。阿里云.NET SDK让您不用复杂编程即可访问云服务器、云数据库RDS、云监控等多个阿里云服务。本操作介绍如何获取阿里云.NET SDK并开始调用。
在线调试和生成SDK示例
OpenAPI 开发者门户提供在线调用云产品API、动态生成 SDK示例代码和快速检索接口等功能,能显著降低使用API 的难度,推荐您使用。
环境准备
- 使用阿里云.NET SDK,您需要一个RAM账号以及一对AccessKey ID和AccessKey Secret。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey,或联系您的系统管理员。
- 使用阿里云SDK调用某个产品的API前,确保您已经在阿里云控制台开通了该产品。
- 阿里云.NET SDK适用于.NET Framework 4.5及以上版本。
安装阿里云 .NET SDK
- 添加DLL引用
- 从.NET SDK 发布列表下载包含DLL文件的压缩包,解压获得DLL文件。
- 在Visual Studio的解决方案资源管理器中右键单击您的项目,然后单击引用。
- 在弹出的菜单中单击添加引用。
- 在弹出对话框中,单击浏览,选择之前下载的DLL文件,单击确定。
- 项目引入方式
- 执行以下命令,在GitHub中下载SDK的源代码。
git clone https://github.com/aliyun/aliyun-openapi-net-sdk.git
您可以在下载生成的文件夹中找到名为 aliyun-net-sdk-XXX 的子文件夹,再找到 \\*.csproj 文件,即 .NET 项目文件。例如,在
aliyun-net-sdk-ecs
子文件夹下,有一个aliyun-net-sdk-ecs.vs2017.csproj
文件。 - 在Visual Studio的界面中,右键单击您的解决方案。
- 单击 。
- 在弹出的对话框中,选择刚才下载的源代码中相应的.NET 项目文件(例如
aliyun-net-sdk-ecs.vs2017.csproj
),单击打开。 - 右键单击您的项目,单击 。
- 执行以下命令,在GitHub中下载SDK的源代码。
使用.NET SDK
以下这个代码示例展示了调用阿里云.NET SDK的3个主要步骤:
- 创建并初始化DefaultAcsClient实例。
- 创建API请求并设置参数。
- 发起请求并处理应答或异常。
using Aliyun.Acs.Core; using Aliyun.Acs.Core.Profile; using Aliyun.Acs.Core.Exceptions; using Aliyun.Acs.Ecs.Model.V20140526; class TestProgram { static void Main(string[] args) { // 构建一个 Client,用于发起请求 IClientProfile profile = DefaultProfile.GetProfile( "<your-region-id>", "<your-access-key-id>", "<your-access-key-secret>"); DefaultAcsClient client = new DefaultAcsClient(profile); try { // 构造请求 DescribeInstancesRequest request = new DescribeInstancesRequest(); request.PageSize = 10; // 发起请求,并得到 Response DescribeInstancesResponse response = client.GetAcsResponse(request); System.Console.WriteLine(response.TotalCount); } catch (ServerException ex) { System.Console.WriteLine(ex.ToString()); } catch (ClientException ex) { System.Console.WriteLine(ex.ToString()); } } }