有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

简介

本文档提供关于媒体 bucket 接口的 API 概览和 SDK 示例代码。
注意:
COS Javascript SDK 版本需要大于等于 v1.3.1。
API
操作名
操作描述
查询媒体处理开通情况
用于查询已经开通媒体处理功能的存储桶

查询媒体处理开通情况

功能说明

用于查询已经开通媒体处理功能的存储桶。

使用示例

function describeMediaBuckets() {
const config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', // 存储桶,必须
Region: 'COS_REGION', // 存储桶所在地域,必须字段
};
const host = 'ci.' + config.Region + '.myqcloud.com';
const url = 'https://' + host + '/mediabucket';
cos.request({
Method: 'GET',
Key: 'mediabucket', // 固定值,必须
Url: url,
Query: {
pageNumber: '1', // 第几页,非必须
pageSize: '10', // 每页个数,非必须
// regions: 'ap-chengdu', // 地域信息,例如'ap-beijing',支持多个值用逗号分隔如'ap-shanghai,ap-beijing',非必须
// bucketNames: 'test-1250000000', // 存储桶名称,精确搜索,例如'test-1250000000',支持多个值用逗号分隔如'test1-1250000000,test2-1250000000',非必须
// bucketName: 'test', // 存储桶名称前缀,前缀搜索,例如'test',支持多个值用逗号分隔如'test1,test2',非必须
}
}, function (err, data) {
if (err) {
// 处理请求失败
console.log(err);
} else {
// 处理请求成功
console.log(data.Response);
}
});
}

参数说明

cos.request 方法参数说明:
参数名称
参数描述
类型
是否必填
Method
固定值:GET
String
Url
请求 url,固定值
String
Key
固定值: mediabucket
String
Query
请求参数
Object
Query 参数说明:
参数名称
参数描述
类型
是否必填
pageNumber
第几页
String
pageSize
每页个数
String
regions
地域信息,例如 ap-shanghai、ap-beijing,若查询多个地域以“,”分隔字符串,支持中国大陆地域,详情请参见 地域与域名
String
bucketNames
存储桶名称,以“,”分隔,支持多个存储桶,精确搜索
String
bucketName
存储桶名称前缀,前缀搜索
String

回调函数说明

function(err, data) { ... }
参数名
参数描述
类型
err
请求发生错误时返回的对象,包括网络错误和业务错误。如果请求成功则为空,更多详情请参见 错误码
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
data
请求成功时返回的对象,如果请求发生错误,则为空
Object
- statusCode
请求返回的 HTTP 状态码,例如 200、403、404 等
Number
- headers
请求返回的头部信息
Object
- Response
响应结果 详情请参见 查询媒体处理服务
Object

相关链接