调用GetUrlUploadInfos获取URL上传信息_智能媒体服务(IMS)-阿里云帮助中心

调用GetURLUploadInfos获取URL上传信息。

接口说明

通过 URL 上传时返回的 JobId 或者上传时使用的 URL 来获取 URL 上传信息，包括 URL 上传状态、UserData、创建时间、完成时间等。

如果上传失败可以查看错误码和错误信息，上传成功可以查看对应的视频 ID。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
JobIds	string	否	上传任务 ID（JobId）列表。由一个或多个 JobId 组成，JobId 为通过 UploadMediaByURL 接口上传时，返回参数 JobId 的值。最多支持 10 个 ID。多个 ID 之间使用半角逗号（,）分隔。说明 JobIds 和 UploadURLs 必须指定一个，二者同时传入时只处理 JobIds。	df2ac80b481346daa1db6a7c40edc7f8
UploadURLs	string	否	上传视频源文件 URL 列表。多个 URL 之间使用半角逗号（,）分隔，最多支持 10 个。说明使用前，先进行 URL 编码。如果同一 URL 视频多次上传，建议传入单个 URL 进行查询。 JobIds 和 UploadURLs 必须指定一个，二者同时传入时只处理 JobIds。	https://media.w3.org/2010/05/sintel/trailer.mp4

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID	****11-DB8D-4A9A-875B-275798****
NonExists	array	不存在的 ID 或 URL 列表。
	string	不存在的 JobId 或 URL 列表。如果请求参数为 JobIds，返回值为 JobId；如果请求参数为 UploadURLs，返回值为 URL。	['e3e71ae8e4a46e4893d8cadce50c3bd0']
URLUploadInfoList	object []	URL 上传信息详情。
CreationTime	string	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2021-11-07T10:03:37Z
Status	string	URL 拉取任务状态。具体的拉取状态取值及说明，请参见Status：URL 上传任务状态。	Normal
ErrorMessage	string	错误信息。	Success
ErrorCode	string	错误码。	200
CompleteTime	string	完成时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2021-11-26 21:47:37
JobId	string	上传任务 ID。	3829500c0fef429fa4ec1680b122d***
UserData	string	自定义设置。为 JSON 字符串。	{"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}
UploadURL	string	上传视频源文件 URL。说明最多可以返回 100 条记录。	http://****.mp4
MediaId	string	上传视频 ID。	5014ca70f08171ecbf940764a0fd6***
FileSize	string	文件大小。单位：字节。	64610

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "NonExists": [
    "['e3e71ae8e4a46e4893d8cadce50c3bd0']"
  ],
  "URLUploadInfoList": [
    {
      "CreationTime": "2021-11-07T10:03:37Z",
      "Status": "Normal",
      "ErrorMessage": "Success",
      "ErrorCode": "200",
      "CompleteTime": "2021-11-26 21:47:37",
      "JobId": "3829500c0fef429fa4ec1680b122d***",
      "UserData": "{\"MessageCallback\":\"{\"CallbackURL\":\"http://example.aliyundoc.com\"}\", \"Extend\":\"{\"localId\":\"***\", \"test\":\"www\"}\"}",
      "UploadURL": "http://****.mp4",
      "MediaId": "5014ca70f08171ecbf940764a0fd6***",
      "FileSize": "64610"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史