调用CreateOrUpdateAssetGroup接口创建服务器分组或修改服务器分组下的服务器。

一台服务器只能存在一个资产分组中。如果您在该接口请求参数中传入的服务器属于其他分组,该接口调用结束后,该服务器会从原先的资产分组中移出,移入您新创建的资产分组或指定的资产分组中。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateOrUpdateAssetGroup

需要执行的操作。

取值:CreateOrUpdateAssetGroup

Uuids String aq12-***,s23***

指定服务器分组下的服务器的UUID。

说明 您可以调用DescribeCloudCenterInstances接口获取服务器的UUID。
GroupName String test

指定要创建或修改服务器列表的服务器分组名称。

说明 修改服务器与服务器分组关系时,需要提供待修改服务器分组的名称,该名称可调用DescribeAllGroups接口获取。 如果请求参数未输入GroupId,调用该接口会创建新的资产分组,此时必须输入该参数。
GroupId Long 111111

指定要修改服务器列表的服务器分组ID。

说明 修改资产与资产分组关系时,需要提供待修改资产分组的ID,该ID可调用DescribeAllGroups接口获取。如果不输入此参数,调用该接口会创建一个新的资产分组。

以下是CreateOrUpdateAssetGroup接口在创建资产分组和修改资产分组下的资产两种使用场景下的请求参数配置说明:

  • 创建资产分组:请求参数无需输入GroupId,必须输入GroupNameUuid可输入也可不输入。
  • 修改资产分组下的资产 :请求参数必须输入GroupIdUuidsGroupName可输入也可不输入。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
GroupId Long 9935302

服务器分组ID。

RequestId String E70074C8-DFB4-44C5-96C7-909DD231D68A

阿里云为该请求生成的唯一标识符。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateOrUpdateAssetGroup
&GroupName=test
&<公共请求参数>

正常返回示例

XML格式

<CreateOrUpdateAssetGroupResponse>
      <RequestId>E70074C8-DFB4-44C5-96C7-909DD231D68A</RequestId>
      <GroupId>9935302</GroupId>
</CreateOrUpdateAssetGroupResponse>

JSON格式

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

错误码

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