全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：UpdatePipeline - 更新管道：名稱、狀態及通知設定

    文件中心

    ApsaraVideo Media Processing：UpdatePipeline - 更新管道：名稱、狀態及通知設定

    更新時間：Feb 25, 2026

    更新管道。

    介面說明

    • 本介面可以修改指定管道的名稱、狀態及通知設定。

    • 暫停管道後，如果工作流程或其他單任務（如視頻審核、視頻 DNA 等）中選擇使用狀態為已暫停管道，會導致任務失敗無法進行。

    QPS 限制

    本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mts:UpdatePipeline

    update

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    PipelineId

    string

    是

    需要更新的管道 ID。可以通過 MPS 控制台 > 全域設定 > 管道擷取。

    d1ce4d3efcb549419193f50f1fcd****
    Name

    string

    是

    修改後的管道名稱。支援中英文、數字、中劃線（-）等，不能以特殊字元開頭，最大長度 128 位元組。

    example-pipeline-****
    State

    string

    是

    修改後的管道狀態。

    • Active：管道開啟。管道內的作業會被媒體轉碼服務調度轉碼執行。

    • Paused：管道暫停。管道內的作業不再會被媒體轉碼調度轉碼執行，並且所有作業狀態維持在已提交狀態。已經處於轉碼中的任務將繼續轉碼，不受影響。

    Paused
    NotifyConfig

    string

    否

    阿里雲輕量訊息佇列（原 MNS） 配置，即 MNS 隊列或主題資訊。更多資訊，請參見 NotifyConfig 詳情。

    {"Topic":"example-topic-****"}
    Role

    string

    否

    當前 RAM 使用者關聯的角色。可以通過 RAM 控制台 > 身份管理 > 角色擷取。

    AliyunMTSDefaultRole
    ExtendConfig

    string

    否

    擴充配置

    {\"IsBoostNew\":true,\"MultiSpeedDowngradePolicy\":\"NormalSpeed\",\"MaxMultiSpeed\":20}

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    RequestId

    string

    請求 ID。

    1FE0F96B-544D-4244-9D83-DFCFB0E5A231
    Pipeline

    object

    管道詳細資料。

    Speed

    string

    管道類型。預設值：Standard（標準管道）。可取值：

    • Boost：倍速轉碼管道。

    • Standard：標準管道。

    • NarrowBandHDV2：窄帶高清 2.0 管道。

    • AIVideoCover：智能截圖管道。

    • AIVideoFPShot：視頻 DNA 管道。

    • AIVideoCensor：智能審核管道。

    • AIVideoMCU：智能標籤管道。

    • AIVideoSummary：視頻摘要管道。

    • AIVideoPorn：視頻鑒黃管道。

    • AIAudioKWS：音頻關鍵字識別管道。

    • AIAudioASR：語音轉文字管道。

    Standard
    State

    string

    管道狀態。取值：

    • Active：管道開啟。

    • Paused：管道暫停。

    Paused
    NotifyConfig

    object

    阿里雲 MNS 通知配置。

    MqTopic

    string

    接收到的訊息佇列。

    example1,example2
    QueueName

    string

    MNS 中建立的隊列。

    example-queue-****
    MqTag

    string

    標籤。

    mts-test
    Topic

    string

    MNS 中建立的主題。

    example-topic-****
    Name

    string

    修改後的管道名稱。

    example-pipeline-****
    Role

    string

    當前 RAM 使用者關聯的角色。

    AliyunMTSExampleRole
    Id

    string

    管道 ID。

    d1ce4d3efcb549419193f50f1fcd****
    QuotaAllocate

    integer

    管道配額分配。

    10

    樣本

    正常返回樣本

    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
  }
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。