Changes the names of the tags that are added to assets, or modifies tags for assets.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyTagWithUuid

The operation that you want to perform. Set the value to ModifyTagWithUuid.

UuidList String No e2737dc3-78f4-4653-a986-dc5fad4b****,c189f0e3-df22-42d5-a73d-02c05667****

The UUIDs of the assets whose tags you want to modify. Separate multiple UUIDs with commas (,).

Note You can call the DescribeCloudCenterInstances operation to query the UUIDs of assets to which the tags are added. If you do not specify this parameter, the tags that are specified in TagList are removed from all assets.
TagList String Yes ac,ad

The tag names that you want to change. Separate multiple tag names with commas (,).

Note You can call the DescribeGroupedTags operation to query the names of the tags that are added to assets.
TagId String No 3897941

The ID of the tag whose name you want to change.

Note You can call the DescribeGroupedTags operation to query the IDs of the tags.
MachineTypes String No ecs

The type of the assets whose tags you want to modify. Valid values:

  • ecs: Elastic Compute Service (ECS) instances or servers that are not deployed on Alibaba Cloud
  • cloud_product: Alibaba Cloud services
Note If you do not specify this parameter, the default value ecs is used.

All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.

For more information about sample requests, see the "Examples" section of this topic.

Response parameters

Parameter Type Example Description
RequestId String 70C4B40D-D55E-4B7B-9992-8535E396B2F4

The ID of the request, which is used to locate and troubleshoot issues.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyTagWithUuid
&UuidList=e2737dc3-78f4-4653-a986-dc5fad4b****,c189f0e3-df22-42d5-a73d-02c05667****
&TagList=ac,ad
&TagId=3897941
&MachineTypes=ecs
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyTagWithUuidResponse>
    <RequestId>70C4B40D-D55E-4B7B-9992-8535E396B2F4</RequestId>
</ModifyTagWithUuidResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "70C4B40D-D55E-4B7B-9992-8535E396B2F4"
}

Error codes

HTTP status code Error code Error message Description
500 ServerError ServerError The error message returned because a server error occurred.

For a list of error codes, visit the API Error Center.