全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：QueryAnalysisJobList - 查詢範本分析作業

    文件中心

    ApsaraVideo Media Processing：QueryAnalysisJobList - 查詢範本分析作業

    更新時間：Feb 25, 2026

    查詢範本分析作業，模板分析作業完成後，返回可用的預置模板列表。

    介面說明

    本介面一次最多可查詢 10 個模板分析作業。

    QPS 限制

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mts:QueryAnalysisJobList

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AnalysisJobIds

    string

    是

    模板分析作業 ID 列表。

    • 一次最多查詢 10 個。

    • 多個使用半形逗號（,）作為分隔字元。

    bb558c1cc25b45309aab5be44d19****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    5CA6E020-4102-4FFF-AA56-5ED7ECD811A1
    AnalysisJobList

    object

    AnalysisJob

    array<object>

    模板分析作業列表。

    array<object>

    CreationTime

    string

    作業添加時間。

    2014-01-10T12:00:00Z
    Percent

    integer

    轉碼進度。

    86
    State

    string

    作業狀態。

    • Submitted：已提交。

    • Analyzing：分析中。

    • Success：成功。

    • Fail：失敗。

    Success
    AnalysisConfig

    object

    作業配置。

    QualityControl

    object

    輸出品質控制。

    MethodStreaming

    string

    播放方式。

    • network：線上。

    • local：本地。

    • 預設值：network。

    network
    RateQuality

    string

    輸出品質等級。預設值：25。

    25
    PropertiesControl

    object

    屬性控制。

    Deinterlace

    string

    強制掃描模式判定。

    • Auto：自動。

    • Force：強製做 deinterlace。

    • None：強制不做 deinterlace。

    Auto
    Crop

    object

    視頻裁切配置。

    Top

    string

    裁切上邊距。

    說明

    如果 Mode 為 Auto 或 None，則此值失效。

    8
    Width

    string

    裁切後寬。

    說明

    如果 Mode 為 Auto 或 None，則此值失效。

    8
    Height

    string

    裁切後高。

    說明

    如果 Mode 為 Auto 或 None，則此值失效。

    8
    Left

    string

    裁切左邊距。

    說明

    如果 Mode 為 Auto 或 None，則此值失效。

    8
    Mode

    string

    裁切方式。取值：

    • Auto：自動。

    • Force：強制。

    • None：強制不做。

    • 如 Crop 不是空 JSON{}，則此值必填。

    Auto
    Message

    string

    分析失敗時錯誤資訊。

    The resource operated \"PipelineId\" cannot be found
    Priority

    string

    任務在其對應管道內的優先順序。

    • 取值範圍：[1,10]。10 為最高優先順序。

    • 預設值：10。

    8
    MNSMessageResult

    object

    MNS 通知使用者作業完成的結果。

    MessageId

    string

    成功時訊息 ID。分析失敗時不返回此參數。

    3ca84a39a9024f19853b21be9cf9****
    ErrorMessage

    string

    失敗時錯誤資訊。分析成功時不返回此參數。

    The resource operated \"PipelineId\" cannot be found
    ErrorCode

    string

    失敗時錯誤碼。分析成功時不返回此參數。

    InvalidParameter.ResourceNotFound
    TemplateList

    object

    Template

    array<object>

    作業輸出的預置模板列表。

    array<object>

    Video

    object

    視頻編解碼配置。

    Bufsize

    string

    緩衝區大小。

    • 單位：Kb。

    • 預設值：6000。

    6000
    Degrain

    string

    獨立去噪演算法強度。

    5
    BitrateBnd

    object

    視頻平均碼率範圍。

    Max

    string

    總碼率上限。單位：Kbps。

    1500
    Min

    string

    總碼率下限。單位：Kbps。

    800
    PixFmt

    string

    視頻顏色格式。包含 yuv420p，yuvj420p 等標準顏色格式。

    yuv420p
    Codec

    string

    編解碼格式。支援 H.264、H.265。 預設值：H.264。

    H.264
    Height

    string

    視頻高。

    • 單位：px。

    • 預設值：視頻原始高度。

    720
    Qscale

    string

    視頻品質控制度。

    15
    Bitrate

    string

    視頻平均碼率。單位：Kbps。

    1000
    Maxrate

    string

    視頻碼率峰值。

    • 取值範圍：[10,50000]。

    • 單位：Kbps。

    2000
    Profile

    string

    編碼層級。

    • baseline：針對行動裝置。

    • main：針對標準解析度裝置。

    • high：針對高解析度裝置。

    • 預設值：high。

    high
    Crf

    string

    碼率-品質控制因子。

    • 預設值：編碼格式為 H264，預設值為 23。編碼格式為 H265，預設值為 26。

    • 如果設定了 Crf，則 Bitrate 的設定失效。

    26
    Gop

    string

    主要畫面格間最大幀數。預設值：250。

    250
    Width

    string

    視頻寬。

    • 單位：px。

    • 預設值：視頻原始寬度。

    1280
    Fps

    string

    幀率。

    • 當輸入檔案幀率超過 60 時取 60。

    • 預設值：取輸入檔案幀率。

    25
    Preset

    string

    視頻演算法器預置。支援 veryfast（超快）、fast（快）、medium（中等）、slow（慢）、slower（超慢）。 預設值：medium。

    medium
    ScanMode

    string

    掃描模式。取值：

    • interlaced：交叉掃描。

    • progressive：順序掃描。

    interlaced
    TransConfig

    object

    轉碼通用配置。

    TransMode

    string

    轉碼模式。預設值：onepass。可選範圍：

    • onepass

    • twopass

    • CBR

    onepass
    State

    string

    模板的狀態。

    • Normal：正常。

    • Deleted：已刪除。

    Normal
    MuxConfig

    object

    轉碼封包配置。

    Gif

    object

    gif 格式。

    FinalDelay

    string

    gif 的 loop 間隔，單位為百分之一秒，比如 500 代表間隔為 5 秒。

    0
    Loop

    string

    gif 與 webp 迴圈次數，預設不迴圈。

    0
    Segment

    object

    切片配置。

    Duration

    string

    分區時間長度。單位：秒。

    10
    Name

    string

    模板名稱。

    FLV-UD
    Audio

    object

    音頻編解碼配置。

    Profile

    string

    音頻編碼預置。當 Codec 為 aac 時可取值：

    • aac_low

    • aac_he

    • aac_he_v2

    • aac_ld

    • aac_eld

    aac_low
    Codec

    string

    音頻編解碼格式。預設值：aac。可取值：

    • aac

    • mp3

    • vorbis

    • flac

    aac
    Samplerate

    string

    採樣率。

    • 單位：Hz。

    • 預設值：44100。

    44100
    Qscale

    string

    音頻品質控制度。

    15
    Channels

    string

    聲道數。預設值：2。

    2
    Bitrate

    string

    輸出檔案的音頻碼率。

    • 取值範圍：8~1000。

    • 單位：Kbps。

    • 預設值：128。

    128
    Id

    string

    轉碼模板 ID。

    S00000000-00****
    Container

    object

    容器。

    Format

    string

    容器格式。

    flv
    UserData

    string

    使用者自訂資料。

    testid-001
    Code

    string

    分析失敗時錯誤碼。

    InvalidParameter.ResourceNotFound
    InputFile

    object

    作業輸入。

    Object

    string

    OSS 的 Object。

    example.flv
    Location

    string

    OSS 的服務地區。

    oss-cn-hangzhou
    Bucket

    string

    輸入檔案的 OSS Bucket。

    example-bucket
    PipelineId

    string

    管道 ID。

    bb558c1cc25b45309aab5be44d19****
    Id

    string

    模板分析作業 ID。

    57f6aa3f84824309bcba67231b406****
    NonExistAnalysisJobIds

    object

    String

    array

    不存在的模板分析作業。

    string

    不存在的模板分析作業 ID 列表，無資料時該結構不返回。

    null

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "5CA6E020-4102-4FFF-AA56-5ED7ECD811A1",
  "AnalysisJobList": {
    "AnalysisJob": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 86,
        "State": "Success",
        "AnalysisConfig": {
          "QualityControl": {
            "MethodStreaming": "network",
            "RateQuality": "25"
          },
          "PropertiesControl": {
            "Deinterlace": "Auto",
            "Crop": {
              "Top": "8",
              "Width": "8",
              "Height": "8",
              "Left": "8",
              "Mode": "Auto"
            }
          }
        },
        "Message": "The resource operated \\\"PipelineId\\\" cannot be found",
        "Priority": "8",
        "MNSMessageResult": {
          "MessageId": "3ca84a39a9024f19853b21be9cf9****",
          "ErrorMessage": "The resource operated \\\"PipelineId\\\" cannot be found",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        },
        "TemplateList": {
          "Template": [
            {
              "Video": {
                "Bufsize": "6000",
                "Degrain": "5",
                "BitrateBnd": {
                  "Max": "1500",
                  "Min": "800"
                },
                "PixFmt": "yuv420p",
                "Codec": "H.264",
                "Height": "720",
                "Qscale": "15",
                "Bitrate": "1000",
                "Maxrate": "2000",
                "Profile": "high",
                "Crf": "26",
                "Gop": "250",
                "Width": "1280",
                "Fps": "25",
                "Preset": "medium",
                "ScanMode": "interlaced"
              },
              "TransConfig": {
                "TransMode": "onepass"
              },
              "State": "Normal",
              "MuxConfig": {
                "Gif": {
                  "FinalDelay": "0",
                  "Loop": "0"
                },
                "Segment": {
                  "Duration": "10"
                }
              },
              "Name": "FLV-UD",
              "Audio": {
                "Profile": "aac_low",
                "Codec": "aac",
                "Samplerate": "44100",
                "Qscale": "15",
                "Channels": "2",
                "Bitrate": "128"
              },
              "Id": "S00000000-00****",
              "Container": {
                "Format": "flv"
              }
            }
          ]
        },
        "UserData": "testid-001",
        "Code": "InvalidParameter.ResourceNotFound",
        "InputFile": {
          "Object": "example.flv",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "PipelineId": "bb558c1cc25b45309aab5be44d19****",
        "Id": "57f6aa3f84824309bcba67231b406****"
      }
    ]
  },
  "NonExistAnalysisJobIds": {
    "String": [
      "null"
    ]
  }
}

    錯誤碼

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

    變更歷史

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