调用GetEditingJobInfo查询剪辑任务信息。

使用说明

本接口支持查询指定CasterId和ShowId剪辑任务的相关信息,调用时请保证参数设置符合要求。

如果您配置请求参数ShowId,接口返回数据为节目单中指定ShowId对应的节目剪辑任务信息。

如果您未配置请求参数ShowId,接口返回数据为整个节目单的剪辑任务信息。

QPS限制

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

调试

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

请求参数

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

系统规定参数,取值:GetEditingJobInfo

CasterId String 53200b81-b761-4c10-842a-a0726d97****

需要查询的导播台ID。

  • 如果您通过CreateCaster接口创建导播台,请查看CreateCaster接口调用返回的参数CasterId值。
  • 如果您通过直播控制台创建导播台,请通过直播控制台 > 导播台 > 云导播台页面查看。
说明 直播控制台云导播台页面导播台列表中的导播台名称即导播台ID。
ShowId String 72200b81-b761-4c10-842a-a0726d97****

需要查询的节目ID。

说明 通过查看AddShowIntoShowList接口的返回参数获取ShowId值。

返回数据

名称 类型 示例值 描述
CasterId String 53200b81-b761-4c10-842a-a0726d97****

导播台ID。

EditingTasksInfo String "EditingTasksInfo": { "OutputVodId": "3e34733b40b9a96ccf5c1ff6f69****", "TaskStatus": 1, "StorageInfo": { "StorageLocation": "***bucket***", "FileName": "EditFile****" }, "ShowId": "42200b81-b761-4c10-842a-a0726d97****" },

剪辑任务信息。包含:

  • OutputVodId:输出的Vod文件ID。
  • TaskStatus:剪辑任务状态。(-1:失败;0:任务初始化;1:剪辑中;2:上传中;3:任务成功。)
  • StorageLocation:点播存储地址。
  • FileName:剪辑文件名。
  • ShowId:节目ID。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=GetEditingJobInfo
&CasterId=53200b81-b761-4c10-842a-a0726d97****
&<公共请求参数>

正常返回示例

XML格式

<GetEditingJobInfoResponse>
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  <EditingTasksInfo>
        <OutputVodId>3e34733b40b9a96ccf5c1ff6f69****</OutputVodId>
        <TaskStatus>1</TaskStatus>
        <StorageInfo>
              <StorageLocation>***bucket***</StorageLocation>
              <FileName>EditFile****</FileName>
        </StorageInfo>
        <ShowId>42200b81-b761-4c10-842a-a0726d97****</ShowId>
  </EditingTasksInfo>
  <CasterId>53200b81-b761-4c10-842a-a0726d97****</CasterId>
</GetEditingJobInfoResponse>

JSON格式

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
    "EditingTasksInfo": {
        "OutputVodId": "3e34733b40b9a96ccf5c1ff6f69****",
        "TaskStatus": 1,
        "StorageInfo": {
            "StorageLocation": "***bucket***",
            "FileName": "EditFile****"
        },
        "ShowId": "42200b81-b761-4c10-842a-a0726d97****"
    },
    "CasterId": "53200b81-b761-4c10-842a-a0726d97****"
}

错误码

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