初始化

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

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

配置服务地址(Endpoint)

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

重要
  • 设置ClientEndpoint时,必须保证您需要访问的项目所在地域和Endpoint对应的地域一致,否则SDK将无法访问指定的项目。

  • 由于只能在构造Client实例时指定服务地址,如果需要访问不同地域下的项目,则需要使用不同的Endpoint构造对应的Client实例。

服务地域(Region)

地域ID

接入地址

VPC域名

华东1(杭州)

cn-hangzhou

imm.cn-hangzhou.aliyuncs.com

imm-vpc.cn-hangzhou.aliyuncs.com

华东2(上海)

cn-shanghai

imm.cn-shanghai.aliyuncs.com

imm-vpc.cn-shanghai.aliyuncs.com

华北1(青岛)

cn-qingdao

imm.cn-qingdao.aliyuncs.com

imm-vpc.cn-qingdao.aliyuncs.com

华北2(北京)

cn-beijing

imm.cn-beijing.aliyuncs.com

imm-vpc.cn-beijing.aliyuncs.com

华北3(张家口)

cn-zhangjiakou

imm.cn-zhangjiakou.aliyuncs.com

imm-vpc.cn-zhangjiakou.aliyuncs.com

华南1(深圳)

cn-shenzhen

imm.cn-shenzhen.aliyuncs.com

imm-vpc.cn-shenzhen.aliyuncs.com

华南3(广州)

cn-guangzhou

imm.cn-guangzhou.aliyuncs.com

imm-vpc.cn-guangzhou.aliyuncs.com

西南1(成都)

cn-chengdu

imm.cn-chengdu.aliyuncs.com

imm-vpc.cn-chengdu.aliyuncs.com

中国香港

cn-hongkong

imm.cn-hongkong.aliyuncs.com

imm-vpc.cn-hongkong.aliyuncs.com

新加坡(新加坡)

ap-southeast-1

imm.ap-southeast-1.aliyuncs.com

imm-vpc.ap-southeast-1.aliyuncs.com

印度尼西亚(雅加达)

ap-southeast-5

imm.ap-southeast-5.aliyuncs.com

imm-vpc.ap-southeast-5.aliyuncs.com

德国(法兰克福)

eu-central-1

imm.eu-central-1.aliyuncs.com

imm-vpc.eu-central-1.aliyuncs.com

英国(伦敦)

eu-west-1

imm.eu-west-1.aliyuncs.com

imm-vpc.eu-west-1.aliyuncs.com

美国(弗吉尼亚)

us-east-1

imm.us-east-1.aliyuncs.com

imm-vpc.us-east-1.aliyuncs.com

美国(硅谷)

us-west-1

imm.us-west-1.aliyuncs.com

imm-vpc.us-west-1.aliyuncs.com

配置访问密钥

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

  • 阿里云账号的AccessKey IDAccessKey Secret。获取步骤如下:

    警告

    阿里云账号AccessKey泄露会威胁您所有资源的安全。建议您使用RAM用户AccessKey进行操作,可以有效降低AccessKey泄露的风险。

    1. 在阿里云官网注册阿里云账号

    2. 创建AccessKey IDAccessKey Secret。具体操作,请参见获取AccessKey

  • 具有智能媒体管理服务操作权限的RAM用户的AccessKey IDAccessKey Secret。获取步骤如下:

    1. 使用阿里云账号登录RAM控制台

    2. 创建一个新的RAM用户或者使用已存在的RAM用户。

    3. 使用阿里云账号授予RAM用户访问智能媒体管理服务的权限。

    4. RAM用户创建AccessKey IDAccessKey Secret。具体操作,请参见获取AccessKey

  • STS获取的临时访问凭证。获取步骤如下:

    1. 通过STS服务生成一个临时的AccessKey ID、AccessKey SecretSecurityToken。具体操作,请参见AssumeRole

    2. 使用获取的临时密钥操作智能媒体管理服务。

初始化对接

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

如下以使用1.27.4版本的Python SDK访问华东1(杭州)地域下的项目为例介绍初始化对接时安装SDK和构造Client的方法。

重要

调用2020-09-30版本的API,需要使用2020-09-30版本的SDK。

  • 安装SDK

    使用如下命令安装SDK:

    pip install alibabacloud_imm20200930

  • 构造Client

    构造Client的示例代码如下:

    from alibabacloud_imm20200930.client import Client as imm20200930Client
    from alibabacloud_tea_openapi import models as open_api_models
    import os
    cred = Client(config)
    config = Config(
    	type='access_key',
    	access_key_id=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID'),
    	access_key_secret=os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
    )
    # 填写访问的域名。
    config.endpoint = f'imm.cn-hangzhou.aliyuncs.com'
    client = imm20200930Client(config)