QueryJobList API でジョブ ID によりトランスコーディングジョブをクエリする - MPS

トランスコーディングジョブの ID を指定して、複数のジョブを照会できます。

操作説明

この API では、1 回の呼び出しで最大 10 個のトランスコーディングジョブを照会できます。
JobIds パラメーターを指定しない場合、InvalidParameter エラーコードが返されます。

QPS 制限

この API の単一ユーザー QPS（1 秒あたりのリクエスト数）制限は、1 秒あたり 100 回です。この制限を超えると、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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

mts:QueryJobList

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
JobIds	string	任意	トランスコーディングジョブの ID。 1 回の照会で最大 10 個のジョブを指定できます。複数のジョブ ID はカンマ (,) で区切ります。ジョブ ID は、MPS コンソールの [ジョブ管理] ページ、またはトランスコーディングジョブの送信後に返されるレスポンスパラメーターから取得できます。説明このパラメーターを指定しない場合、`InvalidParameter` エラーコードが返されます。	bb558c1cc25b45309aab5be44d19**,d1ce4d3efcb549419193f50f1fcd**

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
NonExistJobIds	object
String	array	存在しないジョブの ID。
	string	存在しないトランスコーディングジョブの ID のリスト。該当する ID がない場合は、この構造は返されません。	d1ce4d3efcb549419193f50f1fcd****
RequestId	string	リクエスト ID。	197ADF44-104C-514C-9F92-D8924CB34E2A
JobList	object
Job	array<object>	トランスコーディングジョブのリスト。
	array<object>	トランスコーディングジョブの詳細情報。
CreationTime	string	ジョブが送信された時刻。	2014-01-10T12:00:00Z
Percent	integer	トランスコード進捗率（パーセント単位）。	100
FinishTime	string	ジョブが完了した時刻。	2014-01-10T12:20:25Z
State	string	ジョブのステータス。 Submitted: ジョブが送信されました。 Transcoding: トランスコード中です。 TranscodeSuccess: トランスコードが成功しました。 TranscodeFail: トランスコードに失敗しました。 TranscodeCancelled: トランスコードがキャンセルされました。	TranscodeSuccess
JobId	string	ジョブ ID。	31fa3c9ca8134fb4b0b0f7878301****
Code	string	失敗したジョブのエラーコード。成功したジョブではこのパラメーターは返されません。	InvalidParameter.NullValue
Message	string	失敗したジョブのエラーメッセージ。成功したジョブではこのパラメーターは返されません。	The specified parameter "%s" cannot be null.
Output	object	ジョブの出力内容。
Video	object	動画設定。
Bufsize	string	バッファサイズ。単位：Kb。デフォルト値：6000。	6000
Degrain	string	スタンドアロンノイズ除去アルゴリズムの強度。	5
BitrateBnd	object	平均動画ビットレートの範囲。
Max	string	最大ビットレート。	1000
Min	string	最小ビットレート。	300
PixFmt	string	動画カラーフォーマット。有効な値：yuv420p、yuvj420p。	yuv420p
Pad	string	動画に黒枠を追加します。単位：px。書式：width:height:left:top。	1280:800:0:140
Codec	string	コーデックフォーマット。有効な値：H.264、H.265。デフォルト値：H.264。	H.264
Height	string	出力動画の高さ。単位：px。デフォルト値：入力動画の元の高さ。	720
Qscale	string	動画品質制御係数。	15
Crop	string	動画フレームを切り取ります。対応する方法：黒枠を自動検出し、切り取るには、このパラメーターを border に設定します。カスタム切り取りには、書式：width:height:left:top を使用します。	1280:800:0:140
Bitrate	string	平均動画ビットレート。単位：Kbps。	500
Maxrate	string	ピーク動画ビットレート。単位：Kbps。	3000
MaxFps	string	最大フレームレート。	60
Profile	string	エンコーディングプロファイル。有効な値：baseline、main、high。説明複数の解像度がある場合、低性能デバイスでの再生を保証するために、最低解像度には baseline を使用し、他の解像度には main または high を使用します。 baseline: モバイルデバイス向け。 main: 標準解像度デバイス向け。 high: 高解像度デバイス向け。デフォルト値：high。	high
Crf	string	ビットレート・品質制御のための Constant Rate Factor（CRF）。デフォルト値：H.264 の場合は 23、H.265 の場合は 26。 CRF が設定されている場合、Bitrate の設定は無視されます。	26
Gop	string	キーフレーム間の最大時間間隔またはフレーム数。単位：秒。デフォルト値：250。最大フレーム数を指定する場合は、単位はありません。	250
Width	string	出力動画の幅。単位：px。デフォルト値：入力動画の元の幅。	1280
Fps	string	フレームレート。単位：fps。入力ファイルのフレームレートが 60 を超える場合、値は 60 に制限されます。デフォルト値：入力ファイルのフレームレート。	25
Preset	string	動画エンコーダーのプリセット。デフォルト値：medium。有効な値： veryfast: 非常に高速。 fast: 高速。 medium: 中速。 slow: 低速。 slower: 非常に低速。	medium
ScanMode	string	スキャンモード。有効な値： Not set: 入力ファイルの元のスキャンモードを使用します。 auto: 自動デインタレース。 progressive: 進行形スキャン（ラインごと）。 interlaced: インターレーススキャン。デフォルト値: 空（未設定）。ベストプラクティス: インターレーススキャンは帯域幅を節約しますが、品質が低下します。ほとんどの最新の動画は進行形スキャンを使用しています。 progressive または interlaced を設定したが、ソースと一致しない場合、トランスコードは失敗します。互換性を高めるために、元のスキャンモードまたは自動デインタレースを推奨します。	interlaced
ResoPriority	string	リソース優先度。	1
TransConfig	object	一般的なトランスコーディング設定。説明リクエストでこれらの値を指定すると、トランスコーディングテンプレート内の対応する設定が上書きされます。
IsCheckAudioBitrate	string	音声ビットレートをチェックするかどうか。出力音声ビットレートがソース音声ビットレートを超える場合、出力ビットレートはソースビットレートに設定され、設定したビットレートは無視されます。この設定は IsCheckAudioBitrateFail よりも優先順位が低いです。 true: チェックします。 false: チェックしません。デフォルト値：空のパラメーターで、コーデックがソースと異なる場合：false。空のパラメーターで、コーデックがソースと一致する場合：true。	false
TransMode	string	トランスコーディングモード。有効な値：onepass、twopass、CBR。デフォルト値：onepass。	onepass
IsCheckReso	string	解像度をチェックするかどうか。出力解像度（幅または高さ）が入力解像度を超える場合、出力解像度は入力解像度に設定されます。 true: チェックします。 false: チェックしません。デフォルト値：false。	false
IsCheckVideoBitrateFail	string	動画ビットレートをチェックするかどうか。出力動画ビットレートがソース動画ビットレートを超える場合、トランスコードは即座に失敗します。この設定は IsCheckVideoBitrate よりも優先順位が高いです。 true: チェックします。 false: チェックしません。デフォルト値：false。	false
AdjDarMethod	string	解像度調整方法。デフォルト値：none。有効な値：rescale、crop、pad、none。	none
IsCheckVideoBitrate	string	動画ビットレートをチェックするかどうか。出力動画ビットレートが入力動画ビットレートを超える場合、出力ビットレートは入力ビットレートに設定されます。 true: チェックします。 false: チェックしません。デフォルト値：false。	false
IsCheckResoFail	string	解像度をチェックするかどうか。出力解像度（幅または高さ）が入力解像度を超える場合、トランスコードは失敗します。 true: チェックします。 false: チェックしません。デフォルト値：false。	false
IsCheckAudioBitrateFail	string	音声ビットレートをチェックするかどうか。出力音声ビットレートがソース音声ビットレートを超える場合、トランスコードは即座に失敗します。この設定は IsCheckAudioBitrate よりも優先順位が高いです。 true: チェックします。 false: チェックしません。デフォルト値：false。	false
Encryption	object	データ暗号化。m3u8 出力のみサポートされています。
Type	string	暗号化タイプ。有効な値：hls-aes-128。	hls-aes-128
Key	string	動画の暗号化キー。	encryptionkey128
KeyType	string	キー暗号化方式。有効な値：Base64、KMS。説明たとえば、キーが `"encryptionkey128"` の場合、`Base64("encryptionkey128")` または `KMS(Base64("encryptionkey128"))` となります。	Base64
Id	string	暗号化 ID。	31fa3c9ca8134f9cec2b4b0b0f78****
KeyUri	string	キーへのアクセス URL。BASE64 でエンコードされています。	https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/
SkipCnt	string	初期セグメントのうち、暗号化しない数（高速再生を可能にするため）。	3
WaterMarkList	object
WaterMark	array<object>	ウォーターマークのリスト。
	array<object>	ウォーターマークの詳細情報。
Type	string	ウォーターマークタイプ。リクエストで指定した場合、この値はウォーターマークテンプレート内の対応するパラメーターを上書きします。詳細については、「パラメーターの詳細」をご参照ください。有効な値： Image: 画像ウォーターマーク。 Text: テキストウォーターマーク。	Image
ReferPos	string	ウォーターマークの位置。リクエストで指定した場合、この値はウォーターマークテンプレート内の対応するパラメーターを上書きします。有効な値： TopRight: 右上。 TopLeft: 左上。 BottomRight: 右下。 BottomLeft: 左下。	TopRight
Dx	string	ウォーターマーク画像の水平オフセット（出力動画に対する相対位置）。リクエストで指定した場合、この値はウォーターマークテンプレート内の対応するパラメーターを上書きします。デフォルト値：0。値の種類：整数：ピクセル単位のオフセット。範囲：[8,4096]。単位：px。小数：水平オフセットを出力動画の幅に対する比率で表したもの。範囲：(0,1)。小数点以下最大 4 桁までサポート（例：0.9999）。それ以上の桁は切り捨てられます。	100
Width	string	ウォーターマーク画像の幅。リクエストで指定した場合、この値はウォーターマークテンプレート内の対応するパラメーターを上書きします。値の種類：整数：ピクセル単位の幅。範囲：[8,4096]。単位：px。小数：ウォーターマークの幅を出力動画の幅に対する比率で表したもの。範囲：(0,1)。小数点以下最大 4 桁までサポート（例：0.9999）。それ以上の桁は切り捨てられます。	50
Height	string	ウォーターマーク画像の高さ。リクエストで指定した場合、この値はウォーターマークテンプレート内の対応するパラメーターを上書きします。値の種類：整数：ピクセル単位の高さ。範囲：[8,4096]。単位：px。小数：ウォーターマークの高さを出力動画の高さに対する比率で表したもの。範囲：(0,1)。小数点以下最大 4 桁までサポート（例：0.9999）。それ以上の桁は切り捨てられます。	50
InputFile	object	ウォーターマークの入力ファイル。サポート形式：PNG 画像および MOV ファイル。
Object	string	入力ファイルの OSS オブジェクト。	example-logo-****.png
Location	string	入力ファイルの OSS ロケーション。	oss-cn-hangzhou
Bucket	string	入力ファイルの OSS バケット。	example-bucket
WaterMarkTemplateId	string	ウォーターマークテンプレートの ID。	88c6ca184c0e47098a5b665e2a12****
Dy	string	ウォーターマーク画像の垂直オフセット（出力動画に対する相対位置）。リクエストで指定した場合、この値はウォーターマークテンプレート内の対応するパラメーターを上書きします。値の種類：整数：垂直オフセット（ピクセル単位）。範囲：[8,4096]。単位：px。小数：垂直オフセットを出力動画の高さに対する比率で表したもの。範囲：(0,1)。小数点以下最大 4 桁までサポート（例：0.9999）。それ以上の桁は切り捨てられます。	100
WaterMarkConfigUrl	string	ウォーターマーク設定ファイルの URL。	http://example.com/configure
DeWatermark	string	ぼかし設定（JSON オブジェクト）。詳細については、「パラメーターの詳細」のぼかし設定の説明をご参照ください。	{"0":[{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000":[],"250000":[{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}
M3U8NonStandardSupport	object	m3u8 非標準サポート（JSON オブジェクト）。詳細については、「パラメーターの詳細」の m3u8 非標準パラメーターのサポートに関する説明をご参照ください。
TS	object	TS ファイル非標準サポートの JSON オブジェクト。詳細については、「パラメーターの詳細」の TS パラメーターのサポートに関する説明をご参照ください。
SizeSupport	boolean	m3u8 ファイル内に TS ファイルのサイズを含めるかどうか。有効な値： true: 含めます。 false: 含めません。	true
Md5Support	boolean	m3u8 ファイル内に TS ファイルの MD5 ハッシュを含めるかどうか。有効な値： true: 含めます。 false: 含めません。	true
Priority	string	パイプライン内におけるジョブの優先度。最大優先度：10。デフォルト値：6。	6
Audio	object	音声設定。説明リクエストで音声設定を指定した場合、トランスコーディングテンプレート内の対応する設定が上書きされます。
Profile	string	音声コーデックプロファイル。Codec が aac の場合の有効な値：aaclow、aache、aachev2、aacld、aaceld。	aaclow
Codec	string	音声コーデックフォーマット。有効な値：aac、mp3、vorbis、flac。デフォルト値：aac。	aac
Samplerate	string	サンプルレート。有効な値：22050、32000、44100、48000、96000。単位：Hz。デフォルト値：44100。説明コンテナ形式が flv で、音声コーデックが mp3 の場合、サンプルレート 32000、48000、96000 はサポートされていません。また、音声コーデックが mp3 の場合、サンプルレート 96000 はサポートされていません。	44100
Qscale	string	音声品質制御係数。	15
Channels	string	サウンドチャンネル数。有効な値：1、2、3、4、5、6、7、8。デフォルト値：2。	2
Volume	object	音量設定。
Method	string	音量調整方法。有効な値： auto: 自動調整。 dynamic: 動的調整。 linear: 線形調整。	auto
Level	string	音量調整レベル。デフォルト値：-20 dB。	-20
Bitrate	string	出力ファイルの音声ビットレート。単位：Kbps。デフォルト値：128。	128
AudioStreamMap	string	音声ストリームのインデックス。書式：0:a:{index}。例：0:a:0。インデックスは、音声ストリームリスト内での位置（0 から始まる）です。未設定の場合、デフォルトの音声ストリームが使用されます。	0:a:0
MergeList	object
Merge	array<object>	マージ設定。最大 4 つの MergeURL をサポートしています。
	object	マージ操作の詳細情報。
Start	string	開始時刻。書式：`hh:mm:ss[.SSS]` または `sssss[.SSS]`。例：01:59:59.999 または 32000.23。	01:59:59.999
RoleArn	string	エージェント権限付与のためのロール ARN。	acs:ram:::role/
MergeURL	string	マージ対象のセグメントの URL。例：`http://example-bucket-.oss-cn-hangzhou.aliyuncs.com/example-object.flv`。オブジェクト名は UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコーディングの手順」をご参照ください。	http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv
Duration	string	持続時間。書式：`hh:mm:ss[.SSS]` または `sssss[.SSS]`。例：01:59:59.999 または 32000.23。	01:59:59.999
SuperReso	object	解像度はソースに従います。
IsHalfSample	string	サンプリングレート関連パラメーターを取得するかどうか。有効な値： true: はい。 false: いいえ。	true
UserData	string	ユーザー定義データ。	testid-001
ExtendData	string	ユーザー定義拡張フィールド。	testid-002
OutSubtitleList	object
OutSubtitle	array<object>	出力字幕のリスト。
	array<object>	出力字幕の詳細情報。
Map	string	動画トラック。書式：`0:{stream}:{index}`、つまり `0:v:{video_index}`。ストリーム値：v は動画を表します。インデックスは、動画ストリームリスト内での位置（0 から始まる）です。	0:v:0
OutSubtitleFile	object	出力ファイルの詳細情報。
RoleArn	string	エージェント権限付与のためのロール ARN。	acs:ram:::role/
Object	string	出力ファイルの OSS オブジェクト。	example.flv
Location	string	出力ファイルの OSS ロケーション。	oss-cn-hangzhou
Bucket	string	出力ファイルの OSS バケット。	exampleBucket
Success	boolean	操作が成功したかどうか。有効な値： true: 成功しました。 false: 失敗しました。	true
Message	string	失敗したジョブのエラーメッセージ。成功したジョブではこのパラメーターは返されません。	The specified parameter “%s” cannot be null.
VideoStreamMap	string	動画ストリームのインデックス。インデックスは 0 から始まり、動画ストリームリスト内での位置を示します。未設定の場合、デフォルトの動画ストリームが使用されます。	0
OutputFile	object	出力ファイル。
RoleArn	string	エージェント権限付与のためのロール ARN。	acs:ram:::role/
Object	string	出力ファイルの OSS オブジェクト。	example-output.flv
Location	string	出力ファイルの OSS ロケーション。	oss-cn-hangzhou
Bucket	string	出力ファイルの OSS バケット。	example-bucket
Rotate	string	動画回転角度。	90
Container	object	コンテナ。
Format	string	コンテナ形式。デフォルト値：mp4。動画トランスコーディングの場合、有効な値：flv、mp4、HLS（m3u8+ts）、MPEG-DASH（MPD+fMP4）。音声トランスコーディングの場合、有効な値：mp3、mp4、ogg、flac、m4a。画像の場合、有効な値：gif、WEBP。コンテナが gif の場合、VideoCodec は GIF である必要があります。コンテナが webp の場合、VideoCodec は WEBP である必要があります。コンテナが flv の場合、VideoCodec は H.265 にできません。	mp4
Clip	object	クリップされたセグメント。
TimeSpan	object	クリッピング時間範囲。
Seek	string	開始時刻。書式：`hh:mm:ss[.SSS]`。例：01:59:59.999。または書式：`sssss[.SSS]`。例：32000.23。	01:59:59.999
Duration	string	持続時間。書式：`hh:mm:ss[.SSS]`。例：01:00:59.999。または書式：`sssss[.SSS]`。例：32000.23。	01:00:59.999
MergeConfigUrl	string	マージ設定ファイルの URL。MergeList または MergeConfigUrl のいずれかを指定できますが、両方を指定することはできません。 MergeConfigUrl で指定された設定ファイルは、最大 50 個のマージセグメントをサポートしています。 MergeConfigUrl はマージ設定ファイルの URL です。ファイルは OSS に保存され、MPS からアクセス可能である必要があります。ファイル内容の詳細については、マージパラメーターの詳細をご参照ください。マージ設定ファイルの内容例：`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}`。	https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8
OpeningList	object
Opening	array<object>	オープニング動画のリスト（JSON オブジェクト）。
	object	オープニングの詳細情報。
openUrl	string	オープニング動画の OSS URL。	http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4
Start	string	メイン動画に対するオープニング動画の開始時刻。オープニング動画を表示するまでの遅延時間。単位：秒。デフォルト値：0。	0
Width	string	幅。有効な値：(0,4096)、1、full。 -1 はソース動画の幅を使用することを意味します。 full は画面全体を埋めることを意味します。デフォルト値：-1。	-1
Height	string	高さ。有効な値：(0,4096)、-1、full。 -1 はソース動画の高さを使用することを意味します。 full は画面全体を埋めることを意味します。デフォルト値：-1。	-1
MuxConfig	object	マルチプレクス設定。リクエストでこのパラメーターを指定すると、トランスコーディングテンプレート内の対応する設定が上書きされます。
Webp	object	WebP マルチプレクス設定。
Loop	string	ループ回数。	0
Gif	object	GIF マルチプレクス設定。
FinalDelay	string	最終フレームでの一時停止時間。単位：1/100 秒。	0
DitherMode	string	カラーパレットのディザリング方法。有効な値：sierra、bayer。	bayer
Loop	string	ループ回数。	0
IsCustomPalette	string	カスタムカラーパレットを使用するかどうか。有効な値： true: カスタムパレットを使用します。 false: カスタムパレットを使用しません。	false
Segment	object	セグメンテーション設定（JSON オブジェクト）。
Duration	string	セグメントの持続時間。単位：秒。	20
TailSlateList	object
TailSlate	array<object>	テールスレート動画のリスト。
	object	テールスレート動画の詳細情報。
Start	string	テールスレート動画の開始時刻。	00000.00
BgColor	string	テールスレート動画がメイン動画より小さい場合の空白領域の背景色。デフォルト値：White。詳細については、「bgcolor」をご参照ください。	White
IsMergeAudio	boolean	テールスレート動画の音声をマージするかどうか。有効な値： true: マージします。 false: マージしません。	true
Width	string	幅。有効な値：(0,4096)、-1、full。 -1 はソース動画の幅を使用することを意味します。 full は画面全体を埋めることを意味します。デフォルト値：-1。	-1
Height	string	高さ。有効な値：(0,4096)、-1、full。 -1 はソース動画の高さを使用することを意味します。 full は画面全体を埋めることを意味します。デフォルト値：-1。	-1
BlendDuration	string	メイン動画とテールスレート動画間のトランジション時間。トランジション効果：メイン動画の最終フレームをフェードアウトしながら、テールスレート動画をフェードインします。単位：秒。デフォルト値：0。	0
TailUrl	string	テールスレート動画の OSS URL。	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
TemplateId	string	テンプレート ID。	S00000001-200010
SubtitleConfig	object	字幕設定。
ExtSubtitleList	object
ExtSubtitle	array<object>	外部字幕のリスト。
	array<object>	字幕の詳細情報。
CharEnc	string	外部字幕の文字コード。有効な値：UTF-8、GBK、BIG5、auto。デフォルト値：auto。説明 auto に設定した場合、文字コードの検出が失敗する可能性があります。明示的なエンコーディングを指定することを推奨します。	auto
FontName	string	外部字幕をハード字幕に変換する際に使用するフォント名。デフォルト値：SimSun。詳細については、「フォント一覧」をご参照ください。	"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"
Input	object	外部字幕の入力ファイル。サポート形式：srt、ass。詳細については、「パラメーターの詳細」の Input パラメーターをご参照ください。例：`{“Bucket”:”example-bucket”,“Location”:”oss-cn-hangzhou”,“Object”:”example.srt”}`。
Object	string	入力ファイルの OSS オブジェクト。	example-output.flv
Location	string	入力ファイルの OSS ロケーション。	oss-cn-hangzhou
Bucket	string	入力ファイルの OSS バケット。	example-bucket-****
SubtitleList	object
Subtitle	array<object>	字幕のリスト。
	object	字幕の詳細情報。
Map	string	音声トラック。書式：`0:{stream}:{index}`、つまり `0:a:{audio_index}`。ストリーム値：a は音声を表します。インデックスは、音声ストリームリスト内での位置（0 から始まる）です。	0:a:0
Properties	object	メディアプロパティ。
Width	string	動画の幅。	720
Height	string	動画の高さ。	1280
SourceLogos	object
SourceLogo	array<object>	エンジンレイヤーで処理されないキーワード。
	object	キーワードの詳細情報。
Source	string	キーワード。	example
Duration	string	持続時間。	17
Fps	string	フレームレート。	30
Bitrate	string	ビットレート。	490
FileFormat	string	ファイル形式。	mp4
Streams	object	ストリーム情報。
VideoStreamList	object
VideoStream	array<object>	動画ストリームのリスト。
	array<object>	動画ストリームの詳細情報。
Index	string	動画ストリームのインデックス。メディアストリーム内での位置を示します。	0
Timebase	string	タイムベース。	1/15360
AvgFPS	string	平均フレームレート。	30.0
PixFmt	string	ピクセルフォーマット。	yuv420p
Sar	string	サンプルアスペクト比。	1:1
Lang	string	言語。詳細については、「FFmpeg 言語定義」および「ISO-639」をご参照ください。	eng
CodecLongName	string	コーデックの正式名称。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Height	string	動画解像度の高さ。	1280
NumFrames	string	総フレーム数。	30
Bitrate	string	ビットレート。	421.117
CodecTagString	string	コーデックタグ文字列。	avc1
HasBFrames	string	B フレームの有無。	2
Profile	string	エンコーディングプロファイル。	high
StartTime	string	開始時刻。	0.000000
NetworkCost	object	ネットワーク帯域幅消費量。
PreloadTime	string	プリロード時間。	8
AvgBitrate	string	平均ビットレート。	300
CostBandwidth	string	消費される最大帯域幅。	10
Dar	string	表示アスペクト比。	9:16
CodecName	string	コーデックの短縮名。	h264
Width	string	動画解像度の幅（数値）。	720
Duration	string	持続時間。	17.233333
Fps	string	フレームレート。	30.0
CodecTag	string	コーデックタグ。	0x31637661
CodecTimeBase	string	コーデックタイムベース。	1/60
Level	string	エンコーディングレベル。	31
colorTransfer	string	色伝送特性。	bt709
colorPrimaries	string	原色。	bt709
bitsPerRawSample	string	生サンプルまたはピクセルあたりのビット数。	8
AudioStreamList	object
AudioStream	array<object>	音声ストリームのリスト。
	object	音声ストリームの詳細情報。
Timebase	string	タイムベース。	1/32000
Index	string	音声ストリームのインデックス。メディアストリーム内での位置を示します。	1
SampleFmt	string	サンプルフォーマット。	fltp
ChannelLayout	string	チャンネルレイアウト。	mono
Lang	string	言語。詳細については、「FFmpeg 言語定義」および「ISO-639」をご参照ください。	und
Samplerate	string	サンプルレート。	32000
CodecLongName	string	コーデックの正式名称。	AAC (Advanced Audio Coding)
Channels	string	サウンドチャンネル数。	1
NumFrames	string	総フレーム数。	50
Bitrate	string	ビットレート。	64.136
CodecTagString	string	コーデックタグ文字列。	mp4
StartTime	string	開始時刻。	0.064000
CodecName	string	コーデックの短縮名。	aac
Duration	string	持続時間。	17.223562
CodecTag	string	コーデックタグ。	0x6134706d
CodecTimeBase	string	コーデックタイムベース。	1/32000
SubtitleStreamList	object
SubtitleStream	array<object>	字幕ストリームのリスト。
	object	字幕ストリームの詳細情報。
Index	string	字幕ストリームのインデックス。メディアストリーム内での位置を示します。	1
Lang	string	言語。詳細については、「FFmpeg 言語定義」および「ISO-639」をご参照ください。	eng
Format	object	フォーマット情報。
StartTime	string	開始時刻。	-0.064000
NumPrograms	string	プログラムストリームの総数。	0
Size	string	ファイルサイズ。	1057273
NumStreams	string	メディアストリームの総数。	2
FormatLongName	string	コンテナまたはラッパー形式の正式名称。	QuickTime / MOV
Duration	string	総持続時間。	17.234000
Bitrate	string	総ビットレート。	490.784
FormatName	string	コンテナまたはラッパー形式の短縮名。有効な値：mov、mp4、m4a、3gp、3g2、mj2。	mov
FileMd5	string		ad195fd1317a761d4425232867759d1e
FileSize	string	ファイルサイズ。	1057273
MultiSpeedInfo	object	マルチスピードジョブに関する情報。このフィールドは、マルチスピードパイプラインに送信されたジョブに対してのみ表示されます（レガシーマルチスピードジョブでは利用できません）。
Enable	string	マルチスピード機能が有効かどうか。	true
Code	string	マルチスピードが実際に有効になっていない場合のエラーコード。	Boost.NotNeedSpeed
Message	string	マルチスピードが実際に有効になっていない場合のエラーメッセージ。	success
SettingSpeed	integer	設定された速度。	30
DowngradePolicy	string	マルチスピードがサポートされていない場合のダウングレードポリシー。	NormalSpeed
RealSpeed	number	実際のマルチスピード値。	6.576886940181647
Duration	number	出力動画の持続時間。	21.0
TimeCost	number	ジョブに要した時間。	3.193
PipelineId	string	パイプライン ID。	88c6ca184c0e47b665e2a1267971****
Input	object	ジョブの入力内容。
Object	string	入力ファイルの OSS オブジェクト。	video_01.mp4
Location	string	入力ファイルの OSS ロケーション。	oss-cn-shanghai
Bucket	string	入力ファイルの OSS バケット。	exampleBucket
MNSMessageResult	object	ジョブ完了時の MNS 通知結果。
MessageId	string	成功したジョブのメッセージ ID。	123
ErrorMessage	string	失敗したジョブのエラーメッセージ。成功したジョブではこのパラメーターは返されません。	The resource operated “%s” cannot be found.
ErrorCode	string	失敗したジョブのエラーコード。成功したジョブではこのパラメーターは返されません。	InvalidParameter.ResourceNotFound
SubmitTime	string	ジョブがキューから取り出され、実行を開始した時刻。	2021-03-04T06:44:43Z

コールバックメッセージの形式

トランスコーディングジョブのステータスが変更されると、MPS（Media Processing Service）は指定されたキューにメッセージを送信します。コールバックキューの指定方法については、MPS の「UpdatePipeline 操作」をご参照ください。メッセージ本文は、以下のフィールドを含む JSON 文字列です。

{
  "Type": "Transcode",
  "State": "Success",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}

名前	タイプ	説明
Type	String	固定文字列 "Transcode"。これはトランスコーディングジョブであることを示します。
JobId	String	ジョブの一意な ID。
State	String	現在のジョブステータス。QueryJobList の State フィールドと一致します。
UserData	String	SubmitJobs で渡した UserData の値。

例

成功レスポンス

JSONJSON

{
  "NonExistJobIds": {
    "String": [
      "d1ce4d3efcb549419193f50f1fcd****"
    ]
  },
  "RequestId": "197ADF44-104C-514C-9F92-D8924CB34E2A",
  "JobList": {
    "Job": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "FinishTime": "2014-01-10T12:20:25Z",
        "State": "TranscodeSuccess",
        "JobId": "31fa3c9ca8134fb4b0b0f7878301****",
        "Code": "InvalidParameter.NullValue",
        "Message": "The specified parameter \"%s\" cannot be null.",
        "Output": {
          "Video": {
            "Bufsize": "6000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "1000",
              "Min": "300"
            },
            "PixFmt": "yuv420p",
            "Pad": "1280:800:0:140",
            "Codec": "H.264",
            "Height": "720",
            "Qscale": "15",
            "Crop": "1280:800:0:140",
            "Bitrate": "500",
            "Maxrate": "3000",
            "MaxFps": "60",
            "Profile": "high",
            "Crf": "26",
            "Gop": "250",
            "Width": "1280",
            "Fps": "25",
            "Preset": "medium",
            "ScanMode": "interlaced",
            "ResoPriority": "1"
          },
          "TransConfig": {
            "IsCheckAudioBitrate": "false",
            "TransMode": "onepass",
            "IsCheckReso": "false",
            "IsCheckVideoBitrateFail": "false",
            "AdjDarMethod": "none",
            "IsCheckVideoBitrate": "false",
            "IsCheckResoFail": "false",
            "IsCheckAudioBitrateFail": "false"
          },
          "Encryption": {
            "Type": "hls-aes-128",
            "Key": "encryptionkey128",
            "KeyType": "Base64",
            "Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
            "KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
            "SkipCnt": "3"
          },
          "WaterMarkList": {
            "WaterMark": [
              {
                "Type": "Image",
                "ReferPos": "TopRight",
                "Dx": "100",
                "Width": "50",
                "Height": "50",
                "InputFile": {
                  "Object": "example-logo-****.png",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "example-bucket"
                },
                "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
                "Dy": "100"
              }
            ]
          },
          "WaterMarkConfigUrl": "http://example.com/configure",
          "DeWatermark": "{\"0\":[{\"l\":10,\"t\":10,\"w\":10,\"h\":10},{\"l\":100,\"t\":0.1,\"w\":10,\"h\":10}],\"128000\":[],\"250000\":[{\"l\":0.2,\"t\":0.1,\"w\":0.01,\"h\":0.05}]}",
          "M3U8NonStandardSupport": {
            "TS": {
              "SizeSupport": true,
              "Md5Support": true
            }
          },
          "Priority": "6",
          "Audio": {
            "Profile": "aaclow",
            "Codec": "aac",
            "Samplerate": "44100",
            "Qscale": "15",
            "Channels": "2",
            "Volume": {
              "Method": "auto",
              "Level": "-20"
            },
            "Bitrate": "128"
          },
          "AudioStreamMap": "0:a:0",
          "MergeList": {
            "Merge": [
              {
                "Start": "01:59:59.999",
                "RoleArn": "acs:ram:::role/",
                "MergeURL": "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
                "Duration": "01:59:59.999"
              }
            ]
          },
          "SuperReso": {
            "IsHalfSample": "true"
          },
          "UserData": "testid-001",
          "ExtendData": "testid-002",
          "OutSubtitleList": {
            "OutSubtitle": [
              {
                "Map": "0:v:0",
                "OutSubtitleFile": {
                  "RoleArn": "acs:ram:::role/",
                  "Object": "example.flv",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "exampleBucket"
                },
                "Success": true,
                "Message": "The specified parameter “%s” cannot be null."
              }
            ]
          },
          "VideoStreamMap": "0",
          "OutputFile": {
            "RoleArn": "acs:ram:::role/",
            "Object": "example-output.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
          },
          "Rotate": "90",
          "Container": {
            "Format": "mp4"
          },
          "Clip": {
            "TimeSpan": {
              "Seek": "01:59:59.999",
              "Duration": "01:00:59.999"
            }
          },
          "MergeConfigUrl": "https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8",
          "OpeningList": {
            "Opening": [
              {
                "openUrl": "http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4",
                "Start": "0",
                "Width": "-1",
                "Height": "-1"
              }
            ]
          },
          "MuxConfig": {
            "Webp": {
              "Loop": "0"
            },
            "Gif": {
              "FinalDelay": "0",
              "DitherMode": "bayer",
              "Loop": "0",
              "IsCustomPalette": "false"
            },
            "Segment": {
              "Duration": "20"
            }
          },
          "TailSlateList": {
            "TailSlate": [
              {
                "Start": "00000.00",
                "BgColor": "White",
                "IsMergeAudio": true,
                "Width": "-1",
                "Height": "-1",
                "BlendDuration": "0",
                "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
              }
            ]
          },
          "TemplateId": "S00000001-200010",
          "SubtitleConfig": {
            "ExtSubtitleList": {
              "ExtSubtitle": [
                {
                  "CharEnc": "auto",
                  "FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
                  "Input": {
                    "Object": "example-output.flv",
                    "Location": "oss-cn-hangzhou",
                    "Bucket": "example-bucket-****"
                  }
                }
              ]
            },
            "SubtitleList": {
              "Subtitle": [
                {
                  "Map": "0:a:0"
                }
              ]
            }
          },
          "Properties": {
            "Width": "720",
            "Height": "1280",
            "SourceLogos": {
              "SourceLogo": [
                {
                  "Source": "example"
                }
              ]
            },
            "Duration": "17",
            "Fps": "30",
            "Bitrate": "490",
            "FileFormat": "mp4",
            "Streams": {
              "VideoStreamList": {
                "VideoStream": [
                  {
                    "Index": "0",
                    "Timebase": "1/15360",
                    "AvgFPS": "30.0",
                    "PixFmt": "yuv420p",
                    "Sar": "1:1",
                    "Lang": "eng",
                    "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "Height": "1280",
                    "NumFrames": "30",
                    "Bitrate": "421.117",
                    "CodecTagString": "avc1",
                    "HasBFrames": "2",
                    "Profile": "high",
                    "StartTime": "0.000000",
                    "NetworkCost": {
                      "PreloadTime": "8",
                      "AvgBitrate": "300",
                      "CostBandwidth": "10"
                    },
                    "Dar": "9:16",
                    "CodecName": "h264",
                    "Width": "720",
                    "Duration": "17.233333",
                    "Fps": "30.0",
                    "CodecTag": "0x31637661",
                    "CodecTimeBase": "1/60",
                    "Level": "31",
                    "colorTransfer": "bt709",
                    "colorPrimaries": "bt709",
                    "bitsPerRawSample": "8"
                  }
                ]
              },
              "AudioStreamList": {
                "AudioStream": [
                  {
                    "Timebase": "1/32000",
                    "Index": "1",
                    "SampleFmt": "fltp",
                    "ChannelLayout": "mono",
                    "Lang": "und",
                    "Samplerate": "32000",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "Channels": "1",
                    "NumFrames": "50",
                    "Bitrate": "64.136",
                    "CodecTagString": "mp4",
                    "StartTime": "0.064000",
                    "CodecName": "aac",
                    "Duration": "17.223562",
                    "CodecTag": "0x6134706d",
                    "CodecTimeBase": "1/32000"
                  }
                ]
              },
              "SubtitleStreamList": {
                "SubtitleStream": [
                  {
                    "Index": "1",
                    "Lang": "eng"
                  }
                ]
              }
            },
            "Format": {
              "StartTime": "-0.064000",
              "NumPrograms": "0",
              "Size": "1057273",
              "NumStreams": "2",
              "FormatLongName": "QuickTime / MOV",
              "Duration": "17.234000",
              "Bitrate": "490.784",
              "FormatName": "mov"
            },
            "FileMd5": "ad195fd1317a761d4425232867759d1e",
            "FileSize": "1057273"
          },
          "MultiSpeedInfo": {
            "Enable": "true",
            "Code": "Boost.NotNeedSpeed",
            "Message": "success",
            "SettingSpeed": 30,
            "DowngradePolicy": "NormalSpeed",
            "RealSpeed": 6.576886940181647,
            "Duration": 21,
            "TimeCost": 3.193
          }
        },
        "PipelineId": "88c6ca184c0e47b665e2a1267971****",
        "Input": {
          "Object": "video_01.mp4",
          "Location": "oss-cn-shanghai",
          "Bucket": "exampleBucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The resource operated “%s” cannot be found.",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        },
        "SubmitTime": "2021-03-04T06:44:43Z"
      }
    ]
  }
}

エラーコード

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

変更履歴

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