配置
IMM 服务所有语言的 SDK 都定义了一个 Client 类作为入口类,这些基本配置信息在该入口类的构造时指定。具体包括如下几项:
- 服务入口(Endpoint):指定 Client 需要访问的服务入口。
- 阿里云访问秘钥(AccessKeyId/AccessKeySecret):指定 Client 访问 IMM 服务时使用的访问秘钥。
下面详细说明这两个配置的使用方式。
服务入口(Endpoint):
当使用 SDK 时,首先需要明确访问的 Project 所在 Region(如“华东 1 (杭州)”、“华北 1 (青岛)”等),然后选择与其匹配的服务入口初始化 Client。该服务入口与 API 中的 服务入口 定义一致。
- 当选择 Client 的 Endpoint 时,必须要保证您需要访问的 Project 的 Region 和 Endpoint 对应的 Region 一致,否则 SDK 将无法访问您指定的 Project。
- 由于 Client 实例只能在构造时指定该服务入口,如果需要访问不同 Region 里的 Project,则需要用不同的 Endpoint 构建不同的 Client 实例。
访问秘钥(AccessKey):
所有和 IMM 服务端交互的请求都必须经过安全验证,而访问秘钥就是用来对请求进行安全验证的关键因子,且以 AccessKeyId 和 AccessKeySecret 方式成对出现。在 Client 构造时需要指定两个参数(AccessKeyId,AccessKeySecret)即为该访问秘钥对。所以,在使用 SDK 前,请在阿里云控制台 秘钥管理页面 获取(或者创建)合适的秘钥对。另外,在构造 Client 时还需要注意下面几点:
- 您的阿里云账号下可以拥有多组访问秘钥对,但在构造 Client 时指定的 AccessKeyId 和 AccessKeySecret 必须成对,否则无法通过服务端的安全验证。
- 指定的访问秘钥对必须处于“启用”状态,否则会被服务端拒绝请求。同样,您也可以到阿里云控制台 秘钥管理页面 查看访问秘钥的状态。
示例:
如果您需要访问在“华东 2 (上海)”Region 下的 Project,且当前已经拥有一对处于“启用”状态的访问秘钥对。如下:
AccessKeyId = "xxxx"
AccessKeySecret = "yyyyyyyyyyyyyyyyy"
则可以如下配置完成安装:
Java
<!-- pom.xml 配置 -->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<optional>true</optional>
<version>3.5.1</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-imm</artifactId>
<optional>true</optional>
<version>1.2.1</version>
</dependency>
//调用构造方法
IMMClient client = new IMMClient("cn-shanghai", accessKeyId, accessKeySecret);
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论