首页 >视频点播 >API参考指南 >API目录 >媒体上传 >GetURLUploadInfos - 获取URL上传信息

GetURLUploadInfos - 获取URL上传信息

调用GetURLUploadInfos获取URL上传信息。

接口说明

使用说明

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

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

QPS限制

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

调试

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

调试

授权信息

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

请求参数

名称类型必填描述示例值
JobIdsstring

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

  • 最多支持10个ID。
  • 多个ID之间使用半角逗号(,)分隔。
说明JobIds和UploadURLs必须指定一个,二者同时传入时只处理JobIds。
86c1925fba0****,7afb201e7fa****,2cc4997378****
UploadURLsstring

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

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

    返回参数

    名称类型描述示例值
    object

    返回结果。

    RequestIdstring

    请求ID。

    25818875-5F78-4AF6-D7393642CA58****
    NonExistsarray

    不存在的ID或URL列表。

    string

    不存在的ID或URL列表。

    ["****1", "****2"]
    URLUploadInfoListarray

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

    object

    URL上传信息详情。

    CreationTimestring

    创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

    2019-01-01T01:01:01Z
    Statusstring

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

    SUCCESS
    ErrorMessagestring

    错误信息。

    error_message
    ErrorCodestring

    错误码。

    200
    CompleteTimestring

    完成时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

    2019-01-01T01:11:01Z
    JobIdstring

    上传任务ID。

    86c1925fba0****
    UserDatastring

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

    {"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}
    UploadURLstring

    上传视频源文件URL。

    说明最多可以返回100条记录。
    http://****.mp4
    MediaIdstring

    上传视频ID。

    93ab850b4f6f54b6e91d24d81d4****
    FileSizestring

    文件大小。单位:字节。

    24

    示例

    请求示例

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

    正常返回示例

    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"
            }
        ]
    }

    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>

    错误码

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

    阿里云首页 视频点播 相关技术圈