Importing User Tags
Function
This API is used to modify user or user group tags in batches.

- The import file must be an Excel file.
- The number of entries per batch import is limited, with a default limit of 1,000 entries.
- The number of new tags is validated according to the logic of the new tag API. If the number of tags exceeds the limit, the import will fail.
- The validation rules for tag names and tag values are consistent with those for adding new tags or tag values.
- The account_id field must be present during import. The value is carried from the export file and serves as the unique ID for the user or user group. It cannot be edited or modified.
URI
POST /v1/{project_id}/tags/import
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Explanation Project ID. For how to obtain the project ID, see Obtaining a Project ID. Constraints N/A Value range N/A Default value N/A |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
Explanation User token. Obtain a user token by calling IAM's "Obtaining a User Token" API. X-Subject-Token in the response header is the desired user token. Constraints N/A Value range N/A Default value N/A |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
file |
Yes |
File |
Explanation File that contains the user or user group tags to be imported, which must be in Excel format. Constraints
Value range N/A Default value N/A |
type |
Yes |
String |
Explanation User type. Constraints N/A Value range
Default value N/A |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
data |
Boolean |
Explanation Execution result. Constraints N/A Value range
Default value N/A |
Example Request
None
Example Response
Status code: 200
The tags are successfully imported.
{ "data" : true }
Status Codes
Status Code |
Description |
---|---|
200 |
The tags are successfully imported. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot