全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：UpdateMedia - 更新媒體基本資料

    文件中心

    ApsaraVideo Media Processing：UpdateMedia - 更新媒體基本資料

    更新時間：Feb 25, 2026

    更新媒體基本資料。

    介面說明

    本介面更新的媒體基本資料包括標題、描述、類目等。注意是全量更新，每個屬性都要設定，未設定的會被空值覆蓋。

    QPS 限制

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mts:UpdateMedia

    update

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    MediaId

    string

    是

    需要更新基本資料的媒體 ID。可以通過 MPS 控制台 > 媒體管理 > 媒體列表擷取。

    3e1cd21131a94525be55acf65888****
    Title

    string

    否

    媒體標題。支援中英文、數字等。

    • 若不設定則清空此欄位。

    • UTF8 編碼，最大 128 位元組。

    hello
    Description

    string

    否

    媒體描述。支援中英文、數字等。

    • 若不設定則清空此欄位。

    • UTF8 編碼，最大 1024 位元組。

    example description
    CoverURL

    string

    否

    封面 URL。即您需要設定的封面的儲存地址，可以通過 MPS 控制台 > 工作流程管理 > 媒體 Bucket或OSS 控制台 > 我的訪問路徑擷取。

    • 不超過 3200 位元組。

    • URL 遵循 RFC 2396（UTF-8 編碼，並進行 URLEncode）。更多資訊，請參見 URLEncode 說明。

    http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg
    CateId

    integer

    否

    類目 ID，整數。

    • 若不設定則清空此欄位。

    • 不能為負數。

    1
    Tags

    string

    否

    標籤列表。

    • 用半形逗號（,）分隔，不超過 16 個標籤。

    • 單個標籤不超過 32 位元組。

    • UTF8 編碼。

    tag1,tag2

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    RequestId

    string

    請求 ID。

    6A88246F-C91F-42BD-BABE-DB0DF993F960
    Media

    object

    媒體資訊。

    CreationTime

    string

    建立時間。

    2016-09-14T08:30:33Z
    CateId

    integer

    類目 ID。

    1
    Height

    string

    媒體檔案高。

    1080
    CensorState

    string

    視頻審核狀態。取值：

    • Initiated：初始（上傳成功審核未完成）。

    • Pass：通過（上傳成功審核已通過）。

    Initiated
    Tags

    object

    Tag

    array

    標籤資訊。

    string

    標籤列表。

    tag1,tag2
    Bitrate

    string

    碼率。

    2659.326
    MediaId

    string

    媒體 ID。

    3e1cd21131a94525be55acf65888****
    File

    object

    原檔案。

    State

    string

    檔案狀態。取值範圍：

    • Normal：正常。

    • Deleted：已刪除。

    Normal
    URL

    string

    輸入檔案的 OSS Bucket。

    http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4
    PublishState

    string

    媒體發布狀態，表示是否對外發布媒體。取值：

    • Initiated：初始。

    • UnPublish：未發布，OSS 播放檔案許可權為 Private。

    • Published：發行，OSS 播放檔案許可權為 Default。

    • Deleted：已刪除。

    Published
    Description

    string

    媒體檔案描述。

    example description
    Width

    string

    媒體檔案寬。

    1920
    Size

    string

    媒體檔案大小。

    2647692
    CoverURL

    string

    封面 URL。

    http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg
    RunIdList

    object

    RunId

    array

    媒體工作流程執行執行個體 ID 列表。

    string

    媒體工作流程執行執行個體 ID 列表。

    {"RunId":["47b42486019c4f688bf144c1a6ba****"]}
    Duration

    string

    時間長度。

    7.965000
    Fps

    string

    幀率。

    25.0
    Title

    string

    標題。

    hello
    Format

    string

    格式。支援 mov，mp4，m4a，3gp，3g2，mj2。

    mov

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "6A88246F-C91F-42BD-BABE-DB0DF993F960",
  "Media": {
    "CreationTime": "2016-09-14T08:30:33Z",
    "CateId": 1,
    "Height": "1080",
    "CensorState": "Initiated",
    "Tags": {
      "Tag": [
        "tag1,tag2"
      ]
    },
    "Bitrate": "2659.326",
    "MediaId": "3e1cd21131a94525be55acf65888****",
    "File": {
      "State": "Normal",
      "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "PublishState": "Published",
    "Description": "example description",
    "Width": "1920",
    "Size": "2647692",
    "CoverURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg",
    "RunIdList": {
      "RunId": [
        "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}"
      ]
    },
    "Duration": "7.965000",
    "Fps": "25.0",
    "Title": "hello",
    "Format": "mov"
  }
}

    錯誤碼

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

    變更歷史

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