所有语言的SDK均定义了一个Client类作为入口类,在构造该入口类时需要指定配置信息。配置信息包括服务地址(Endpoint)和AccessKey。

配置服务地址(Endpoint)

当使用SDK时,需要确定访问的项目所在地域,例如华东1(杭州)等,并选择地域对应的接入地址初始化Client。服务地域的接入地址请参见下表。

注意
  • 设置Client的Endpoint时,必须保证您需要访问的项目所在地域和Endpoint对应的地域一致,否则SDK将无法访问指定的项目。
  • 由于只能在构造Client实例时指定服务地址,如果需要访问不同地域下的项目,则需要使用不同的Endpoint构造对应的Client实例。
服务地域(Region) 地域ID 接入地址
华东1(杭州) cn-hangzhou imm.cn-hangzhou.aliyuncs.com
华东2(上海) cn-shanghai imm.cn-shanghai.aliyuncs.com
华北2(北京) cn-beijing imm.cn-beijing.aliyuncs.com
华南1(深圳) cn-shenzhen imm.cn-shenzhen.aliyuncs.com

配置访问密钥

要接入阿里云的智能媒体管理服务,您需要拥有一个有效的访问密钥进行签名认证。目前支持下面三种方式:

  • 阿里云帐号的AccessKey ID和AccessKey Secret。获取步骤如下:
    警告 阿里云账号AccessKey泄露会威胁您所有资源的安全。建议您使用RAM用户AccessKey进行操作,可以有效降低AccessKey泄露的风险。
    1. 在阿里云官网注册阿里云帐号
    2. 登录AccessKey管理控制台创建AccessKey ID和AccessKey Secret。具体操作,请参见获取AccessKey
  • 具有智能媒体管理服务操作权限的RAM用户的AccessKey ID和AccessKey Secret。获取步骤如下:
    1. 使用阿里云帐号登录RAM控制台
    2. 创建一个新的RAM用户或者使用已存在的RAM用户。
    3. 使用阿里云帐号授予RAM用户访问智能媒体管理服务的权限。
    4. 为RAM用户创建AccessKey ID和AccessKey Secret。具体操作,请参见获取AccessKey
  • 从STS获取的临时访问凭证。获取步骤如下:
    1. 通过STS服务生成一个临时的AccessKey ID、AccessKey Secret和SecurityToken。具体操作,请参见AssumeRole
    2. 使用获取的临时密钥操作智能媒体管理服务。

初始化对接

使用智能媒体管理的SDK时,必须首先构造一个Client,通过调用该Client的接口来访问智能媒体管理服务。

本文使用Java SDK以访问华东1(杭州)地域下的项目为例介绍初始化对接时的pom配置和构造方法。

<!-- 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.22.0</version>
</dependency>
            
//调用构造方法。
IAcsClient client = new DefaultAcsClient(DefaultProfile.getProfile("cn-hangzhou", "your_access_key_id","your_access_key_secret"));