更新时间:2025-08-19 GMT+08:00
分享

批量释放强制点位控制

功能介绍

批量释放强制点位控制

URI

POST /v1/iotfm/edge/forced-points/batch-release

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数说明:用户Token。通过调用 生成Token 接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。

X-Instance-Id

String

参数说明:实例ID。通过访问智能设施云平台界面后获取,智能设施云平台资源均为实例级隔离,所有业务接口必须填写正确的实例ID才能被成功调用。

取值范围:长度8-36,只允许大小写字母、数字和-字符的组合。

X-Root-Zone-Id

String

参数说明:项目ID。

取值范围:长度不超过24,只允许字母、数字的组合。

表2 请求Body参数

参数

是否必选

参数类型

描述

forced_point_ids

Array of strings

强制点位列表

响应参数

状态码:200

表3 响应Header参数

参数

参数类型

描述

X-Request-Id

String

This field is the request ID number for task tracking.

Format is request_uuid-timestamp-hostname.

表4 响应Body参数

参数

参数类型

描述

results

Array of ReleaseForcedPointControlResult objects

批量释放强制点位结果列表

表5 ReleaseForcedPointControlResult

参数

参数类型

描述

forced_point_id

String

强制点位控制记录id

result_code

Integer

释放强制点位响应码

result_desc

String

释放强制点位响应描述

状态码:400

表6 响应Header参数

参数

参数类型

描述

X-Request-Id

String

This field is the request ID number for task tracking.

Format is request_uuid-timestamp-hostname.

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数说明:错误码。

取值范围:长度8-36。

error_msg

String

参数说明:错误描述。

取值范围:长度2-512。

请求示例

批量释放强制点位

POST https://{endpoint}/v1/iotfm/edge/forced-points/batch-release

{
  "forced_point_ids" : [ "bc8420b9-1535-4ad1-964e-7c6249973524" ]
}

响应示例

状态码

状态码

描述

200

No Content

400

Bad Request

相关文档