本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
所有语言的SDK均定义了一个Client类作为入口类,在构造该入口类时需要指定配置信息。配置信息包括服务地址(Endpoint)和AccessKey。
配置服务地址(Endpoint)
当使用SDK时,需要确定访问的项目所在地域,例如华东1(杭州)等,并选择地域对应的接入地址初始化Client。服务地域的接入地址请参见下表。
设置Client的Endpoint时,必须保证您需要访问的项目所在地域和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 ID和AccessKey Secret。获取步骤如下:
警告阿里云账号AccessKey泄露会威胁您所有资源的安全。建议您使用RAM用户AccessKey进行操作,可以有效降低AccessKey泄露的风险。
在阿里云官网注册阿里云账号。
创建AccessKey ID和AccessKey Secret。具体操作,请参见获取AccessKey。
具有智能媒体管理服务操作权限的RAM用户的AccessKey ID和AccessKey Secret。获取步骤如下:
使用阿里云账号登录RAM控制台。
创建一个新的RAM用户或者使用已存在的RAM用户。
使用阿里云账号授予RAM用户访问智能媒体管理服务的权限。
为RAM用户创建AccessKey ID和AccessKey Secret。具体操作,请参见获取AccessKey。
从STS获取的临时访问凭证。获取步骤如下:
通过STS服务生成一个临时的AccessKey ID、AccessKey Secret和SecurityToken。具体操作,请参见AssumeRole。
使用获取的临时密钥操作智能媒体管理服务。
初始化对接
使用智能媒体管理的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)