调用GetURLUploadInfos获取URL上传信息。

使用说明

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

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

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 GetURLUploadInfos

系统规定参数。取值：GetURLUploadInfos。

JobIds String 否 86c1925fba0****,7afb201e7fa****,2cc4997378****

上传任务ID（JobId）列表。由一个或多个JobId组成，JobId为通过UploadMediaByURL接口上传时，返回参数JobId的值。

  • 最多支持10个ID。
  • 多个ID之间使用半角逗号（,）分隔。
说明 JobIds和UploadURLs必须指定一个，二者同时传入时只处理JobIds。
UploadURLs String 否 http://****.mp4

上传视频源文件URL列表。多个URL之间使用半角逗号（,）分隔，最多支持10个。

说明
  • 使用前，先进行URL编码。
  • 如果同一URL视频多次上传，建议传入单个URL进行查询。
  • JobIds和UploadURLs必须指定一个，二者同时传入时只处理JobIds。

返回数据

名称 类型 示例值 描述
RequestId String 25818875-5F78-4AF6-D7393642CA58****

请求ID。
NonExists Array of String ["****1", "****2"]

不存在的ID或URL列表。
URLUploadInfoList Array of UrlUploadJobInfoDTO

URL上传信息列表。具体上传名称及描述，请参见URLUploadInfo：URL上传信息。

CreationTime String 2019-01-01T01:01:01Z

创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

Status String SUCCESS

URL拉取任务状态。具体的拉取状态取值及说明，请参见Status：URL上传任务状态。

ErrorMessage String error_message

错误信息。
ErrorCode String 200

错误码。
CompleteTime String 2019-01-01T01:11:01Z

完成时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

JobId String 86c1925fba0****

上传任务ID。
UserData String {"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}

自定义设置。为JSON字符串。更多信息，请参见UserData。

UploadURL String http://****.mp4

上传视频源文件URL。

说明 最多可以返回100条记录。
MediaId String 93ab850b4f6f54b6e91d24d81d4****

上传视频ID。
FileSize String 24

文件大小。单位：字节。

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetURLUploadInfos
&JobIds=86c1925fba0****,7afb201e7fa****,2cc4997378****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<GetURLUploadInfosResponse>
    <RequestId>25818875-5F78-4AF6-D7393642CA58****</RequestId>
    <NonExists>["****1", "****2"]</NonExists>
    <URLUploadInfoList>
      <UrlUploadJobInfoDTO>
        <CreationTime>2019-01-01T01:01:01Z</CreationTime>
        <Status>SUCCESS</Status>
        <ErrorMessage>error_message</ErrorMessage>
        <ErrorCode>200</ErrorCode>
        <CompleteTime>2019-01-01T01:11:01Z</CompleteTime>
        <JobId>86c1925fba0****</JobId>
        <UserData>{"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}</UserData>
        <UploadURL>http://****.mp4</UploadURL>
        <MediaId>93ab850b4f6f54b6e91d24d81d4****</MediaId>
        <FileSize>24</FileSize>
      </UrlUploadJobInfoDTO>
    </URLUploadInfoList>
</GetURLUploadInfosResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4AF6-D7393642CA58****",
  "NonExists" : [ "[\"****1\", \"****2\"]" ],
  "URLUploadInfoList" : [ {
    "CreationTime" : "2019-01-01T01:01:01Z",
    "Status" : "SUCCESS",
    "ErrorMessage" : "error_message",
    "ErrorCode" : "200",
    "CompleteTime" : "2019-01-01T01:11:01Z",
    "JobId" : "86c1925fba0****",
    "UserData" : "{\"MessageCallback\":\"{\"CallbackURL\":\"http://example.aliyundoc.com\"}\", \"Extend\":\"{\"localId\":\"***\", \"test\":\"www\"}\"}",
    "UploadURL" : "http://****.mp4",
    "MediaId" : "93ab850b4f6f54b6e91d24d81d4****",
    "FileSize" : "24"
  } ]
}

错误码

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