全部产品
云市场

配置

更新时间:2018-03-07 12:52:40

IMM 服务所有语言的 SDK 都定义了一个 Client 类作为入口类,这些基本配置信息在该入口类的构造时指定。具体包括如下几项:

  • 服务入口(Endpoint):指定 Client 需要访问的服务入口。
  • 阿里云访问秘钥(AccessKeyId/AccessKeySecret):指定 Client 访问 IMM 服务时使用的访问秘钥。

下面详细说明这两个配置的使用方式。

服务入口(Endpoint):

当使用 SDK 时,首先需要明确访问的 Project 所在 Region(如“华东 1 (杭州)”、“华北 1 (青岛)”等),然后选择与其匹配的服务入口初始化 Client。该服务入口与 API 中的 服务入口 定义一致。

  1. 当选择 Client 的 Endpoint 时,必须要保证您需要访问的 Project 的 Region 和 Endpoint 对应的 Region 一致,否则 SDK 将无法访问您指定的 Project。
  2. 由于 Client 实例只能在构造时指定该服务入口,如果需要访问不同 Region 里的 Project,则需要用不同的 Endpoint 构建不同的 Client 实例。

访问秘钥(AccessKey):

所有和 IMM 服务端交互的请求都必须经过安全验证,而访问秘钥就是用来对请求进行安全验证的关键因子,且以 AccessKeyId 和 AccessKeySecret 方式成对出现。在 Client 构造时需要指定两个参数(AccessKeyId,AccessKeySecret)即为该访问秘钥对。所以,在使用 SDK 前,请在阿里云控制台 秘钥管理页面 获取(或者创建)合适的秘钥对。另外,在构造 Client 时还需要注意下面几点:

  • 您的阿里云账号下可以拥有多组访问秘钥对,但在构造 Client 时指定的 AccessKeyId 和 AccessKeySecret 必须成对,否则无法通过服务端的安全验证。
  • 指定的访问秘钥对必须处于“启用”状态,否则会被服务端拒绝请求。同样,您也可以到阿里云控制台 秘钥管理页面 查看访问秘钥的状态。

示例:

如果您需要访问在“华东 2 (上海)”Region 下的 Project,且当前已经拥有一对处于“启用”状态的访问秘钥对。如下:

  1. AccessKeyId = "xxxx"
  2. AccessKeySecret = "yyyyyyyyyyyyyyyyy"

则可以如下配置完成安装:

Java

  1. <!-- pom.xml 配置 -->
  2. <dependency>
  3. <groupId>com.aliyun</groupId>
  4. <artifactId>aliyun-java-sdk-core</artifactId>
  5. <optional>true</optional>
  6. <version>3.5.1</version>
  7. </dependency>
  8. <dependency>
  9. <groupId>com.aliyun</groupId>
  10. <artifactId>aliyun-java-sdk-imm</artifactId>
  11. <optional>true</optional>
  12. <version>1.2.1</version>
  13. </dependency>
  1. //调用构造方法
  2. IMMClient client = new IMMClient("cn-shanghai", accessKeyId, accessKeySecret);