云服务器内容精选

  • 响应示例 { "status" : 1, "message" : "SUCCESS", "error" : null, "data" : [{ "groupId" : 113117, "groupName" : "Test群组" }, { "groupId" : 100000, "groupName" : "默认群组" } ], "timestamp" : "2022-09-06T17:39:33.270+0800" }
  • 请求参数 参数 类型 是否必填 描述 page Object 否 分页参数 start Integer 否 当前页码 分页参数,page子项 count Integer 否 每页条数 分页参数,page子项 deviceId String 否 设备编码 isdpDeviceId String 否 设备唯一键 多个通过英文逗号分隔,最多200个 deviceName String 否 设备名称 coordType String 否 坐标系类型 可选值WGS84或GCJ02或BD09,不填默认WGS84 projectName String 否 项目名称 projectNumber String 否 项目编码 groupId Long 否 群组Id groupName String 否 群组名称 deviceUserId Long 否 设备使用Id deviceUserName String 否 设备使用人名称 ownnerName String 否 设备责任人名称 deviceState String 否 设备状态 可选值ONLINE/OFFLINE/UNALLOCATED/MEETING/MULTI_MEETING 多个以英文逗号分隔,不传默认查询所有 orgId Long 否 组织Id
  • 响应参数 参数 类型 描述 status Int 响应状态,1标识成功,否则不成功 message String 响应信息,SUCCESS标识成功,否则失败 error String 错误信息,接口错误时有值,正常调用时为空 data object 响应消息体 groupId Long 群组Id,data子项 groupName String 群组名称,data子项 timestamp Date 响应时间
  • 响应参数 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码 最小长度:0 最大长度:64 error_msg String 错误描述 最小长度:0 最大长度:200 request_id String 消息ID 最小长度:0 最大长度:64 状态码: 404 表5 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码 最小长度:0 最大长度:64 error_msg String 错误描述 最小长度:0 最大长度:200 request_id String 消息ID 最小长度:0 最大长度:64 状态码: 500 表6 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码 最小长度:0 最大长度:64 error_msg String 错误描述 最小长度:0 最大长度:200 request_id String 消息ID 最小长度:0 最大长度:64
  • 响应示例 状态码: 400 Bad Request { "error_code" : "SCB.00000000", "error_msg" : "Parameter is not valid for operation [romalink.link-device-groups.addDeviceIntoGroup]. Parameter is [batchRequest]. Processor is [body].", "request_id" : "cb39e78a-afd3-4e04-901d-70468b1c23dc-1619602712496-cnnorth7a-P-romalink-service01" } 状态码: 404 Not Found { "error_code" : "ROMA.00110006", "error_msg" : "The resource does not exist. Check whether the resource ID 1 is correct.", "request_id" : "624c8be1-39b6-47b7-941d-c159aced368a-1619602544650-cnnorth7a-P-romalink-service01" } 状态码: 500 Internal Server Error { "error_code" : "ROMA.00110002", "error_msg" : "The instance does not exist. project_id: 397cd10b30544c588b2f4a56d83856c4, instance_id: f3bb386a-23ec-47aa-9943-4c60ac658611", "request_id" : "c8c06d0a-be92-4fdf-9d10-bc20131ab158-1619593104919-cnnorth7a-P-romalink-service01" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:100000 表3 请求Body参数 参数 是否必选 参数类型 描述 resources 是 Array of integers 设备ID列表,自动向下取整 最小值:1 最大值:9999999999999999999 数组长度:0 - 9999
  • 响应示例 状态码: 200 OK { "size" : 1, "items" : [ { "id" : 14, "name" : "group_name", "parent_id" : 0, "children" : [ ] } ] } 状态码: 400 Bad Request { "error_code" : "SCB.00000000", "error_msg" : "Parameter is not valid for operation [romalink.link-device-groups.selectGroupNodeTree]. Parameter is [app_id]. Processor is [query].", "request_id" : "cb39e78a-afd3-4e04-901d-70468b1c23dc-1619602712496-cnnorth7a-P-romalink-service01" } 状态码: 404 Not Found { "error_code" : "SCB.00000000", "error_msg" : "Not Found", "request_id" : "624c8be1-39b6-47b7-941d-c159aced368a-1619602544650-cnnorth7a-P-romalink-service01" } 状态码: 500 Internal Server Error { "error_code" : "ROMA.00110002", "error_msg" : "The instance does not exist. project_id: 397cd10b30544c588b2f4a56d83856c4, instance_id: f3bb386a-23ec-47aa-9943-4c60ac658611", "request_id" : "c8c06d0a-be92-4fdf-9d10-bc20131ab158-1619593104919-cnnorth7a-P-romalink-service01" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 size Integer 本次返回数量 最小值:1 最大值:9999 items Array of GroupTreeResponse objects 设备分组信息 数组长度:0 - 9999 表5 GroupTreeResponse 参数 参数类型 描述 id Integer 分组id 最小值:1 最大值:99999999 name String 分组名称 最小长度:0 最大长度:200 parent_id Integer 父分组id 最小值:1 最大值:99999999 children Array of GroupTreeResponse objects 子分组 数组长度:0 - 9999 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码 最小长度:0 最大长度:64 error_msg String 错误描述 最小长度:0 最大长度:200 request_id String 消息ID 最小长度:0 最大长度:64 状态码: 404 表7 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码 最小长度:0 最大长度:64 error_msg String 错误描述 最小长度:0 最大长度:200 request_id String 消息ID 最小长度:0 最大长度:64 状态码: 500 表8 响应Body参数 参数 参数类型 描述 error_code String 系统错误码,针对4xx和5xx类HTTP错误码的详细错误码 最小长度:0 最大长度:64 error_msg String 错误描述 最小长度:0 最大长度:200 request_id String 消息ID 最小长度:0 最大长度:64