aliyun open api sdk for .net
Switch branches/tags
Nothing to show
Clone or download
jxyowen DYBASEAPI SDK Auto Released By pianzuo.zj,Version:1.0.0
1, Add MNS STS Token Query API
2, Add MNS Minimal Package
Latest commit 90b8d12 Nov 20, 2018
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.1 Nov 16, 2018
aliyun-net-sdk-arms ARMS SDK Auto Released By qikai.yangqikai,Version:2.2.0 Oct 16, 2018
aliyun-net-sdk-arms4finance add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-bssopenapi BSSOPENAPI SDK Auto Released By xueyulun,Version:1.0.5 Nov 19, 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.2 Nov 10, 2018
aliyun-net-sdk-chatbot CHATBOT SDK Auto Released By longda.cld,Version:1.2.0 Nov 15, 2018
aliyun-net-sdk-cloudapi add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-cloudauth CLOUDAUTH SDK Auto Released By,Version:1.1.6 Oct 26, 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 由归邪发起的CORE SDK自动发布, BUILD_ID=198, 版本号:1.1.12 Mar 15, 2018
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.1.0 Sep 29, 2018
aliyun-net-sdk-dds DDS SDK Auto Released By junjun.zhang,Version:2.0.2 Oct 31, 2018
aliyun-net-sdk-dm add the vs2017.csproj files Feb 28, 2018
aliyun-net-sdk-domain-intl DOMAIN-INTL SDK Auto Released By lukang.zlh,Version:1.3.0 Nov 13, 2018
aliyun-net-sdk-domain DOMAIN SDK Auto Released By tieqin.lxy,Version:3.10.1 Nov 19, 2018
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,Version:4.13.0 Nov 15, 2018
aliyun-net-sdk-ehpc EHPC SDK Auto Released By,Version:1.9.0 Nov 14, 2018
aliyun-net-sdk-ess ESS SDK Auto Released By kangning.tkn,Version:2.2.6 Sep 6, 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-imm IMM SDK Auto Released By kuta.zyb,Version:1.1.2 Nov 15, 2018
aliyun-net-sdk-iot IOT SDK Auto Released By cheyun.lxf,Version:6.3.1 Oct 16, 2018
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.2 Oct 30, 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 add the vs2017.csproj files Feb 28, 2018
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.3 Sep 6, 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.1.9 Sep 17, 2018
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.1.0 Sep 29, 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.2.0 Aug 13, 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 guzhaoyuan,Version:2.11.6 Oct 11, 2018
aliyun-net-sdk-vpc 由温仰发起的VPC SDK自动发布, BUILD_ID=466, 版本号:3.0.2 Mar 15, 2018
.gitignore Create .gitignore Feb 12, 2018
LICENSE Create LICENSE Feb 12, 2018 add readme May 5, 2018 Update Oct 22, 2018

Alibaba Cloud C# Software Development Kit


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)