更新时间:2024-05-21 GMT+08:00
分享

添加设备分组

功能介绍

添加设备分组

URI

POST /v1/{user_id}/device-orgs

表1 路径参数

参数

是否必选

参数类型

描述

user_id

String

用户ID:由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Access-Token

String

用户认证AccessToken:从获取用户北向接口认证AccessToken中获取

表3 请求Body参数

参数

是否必选

参数类型

描述

device_org_name

String

设备组织名称:支持数字、中文(一个汉字算两个字符)、英文、空格、-、_,长度范围[1,50]

parent_org_id

String

父级组织ID:由数字组成,长度范围[1,25],可以从查询子级设备组织获取,根节点无法添加子级组织

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

device_org_id

String

设备分组ID

请求示例

添加设备分组

POST /v1/2562572829***/device-orgs

{
  "parent_org_id" : "1234567890***",
  "device_org_name" : "组织名称"
}

响应示例

状态码: 200

OK

{
  "device_org_id" : "1234567890***"
}

状态码

请参见状态码

错误码

请参见错误码

相关文档