更新管道。
接口說(shuō)明
- 本接口可以修改指定管道的名稱(chēng)、狀態(tài)及通知設(shè)定。
- 暫停管道后,如果工作流或其他單任務(wù)(如視頻審核、視頻 DNA 等)中選擇使用狀態(tài)為已暫停的管道,會(huì)導(dǎo)致任務(wù)失敗無(wú)法進(jìn)行。
注意 暫停管道后,不會(huì)影響已經(jīng)提交的任務(wù)。如果任務(wù)提交后關(guān)閉管道,已經(jīng)進(jìn)入處理排隊(duì)的任務(wù)將無(wú)法取消,會(huì)正常執(zhí)行并收取相應(yīng)的費(fèi)用。
QPS 限制
本接口的單用戶 QPS 限制為 100 次/秒。超過(guò)限制,API 調(diào)用會(huì)被限流,這可能會(huì)影響您的業(yè)務(wù),請(qǐng)合理調(diào)用。更多信息,請(qǐng)參見(jiàn) QPS 限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語(yǔ)句的Action
元素中使用,用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問(wèn)級(jí)別:是指每個(gè)操作的訪問(wèn)級(jí)別,取值為寫(xiě)入(Write)、讀取(Read)或列出(List)。
- 資源類(lèi)型:是指操作中支持授權(quán)的資源類(lèi)型。具體說(shuō)明如下:
- 對(duì)于必選的資源類(lèi)型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問(wèn)級(jí)別 | 資源類(lèi)型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
mts:UpdatePipeline | update |
|
| 無(wú) |
請(qǐng)求參數(shù)
名稱(chēng) | 類(lèi)型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
PipelineId | string | 是 | 需要更新的管道 ID??梢酝ㄟ^(guò) MPS 控制臺(tái) > 全局設(shè)置 > 管道獲取。 | d1ce4d3efcb549419193f50f1fcd**** |
Name | string | 是 | 修改后的管道名稱(chēng)。支持中英文、數(shù)字、中劃線(-)等,不能以特殊字符開(kāi)頭,最大長(zhǎng)度 128 字節(jié)。 | example-pipeline-**** |
State | string | 是 | 修改后的管道狀態(tài)。
| Paused |
NotifyConfig | string | 否 | 阿里云輕量消息隊(duì)列(原 MNS) 配置,即 MNS 隊(duì)列或主題信息。更多信息,請(qǐng)參見(jiàn) NotifyConfig 詳情。 | {"Topic":"example-topic-****"} |
Role | string | 否 | 當(dāng)前 RAM 用戶關(guān)聯(lián)的角色??梢酝ㄟ^(guò) RAM 控制臺(tái) > 身份管理 > 角色獲取。 | AliyunMTSDefaultRole |
ExtendConfig | string | 否 | 擴(kuò)展配置 | {\"IsBoostNew\":true,\"MultiSpeedDowngradePolicy\":\"NormalSpeed\",\"MaxMultiSpeed\":20} |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "1FE0F96B-544D-4244-9D83-DFCFB0E5A231",
"Pipeline": {
"Speed": "Standard",
"State": "Paused",
"NotifyConfig": {
"MqTopic": "example1,example2",
"QueueName": "example-queue-****",
"MqTag": "mts-test",
"Topic": "example-topic-****"
},
"Name": "example-pipeline-****",
"Role": "AliyunMTSExampleRole",
"Id": "d1ce4d3efcb549419193f50f1fcd****",
"QuotaAllocate": 10
}
}
錯(cuò)誤碼
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2023-06-13 | OpenAPI 返回結(jié)構(gòu)發(fā)生變更 | 查看變更詳情 |