文档

查询边缘转码任务详情

调用GetEdgeTranscodeJob查询边缘转码任务详情。

使用说明

用户需要具有访问边缘转码服务的权限,才能正常调用本接口。

QPS限制

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

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String GetEdgeTranscodeJob

系统规定参数。取值:GetEdgeTranscodeJob

ClusterId String ******3b-4d18-395c-8106-ff21a6******

机房ID。

JobId String ****20b48fb04483915d4f2cd8ac****

边缘转码任务ID。

返回数据

名称

类型

示例值

描述

Job Object

边缘转码任务。

CreateTime String 2023-07-24T16:44:55Z

任务创建时间。

JobId String ****20b48fb04483915d4f2cd8ac****

任务ID。

LastStartAt String 2023-07-25T02:48:58Z

任务上一次启动的时间。

LastStopAt String 2023-07-25T05:48:58Z

任务上一次停止的时间。

Name String my_job

任务名称。

Status String 0

转码任务状态,枚举:

  • 0 未启动。
  • 1 运行中。
StreamInput String rtmp://mydomain/app/stream1

输入流地址。

StreamOutput String rtmp://testdomain/app/stream2

输出流地址。

TemplateId String 9b1571b513cb44f7a1ba6ae561ff****

任务使用的边缘转码模板ID。

TemplateName String my_template

任务使用的边缘转码模板名。

Type String common

边缘转码类型,枚举:

  • common,通用(普通+窄带高清1.0)。
  • nbhd-2,窄带高清2.0。
  • ultra-hd,超高清。
RequestId String ******3B-0E1A-586A-AC29-742247******

请求ID。

示例

请求示例

http(s)://[live.aliyuncs.com]/?Action=GetEdgeTranscodeJob
&ClusterId=******3b-4d18-395c-8106-ff21a6******
&JobId=****20b48fb04483915d4f2cd8ac****
&公共请求参数

正常返回示例

XML格式

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

<GetEdgeTranscodeJobResponse>
    <Job>
        <CreateTime>2023-07-24T16:44:55Z</CreateTime>
        <JobId>****20b48fb04483915d4f2cd8ac****</JobId>
        <LastStartAt>2023-07-25T02:48:58Z</LastStartAt>
        <LastStopAt>2023-07-25T05:48:58Z</LastStopAt>
        <Name>my_job</Name>
        <Status>0</Status>
        <StreamInput>rtmp://mydomain/app/stream1</StreamInput>
        <StreamOutput>rtmp://testdomain/app/stream2</StreamOutput>
        <TemplateId>9b1571b513cb44f7a1ba6ae561ff****</TemplateId>
        <TemplateName>my_template</TemplateName>
        <Type>common</Type>
    </Job>
    <RequestId>******3B-0E1A-586A-AC29-742247******</RequestId>
</GetEdgeTranscodeJobResponse>

JSON格式

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

{
  "Job" : {
    "CreateTime" : "2023-07-24T16:44:55Z",
    "JobId" : "****20b48fb04483915d4f2cd8ac****",
    "LastStartAt" : "2023-07-25T02:48:58Z",
    "LastStopAt" : "2023-07-25T05:48:58Z",
    "Name" : "my_job",
    "Status" : "0",
    "StreamInput" : "rtmp://mydomain/app/stream1",
    "StreamOutput" : "rtmp://testdomain/app/stream2",
    "TemplateId" : "9b1571b513cb44f7a1ba6ae561ff****",
    "TemplateName" : "my_template",
    "Type" : "common"
  },
  "RequestId" : "******3B-0E1A-586A-AC29-742247******"
}

错误码

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