すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:GetJobDetail

    ドキュメントセンター

    ApsaraVideo VOD:GetJobDetail

    最終更新日:Apr 07, 2026

    この API を呼び出して、jobId に基づいて非同期タスクの詳細を取得します。

    操作説明

    この API は、過去 6 か月以内に作成された非同期タスクに関するデータを取得します。サポートされているタスクタイプには、トランスコードタスク、スクリーンショットタスク、AI タスク、ワークフロータスクが含まれます。

    QPS 制限

    この API の単一ユーザーの QPS 制限は、毎秒 15 呼び出しです。この制限を超えると、後続の API 呼び出しがスロットルされ、ビジネスに影響を与える可能性があります。適切なレートで API を呼び出してください。詳細については、「QPS 制限」をご参照ください。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:GetJobDetail

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    JobId

    string

    必須

    ジョブ ID。タスク ID でトランスコードタスクをクエリするには、「GetTranscodeTask」をご参照ください。

    5c9dff***************59d50a967f5
    JobType

    string

    必須

    ジョブタイプ。有効な値は次のとおりです：

    • transcode

    • snapshot

    • ai

    • workflow

    transcode

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ。

    RequestId

    string

    リクエスト ID。

    6708D849-F109-1A6C-AC91-************
    JobType

    string

    ジョブタイプ。

    transcode
    TranscodeJobDetail

    object

    トランスコードジョブの詳細。このパラメーターは、JobType が transcode の場合にのみ返されます。

    JobId

    string

    ジョブ ID。

    2dc1634e**********3f1d22d1a0174e
    UserId

    integer

    ジョブを開始したユーザーの ID。

    139109*****84930
    VideoId

    string

    メディアアセット ID。

    30e5d7**********bd900764de7c0102
    Status

    string

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

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

    • Transcoding：ジョブは進行中です。

    • TranscodeSuccess：ジョブは正常に完了しました。

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

    • TranscodeCancelled：ジョブはキャンセルされました。

    TranscodeSuccess
    TemplateId

    string

    テンプレート ID。

    dbfaaec9e**********bf0b81219244c
    Definition

    string

    解像度。

    HD
    CreateTime

    string

    ジョブが作成された時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2024-10-14T07:39:25Z
    CompleteTime

    string

    ジョブが完了した時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2024-10-14T07:39:34Z
    SnapshotJobDetail

    object

    スナップショットジョブの詳細。このパラメーターは、JobType が snapshot の場合にのみ返されます。

    JobId

    string

    ジョブ ID。

    63df12s0**********4hdq249t82kr91
    UserId

    integer

    ジョブを開始したユーザーの ID。

    139109*****84930
    VideoId

    string

    メディアアセット ID。

    30e5d7**********bd900764de7c0102
    Status

    string

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

    • Processing：ジョブは進行中です。

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

    • Success：ジョブは正常に完了しました。

    Success
    Trigger

    string

    トリガー。有効な値：

    • Auto：ジョブはワークフローによって自動的にトリガーされました。

    • Manual：ジョブは手動で送信されました。

    Auto
    NormalConfig

    string

    一般スナップショットの構成。

    {"inl":0,"num":32,"tm":5,"wd":"352","ft":"normal","hg":"640"}
    SpriteConfig

    string

    スプライトの構成。

    {"pad":"0","lines":"10","mgin":"0","cols":"10","ikcp":"false","hg":"68"}
    CreateTime

    string

    ジョブが作成された時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2024-10-14T07:39:25Z
    CompleteTime

    string

    ジョブが完了した時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2024-10-14T07:39:45Z
    AIJobDetail

    object

    AI ジョブの詳細。このパラメーターは、JobType が ai の場合にのみ返されます。

    JobId

    string

    ジョブ ID。

    5c9dff751ba**********59d50a967f5
    UserId

    integer

    ジョブを開始したユーザーの ID。

    139109*****84930

    MediaId

    string

    メディアアセット ID。

    30e5d7**********bd900764de7c0102
    JobType

    string

    AI ジョブのタイプ。

    AIVideoCensor
    Status

    string

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

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

    • init：ジョブは開始されました。

    • success：ジョブは正常に完了しました。

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

    • processing：ジョブは進行中です。

    • analyzing：ジョブは分析中です。

    success
    Trigger

    string

    トリガー。有効な値：

    • Auto：ジョブはワークフローによって自動的にトリガーされました。

    • Manual：ジョブは手動で送信されました。

    Auto
    TemplateConfig

    string

    テンプレート構成。

    {"AuditRange":["video","image-cover","text-title"],"AuditContent":["screen"],"AuditItem":["terrorism","porn"],"AuditAutoBlock":"no"}
    CreateTime

    string

    ジョブが作成された時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2024-10-14T07:39:25Z
    CompleteTime

    string

    ジョブが完了した時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2024-10-14T07:39:46Z

    WorkflowTaskDetail

    object

    ワークフロータスクの詳細。このパラメーターは、JobType が workflow の場合にのみ返されます。

    TaskId

    string

    タスク ID。

    46ecc024******92c8e26237e51
    Status

    string

    タスクステータス。有効な値：

    • Init：タスクは開始されました。

    • Processing：タスクは進行中です。

    • Succeed：タスクは成功しました。

    • Failed：タスクは失敗しました。

    • Canceled：タスクはキャンセルされました。

    • Skip：タスクはスキップされました。

    Succeed
    TaskInput

    string

    メディアアセット情報。

    {\"Type\":\"Media\",\"Media\":\"00f985a50ae371f0ad1c4106e0ea0102\",\"Title\":\"2.mp4\",\"StorageLocation\":\"yiming-pre.oss-cn-shanghai.aliyuncs.com\"}
    CreateTime

    string

    タスクが作成された時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2025-03-27T08:15:46Z
    FinishTime

    string

    タスクが完了した時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2025-03-27T08:20:19Z
    ActivityResults

    string

    ワークフロー内の各ノードの処理結果。JSON 形式です。

    {\"VodSnapshot_123\":{\"ActivityId\":\"VodSnapshot\",\"ActivityInstanceId\":\"c8cf62d53bef4e04bf703976bae6d0b9\",\"EndTime\":\"2025-03-27T08:15:51Z\",\"Result\":\"{\\\"RequestId\\\":\\\"8B3649AF-5A6B-1099-BEB6-164D81067398\\\",\\\"EventType\\\":\\\"SnapshotComplete\\\",\\\"UserId\\\":1797131669910763,\\\"MessageBody\\\":{\\\"Status\\\":\\\"success\\\",\\\"VideoId\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"EventType\\\":\\\"SnapshotComplete\\\",\\\"EventTime\\\":\\\"2025-03-27T08:15:50Z\\\",\\\"TriggerSource\\\":\\\"{\\\\\\\"ActivityInstanceId\\\\\\\":\\\\\\\"c8cf62d53bef4e04bf703976bae6d0b9\\\\\\\",\\\\\\\"BizType\\\\\\\":\\\\\\\"ice-workflow\\\\\\\"}\\\"}}\",\"StartTime\":\"2025-03-27T08:15:47Z\",\"Status\":\"Succeed\"},\"Translate_zh_en\":{\"ActivityId\":\"VodTranslation\",\"ActivityInstanceId\":\"c043a872bb044763a3d293a5c2458b50\",\"EndTime\":\"2025-03-27T08:20:19Z\",\"Result\":\"{\\\"Type\\\":\\\"VideoTranslationAll\\\",\\\"Success\\\":false}\",\"StartTime\":\"2025-03-27T08:15:46Z\",\"Status\":\"Failed\"},\"Act_Start\":{\"ActivityId\":\"start\",\"ActivityInstanceId\":\"8a9402f4ff064084bf496707fb2d664a\",\"Result\":\"{\\\"Type\\\":\\\"Media\\\",\\\"bizType\\\":6,\\\"Media\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"Title\\\":\\\"2.mp4\\\",\\\"taskInput\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"Media\\\\\\\",\\\\\\\"Media\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\"}\\\",\\\"userTaskInput\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"Media\\\\\\\",\\\\\\\"Media\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"Title\\\\\\\":\\\\\\\"2.mp4\\\\\\\",\\\\\\\"StorageLocation\\\\\\\":\\\\\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\\\\\"}\\\",\\\"StorageLocation\\\":\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\",\\\"callerUid\\\":1797131669910763,\\\"CUR_NODE_NAME\\\":\\\"Act_Start\\\"}\",\"StartTime\":\"2025-03-27T08:15:45Z\",\"Status\":\"Succeed\"},\"VodDynamicImage_123\":{\"ActivityId\":\"VodDynamicImage\",\"ActivityInstanceId\":\"26e8dab82ab84110b1150f146caf633c\",\"EndTime\":\"2025-03-27T08:15:55Z\",\"Result\":\"{\\\"RequestId\\\":\\\"7120B5D5-430F-14AD-8922-577F072DDD64\\\",\\\"EventType\\\":\\\"DynamicImageComplete\\\",\\\"UserId\\\":1797131669910763,\\\"MessageBody\\\":{\\\"Status\\\":\\\"success\\\",\\\"VideoId\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"EventType\\\":\\\"DynamicImageComplete\\\",\\\"EventTime\\\":\\\"2025-03-27T08:15:52Z\\\",\\\"TriggerSource\\\":\\\"{\\\\\\\"ActivityInstanceId\\\\\\\":\\\\\\\"26e8dab82ab84110b1150f146caf633c\\\\\\\",\\\\\\\"BizType\\\\\\\":\\\\\\\"ice-workflow\\\\\\\"}\\\"}}\",\"StartTime\":\"2025-03-27T08:15:47Z\",\"Status\":\"Succeed\"}}
    UserData

    string

    ユーザーデータ。これは、メッセージコールバックやアップロードアクセラレーションなどの設定をサポートする JSON 文字列です。

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"*****","test":"www"}}
    Workflow

    object

    ワークフローの詳細。

    WorkflowId

    string

    ワークフロー ID。

    vw_09d6*****b5c5b19a0c891e02
    Name

    string

    ワークフローの名前。

    All_Activity_New_1_app-1000000
    Status

    string

    ワークフローステータス。有効な値：

    • Active：ワークフローはアクティブです。

    • Inactive：ワークフローは非アクティブです。

    • Deleted：ワークフローは削除されました。

    Active
    Type

    string

    ワークフロータイプ。デフォルトでは、このパラメーターは入力されません。

    CreateTime

    string

    ワークフローが作成された時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2025-03-26T05:50:14Z
    ModifiedTime

    string

    ワークフローが最後に変更された時間。UTC 形式で、YYYY-MM-DDTHH:MM:SSZ の形式です。

    2025-03-26T07:51:55Z
    AppId

    string

    アプリケーション ID。

    app-1000000

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "6708D849-F109-1A6C-AC91-************",
  "JobType": "transcode",
  "TranscodeJobDetail": {
    "JobId": "2dc1634e**********3f1d22d1a0174e",
    "UserId": 0,
    "VideoId": "30e5d7**********bd900764de7c0102",
    "Status": "TranscodeSuccess",
    "TemplateId": "dbfaaec9e**********bf0b81219244c",
    "Definition": "HD",
    "CreateTime": "2024-10-14T07:39:25Z",
    "CompleteTime": "2024-10-14T07:39:34Z"
  },
  "SnapshotJobDetail": {
    "JobId": "63df12s0**********4hdq249t82kr91",
    "UserId": 0,
    "VideoId": "30e5d7**********bd900764de7c0102",
    "Status": "Success",
    "Trigger": "Auto",
    "NormalConfig": "{\"inl\":0,\"num\":32,\"tm\":5,\"wd\":\"352\",\"ft\":\"normal\",\"hg\":\"640\"}",
    "SpriteConfig": "{\"pad\":\"0\",\"lines\":\"10\",\"mgin\":\"0\",\"cols\":\"10\",\"ikcp\":\"false\",\"hg\":\"68\"}",
    "CreateTime": "2024-10-14T07:39:25Z",
    "CompleteTime": "2024-10-14T07:39:45Z"
  },
  "AIJobDetail": {
    "JobId": "5c9dff751ba**********59d50a967f5",
    "UserId": 0,
    "MediaId": "30e5d7**********bd900764de7c0102",
    "JobType": "AIVideoCensor",
    "Status": "success",
    "Trigger": "Auto",
    "TemplateConfig": "{\"AuditRange\":[\"video\",\"image-cover\",\"text-title\"],\"AuditContent\":[\"screen\"],\"AuditItem\":[\"terrorism\",\"porn\"],\"AuditAutoBlock\":\"no\"}",
    "CreateTime": "2024-10-14T07:39:25Z",
    "CompleteTime": "2024-10-14T07:39:46Z\n"
  },
  "WorkflowTaskDetail": {
    "TaskId": "46ecc024******92c8e26237e51",
    "Status": "Succeed",
    "TaskInput": "{\\\"Type\\\":\\\"Media\\\",\\\"Media\\\":\\\"00f985a50ae371f0ad1c4106e0ea0102\\\",\\\"Title\\\":\\\"2.mp4\\\",\\\"StorageLocation\\\":\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\"}",
    "CreateTime": "2025-03-27T08:15:46Z",
    "FinishTime": "2025-03-27T08:20:19Z",
    "ActivityResults": "{\\\"VodSnapshot_123\\\":{\\\"ActivityId\\\":\\\"VodSnapshot\\\",\\\"ActivityInstanceId\\\":\\\"c8cf62d53bef4e04bf703976bae6d0b9\\\",\\\"EndTime\\\":\\\"2025-03-27T08:15:51Z\\\",\\\"Result\\\":\\\"{\\\\\\\"RequestId\\\\\\\":\\\\\\\"8B3649AF-5A6B-1099-BEB6-164D81067398\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"SnapshotComplete\\\\\\\",\\\\\\\"UserId\\\\\\\":1797131669910763,\\\\\\\"MessageBody\\\\\\\":{\\\\\\\"Status\\\\\\\":\\\\\\\"success\\\\\\\",\\\\\\\"VideoId\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"SnapshotComplete\\\\\\\",\\\\\\\"EventTime\\\\\\\":\\\\\\\"2025-03-27T08:15:50Z\\\\\\\",\\\\\\\"TriggerSource\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"ActivityInstanceId\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"c8cf62d53bef4e04bf703976bae6d0b9\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"BizType\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"ice-workflow\\\\\\\\\\\\\\\"}\\\\\\\"}}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:47Z\\\",\\\"Status\\\":\\\"Succeed\\\"},\\\"Translate_zh_en\\\":{\\\"ActivityId\\\":\\\"VodTranslation\\\",\\\"ActivityInstanceId\\\":\\\"c043a872bb044763a3d293a5c2458b50\\\",\\\"EndTime\\\":\\\"2025-03-27T08:20:19Z\\\",\\\"Result\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"VideoTranslationAll\\\\\\\",\\\\\\\"Success\\\\\\\":false}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:46Z\\\",\\\"Status\\\":\\\"Failed\\\"},\\\"Act_Start\\\":{\\\"ActivityId\\\":\\\"start\\\",\\\"ActivityInstanceId\\\":\\\"8a9402f4ff064084bf496707fb2d664a\\\",\\\"Result\\\":\\\"{\\\\\\\"Type\\\\\\\":\\\\\\\"Media\\\\\\\",\\\\\\\"bizType\\\\\\\":6,\\\\\\\"Media\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"Title\\\\\\\":\\\\\\\"2.mp4\\\\\\\",\\\\\\\"taskInput\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"Type\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\\\\\\\\\"}\\\\\\\",\\\\\\\"userTaskInput\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"Type\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"Media\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"Title\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"2.mp4\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"StorageLocation\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\\\\\\\\\\\\\"}\\\\\\\",\\\\\\\"StorageLocation\\\\\\\":\\\\\\\"yiming-pre.oss-cn-shanghai.aliyuncs.com\\\\\\\",\\\\\\\"callerUid\\\\\\\":1797131669910763,\\\\\\\"CUR_NODE_NAME\\\\\\\":\\\\\\\"Act_Start\\\\\\\"}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:45Z\\\",\\\"Status\\\":\\\"Succeed\\\"},\\\"VodDynamicImage_123\\\":{\\\"ActivityId\\\":\\\"VodDynamicImage\\\",\\\"ActivityInstanceId\\\":\\\"26e8dab82ab84110b1150f146caf633c\\\",\\\"EndTime\\\":\\\"2025-03-27T08:15:55Z\\\",\\\"Result\\\":\\\"{\\\\\\\"RequestId\\\\\\\":\\\\\\\"7120B5D5-430F-14AD-8922-577F072DDD64\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"DynamicImageComplete\\\\\\\",\\\\\\\"UserId\\\\\\\":1797131669910763,\\\\\\\"MessageBody\\\\\\\":{\\\\\\\"Status\\\\\\\":\\\\\\\"success\\\\\\\",\\\\\\\"VideoId\\\\\\\":\\\\\\\"00f985a50ae371f0ad1c4106e0ea0102\\\\\\\",\\\\\\\"EventType\\\\\\\":\\\\\\\"DynamicImageComplete\\\\\\\",\\\\\\\"EventTime\\\\\\\":\\\\\\\"2025-03-27T08:15:52Z\\\\\\\",\\\\\\\"TriggerSource\\\\\\\":\\\\\\\"{\\\\\\\\\\\\\\\"ActivityInstanceId\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"26e8dab82ab84110b1150f146caf633c\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\"BizType\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\"ice-workflow\\\\\\\\\\\\\\\"}\\\\\\\"}}\\\",\\\"StartTime\\\":\\\"2025-03-27T08:15:47Z\\\",\\\"Status\\\":\\\"Succeed\\\"}}",
    "UserData": "{\"MessageCallback\":{\"CallbackURL\":\"http://example.aliyundoc.com\"},\"Extend\":{\"localId\":\"*****\",\"test\":\"www\"}}",
    "Workflow": {
      "WorkflowId": "vw_09d6*****b5c5b19a0c891e02",
      "Name": "All_Activity_New_1_app-1000000",
      "Status": "Active",
      "Type": "",
      "CreateTime": "2025-03-26T05:50:14Z",
      "ModifiedTime": "2025-03-26T07:51:55Z",
      "AppId": "app-1000000"
    }
  }
}

    エラーコード

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

    変更履歴

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