Modifying Resource Tags of Nodes

Function

This API is used to modify resource tags of a specified node.

URI

POST /v1/{project_id}/nodes/{node_name}/tags

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.
node_name	Yes	String	Node ID. The value is the metadata.name field in the node details.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Action performed on resource tags. The options are as follows: create: Add a specified resource tag. If the tag key already exists, the value field of that tag is overwritten. delete: Delete a specified resource tag. A resource tag with the same key and value will be deleted. reset: Reset the resource tag to a requested value.
tags	Yes	Array of Tag objects	Resource tag list. The value can be empty only when the value of action is reset.

**Table 3** Tag
Parameter	Mandatory	Type	Description
key	Yes	String	Tag key
value	Yes	String	Tag value

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
tags	Tag object	Resource tag list

**Table 5** Tag
Parameter	Type	Description
key	String	Tag key
value	String	Tag value

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Status code: 401

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Status code: 403

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Status code: 404

**Table 9** Response body parameters
Parameter	Type	Description
error_code	String	Error codes of ModelArts
error_msg	String	Error message

Example Requests

Delete resource tags from a specified node.

https://{endpoint}/v1/{project_id}/nodes/os-node-created-520ad/tags

{
  "action" : "delete",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  } ]
}

Add resource tags to a specified node.

https://{endpoint}/v1/{project_id}/nodes/os-node-created-520ad/tags

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  } ]
}

Example Responses

Status code: 200

Tags added.

{
  "tags" : [ {
    "key" : "test",
    "value" : "service-gpu"
  }, {
    "key" : "key1",
    "value" : "value1"
  } ]
}

Status Codes

Status Code	Description
200	Tags added.
400	Invalid parameter.
401	Authentication failed.
403	Insufficient permission.
404	Resource not found.

Error Codes

See Error Codes.

Parent topic: Tag Management

Previous topic: Obtaining Resource Tags of Nodes

Next topic: Event Management

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.