Open API SDK for .Net Core developers
Requirements
- 仅支持 .NET Core 2.0 及以上版本(为推进新版本发展，停止支持 .NET Core 1.0、1.1版本)；
- 下载SDK 把
Aliyun.Acs.Core.dll和相应产品的 .dll 文件添加引用到项目中。
Installation
进入 Alibaba Cloud SDK for .NET Nuget Package 页面，查看已发布的阿里云产品 SDK 模块列表。
注意： 部分阿里云产品的 SDK 未收录到这个列表中，例如对象存储（OSS），表格存储（Table Store），请前往这些产品的详情页获取相应的 SDK。
使用ECS产品时，应安装 ECS Nuget Package。
如果要安装特定版本，请添加--version，否则它将安装此软件包的最新版本。
您可以通过 NuGet 程序包管理器来安装：
- 在
解决方案资源管理器面板中右击您的项目选择管理 NuGet 程序包菜单，在打开的NuGet 管理面板中点击浏览选项卡输入aliyun-net-sdk，在下方列表中选择Authors为Alibaba Cloud由官方发布的各产品模块，选择您期望的模块点击 安装 即可。
或者通过 .NET CLI 工具来安装（以安装 ECS为例）
dotnet add package aliyun-net-sdk-ecs
使用程序包管理器控制台
Install-Package aliyun-net-sdk-ecs
Examples
using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Ecs.Model.V20140526;
using System;
class Sample
{
static void Main(string[] args)
{
TestDescribeInstanceAttribute();
}
private static void TestDescribeInstanceAttribute()
{
IClientProfile clientProfile = DefaultProfile.GetProfile("cn-hangzhou", "<your access key id>", "<your access key secret>");
DefaultAcsClient client = new DefaultAcsClient(clientProfile);
DescribeInstanceAttributeRequest request = new DescribeInstanceAttributeRequest();
request.InstanceId = "<your instances id>";
try
{
DescribeInstanceAttributeResponse response = client.GetAcsResponse(request);
Console.Write(response.InstanceId);
}
catch (ServerException e)
{
Console.WriteLine(e.ErrorCode);
Console.WriteLine(e.ErrorMessage);
}
catch (ClientException e)
{
Console.WriteLine(e.ErrorCode);
Console.WriteLine(e.ErrorMessage);
}
}
}Questions
-
怎么判断API调用成功？
通过catch异常判断API是否调用成功，当 API 的
http status >= 200 && http status < 300表示API调用成功；当http status >= 300 && http status < 500SDK 抛出ClientException；当http status >= 500SDK 抛出ServerException. -
IClientProfile clientProfile = DefaultProfile.GetProfile("< your request regionid >", "< your access key id >", "< your access key secret >");此处的
regionid参数指你需要操作的region的id，例如要操作杭州region，则regionid=cn-hangzhou；默认填cn-hangzhou. -
docker for linux 环境中，如何无错运行Aliyun SDK Application? 请在Dockerfile中指定
FROM microsoft/dotnet:latest, 而不是FROM microsoft/aspnetcore:latest.
Authors && Contributors
License
licensed under the Apache License 2.0