异步处理队列接口

最近更新时间:2024-07-04 11:13:03

我的收藏

简介

本文档提供关于文档预览队列接口的 API 概览以及 SDK 示例代码。
API
说明
更新文档预览队列信息
查询文档预览队列信息

更新文档预览队列

功能说明

用于更新文档预览队列。

请求示例

function updateDocProcessQueue() {
var config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */
Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */
};
// queueId 可通过查询文档预览队列获得
var queueId = 'p58639252a2cf45aba7a7f3335ffe3xxx'; // 替换成自己的队列id
var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com/docqueue/' + queueId;
var url = 'https://' + host;
var body = COS.util.json2xml({
Request: {
Name: 'queue-doc-process-1', // 替换成自己的队列name
QueueID: queueId,
State: 'Active',
NotifyConfig: {
State: 'Off',
}
}
});
cos.request({
Method: 'PUT',
Key: 'docqueue/' + queueId,
Url: url,
Body: body,
ContentType: 'application/xml',
},
function(err, data){
console.log(err || data);
});
}
updateDocProcessQueue();

参数说明

参数名称
描述
类型
Name
队列名称
String
QueueID
任务所在的队列 ID,开通预览服务后自动生成,请使用查询队列获取或前往万象控制台在存储桶中查询
String
State
队列状态
String
NotifyConfig
通知渠道,详情请参见 DocProcessQueue.NotifyConfig
Container
- Url
回调配置
String
- Type
回调类型,普通回调:Url
String
- Event
回调事件,文档预览任务完成
String
- State
回调开关,Off,On
Container

返回结果说明

详情请参见 更新文档转码队列

查询文档预览队列

功能说明

用于查询文档预览队列。

示例代码

function describeDocProcessQueues() {
var config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */
Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */
};
var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com/docqueue';
var url = 'https://' + host;
cos.request({
Method: 'GET',
Key: 'docqueue',
Url: url,
Query: {
// queueIds: '', /* 非必须,队列 ID,以“,”符号分割字符串 */
// state: '', /* 非必须,1=Active,2=Paused */
// pageNumber: 1, /* 非必须,第几页 */
// pageSize: 2, /* 非必须,每页个数 */
},
},
function(err, data){
console.log(err || data);
});
}
describeDocProcessQueues();

参数说明

名称
描述
类型
是否必选
queueIds
队列 ID,以“,”符号分割字符串,开通预览服务后自动生成,请使用查询队列获取或前往万象控制台在存储桶中查询
string
state
1. Active 表示队列内的作业会被文档预览服务调度执行
2. Paused 表示队列暂停,作业不再会被文档预览服务调度执行,队列内的所有作业状态维持在暂停状态,已经处于执行中的任务将继续执行,不受影响
string
pageNumber
第几页,默认第一页
string
pageSize
每页个数,默认10个
string

返回结果说明

详情请参见 查询文档转码队列