すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Services:GetLiveEditingJob

最終更新日:Jun 05, 2026

ライブ編集ジョブに関する情報を照会します。照会結果には、ジョブの状態、タイムライン、テンプレート、出力ファイルの ID と URL、およびジョブの設定が含まれます。過去 1 年以内に作成されたライブ編集ジョブのみ照会できます。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:GetLiveEditingJob

読み取り

すべてのリソース

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

JobId

文字列

任意

ライブ編集ジョブの ID です。

d80e4e4044975745c14b

レスポンスフィールド

フィールド

説明

object

応答パラメーター。

RequestId

string

リクエスト ID。

36-3C1E-4417-BDB2-1E034F

LiveEditingJob

object

ライブ編集ジョブに関する情報。

JobId

string

ライブ編集ジョブの ID。

cdb3e74639973036bc84

ProjectId

string

ライブ編集プロジェクトの ID。

fddd7748b58bf1d47e95

Status

string

ライブ編集ジョブの状態。有効な値:InitQueuingProcessingSuccessFailed

Success

Clips

string

クリップ。

[{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" }]

UserData

string

ユーザー定義データ。

{"key": "value'}

CreationTime

string

ライブ編集ジョブが作成された時刻。yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準に準拠した UTC 時刻です。

2020-12-23T13:33:40Z

ModifiedTime

string

ライブ編集ジョブが最後に変更された時刻。yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準に準拠した UTC 時刻です。

2020-12-23T13:33:49Z

CompleteTime

string

ライブ編集ジョブが完了した時刻。yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準に準拠した UTC 時刻です。

2020-12-23T13:33:52Z

MediaId

string

出力ファイルのメディアアセット ID。

0cc6ba49eab379332c5b

MediaURL

string

出力ファイルの URL。

http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4

Code

string

応答コード。ジョブが失敗した場合は、このパラメーターを参照してください。

InvalidParameter

Message

string

返されたメッセージ。ジョブが失敗した場合は、このパラメーターを参照してください。

The specific parameter LiveStreamConfig is not valid.

LiveStreamConfig

object

ライブ編集の設定。

AppName

string

ライブストリームのアプリケーション名。

app

DomainName

string

ライブストリームのドメイン名。

domain.com

StreamName

string

ライブストリームのストリーム名。

streamName

MediaProduceConfig

object

生成設定。

Mode

string

編集モード。デフォルト値: Accurate

Accurate

OutputMediaConfig

object

出力ファイルのストレージ設定。

MediaURL

string

出力ファイルの URL。

https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4

StorageLocation

string

OutputMediaTargetvod-media に設定されている場合、このパラメーターは ApsaraVideo VOD でのメディアアセットのストレージロケーションです。ストレージロケーションは、プレフィックス http:// を除いた ApsaraVideo VOD 内のファイルのパスです。例:outin-xxxxxx.oss-cn-shanghai.aliyuncs.com

outin-xxxxxx.oss-cn-shanghai.aliyuncs.com

FileName

string

OutputMediaTargetvod-media に設定されている場合、このパラメーターは出力ファイルのファイル名です。値にはファイル名拡張子が含まれ、パスは含まれません。

test.mp4

Width

integer

出力ファイルの幅。このパラメーターは省略可能です。デフォルト値は、入力素材の最大幅です。

640

Height

integer

出力ファイルの高さ。このパラメーターは省略可能です。デフォルト値は、入力素材の最大高さです。

480

Bitrate

integer

出力ファイルのビットレート。単位は Kbit/s です。このパラメーターは省略可能です。デフォルト値は、入力素材の最大ビットレートです。

1000

VodTemplateGroupId

string

VOD トランスコーディングテンプレートグループの ID。VOD トランスコーディングが不要な場合は、値を VOD_NO_TRANSCODE に設定します。

VOD_NO_TRANSCODE

成功レスポンス

JSONJSON

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "LiveEditingJob": {
    "JobId": "****cdb3e74639973036bc84****",
    "ProjectId": "****fddd7748b58bf1d47e95****",
    "Status": "Success",
    "Clips": "[{\\\"StartTime\\\": \\\" 2021-06-21T08:01:00Z\\\",  \\\"EndTime\\\": \\\" 2021-06-21T08:03:00Z\\\" }]",
    "UserData": "{\"key\": \"value\"}",
    "CreationTime": "2020-12-23T13:33:40Z",
    "ModifiedTime": "2020-12-23T13:33:49Z",
    "CompleteTime": "2020-12-23T13:33:52Z",
    "MediaId": "****0cc6ba49eab379332c5b****",
    "MediaURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4",
    "Code": "InvalidParameter",
    "Message": "The specific parameter LiveStreamConfig is not valid.",
    "LiveStreamConfig": {
      "AppName": "app",
      "DomainName": "domain.com",
      "StreamName": "streamName"
    },
    "MediaProduceConfig": {
      "Mode": "Accurate"
    },
    "OutputMediaConfig": {
      "MediaURL": "https://testice-testbucket.oss-cn-shanghai.aliyuncs.com/test.mp4",
      "StorageLocation": "outin-xxxxxx.oss-cn-shanghai.aliyuncs.com",
      "FileName": "test.mp4",
      "Width": 640,
      "Height": 480,
      "Bitrate": 1000,
      "VodTemplateGroupId": "VOD_NO_TRANSCODE"
    }
  }
}

エラーコード

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

変更履歴

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