メディアワークフローを作成します。
操作説明
この操作を呼び出して、メディアワークフローのトポロジー、アクティビティ、および依存関係を定義できます。トポロジーはコンソール上で有向非循環グラフ(DAG)で表現されます。詳細については、「ワークフローのアクティビティ」をご参照ください。この操作を呼び出して作成したワークフローは、ApsaraVideo Media Processing (MPS) コンソールで確認および実行できます。
MPS のメディアワークフローは、ファイルパスのプレフィックスのみを使用して自動的にトリガーできます。ファイルパスのサフィックスによる自動トリガーはサポートされていません。トリガーに関するルールの詳細については、「ファイルのワークフロー自動トリガールール」をご参照ください。
1 秒あたりの API 呼び出し回数(QPS)制限
アカウント単位で、この API 操作を 1 秒間に最大 100 回まで呼び出すことができます。この制限を超えるリクエストは破棄され、サービス中断が発生します。この制限を意識して操作を実行することを推奨します。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:AddMediaWorkflow |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Name |
string |
必須 |
メディアワークフローの名前です。
|
mediaworkflow-example |
| Topology |
string |
必須 |
メディアワークフローのトポロジーです。アクティビティおよびアクティビティ間の依存関係を含む JSON オブジェクトを指定する必要があります。詳細については、本トピックの「トポロジーのサンプル」セクションをご参照ください。 説明
Object Storage Service (OSS) バケットは、ご利用の MPS サービスと同じリージョンに配置されている必要があります。 |
{"Activities": {"mediaworkflow-example": {"Parameters": {"Outputs": "[{\"OutputObject\":\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\",\"TemplateId\":\"S00000001-200010\",\"TemplateName\":\"MP4-流畅\"}]","OutputBucket": "examplebucket","OutputLocation": "oss-cn-shanghai"},"Type": "Transcode"},"Act-Start": {"Parameters": {"PipelineId": "a7d481f07d8c45da88c71853ce7d****","InputFile": "{\"Bucket\":\"example-input\",\"Location\":\"oss-cn-shanghai\",\"ObjectPrefix\":\"mps-test/input/\"}"},"Type": "Start"},"Act-Report": {"Parameters": {"PublishType": "Manual"},"Type": "Report"}},"Dependencies": {"mediaworkflow-example": ["Act-Report"],"Act-Start": ["mediaworkflow-example"],"Act-Report": []}} |
| TriggerMode |
string |
任意 |
メディアワークフローのトリガーモードです。有効な値は以下のとおりです。
|
OssAutoTrigger |
トポロジーのサンプル
Object Storage Service (OSS) バケットは、ご利用の MPS サービスと同じリージョンに配置されている必要があります。
{
"Activities": {
"mediaworkflow-example": {
"Parameters": {
"Outputs": "[{\"OutputObject\":\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\",\"TemplateId\":\"S00000001-200010\",\"TemplateName\":\"MP4-Low definition\"}]",
"OutputBucket": "examplebucket",
"OutputLocation": "oss-cn-shanghai"
},
"Type": "Transcode"
},
"Act-Start": {
"Parameters": {
"PipelineId": "a7d481f07d8c45da88c71853ce7d****",
"InputFile": "{\"Bucket\":\"example-input\",\"Location\":\"oss-cn-shanghai\",\"ObjectPrefix\":\"mps-test/input/\"}"
},
"Type": "Start"
},
"Act-Report": {
"Parameters": {
"PublishType": "Manual"
},
"Type": "Report"
}
},
"Dependencies": {
"mediaworkflow-example": ["Act-Report"],
"Act-Start": ["mediaworkflow-example"],
"Act-Report": []
}
}
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーターです。 |
||
| RequestId |
string |
リクエスト ID です。 |
F1D21261-ADB9-406A-1234-491382139D59 |
| MediaWorkflow |
object |
メディアワークフローの情報です。 |
|
| CreationTime |
string |
メディアワークフローが作成された時刻です。 |
016-04-01T05:29:37Z |
| MediaWorkflowId |
string |
メディアワークフローの ID です。今後のワークフロー操作で使用するため、この ID を記録しておくことを推奨します。 |
e00732b977da427d9177a4deb1aa**** |
| State |
string |
メディアワークフローの状態です。デフォルトでは、作成されたワークフローは Active 状態になります。 |
Active |
| TriggerMode |
string |
メディアワークフローのトリガーモードです。有効な値は以下のとおりです。
|
OssAutoTrigger |
| Name |
string |
メディアワークフローの名前です。 |
mediaworkflow-example |
| Topology |
string |
メディアワークフローのトポロジーです。アクティビティおよびアクティビティ間の依存関係を含む JSON オブジェクトが返されます。 |
{"Activities": {"mediaworkflow-example": {"Parameters": {"Outputs": "[{\"OutputObject\":\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\",\"TemplateId\":\"S00000001-200010\",\"TemplateName\":\"MP4-流畅\"}]","OutputBucket": "examplebucket","OutputLocation": "oss-cn-shanghai"},"Type": "Transcode"},"Act-Start": {"Parameters": {"PipelineId": "a7d481f07d8c45da88c71853ce7d****","InputFile": "{\"Bucket\":\"example-input\",\"Location\":\"oss-cn-shanghai\",\"ObjectPrefix\":\"mps-test/input/\"}"},"Type": "Start"},"Act-Report": {"Parameters": {"PublishType": "Manual"},"Type": "Report"}},"Dependencies": {"mediaworkflow-example": ["Act-Report"],"Act-Start": ["mediaworkflow-example"],"Act-Report": []}} |
例
成功レスポンス
JSONJSON
{
"RequestId": "F1D21261-ADB9-406A-1234-491382139D59",
"MediaWorkflow": {
"CreationTime": "016-04-01T05:29:37Z",
"MediaWorkflowId": "e00732b977da427d9177a4deb1aa****",
"State": "Active",
"TriggerMode": "OssAutoTrigger",
"Name": "mediaworkflow-example",
"Topology": "{\"Activities\": {\"mediaworkflow-example\": {\"Parameters\": {\"Outputs\": \"[{\\\"OutputObject\\\":\\\"examplebucket/output/{RunId}/TRANSCODE_165941222****/{FileName}\\\",\\\"TemplateId\\\":\\\"S00000001-200010\\\",\\\"TemplateName\\\":\\\"MP4-流畅\\\"}]\",\"OutputBucket\": \"examplebucket\",\"OutputLocation\": \"oss-cn-shanghai\"},\"Type\": \"Transcode\"},\"Act-Start\": {\"Parameters\": {\"PipelineId\": \"a7d481f07d8c45da88c71853ce7d****\",\"InputFile\": \"{\\\"Bucket\\\":\\\"example-input\\\",\\\"Location\\\":\\\"oss-cn-shanghai\\\",\\\"ObjectPrefix\\\":\\\"mps-test/input/\\\"}\"},\"Type\": \"Start\"},\"Act-Report\": {\"Parameters\": {\"PublishType\": \"Manual\"},\"Type\": \"Report\"}},\"Dependencies\": {\"mediaworkflow-example\": [\"Act-Report\"],\"Act-Start\": [\"mediaworkflow-example\"],\"Act-Report\": []}}"
}
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。