快速入门
进阶文档
SDK 示例
历史版本
概述
文档中 SDK 关于 API 的示例代码仅供参考,各 API 的完整使用步骤与说明请参见SDK 示例 和 OpenAPI 文档。环境要求
- 最低要求net framework 4.5 或 .Net Core 2.0
- 安装 SDK 核心库 Core
- 可以通过 .NET CLI 工具来安装,如果要安装特定版本,请添加
--version
,否则它将安装此软件包的最新版本。
- 也可以通过配置 .csproj 文件引入依赖
- 再通过 dotnet 来安装。
- 可以通过 .NET CLI 工具来安装,如果要安装特定版本,请添加
安装方式
.NET CLI
Package Manager
PackageReference
Paket CLI
F# Interactive
示例背景
- 以下代码详细介绍了 SDK 的使用步骤,仅作
步骤示范
。示例展示了如何调用 CreateKey API 进行创建一个主密钥
请求。
完整代码示例
以下为本文示例的完整 .NET SDK代码。
步骤介绍
- 初始化配置对象 Aliyun.Acs.Core.Profile 。
Profile 对象存放
accessKeyId
、accessKeySecret
、regionId
等配置。
- 实例化一个客户端,从 Aliyun.Acs.Core.IAcsClient 类生成对象 client 。
- 创建对应 API 的 Request 。 类的命名规则为 API 方法名加上 Request 。例如:
- 设置请求类 request 的参数。 通过设置 request 类的属性设置参数,即 API 中必须要提供的信息。例如:
- 通过 client 对象获得对应 request 响应 response 。
- 调用 response 中对应的属性获得返回的参数值。 假设您需要获取 requestId :
根据 API 方法的不同,返回的信息中可能会包含多层的信息。
- 使用 catch() 处理服务器报错和客户端报错。
- 服务端报错
- 客户端报错