このトピックでは、トランスコードされたストリームがアップロードされた後に生成されるUploadByURLCompleteイベントの通知内容とサンプルコールバックについて説明します。
イベントタイプ
UploadByURLComplete
UploadByURLCompleteイベントは、URLを使用してトランスコードされたストリームまたはビデオをアップロードした後に生成されます。 ただし、URLを使用してトランスコードされたストリームをアップロードすると、FileTypeパラメーターとStreamFileURLパラメーターがイベントに追加されます。 詳細については、「UploadByURLComplete (ビデオのアップロードの場合) 」をご参照ください。
イベントの説明
UploadByURLCompleteイベントは、トランスコードされたストリームがUploadStreamByURL操作を呼び出してアップロードされた後に生成されます。
イベント通知コンテンツ
パラメーター | タイプ | 必須 | 説明 |
EventTime | String | 必須 | イベントが生成された時刻。 時刻はyyyy-MM-ddTHH:mm:ssZ形式でUTCで表示されます。 |
EventType | String | 必須 | イベントタイプ。 値はUploadByURLCompleteです。 |
VideoId | String | 必須 | トランスコードされたストリームが追加されるビデオのID。 |
JobId | String | 必須 | コード変換ジョブのID。 |
SourceURL | String | 必須 | ソースファイルのURL。 |
FileType | String | 必須 | アップロードされたストリームのファイルタイプ。 有効値: Stream。 |
Status | String | 必須 | トランスコードされたストリームがアップロードされるかどうかを示します。 有効な値:
|
StreamFileURL | String | 任意 | OSSオブジェクトのURL。 このパラメーターは、トランスコードされたストリームがアップロードされるときに使用できます。 |
ErrorCode | String | 任意 | エラーコードを示します。 このパラメーターは、アップロード中にエラーが発生した場合に使用できます。 |
エラーメッセージ | String | 任意 | エラーメッセージを示します。 このパラメーターは、アップロード中にエラーが発生した場合に使用できます。 |
拡張 | String | 任意 | コールバックのパススルーモードで返されるユーザー定義パラメーター。 詳細は、「リクエストパラメーター」をご参照ください。 |
サンプルコールバック
説明:
HTTPコールバックの場合、次の例はHTTP POSTリクエストのボディです。
MNSコールバックの場合、次の例はメッセージ本文です。
次のサンプルコードは、アップロードが成功したことを示します。
{ "Status":"success", "SourceURL":"https://example.com/record/live/03/2021-09-17-14-06-35_2021-09-17-14-07-29", "VideoId":"0a389969855b438a9eb2a1d1efc0****", "EventType":"UploadByURLComplete", "FileType":"Stream", "EventTime":"2021-12-21T04:04:01Z", "StreamFileURL":"http://outin-31059bcee78111eaa0a200163e1c****.oss-cn-shanghai.aliyuncs.com/0a389969855b438a9eb2a1d1efc0cb9f/5d018d2bc9400d1831f9868a04e4a5f****.flv", "JobId":"5d018d2bc9400d1831f9868a04e4****" }
次のサンプルコードは、アップロードが失敗したことを示します。
{ "Status":"fail", "SourceURL":"https://example.com/record/live/03/2021-09-17-14-06-35_2021-09-17-14-07", "VideoId":"0a389969855b438a9eb2a1d1efc0****", "EventType":"UploadByURLComplete", "FileType":"Stream", "EventTime":"2021-12-21T04:05:33Z", "ErrorCode":"Fail", "ErrorMessage":"download status code = 404", "JobId":"c0b543f9347452c4d3e220ef3495****" }