所有語言的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 |
配置存取金鑰
要接入阿里雲的Intelligent Media Management服務,您需要擁有一個有效存取金鑰進行簽名認證。目前支援下面三種方式:
阿里雲帳號的AccessKey ID和AccessKey Secret。擷取步驟如下:
警告阿里雲帳號AccessKey泄露會威脅您所有資源的安全。建議您使用RAM使用者AccessKey進行操作,可以有效降低AccessKey泄露的風險。
在阿里雲官網註冊阿里雲帳號。
建立AccessKey ID和AccessKey Secret。具體操作,請參見擷取AccessKey。
具有Intelligent Media Management服務作業許可權的RAM使用者的AccessKey ID和AccessKey Secret。擷取步驟如下:
使用阿里雲帳號登入RAM控制台。
建立一個新的RAM使用者或者使用已存在的RAM使用者。
使用阿里雲帳號授予RAM使用者訪問Intelligent Media Management服務的許可權。
為RAM使用者建立AccessKey ID和AccessKey Secret。具體操作,請參見擷取AccessKey。
從STS擷取的臨時訪問憑證。擷取步驟如下:
通過STS服務產生一個臨時的AccessKey ID、AccessKey Secret和SecurityToken。具體操作,請參見AssumeRole。
使用擷取的臨時密鑰操作Intelligent Media Management服務。
初始化對接
使用Intelligent Media Management的SDK時,必須首先構造一個Client,通過調用該Client的介面來訪問Intelligent Media Management服務。
如下以使用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)