CreateOrUpdateAssetGroup建立新資產分組或修改資產所屬分組-Security Center-阿里雲

介面說明

一台伺服器只能存在一個資產分組中。如果您在該介面請求參數中傳入的伺服器屬於其他分組，該介面調用結束後，該伺服器會從原先的資產分組中移出，移入您新建立的資產分組或指定的資產分組中。

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:CreateOrUpdateAssetGroup

create

*Group

acs:yundun-sas:{#regionId}:{#accountId}:group/*

無

名稱	類型	必填	描述	樣本值
Uuids	string	否	要建立或修改的伺服器分組下的伺服器的 UUID。多個 UUID 使用半形逗號（,）分隔。說明您可以調用 DescribeCloudCenterInstances 介面擷取伺服器的 UUID。	aq12-*,s23*
GroupName	string	否	要建立或修改伺服器列表的伺服器分組名稱。說明修改伺服器與伺服器分組關係時，需要提供待修改伺服器分組的名稱，該名稱可調用 DescribeAllGroups 介面擷取。如果請求參數未輸入 GroupId，調用該介面會建立新的資產分組，此時必須輸入該參數。	test
GroupId	integer	否	要修改伺服器列表的伺服器分組 ID。說明修改資產與資產分組關係時，需要提供待修改資產分組的 ID，該 ID 可調用 DescribeAllGroups 介面擷取。如果不輸入此參數，調用該介面會建立一個新的資產分組。	55426

以下是 CreateOrUpdateAssetGroup 介面在建立資產分組和修改資產分組下的資產兩種使用情境下的請求參數配置說明：

名稱	類型	描述	樣本值
	object
GroupId	integer	伺服器分組 ID。	9935302
RequestId	string	本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。	E70074C8-DFB4-44C5-96C7-909DD231D68A

正常返回樣本

JSON格式

{
  "GroupId": 9935302,
  "RequestId": "E70074C8-DFB4-44C5-96C7-909DD231D68A"
}

HTTP status code	錯誤碼	錯誤資訊	描述
400	GroupNameRepeated	group name repeated	分組名稱重複，請檢查分組名稱。
400	IllegalParam	Illegal param	無效參數
500	ServerError	Service error, please try again later.
403	NoPermission	caller has no permission	當前操作未被授權，請聯絡主帳號在RAM控制台進行授權後再執行操作。

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

更多資訊，參考變更詳情。