取得开通点播实例列表
更新时间 2026-04-09 17:50:54
最近更新时间: 2026-04-09 17:50:54
通过本接口向云点播查询点播实例列表。
接口功能介绍
用户可通过本接口向云点播查询已经创建的点播实例列表。
注意自2025年5月7日零时起,云点播对资源分配方式进行了升级,原【点播区域】更名为【点播实例】。新开通客户将以实例化方式提供媒资存储、媒体处理等服务,不再以资源池方式进行命名和资源划分。接口中regionCode参数将被替换成InstanceID。
接口约束
本接口的单用户QPS限制为20次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
URI
POST xstore-vod/instance
请求体body参数
无
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | String | 本次请求的结果码 | "0" | |
| message | 是 | String | 错误文本信息,创建成功时,为空字符串。 | “” | |
| data | 是 | Array of Objects | 返回数据 | data |
表 data
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| instanceId | 是 | Interger | 实例ID | 454657 | |
| instanceName | 是 | String | 实例的名称 | 主实例 | |
| originBucketAddr | 是 | String | 源视频桶host | vod-origin-c1wx.vod.ctyunxs.cn | |
| transcodeBucketAddr | 是 | String | 转码视频桶host | vod-transcode-c1wx.vod.ctyunxs.cn | |
| coverBucketAddr | 是 | String | 封面截图桶host | vod-cover-c1wx.vod.ctyunxs.cn | |
| isDefault | 是 | Integer | 是否为默认点播实例:1-默认;0-非默认 | 1 | |
| acl | 是 | String | 实例ACL权限:Private-私有;PublicRead-公共读 | Private | |
| status | 是 | String | 实例状态:F0A-有效;F0X-无效 | F0A | |
| isDeleting | 否 | Boolean | 实例是否正在清空中:true-正在清空中;false-已清理完毕或未触发过清空 | false |
请求示例
请求体body
无
响应示例
{
"code": "0",
"data": [
{
"acl": "PublicRead",
"coverBucketAddr": "vod-cover-mmtz.oss.ctyun.cn",
"instanceId": 690764169969,
"instanceName": "主实例",
"isDefault": 0,
"originBucketAddr": "vod-origin-mmtz.oss.ctyun.cn",
"status": "F0A",
"transcodeBucketAddr": "vod-transcode-mmtz.oss.ctyun.cn"
}
],
"message": ""
}
状态码
| Http 状态码 | 状态码信息 | 状态码描述 |
|---|---|---|
| 0 | 表示业务成功 | 表示业务成功 |
| 400 | 请求参数有误 | 请求参数有误 |
| 403 | 用户鉴权失败,用户无操作权限 | 用户鉴权失败,用户无操作权限 |
| 404 | 请求的资源不存在,输入错误的URL | 请求的资源不存在,输入错误的URL |
| 500 | 业务执行异常 | 业务执行异常 |
错误码
OpenAPI错误码请参考 错误码说明。