控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

更新语音识别队列

最近更新时间:2020-08-25 18:05:16

功能描述

UpdateSpeechQueue 接口用于更新语音识别队列。

请求

请求示例

PUT /asrqueue/p8eb46b8cc1a94bc09512d16c5c4f4d3a HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml

<body>

说明:

  • 此接口 Host 需要填写数据万象域名。
  • Authorization: Auth String(详情请参见 请求签名 文档)。

请求头

此接口仅使用公共请求头部,详情请参见数据万象 公共请求头部 文档。

请求体

该请求操作的实现需要有以下请求体。

<Request>
    <Name>Queue Name</Name>
    <QueueID></QueueID>
    <State></State>
    <NotifyConfig>
        <Type></Type>
        <Url></Url>
        <Event></Event>
    </NotifyConfig>
</Request>

具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 是否必选
Request 保存请求的容器 Container

Container 类型 Request 的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 是否必选 限制
Name Request 模板名称 String 长度限制100字符
QueueID Request 管道 ID String -
State Request 管道状态 String 1. Active 表示管道内的作业会被语音识别服务调度执行
2. Paused 表示管道暂停,作业不再会被语音识别服务调度执行,管道内的所有作业状态维持在已提交状态,已经处于识别中的任务将继续执行,不受影响
NotifyConfig Request 通知渠道 Container 第三方回调 Url

Container 类型 NotifyConfig 的具体数据描述如下:

节点名称(关键字) 父节点 描述 类型 是否必选 限制
Url Request.NotifyConfig 回调配置 String 长度限制100字符
Type Request.NotifyConfig 回调类型,普通回调:Url String 长度限制100字符
Event Request.NotifyConfig 回调事件 String 长度限制100字符
State Request.NotifyConfig 回调开关,Off,On String 长度限制100字符

响应

响应头

此接口仅返回公共响应头部,详情请参见数据万象 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:

<Response>
    <RequestId>NTk0MjdmODlfMjQ4OGY3XzYzYzhf****</RequestId>
    <Queue>
        <QueueId></QueueId>
        <Name></Name>
        <State>Active</State>
        <NotifyConfig>
            <Url>mts-topic-1</Url>
            <Type></Type>
            <Event></Event>
        </NotifyConfig>
        <CreateTime></CreateTime>
        <UpdateTime></UpdateTime>
    </Queue>
</Response>

具体的数据内容如下:

节点名称(关键字) 父节点 描述 类型
Response 保存结果的容器 Container

Container 节点 Response 的内容:

节点名称(关键字) 父节点 描述 类型
RequestId Response 请求的唯一 ID String
Queue Response 队列信息,详情同 DescribeSpeechQueues 接口中的 Response.QueueList 节点 Container

错误码

该请求操作无特殊错误信息,常见的错误信息请参见数据万象 错误码 文档。

实际案例

请求:更新语音识别队列

PUT /asrqueue/pd0a7e02988c24db88b61551cf540444c HTTP/1.1
Connection: keep-alive
Accept-Encoding: gzip, deflate
Accept: */*
User-Agent: cos-python-sdk-v5.3.2
Host: examplebucket-1250000000.ci.ap-chongqing.myqcloud.com
Content-Type: application/xml
Content-Length: 271
Authorization: q-sign-algorithm=sha1&q-ak=AKIDnOr9IDiIUNYWGrrWb2IJ4YmywDXc****&q-sign-time=1597917374;1597927434&q-key-time=1597917374;1597927434&q-header-list=content-type;host&q-url-param-list=&q-signature=670ce7355f265cb0792c00e490a205975856****

<?xml version="1.0" encoding="utf-8"?>

<Request>
  <QueueId>p5275b560c7fd498db9a36e5e202827b6</QueueId>
  <State>Active</State>
  <Name>test</Name>
  <NotifyConfig>
    <Url>http://example.com/</Url>
    <State>On</State>
    <Type>Url</Type>
    <Event>TransCodingFinish</Event>
  </NotifyConfig>
</Request>

响应

HTTP/1.1 200 OK
Date: Thu, 20 Aug 2020 09:53:02 GMT
Content-Type: application/xml
Content-Length: 674
Connection: keep-alive
Server: tencent-ci
x-ci-request-id: NWYzZTQ3ZmRfOTBmYTUwNjRfMjJh****

<Response>
        <RequestId>NWYzZTQ5NTdfZWM0YTYyNjRfNWE4ZF9l****</RequestId>
        <Queue>
                <QueueId>p5275b560c7fd498db9a36e5e202827b6</QueueId>
                <Name>test</Name>
                <State>Active</State>
                <NotifyConfig>
                        <Url>http://example.com/</Url>
                        <Event>TransCodingFinish</Event>
                        <Type>Url</Type>
                        <State>On</State>
                </NotifyConfig>
                <MaxSize>10000</MaxSize>
                <MaxConcurrent>10</MaxConcurrent>
                <CreateTime>2020-06-29T16:55:04+0800</CreateTime>
                <UpdateTime>2020-08-20T17:58:47+0800</UpdateTime>
                <BucketId>examplebucket-1250000000</BucketId>
                <Category>Speeching</Category>
        </Queue>
</Response>

目录