BatchUpdateFileTag-阿里云帮助中心

This operation updates document tags in a data connection in batches.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

PUT /{WorkspaceId}/datacenter/batchupdatetag HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
WorkspaceId	string	Yes	The workspace ID. To get this ID, go to the Model Studio console home and click the workspace details icon in the upper-left corner.	llm-3shx2gu255oqxxxx

Request parameters

Parameter	Type	Required	Description	Example
FileInfos	array<object>	Yes	A list of files to update.
	object	Yes
FileId	string	Yes	The file ID. To get this ID, go to the application data page and click the ID icon next to the file name.	file_3d5319366e2c46309f4c11cfbeacd5fd_10045951
tags	array	Yes	A list of up to 100 tags to associate with the file. The total length of all tags cannot exceed 700 characters.
	string	No	The tag. It can be up to 32 characters long and must not contain spaces. Supported characters include Unicode letters (such as English letters, Chinese characters, and numbers), underscores (_), and hyphens (-).	TagA
UpdateMode	string	No	The update mode. Valid values are APPEND and OVERWRITE.	OVERWRITE

Response elements

Element	Type	Description	Example
	object	The response schema.
Code	string	The response code. A value of Success indicates that the call was successful.	Success
Data	object	The data returned by the operation.
UpdateFileTagResultList	array<object>	A list of the tag update results.
	object
FileId	string	The file ID.	file_f40f2a32205d44b4a93b11617113da15_10045951
Success	boolean	Indicates whether the tags for the specific file were updated. Valid values: true: The tags were updated successfully. false: The tag update failed.	true
ErrorCode	string	The error code. This parameter is returned only if Success is false.	NoPermission
ErrorMessage	string	The error message. This parameter is returned only if Success is false.	FileId not exists.
Message	string	The response message.	Required parameter(FileId) missing or invalid, please check the request parameters.
RequestId	string	The request ID.	17204B98-xxxx-4F9A-8464-2446A84821CA
Status	string	The status code returned for the request.	200
Success	boolean	Indicates whether the request was accepted. Check `UpdateFileTagResultList` for the status of each file. Valid values: true: The request was accepted. false: The request failed, for example, due to an invalid parameter.	true

Examples

Success response

JSON format

{
  "Code": "Success",
  "Data": {
    "UpdateFileTagResultList": [
      {
        "FileId": "file_f40f2a32205d44b4a93b11617113da15_10045951",
        "Success": true,
        "ErrorCode": "NoPermission",
        "ErrorMessage": "FileId not exists."
      }
    ]
  },
  "Message": "Required parameter(FileId) missing or invalid, please check the request parameters.",
  "RequestId": "17204B98-xxxx-4F9A-8464-2446A84821CA",
  "Status": "200",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.