このトピックでは、ワークフロータスク完了イベント、イベント通知の内容、およびコールバックの例について説明します。
イベントタイプ
WorkflowTaskComplete
イベントの説明
このイベントは、ワークフロー内のすべてのタスクが完了したときにトリガーされます。このイベントは、新しいバージョンのワークフローにのみ適用されます。
イベントの内容
パラメーター名 | タイプ | 必須 | 説明 |
EventType | String | はい | イベントタイプ。値は WorkflowTaskComplete に固定されています。 |
EventTime | String | はい | イベントが発生した時間。時間は UTC 形式 (yyyy-MM-ddTHH:mm:ssZ) です。 |
WorkflowId | String | はい | ワークフロー ID。 |
Status | String | はい | ワークフロータスクのステータス。
|
VideoId | String | はい | ビデオ ID。 |
TaskId | String | はい | タスク ID。 |
ActivityResults | String | はい | タスクノードの結果の詳細。これは JSON 文字列です。詳細については、以下のフィールドの説明をご参照ください。 |
TaskInput | String | はい | タスクの入力情報。これは JSON 文字列です。詳細については、以下のフィールドの説明をご参照ください。 |
CreateTime | String | はい | タスクが作成された時間。時間は UTC 形式 (yyyy-MM-ddTHH:mm:ssZ) です。 |
ModifiedTime | String | はい | タスクが最後に更新された時間。時間は UTC 形式 (yyyy-MM-ddTHH:mm:ssZ) です。 |
FinishTime | String | はい | タスクが完了した時間。時間は UTC 形式 (yyyy-MM-ddTHH:mm:ssZ) です。 |
UserId | String | はい | ユーザー ID。 |
ActivityResults は、ワークフロー内の各アクティビティノードの実行ステータスと結果を含む JSON 文字列です。各キー名 (ActivityId) は特定のワークフローノードインスタンスを表し、その値にはそのノードの実行詳細が含まれます。フィールドについては、次の表で説明します。
名前 | タイプ | 必須 | 例 |
Status | String | はい | Succeed |
StartTime | String | はい | 2025-10-15T01:50:30Z |
EndTime | String | はい | 2025-10-15T02:00:33Z |
ActivityId | String | はい | VideoTranslation |
ActivityInstanceId | String | はい | ce87026be902... |
Result | JSONObject | はい | { "Status": "Finished", "JobType": "VideoTranslation", "MediaId": "b0e8xxx281ed0102", "ModifiedTime": "2025-10-15T02:00:32Z", "UserData": "{\"VodSrc\":\"Workflow\"}", "CreateTime": "2025-10-15T01:50:30Z", "JobId": "0f5daxxxx4e5897f147" } |
TaskInput は、ワークフローをトリガーするための入力データとして機能する JSON 文字列です。処理対象のメディアファイルのメタデータとストレージの場所を指定します。フィールドについては、次の表で説明します。
名前 | タイプ | 必須 | 例 |
Type | String | はい | Media |
Media | String | はい | c066a7898e2c71f08b23752281edxxxx |
Title | String | はい | title-sample.mp4 |
StorageLocation | String | はい | sample-bucket.oss-cn-shanghai.aliyuncs.com |
コールバックの例
コールバックの例に関する注意:
HTTP コールバックの場合、次の内容は HTTP POST リクエストの本文です。
MNS コールバックの場合、次の内容はメッセージの本文です。
{
"Status": "Succeed",
"TaskId": "xxx",
"VideoId": "xxx",
"ActivityResults":"{\"VodSnapshot_53e77\":{\"ActivityId\":\"VodSnapshot\",\"ActivityInstanceId\":\"xxxx\",\"EndTime\":\"2025-04-01T02:29:50Z\",\"Result\":\"{\\\"RequestId\\\":\\\"xxx\\\",\\\"EventType\\\":\\\"SnapshotComplete\\\",\\\"UserId\\\":xxx,\\\"MessageBody\\\":{\\\"Status\\\":\\\"success\\\",\\\"VideoId\\\":\\\"xxx\\\",\\\"EventType\\\":\\\"SnapshotComplete\\\",\\\"EventTime\\\":\\\"2025-04-01T02:29:48Z\\\",\\\"TriggerSource\\\":\\\"{\\\\\\\"ActivityInstanceId\\\\\\\":\\\\\\\"xxx\\\\\\\",\\\\\\\"BizType\\\\\\\":\\\\\\\"ice-workflow\\\\\\\"}\\\"}}\",\"StartTime\":\"2025-04-01T02:29:46Z\",\"Status\":\"Succeed\"}}",
"TaskInput": "{\"Type\":\"Media\",\"Media\":\"xxx\",\"Title\":\"xxx\",\"StorageLocation\":\"xxx\"}",
"ModifiedTime": "2025-04-01T02:33:12Z",
"FinishTime": "2025-04-01T02:33:12Z",
"UserId": "xxx",
"CreateTime": "2025-04-01T02:29:43Z",
"WorkflowId": "xxx"
}