ModifyTagWithUuid - 修改资产标签名或标签中的资产 - 云安全中心

修改资产的标签名称或修改指定标签下包含的资产。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sas:ModifyTagWithUuid	update	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
UuidList	string	否	要修改的标签下的资产实例的 UUID 列表。多个 UUID 使用半角逗号（,）分隔。说明您可调用 DescribeCloudCenterInstances 接口查询资产标签下的资产实例的 UUID 列表。如果该参数为空，将清空 TagList 参数指定的标签下的所有资产实例。	e2737dc3-78f4-4653-a986-dc5fad4b**,c189f0e3-df22-42d5-a73d-02c05667**
TagList	string	是	要修改标签的名称列表。多个标签名称使用半角逗号（,）隔开。说明您可调用 DescribeGroupedTags 接口查询资产标签的名称列表。	ac,ad
TagId	string	否	要修改标签的标签 ID。说明您可调用 DescribeGroupedTags 接口查询资产标签的标签 ID。	3897941
MachineTypes	string	否	要修改的资产类型。取值： ecs：服务器，包括阿里云和非阿里云服务器。 cloud_product：云产品。说明不传该参数，默认指定资产类型为 ecs。	ecs
Target	string	否	主机资产标签管理的服务器的配置信息。此参数为 JSON 格式，包含以下参数： Target：要添加或删除的服务器的 UUID。 targetType：生效资产的添加模式。取值： uuid：按单个服务器添加。 groupId：按照服务器分组添加。 flag：对该资产的具体操作。取值： del：将该服务器从规则中删除。 add：将该服务器添加到规则中。	[{"target":"inet-7c676676-06fa-432e-90fb-b802e5d6****","targetType":"uuid","flag":"add"}]

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	70C4B40D-D55E-4B7B-9992-8535E396B2F4

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	MissingTagList	TagList is mandatory for this action.	标签的名称列表必填。
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-09-25	OpenAPI 错误码发生变更	查看变更详情
2024-01-12	OpenAPI 入参发生变更	查看变更详情
2022-08-01	API 内部配置变更，不影响调用	查看变更详情
2022-08-01	API 内部配置变更，不影响调用	查看变更详情