导入用户标签 - ImportUserTag
功能介绍
批量修改用户或用户组标签。
-
导入文件必须为Excel文件。
-
每批导入条数需进行限制,默认限制1000条。
-
新增的标签个数按照新增标签接口的逻辑校验,当超出标签的个数限制时,导入失败。
-
标签名称、标签值内容校验规则与新增标签或标签值时的校验一致。
-
导入时必须要有account_id字段,值为导出文件时携带内容,为用户或用户组的唯一ID,不能编辑修改。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/tags/import
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。通过调用IAM服务获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
file |
是 |
File |
参数解释: 导入的用户或用户组标签内容,要求Excel格式。 约束限制:
取值范围: 不涉及 默认取值: 不涉及 |
|
type |
是 |
String |
参数解释: 标签类型,分为用户标签及用户组标签。 约束限制: 不涉及 取值范围:
默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
Boolean |
参数解释: 执行结果。 取值范围:
|
请求示例
无
响应示例
状态码:200
导入结果。
{
"data" : true
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
导入结果。 |
错误码
请参见错误码。