全部產品
Search
文件中心

Security Center:ModifyTagWithUuid - 修改資產標籤名或標籤中的資產

更新時間:Mar 21, 2026

修改資產的標籤名稱或修改指定標籤下包含的資產。

調試

您可以在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. 標籤的名稱列表必填。
500 ServerError ServerError 服務故障,請稍後重試!
403 NoPermission caller has no permission 當前操作未被授權,請聯絡主帳號在RAM控制台進行授權後再執行操作。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情