GetUrlUploadInfos - 获取URL上传信息

调用GetURLUploadInfos获取URL上传信息。

接口说明

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

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

调试

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

调试

授权信息

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

请求参数

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

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

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

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

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

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求ID

    ******11-DB8D-4A9A-875B-275798******
    NonExistsarray

    不存在的ID或URL列表。

    string

    不存在的JobId或URL列表。

    如果请求参数为JobIds,返回值为JobId;如果请求参数为UploadURLs,返回值为URL。

    ['e3e71ae8e4a46e4893d8cadce50c3bd0']
    URLUploadInfoListarray

    URL上传信息详情。

    object

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

    CreationTimestring

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

    2021-11-07T10:03:37Z
    Statusstring

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

    Normal
    ErrorMessagestring

    错误信息。

    Success
    ErrorCodestring

    错误码。

    200
    CompleteTimestring

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

    2021-11-26 21:47:37
    JobIdstring

    上传任务ID。

    3829500c0fef429fa4ec1680b122d***
    UserDatastring

    自定义设置。为JSON字符串。

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

    上传视频源文件URL。

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

    上传视频ID。

    5014ca70f08171ecbf940764a0fd6***
    FileSizestring

    文件大小。单位:字节。

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

    错误码

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

    阿里云首页 智能媒体生产 相关技术圈