Csharp SDK手册(澳洲和新加坡区域)
本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
本文介绍了如何安装和使用C# SDK。
创建AccessKey
(注:也可以使用阿里云访问控制服务创建的AccessKey。)
单击页面右上角创建 AccessKey按钮,弹出创建对话框。
阅读《API使用规范》后,单击同意并创建。
(推荐)安装 C# SDK
开发环境
阿里云邮件推送的 C# SDK 支持 .Net Framework 2.0 或以上版本。
SDK 安装
通过 dotnet 进行安装
1、添加依赖包
您可以在openAPI页面,“SDK信息”获取新版本号。
dotnet add package AlibabaCloud.SDK.Dm20151123 --version 1.0.x
version 1.0.x为示例,实际添加中请填写在openAPI中获取的最新版本号。
2、跳转到openAPI进行调试,选择开发语言,填写参数,下载自动生成的代码(会包含参数值)。
调试页面无须填写Key值。
请勿在代码中硬编码"accessKeyId","accessKeySecret"值,以免泄露。
阿里云SDK支持在操作系统的环境变量中定义ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET的值,代码中从环境变量获取后进行鉴权,参考文档:身份验证配置。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
(不推荐)旧版SDK安装方式
安装 C# SDK
开发环境
阿里云C# SDK的.NET 开发环境:
.NET Framework 4.6.1 或以上
.NET Standard 2.0 或以上
SDK 安装
必须为您使用的任何SDK安装SDK核心Nuget包.
使用包管理器
Install-Package aliyun-net-sdk-core
Install-Package aliyun-net-sdk-dm-overseas -Version 4.7.2
您还可以使用VisualStudio来安装.NET Framework应用程序,参考https://docs.microsoft.com/en-us/nuget/quickstart/install-and-use-a-package-in-visual-studio 在包浏览器中搜索我们的SDK名称“aliyun net SDK dm overseas”。
发送邮件示例
调用单一发信API示例(如何调用此接口,请参见 SingleSendMail):
using System;
using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Dm.Model.V20170622;
namespace ConsoleApp
{
class Program
{
static void Main(string[] args)
{
//Region-Id: ap-southeast-1 for Singapore Region and ap-southeast-2 for Australlia Region
string regionId = "ap-southeast-1";
//Region-Host: dm.ap-southeast-1.aliyuncs.com for Singapore Region and dm.ap-southeast-2.aliyuncs.com for Australlia Region
string regionHost = "dm.ap-southeast-1.aliyuncs.com";
//请在环境变量中配置ALIBABA_CLOUD_ACCESS_KEY_ID,ALIBABA_CLOUD_ACCESS_KEY_SECRET。
//参考文档:https://help.aliyun.com/document_detail/2361895.html
IClientProfile profile = DefaultProfile.GetProfile(regionId, Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"), Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
IAcsClient client = new DefaultAcsClient(profile);
DefaultProfile.AddEndpoint(regionHost, regionId, "Dm", regionHost);
SingleSendMailRequest request = new SingleSendMailRequest();
try {
request.AccountName = "Sender address created in the console";
request.FromAlias = "Sender nickname";
request.AddressType = 1;
request.TagName = "Tag created in the console";
request.ReplyToAddress = true;
request.ToAddress = "Destination address";
request.Subject = "Subject";
request.HtmlBody = "Body";
SingleSendMailResponse httpResponse = client.GetAcsResponse(request);
System.Console.WriteLine(httpResponse.RequestId);
} catch (ServerException e) {
System.Console.WriteLine(e.ToString());
}
catch (ClientException e) {
System.Console.WriteLine(e.ToString());
}
}
}
}
- 本页导读 (0)