阿里云-日志服务SDK-D

《阿里云-日志服务SDK-D》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、日志服务SDK日志服务/SDKSDK基本介绍为方便开发人员更高效地使用日志服务服务，我们提供了多个语言版本（Java、.NET、Python、PHP、C）的SDK（SoftwareDevelopmentKit），你可以根据自己需求选择合适版本使用。日志服务SDK基于日志服务API实现，且提供和日志服务API同样的能力。如果你需要了解日志服务API的更多细节，请见API参考。类似于使用日志服务API，你首先需要拥有一个处于Active状态的阿里云访问秘钥（AccessKeyId/AccessKeySecurity)，详情请

2、见访问秘钥。为使用日志服务SDK，你需要了解日志服务在各个阿里云区域（Region）的服务入口。具体如何在SDK中指定这个根服务入口，请参考SDK配置。尽管不同语言的日志服务SDK具体实现细节会有所不同，但是它们都是日志服务API在不同语言上的封装，实现的功能也基本一致，具体包括如下几个方面：-实现对日志服务API接口的统一封装，让用户不需要关心具体的API请求构建和响应解析。而且各个不同语言的接口也非常接近，方面用户在不同语言切换。-实现日志服务API的数字签名逻辑，让用户不需要关心API的签名逻辑细节，大大降低使用日

3、志服务API的难度。-实现日志服务日志的ProtoBuffer格式封装，让用户在写入日志时不需要关心ProtoBuffer格式的具体细节。-实现日志服务API中定义的压缩方法，让用户不用关心压缩实现的细节。部分语言的SDK可以让用户指定是否启用压缩模式写入日志（默认为使用压缩方式）。-提供统一的错误处理机制，让用户以使用语言所熟悉的方式处理请求异常。-目前所有语言实现的SDK仅提供同步请求方式各个不同语言的SDK的下载地址、详细使用说明及完整的编程参考请见如下表格：SDK语言SDK下载链接相关文档源码Java最新版本所有

4、版本快速入门,接口参考敬请期待.NET最新版本所有版本快速入门,接口参考GitHubPHP最新版本所有版本快速入门,接口参考敬请期待Python最新版本所有版本快速入门,接口参考敬请期待34日志服务/SDKC请参考GitHubREADME请参考GitHubREADMEGitHub就如同使用API和日志服务服务端交互一样，使用SDK也需要指定一些基本配置。目前，所有语言的SDK都定义了一个Client类作为入口类，这些基本配置信息在该入口类的构造时指定。具体包括如下几项：-服务入口（Endpoint）：指定Client需要

5、访问的服务入口。-阿里云访问秘钥（AccessKeyId/AccessKeySecret）：指定Client访问日志服务时使用的访问秘钥。下面详细说明这两个配置的使用方式：服务入口（Endpoint）：当使用SDK时，首先需要明确访问的日志服务Project所在Region（如"华东1(杭州)"、"华北1(青岛)"等），然后选择和其匹配的日志服务入口初始化化Client。该服务入口与API中的服务入口定义一致。1.当选择Client的Endpoint时，必须要保证你需要访问Project的Region和Endpoint对

6、应的Region一致，否则SDK将无法访问你指定的Project。2.由于Client实例只能在构造时指定该服务入口，如果需要访问不同Region里的Project，则需要用不同的Endpoint构建不同的Client实例。3.目前，所有API的服务入口仅支持HTTP协议。4.如果在阿里云ECS虚拟机内使用SDK，你还可以使用内网Endpoint避免公网带宽开销，具体请参考服务入口。访问秘钥（AccessKey）：正如访问秘钥所述，所有和日志服务端交互的请求都必须经过安全验证，而访问秘钥就是用来对请求进行安全验证的关键因

7、子，且以AccessKeyId和AccessKeySecret方式成对出现。在Client构造时需要指定两个参数（AccessKeyId，AccessKeySecret）即为该访问秘钥对。所以，在使用SDK前请在阿里云控制台秘钥管理页面获取（或者创建）合适秘钥对。另外，在构造Client类还需要注意下面几点：-你的阿里云账号下可以拥有多组访问秘钥对，但在构造Client时指定的AccessKeyId和AccessKeySecret必须成对，否则无法通过服务端的安全验证。-指定的访问秘钥对必须处于"启用"状态，否则会被服务

8、端拒绝请求。同样，你也可以到阿里云控制台秘钥管理页面参看访问秘钥的状态。示例：如果需要访问在"华东1(杭州)"Region下的Project，且当前已经拥有一对处于"启用"状态的访问秘钥对。如下AccessKeyId="bq2sjzesjmo86kq35behupbq"AccessKeySecret="4fdO2fT