全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
阿里云SDK开发指南

快速开始

更新时间:2018-02-13 13:48:02

欢迎使用阿里云开发者工具套件(SDK)。适用于阿里云的C# SDK让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。如果您在使用SDK的过程中遇到任何问题,欢迎加入 钉钉群: 11771185 (阿里云官方SDK客户服务群)咨询。

环境准备

  1. 阿里云C# SDK适用于.NET Framework 4.0及以上版本。

  2. 要使用阿里云C# SDK,您需要一个云账号以及一对AccessKey IDAccessKey Secret。请在阿里云控制台中的AccessKey 管理页面上创建和查看您的 AccessKey,或者联系您的系统管理员。

  3. 要使用阿里云SDK访问某个产品的API,您需要在阿里云控制台中开通这个产品。

获取和安装SDK

进入阿里云SDK频道,查看已发布的阿里云产品SDK模块列表。

说明:部分阿里云产品的SDK未收录到这个列表中,请前往这些产品的详情页获取相应的 SDK。

要调用一个产品的SDK,您需要安装SDK核心库和该产品的SDK。例如,对于云服务器 SDK的调用,您需要获取和安装SDK核心库和云服务器的SDK。

方式一:添加DLL引用

  1. .NET SDK 发布列表这个下载包含DLL文件的压缩包,解压获得DLL文件。

  2. 在Visual Studio的解决方案资源管理器中右键单击您的项目,然后单击引用

  3. 在弹出的菜单中单击添加引用

  4. 在弹出对话框中,单击浏览,选择之前下载的DLL文件,单击确定

方式二:项目引入方式

  1. 执行以下命令,在GitHub中下载SDK的源代码。
  1. git clone https://github.com/aliyun/aliyun-openapi-net-sdk.git

您可以在下载生成的文件夹中,找到很多名为 aliyun-net-openapi-XXX 的子文件夹,里面都有一个 \\*.csproj 文件,即 C# 项目文件。例如,在 aliyun-net-openapi-ecs 子文件夹下,有一个 aliyun-net-sdk-ecs.csproj 文件。

  1. 在Visual Studio的界面中,右键单击您的解决方案。

  2. 单击添加 > 现有项目

  3. 在弹出的对话框中,选择刚才下载的源代码中相应的C# 项目文件(例如 aliyun-net-sdk-ecs.csproj),单击打开

  4. 右键单击您的项目,单击引用 > 添加引用

  5. 在弹出的对话框中单击项目选项卡,选中刚才打开的项目(例如 aliyun-net-sdk-ecs),然后单击确定

代码示例

以下代码示例展示了调用阿里云SDK的3个主要步骤:

  • 创建DefaultAcsClient实例并初始化。

  • 创建API请求并设置参数。

  • 发起请求并处理返回。

  1. using Aliyun.Acs.Core;
  2. using Aliyun.Acs.Core.Profile;
  3. using Aliyun.Acs.Core.Exceptions;
  4. using Aliyun.Acs.Ecs.Model.V20140526;
  5. class TestProgram
  6. {
  7. static void Main(string[] args)
  8. {
  9. // 构建一个 Client,用于发起请求
  10. IClientProfile profile = DefaultProfile.GetProfile(
  11. "<your-region-id>",
  12. "<your-access-key-id>",
  13. "<your-access-key-secret>");
  14. DefaultAcsClient client = new DefaultAcsClient(profile);
  15. try
  16. {
  17. // 构造请求
  18. DescribeInstancesRequest request = new DescribeInstancesRequest();
  19. request.PageSize = 10;
  20. // 发起请求,并得到 Response
  21. DescribeInstancesResponse response = client.GetAcsResponse(request);
  22. System.Console.WriteLine(response.TotalCount);
  23. }
  24. catch (ServerException ex)
  25. {
  26. System.Console.WriteLine(ex.ToString());
  27. }
  28. catch (ClientException ex)
  29. {
  30. System.Console.WriteLine(ex.ToString());
  31. }
  32. }
  33. }

在创建DefaultAcsClient实例并初始化时,您需要提供3个参数:Region IDAccessKey IDAccessKey SecretAccessKey IDAccessKey Secret 可以在阿里云控制台中的AccessKey管理页面获得, Region ID 可以在地域列表获得。

API参考

要知道您想访问的产品提供的API以及它们的参数,请参考已开发API的云产品列表

本文导读目录