aliyun open api sdk for .net
Clone or download
AxiosCros Merge pull request #63 from aliyun/appveyor
add Appveyor badge and ignore UnitTests dir
Latest commit e6c2e96 Jan 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
aliyun-net-sdk-aegis add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-afs add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-alidns add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-alimt ALIMT SDK Auto Released By xulei.xl,Version:1.0.3 Dec 27, 2018
aliyun-net-sdk-arms ARMS SDK Auto Released By shichun.fsc,Version:2.3.0 Dec 21, 2018
aliyun-net-sdk-arms4finance add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-baas BAAS SDK Auto Released By titian.gtt,Version:1.0.0 Dec 4, 2018
aliyun-net-sdk-bssopenapi BSSOPENAPI SDK Auto Released By liupan,Version:1.0.7 Dec 17, 2018
aliyun-net-sdk-ccc CCC SDK Auto Released By yonghong.lyh,Version:1.0.8 Aug 14, 2018
aliyun-net-sdk-ccs CCS SDK Auto Released By wilson.liuw,Version:1.0.0 Sep 25, 2018
aliyun-net-sdk-cdn CDN SDK Auto Released By xiaoyao,Version:3.0.3 Dec 3, 2018
aliyun-net-sdk-chatbot CHATBOT SDK Auto Released By longda.cld,Version:1.2.0 Nov 15, 2018
aliyun-net-sdk-cloudapi CLOUDAPI SDK Auto Released By carter,Version:4.8.0 Jan 16, 2019
aliyun-net-sdk-cloudauth CLOUDAUTH SDK Auto Released By,Version:1.2.0 Jan 15, 2019
aliyun-net-sdk-cloudesl CLOUDESL SDK Auto Released By,Version:1.0.0 Dec 17, 2018
aliyun-net-sdk-cloudphoto 由廷诚发起的CLOUDPHOTO SDK自动发布, 版本号:1.1.18 Apr 24, 2018
aliyun-net-sdk-cloudwf add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-cms CMS SDK Auto Released By yixiong.jxy,Version:6.0.13 Aug 2, 2018
aliyun-net-sdk-core.Tests Fix issues #53 (#60) Jan 17, 2019
aliyun-net-sdk-core Fix issues #53 (#60) Jan 17, 2019
aliyun-net-sdk-cs add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-csb CSB SDK Auto Released By,Version:1.1.6 Sep 3, 2018
aliyun-net-sdk-dcdn DCDN SDK Auto Released By xiaoyao,Version:1.2.2 Dec 20, 2018
aliyun-net-sdk-dds DDS SDK Auto Released By junjun.zhang,Version:2.0.3 Dec 11, 2018
aliyun-net-sdk-dm add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-dms-enterprise DMS-ENTERPRISE SDK Auto Released By yuyang.cjx,Version:1.1.0 Dec 29, 2018
aliyun-net-sdk-domain-intl DOMAIN-INTL SDK Auto Released By huizeng.zh,Version:1.4.0 Dec 20, 2018
aliyun-net-sdk-domain DOMAIN SDK Auto Released By tieqin.lxy,Version:3.12.1 Jan 10, 2019
aliyun-net-sdk-drds 由燧木发起的DRDS SDK自动发布, 版本号:2.5.0 May 23, 2018
aliyun-net-sdk-dybaseapi DYBASEAPI SDK Auto Released By pianzuo.zj,Version:1.0.0 Nov 20, 2018
aliyun-net-sdk-dyvmsapi 由峰远发起的DYVMSAPI SDK自动发布, 版本号:1.0.0 May 23, 2018
aliyun-net-sdk-ecs ECS SDK Auto Released By wenle.bwl,Version:4.16.0 Jan 17, 2019
aliyun-net-sdk-ehpc EHPC SDK Auto Released By,Version:1.10.0 Dec 13, 2018
aliyun-net-sdk-ess ESS SDK Auto Released By deyan.jdy,Version:2.2.7 Dec 3, 2018
aliyun-net-sdk-green GREEN SDK Auto Released By fengdong.xfd,Version:3.3.2 Sep 27, 2018
aliyun-net-sdk-hpc add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-hsm 由鸿逸发起的HSM SDK自动发布, 版本号:1.0.0 Apr 27, 2018
aliyun-net-sdk-httpdns HTTPDNS SDK Auto Released By baijue.xwz,Version:2.2.0 Dec 15, 2018
aliyun-net-sdk-imm IMM SDK Auto Released By kuta.zyb,Version:1.3.4 Jan 11, 2019
aliyun-net-sdk-iot IOT SDK Auto Released By cheyun.lxf,Version:6.6.0 Jan 15, 2019
aliyun-net-sdk-jarvis JARVIS SDK Auto Released By mainri.mxy,Version:1.2.3 Jun 21, 2018
aliyun-net-sdk-kms 由丰鲁成发起的KMS SDK自动发布, 版本号:2.5.0 Mar 29, 2018
aliyun-net-sdk-linkface LINKFACE SDK Auto Released By jiayao.wjy,Version:1.1.2 Nov 2, 2018
aliyun-net-sdk-live LIVE SDK Auto Released By renrang.yl,Version:3.7.3 Dec 6, 2018
aliyun-net-sdk-lubancloud LUBANCLOUD SDK Auto Released By benxiang.hhq,Version:1.0.0 Nov 2, 2018
aliyun-net-sdk-mopen MOPEN SDK Auto Released By everettli.ll,Version:1.1.0 Jul 31, 2018
aliyun-net-sdk-mts MTS SDK Auto Released By lingkong.mxs,Version:2.6.0 Aug 4, 2018
aliyun-net-sdk-nas NAS SDK Auto Released By hanjie.ghj,Version:3.2.0 Jan 4, 2019
aliyun-net-sdk-ons add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-ots OTS SDK Auto Released By wanhong.chenwh,Version:4.0.0 Aug 8, 2018
aliyun-net-sdk-push 由释一发起的PUSH SDK自动发布, BUILD_ID=490, 版本号:3.10.0 Mar 23, 2018
aliyun-net-sdk-pvtz 由空木发起的PVTZ SDK自动发布, 版本号:1.0.0 May 17, 2018
aliyun-net-sdk-r-kvstore R-KVSTORE SDK Auto Released By junjun.zhang,Version:2.0.5 Dec 27, 2018
aliyun-net-sdk-ram add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-rds RDS SDK Auto Released By junjun.zhang,Version:2.3.1 Jan 4, 2019
aliyun-net-sdk-release-test rename csproj to vs2010.csproj and removed AssemblyInfo.cs Feb 28, 2018
aliyun-net-sdk-rtc RTC SDK Auto Released By renrang.yl,Version:1.0.1 Nov 8, 2018
aliyun-net-sdk-saf SAF SDK Auto Released By xinfa.duanxf,Version:1.0.1 Oct 9, 2018
aliyun-net-sdk-sas-api add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-scdn SCDN SDK Auto Released By xiaoyao,Version:1.2.3 Dec 12, 2018
aliyun-net-sdk-slb 由挐云发起的SLB SDK自动发布, 版本号:3.2.4 Apr 19, 2018
aliyun-net-sdk-smartag SMARTAG SDK Auto Released By jijun.jj,Version:1.4.1 Dec 12, 2018
aliyun-net-sdk-sts add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-tesladam add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-teslamaxcompute 由荣旸发起的TESLAMAXCOMPUTE SDK自动发布, 版本号:1.5.4 May 8, 2018
aliyun-net-sdk-teslastream TESLASTREAM SDK Auto Released By,Version:1.0.0 Jul 26, 2018
aliyun-net-sdk-vod VOD SDK Auto Released By zhanglilei,Version:2.12.0 Jan 15, 2019
aliyun-net-sdk-vpc 由温仰发起的VPC SDK自动发布, BUILD_ID=466, 版本号:3.0.2 Mar 15, 2018
.gitignore Add codecov support Jan 17, 2019
.travis.yml update .travis.yml Jan 18, 2019
LICENSE Create LICENSE Feb 12, 2018 appveyor badge Jan 18, 2019 appveyor badge Jan 18, 2019
aliyun-net-sdk.sln Add codecov support Jan 17, 2019
appveyor.yml update appveyor.yml and TEST only build master branch Jan 18, 2019
codecov.yml ignore aliyun-net-sdk-core.Tests Jan 18, 2019

Alibaba Cloud C# Software Development Kit


Travis CI Build Status Appveyor CI Build Status codecov

The Alibaba Cloud C# Software Development Kit (SDK) allows you to access Alibaba Cloud services such as Elastic Compute Service (ECS), Server Load Balancer (SLB), and CloudMonitor. You can access Alibaba Cloud services without the need to handle API related tasks, such as signing and constructing your requests.

This document introduces how to install and use Alibaba Cloud C# SDK.

If you have any problem while using Java SDK, please join the DingTalk group: 11771185 (the official SDK customer service group of Alibaba Cloud) for consultation.


  • To use Alibaba Cloud C# SDK, you must have an Alibaba Cloud account and an AccessKey.

    The AccessKey is required when initializing the client. You can create an AccessKey in the Alibaba Cloud console. For more information, see Create an AccessKey.

    Note: To increase the security of your account, we recommend that you use the AccessKey of the RAM user to access Alibaba Cloud services.

  • To use Alibaba Cloud Java SDK to access the APIs of a product, you must first activate the product on the Alibaba Cloud console if required.

  • The Alibaba Cloud C# SDK is requires .NET Framework 4.0 or later.

Install C# SDK

You must install the SDK core library for any SDK you use. For example, to call the ECS SDK, you must install both the ECS SDK and the SDK core library.

Install the Alibaba Cloud C# SDK using one of the following methods:

  • Add DLL reference

    1. Download the DLL package from .NET SDK.

    2. Right click your project in the Solution Explorer of Visual Studio and click Reference.

    3. In the displayed menu, click Add Reference.

    4. In the displayed dialog box, click Browse. Then select the downloaded DLL file and click Confirm.

  • Add project reference

    1. Run the following command to clone the SDK source codes from GitHub.
     git clone

    There are many folders prefixed withaliyun-net-openapi-in the cloned directory. Each folder contains \\*.csproj file, which is the project file**. For example, there is an aliyun-net-sdk-ecs.csproj file under the aliyun-net-openapi-ecs subfolder.

    1. In Visual Studio, right click your solution.

    2. Click Add > Existing Project.

    3. In the displayed dialogue box, select the project file, for example, aliyun-net-sdk-ecs.csproj, and click then Open.

    4. Right click your project and click Reference > Add Reference.

    5. In the displayed dialog box, click the **Project ** tab, select the opened project and click Confirm.

Initiate a call

The following code example shows the three main steps to use the Alibaba Cloud C# SDK:

  • Create and initialize a DefaultAcsClient instance.

  • Create a request and set parameters.

  • Initiate the request and handle the response.

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)
        // Create a client used for initiating a request
        IClientProfile profile = DefaultProfile.GetProfile(
        DefaultAcsClient client = new DefaultAcsClient(profile);

            // Create the request
            DescribeInstancesRequest request = new DescribeInstancesRequest();
            request.PageSize = 10;

            // Initiate the request and get the response
            DescribeInstancesResponse response = client.GetAcsResponse(request);
        catch (ServerException ex)
        catch (ClientException ex)