Associating Assets with a Classification

Function

Associating Assets with Categories in Batches: Categories can be added only to columns of data tables and OBS objects.

Calling Method

For details, see Calling APIs.

URI

POST /v3/{project_id}/asset/entities/classification

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain it, see Project ID and Account ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. This parameter is mandatory when token authentication is used. You can obtain it from the value of X-Subject-Token in the response message header returned by the "Obtaining a User Token" API of the IAM service.
workspace	Yes	String	Workspace ID. For details about how to obtain it, see Instance ID and Workspace ID.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
guids	Yes	Array of strings	Data asset list.
classification	Yes	OpenClassification object	Category information.

**Table 4** OpenClassification
Parameter	Mandatory	Type	Description
name	Yes	String	Category name
description	No	String	Category Description
create_user	No	String	Category creator.
create_time	No	Number	Time when a category is created.
update_time	No	Number	Time when a category is updated.
update_user	No	String	Category updater.
guid	No	String	GUID of a category.

Response Parameters

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Status code: 401

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Status code: 403

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Status code: 404

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error description.

Example Requests

{
  "guids" : [ "0aa90b11-5064-4c6a-9c00-a35267a85aab", "348f0dc5-e03f-487e-a967-3e1abacccce8" ],
  "classification" : {
    "name" : "hive_common"
  }
}