创建组织与用户的关联关系
功能介绍
应用服务器可调用此接口创建组织与用户的关联关系。
一个用户可以关联多个组织，一个组织可以被多个用户关联。
URI
POST /v1/iotfm/organizations/{organization_id}/user-associations/batch-create
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
organization_id | 是 | String | 参数说明：组织ID。 取值范围：长度固定24，只允许大小写字母、数字的组合。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 参数说明：用户Token。通过调用 生成Token 接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 |
X-Instance-Id | 是 | String | 参数说明：实例ID。通过访问智能设施云平台界面后获取，智能设施云平台资源均为实例级隔离，所有业务接口必须填写正确的实例ID才能被成功调用。 取值范围：长度8-36，只允许大小写字母、数字和-字符的组合。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
user_ids | 否 | Array of strings | 参数说明：被关联的用户ID列表。 取值范围：长度1-100。 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
users | Array of UserAssociation objects | 参数说明：被关联的用户列表。 取值范围：长度1-100。 |
参数 | 参数类型 | 描述 |
|---|---|---|
user_id | String | 参数说明：被关联的用户ID。 取值范围：长度固定1-64，只允许大小写字母、数字以及_-等符号的组合。 |
user_name | String | 参数说明：被关联的用户名。 取值范围：长度4-32，要求大小写字母开头，只允许大小写字母、数字以及_.-等符号的组合。 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数说明：错误码。 取值范围：长度8-36。 |
error_msg | String | 参数说明：错误描述。 取值范围：长度2-512。 |
请求示例
创建组织与用户的关联关系
POST https://{endpoint}/v1/iotfm/organizations/abcdefaaaaaaaaaaaaaaaaaaaa/user-associations/batch-create 响应示例
状态码：200
OK
{
"users" : [ {
"user_id" : "abcdefaaaaaaaaaaaaaaaaaaaa",
"user_name" : "demo-username"
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Error response |
