すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:QueryAnalysisJobList

    ドキュメントセンター

    ApsaraVideo Media Processing:QueryAnalysisJobList

    最終更新日:Feb 25, 2026

    テンプレート分析ジョブを照会し、テンプレート分析ジョブが完了したときに利用可能なプリセットテンプレートのリストを返します。

    操作説明

    ジョブが作成された時刻。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    mts:QueryAnalysisJobList

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    AnalysisJobIds

    string

    必須

    テンプレート分析ジョブ ID のリスト。

    bb558c1cc25b45309aab5be44d19****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    ジョブのステータス。有効な値：

    • Submitted：ジョブは送信済みです。

    • Analyzing：ジョブは実行中です。

    • Success：ジョブは成功しました。

    • Fail：ジョブは失敗しました。

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

    object

    AnalysisJob

    array<object>

    テンプレート分析ジョブの ID。

    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：デインターレースは強制的に実行されました。

    • None：デインターレースは強制的に実行されませんでした。

    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

    ジョブが送信された ApsaraVideo Media Processing (MPS) キューにおけるジョブの優先度。

    • 有効な値：1～10。値 10 は最も高い優先度を示します。

    • デフォルト値：10。

    8
    MNSMessageResult

    object

    ジョブ結果をユーザーに通知するために Message Service (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

    合計ビットレートの上限。単位：Kbit/s。

    1500
    Min

    string

    合計ビットレートの下限。単位：Kbit/s。

    800
    PixFmt

    string

    ビデオのピクセルフォーマット。有効な値：yuv420p や yuvj420p などの標準ピクセルフォーマット。

    yuv420p
    Codec

    string

    コーデック。有効な値：H.264 および H.265。デフォルト値：H.264。

    H.264
    Height

    string

    ビデオの高さ。

    • 単位：ピクセル。

    • デフォルト値：入力ビデオの高さ。

    720
    Qscale

    string

    ビデオの品質管理レベル。

    15
    Bitrate

    string

    ビデオの平均ビットレート。単位：Kbit/s。

    1000
    Maxrate

    string

    ビデオの最大ビットレート。

    • 有効な値：10～50000。

    • 単位：Kbit/s。

    2000
    Profile

    string

    コーデックプロファイル。有効な値：

    • baseline：モバイルデバイスに適用されます。

    • main：標準解像度デバイスに適用されます。

    • high：高解像度デバイスに適用されます。

    • デフォルト値：high。

    high
    Crf

    string

    固定レート係数。

    • Codec パラメーターが H.264 に設定されている場合のデフォルト値：23、Codec パラメーターが H.265 に設定されている場合のデフォルト値：26。

    • このパラメーターが指定されている場合、Bitrate パラメーターの値は無効になります。

    26
    Gop

    string

    2 つのキーフレーム間の最大フレーム数。デフォルト値：250。

    250
    Width

    string

    ビデオの幅。

    • 単位：ピクセル。

    • デフォルト値：入力ビデオの幅。

    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 フォーマットの 2 つの連続するループ間の間隔。単位：0.01 秒。たとえば、値 500 は 5 秒を示します。

    0
    Loop

    string

    GIF または WebP フォーマットのループ数。デフォルト値：0。

    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。

    • 単位：Kbit/s。

    • デフォルト値：128。

    128
    Id

    string

    トランスコーディングテンプレート ID。

    S00000000-00****
    Container

    object

    コンテナフォーマット構成。

    Format

    string

    コンテナフォーマット。

    flv
    UserData

    string

    カスタムデータ。

    testid-001
    Code

    string

    ジョブが失敗した場合に返されるエラーコード。

    InvalidParameter.ResourceNotFound
    InputFile

    object

    ジョブ入力に関する情報。

    Object

    string

    入力ファイルとして使用される Object Storage Service (OSS) オブジェクトの名前。

    example.flv
    Location

    string

    OSS が存在するリージョン。

    oss-cn-hangzhou
    Bucket

    string

    入力ファイルが保存されている OSS バケットの名前。

    example-bucket
    PipelineId

    string

    ジョブが送信された MPS キューの ID。

    bb558c1cc25b45309aab5be44d19****
    Id

    string

    テンプレート分析ジョブの ID。

    57f6aa3f84824309bcba67231b406****
    NonExistAnalysisJobIds

    object

    String

    array

    ジョブ結果をユーザーに通知するために Message Service (MNS) によって送信されたメッセージ。

    string

    実行する操作。値を QueryAnalysisJobList に設定します。

    null

    例

    成功レスポンス

    JSONJSON

    {
  "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"
    ]
  }
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。