调用该接口查询本地录像上传任务结果。

调试

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

请求参数

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

系统规定参数。取值:QueryLocalFileUploadJob。

JobId String 1ec1a****5d0435fbc0****34f6f139d

本地录像上传任务ID。通过CreateLocalFileUploadJob创建。

IotInstanceId String iot-cn-n6w1y59****

实例ID。

您可在物联网平台控制台的实例概览页面,查看当前实例的ID。若有ID值,必须传入该ID值,否则调用会失败。

说明 如果公共实例没有ID值,请参见如何获取实例ID

返回数据

名称 类型 示例值 描述
Code String 200

接口返回码:

  • 200:表示成功。
  • 其它:表示错误码。错误码详情,请参见错误码
Data Struct

查询结果。

ResultList Array of ResultList

任务列表。

Code Integer 9201

录像上传任务状态码:

  • 200:正常。
  • 9201 :设备不在线。请上线设备后重试。
  • 9409 :无云存储配额。请检查云存储配额后重试。
  • 9417:设备、网络或其它异常。请您重试,或检查设备和网络状态。
  • 9435 :录像文件不存在。请确保视频设备本地存证录像文件,然后重试。
DeviceName String gb_hik_IPC

视频设备的设备名称。

FileList Array of FileList

录像文件列表。

FileEndTime Integer 1634746054

录像文件结束时间。

FileName String video1

录像文件名。

FileStartTime Integer 1634747054

录像文件开始时间。

IotId String IQ9mO4tvMnAj****QUdcg2n400

视频设备的设备ID。物联网平台为该设备颁发的ID,设备的唯一标识符。

ProductKey String g2****Q6ggK

视频设备所属产品的ProductKey。

SlotEndTime Integer 1634746054

录像上传任务结束时间。

SlotStartTime Integer 1634745754

录像上传任务开始时间。

SlotStatus Integer 3

SlotStartTimeSlotEndTime的时间段内,录像上传任务的执行状态:

  • 0:任务初始化中。
  • 1:任务执行中。
  • 2:任务执行完成。
  • 3:任务执行异常。
  • 4:任务主动结束。
Status Integer 2

录像上传任务状态:

  • 0:任务初始化中。
  • 1:任务执行中。
  • 2:任务执行完成。
ErrorMessage String tenant auth error

调用失败时,返回的出错信息。

RequestId String 449ECE75-A36A-4ACE-B253-147C78C440C5

阿里云为该请求生成的唯一标识符。

Success Boolean true

是否调用成功:

  • true:调用成功。
  • false:调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=QueryLocalFileUploadJob
&JobId=1ec1a****5d0435fbc0****34f6f139d
&<公共请求参数>

正常返回示例

XML格式

<QueryLocalFileUploadJobResponse>
  <RequestId>F9220B6D-E9BD-166E-B103-22ECF0B64393</RequestId>
  <Data>
        <Status>2</Status>
        <ResultList>
              <IotId>IQ9mO4tvM****kQRQUdcg2n400</IotId>
              <SlotStartTime>1634745754</SlotStartTime>
              <FileList>
                    <FileEndTime>1634746054</FileEndTime>
                    <FileName>video1</FileName>
                    <FileStartTime>1634747054</FileStartTime>
              </FileList>
              <SlotStatus>3</SlotStatus>
              <SlotEndTime>1634746054</SlotEndTime>
              <Code>200</Code>
              <ProductKey>g2n4DLQ6ggK</ProductKey>
              <DeviceName>gb_hik_IPC</DeviceName>
        </ResultList>
        <ResultList>
              <IotId>kIDFJy49n****aSSxtqvg2n400</IotId>
              <SlotStartTime>1634745754</SlotStartTime>
              <SlotStatus>3</SlotStatus>
              <SlotEndTime>1634746054</SlotEndTime>
              <Code>9201</Code>
              <ProductKey>g2n4DLQ6ggK</ProductKey>
              <DeviceName>hik_nvr_39_IPC</DeviceName>
        </ResultList>
        <ResultList>
              <IotId>JWNQ5oTFzU5****BJZKJg2n400</IotId>
              <SlotStartTime>1634745754</SlotStartTime>
              <SlotStatus>3</SlotStatus>
              <SlotEndTime>1634752834</SlotEndTime>
              <Code>9201</Code>
              <ProductKey>g2n4DLQ6ggK</ProductKey>
              <DeviceName>hik_nvr_33_</DeviceName>
        </ResultList>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</QueryLocalFileUploadJobResponse>

JSON格式

{
    "RequestId": "F9220B6D-E9BD-166E-B103-22ECF0B64393",
    "Data": {
        "Status": 2,
        "ResultList": [
            {
                "IotId": "IQ9mO4tvM****kQRQUdcg2n400",
                "SlotStartTime": 1634745754,
                "FileList": [
                    {
                        "FileEndTime": "1634746054",
                        "FileName": "video1",
                        "FileStartTime": "1634747054"
                    }
                ],
                "SlotStatus": 3,
                "SlotEndTime": 1634746054,
                "Code": 200,
                "ProductKey": "g2n4DLQ6ggK",
                "DeviceName": "gb_hik_IPC"
            },
            {
                "IotId": "kIDFJy49n****aSSxtqvg2n400",
                "SlotStartTime": 1634745754,
                "FileList": [],
                "SlotStatus": 3,
                "SlotEndTime": 1634746054,
                "Code": 9201,
                "ProductKey": "g2n4DLQ6ggK",
                "DeviceName": "hik_nvr_39_IPC"
            },
            {
                "IotId": "JWNQ5oTFzU5****BJZKJg2n400",
                "SlotStartTime": 1634745754,
                "FileList": [],
                "SlotStatus": 3,
                "SlotEndTime": 1634752834,
                "Code": 9201,
                "ProductKey": "g2n4DLQ6ggK",
                "DeviceName": "hik_nvr_33_"
            }
        ]
    },
    "Code": "200",
    "Success": true
}

错误码

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