获取NVR设备信息。

调试

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

请求参数

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

系统规定参数。取值：DescribeNvrs。

PageNum Long 是 1

分页编码
PageSize Long 是 5

分页条数设定，最大200
NvrDeviceIdList String 否 1372771321890****

所要查看的NVR设备的国标编码；多个之间用逗号分隔。
CorpIdList String 否 323153238989734****

所要查看的设备所属的项目ID；多个之间用逗号分隔。
DeviceFilter String 否 100001****

设备名称或编号，用来模糊搜索

返回数据

名称 类型 示例值 描述
RequestId String 46329898-489C-4E63-9BA1-C1DA5C5D0986

请求ID
Code String 200

返回结果编码
Message String Success

返回结果消息
Data Object

返回结果数据
TotalCount Long 32

设备总数量
TotalPage Long 4

分页总数量
PageNum Long 1

返回第几个分页
PageSize Long 10

分页大小
Records Array of Record

返回结果数据
CorpId String 323153238989734****

项目ID
ServerId String 330100990120****

设备接入的服务编码，接入协议为GB28181时表示服务器国标ID
ServerIp String 192.168.XX.XX

设备接入的服务器IP
ServerRealm String 2021****

接入服务器的域名，目前仅在国标协议中有效，您需要将其填写到设备页面中
ServerPort String 5060

设备接入的服务器端口
DeviceId String 3301220100200000**********

NVR设备国标编码
Password String ******

设备接入服务器的密码
DeviceName String 某公司门口

所注册的设备的名称
DeviceAddress String 某地市

设备地址
Longitude String 116.397128

经度
Latitude String 39.916527

纬度
Vendor String 阿里云

设备产商
DeviceType String NVR

所注册的设备的类型：IPC、NVR、ABox（该类型为阿里云定制ACube系列类型）
InProtocol String GBT28181

设备接入协议，比如GBT28181
DeviceSn String a2374ea48186****

设备唯一编码（SN码），快速上云方式注册回传的设备SN号，普通注册无
DatasourceType String VIDEO

数据源类型：VIDEO（IPC、NVR通用数据类型）、PIC_VIDEO（阿里云定制ACube系列的数据类型）
DeviceStatus String 1

设备在线状态：1表示在线，0表示离线， 2表示待注册
SubDeviceCount String 8

子设备数量
SubDeviceInfo Array of SubDeviceInfo

子设备信息列表
SubDeviceId String 33011012011327999****

子设备ID
CreateTime String 2021-08-26T12:31:22

设备创建时间
ModifyTime String 2021-08-26T12:31:22

设备修改时间
DeviceModel String ACube200-8

设备型号

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeNvrs
&PageNum=1
&PageSize=5
&NvrDeviceIdList=1372771321890****
&CorpIdList=323153238989734****
&DeviceFilter=100001****
&公共请求参数

正常返回示例

XML格式 

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

<DescribeNvrsResponse>
    <RequestId>46329898-489C-4E63-9BA1-C1DA5C5D0986</RequestId>
    <Code>200</Code>
    <Message>Success</Message>
    <Data>
        <TotalCount>32</TotalCount>
        <TotalPage>4</TotalPage>
        <PageNum>1</PageNum>
        <PageSize>10</PageSize>
        <Records>
        	<Record>
            <CorpId>323153238989734****</CorpId>
            <ServerId>330100990120****</ServerId>
            <ServerIp>192.168.XX.XX</ServerIp>
            <ServerRealm>2021****</ServerRealm>
            <ServerPort>5060</ServerPort>
            <DeviceId>3301220100200000**********</DeviceId>
            <Password>******</Password>
            <DeviceName>某公司门口</DeviceName>
            <DeviceAddress>某地市</DeviceAddress>
            <Longitude>116.397128</Longitude>
            <Latitude>39.916527</Latitude>
            <Vendor>阿里云</Vendor>
            <DeviceType>NVR</DeviceType>
            <InProtocol>GBT28181</InProtocol>
            <DeviceSn>a2374ea48186****</DeviceSn>
            <DatasourceType>VIDEO</DatasourceType>
            <DeviceStatus>1</DeviceStatus>
            <SubDeviceCount>8</SubDeviceCount>
            <SubDeviceInfo>
                <SubDeviceId>33011012011327999****</SubDeviceId>
            </SubDeviceInfo>
            <CreateTime>2021-08-26T12:31:22</CreateTime>
            <ModifyTime>2021-08-26T12:31:22</ModifyTime>
            <DeviceModel>ACube200-8</DeviceModel>
        	</Record>
        </Records>
    </Data>
</DescribeNvrsResponse>

JSON格式 

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

{
  "RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
  "Code" : "200",
  "Message" : "Success",
  "Data" : {
    "TotalCount" : 32,
    "TotalPage" : 4,
    "PageNum" : 1,
    "PageSize" : 10,
    "Records" : [ {
      "CorpId" : "323153238989734****",
      "ServerId" : "330100990120****",
      "ServerIp" : "192.168.XX.XX",
      "ServerRealm" : "2021****",
      "ServerPort" : "5060",
      "DeviceId" : "3301220100200000**********",
      "Password" : "******",
      "DeviceName" : "某公司门口",
      "DeviceAddress" : "某地市",
      "Longitude" : "116.397128",
      "Latitude" : "39.916527",
      "Vendor" : "阿里云",
      "DeviceType" : "NVR",
      "InProtocol" : "GBT28181",
      "DeviceSn" : "a2374ea48186****",
      "DatasourceType" : "VIDEO",
      "DeviceStatus" : "1",
      "SubDeviceCount" : "8",
      "SubDeviceInfo" : [ {
        "SubDeviceId" : "33011012011327999****"
      } ],
      "CreateTime" : "2021-08-26T12:31:22",
      "ModifyTime" : "2021-08-26T12:31:22",
      "DeviceModel" : "ACube200-8"
    } ]
  }
}

错误码

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