SDK for Python 使用指南

最近更新时间:2018-03-20 17:28:55

安装Python SDK

添加模板

更新模板

删除模板

查询模板列表

查询模板详情

创建任务

置顶任务

删除任务

查询任务列表

查询任务详情

查询任务META信息

安装Python SDK

1.git 安装

git clone https://github.com/KscSDK/ksc-sdk-python.git
cd ksc-sdk-python
python setup.py install

2.pip 安装

pip install ksc-sdk-python

3.通过文件配置及管理密钥

  • 所在位置: '/etc/kscore.cfg' 或 './.kscore.cfg'
  • 注意: 使用相对路径时,需与运行目录保持一致
  • ks_access_key_id和ks_secret_access_key是金山云控制台身份与管理里面生成密钥对
[Credentials]
ks_access_key_id=xxxxxxxxxxxxxxxxxxxx
ks_secret_access_key=xxxxxxxxxxxxxxxxxxxx

4.创建一个session (初始化)

from kscore.kvs import getKvsClient

第一种:
client = getKvsClient("kvs", "cn-beijing-6",use_ssl=False)
参数说明:
    service_name:   服务名,填写"kvs"
    region_name:    区域名,填写"cn-beijing-6"
    use_ssl:        是否https访问,填写False

第二种:
没有配置kscore.cfg调用方式
ks_access_key_id='xxxxxxxxxxxxxxxxxxxx'
ks_secret_access_key='xxxxxxxxxxxxxxxxxxxx'
参数:服务service_name,大区region_name 
client = getKvsClient("kvs", "cn-beijing-6",use_ssl=False,ks_access_key_id=ks_access_key_id,ks_secret_access_key=ks_secret_access_key)

6.运行环境

适用于2.6、2.7、3.3、3.4的Python版本

注:接口的传递的参数及返回值请参考《视频云离线转码接入文档》API接口说明

创建模板

  • 接口名

Preset

  • 调用方式
param = {
    "Preset": "xxxx",
    "Description": "xxxx",
    "PresetType": "xxxx",
    "Param":{
        "f": "xxx", 
        "AUDIO": {
            "ab": xxx,
            "ar": xxx,
            "acodec": "xxxx",
            "an": xxx
        },
        "VIDEO": {
            "vr": xxx,
            "vb": "xxxx",
            "vcodec": "xxxx",
            "width": xxx,
            "height": xxx,
            "as": xxx,
            "rotate": "xxxx",
            "vn": xxx
        }
    }
}
注:
1.param必须是json格式数据
res = client.Preset(param)  

更新模板

  • 接口名

UpdatePreset

  • 调用方式
param = {
    "Preset": "xxxx",
    "Description": "xxxx",
    "PresetType": "xxxx",
    "Param":{
        "f": "xxx", 
        "AUDIO": {
            "ab": xxx,
            "ar": xxx,
            "acodec": "xxxx",
            "an": xxx
        },
        "VIDEO": {
            "vr": xxx,
            "vb": "xxxx",
            "vcodec": "xxxx",
            "width": xxx,
            "height": xxx,
            "as": xxx,
            "rotate": "xxxx",
            "vn": xxx
        }
    }
}
注:
1.param必须是json格式数据
res = client.UpdatePreset(param)

查询模板列表

  • 接口名

GetPresetList

  • 调用方式
res = client.GetPresetList(WithDetail=0,PresetType="xxx",Presets="xxx")

查询模板详情

  • 接口名

GetPresetDetail

  • 调用方式
res = client.GetPresetDetail(Preset="xxx")

删除模板

  • 接口名

DelPreset

  • 调用方式
res = client.DelPreset(Preset="xxx")

创建任务

  • 接口名

CreateTask

  • 调用方式
task = {
    "DstDir": "",
    "DstObjectKey": "xxx",
    "DstBucket": "xxx",
    "DstAcl": "public-read",
    "Preset": "xxx",
    "SrcInfo": [
        {
            "path": "xxx",
            "type": "video",
            "index": 0
        }
    ],
    "CbMethod": "xxx",
    "CbUrl": "xxx"
}
注:
1.task必须是json格式数据
res = client.CreateTask(task)

置顶任务

  • 接口名

TopTaskByTaskID

  • 调用方式
res = client.TopTaskByTaskID(TaskID = taskid)

删除任务

  • 接口名

DelTaskByTaskID

  • 调用方式
res = client.DelTaskByTaskID(TaskID = taskid)

查询任务列表

  • 接口名

GetTaskList

  • 调用方式
res = client.GetTaskList(StartDate=20170100,EndDate=20170112,Marker=0,Limit=50)

查询任务详情

  • 接口名

GetTaskByTaskID

  • 调用方式
res = client.GetTaskByTaskID(TaskID = taskid)

查询任务META列表

  • 接口名

GetTaskMetaInfo

  • 调用方式
res = client.GetTaskMetaInfo(StartDate=20170100,EndDate=20170112,Marker=0,Limit=50)

金山云,开启您的云计算之旅

免费注册