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

导入用户标签

功能介绍

批量修改用户或用户组标签。

  • 导入文件必须为Excel文件。
  • 每批导入条数需进行限制,默认限制1000条。
  • 新增的标签个数按照新增标签接口的逻辑校验,当超出标签的个数限制时,导入失败。
  • 标签名称、标签值内容校验规则与新增标签或标签值时的校验一致。
  • 导入时必须要有account_id字段,值为导出文件时携带内容,为用户或用户组的唯一ID,不能编辑修改。

URI

POST /v1/{project_id}/tags/import

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID。获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 FormData参数

参数

是否必选

参数类型

描述

file

File

参数解释:

导入的用户或用户组标签内容,要求Excel格式。

约束限制:

  • 必须是Excel文件。
  • 文件大小不能超过10MB。
  • 导入处理的用户或用户组行数,不能超过1000条。

取值范围:

不涉及

默认取值:

不涉及

type

String

参数解释:

用户类型。

约束限制:

不涉及

取值范围:

  • user:用户
  • userGroup:用户组

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

data

Boolean

参数解释:

执行结果。

约束限制:

不涉及

取值范围:

  • true:成功
  • false:失败

默认取值:

不涉及

请求示例

响应示例

状态码:200

导入成功。

{
  "data" : true
}

状态码

状态码

描述

200

导入成功。

错误码

请参见错误码

相关文档