Adds an Elastic Compute Service (ECS) resource or service to a resource group.
Usage notes
A resource is a cloud service entity that you create in Alibaba Cloud, such as an ECS instance, elastic network interface (ENI), or image. A resource group is a collection of infrastructure for projects, environments, or stacks. In a resource group, you can manage resources and monitor and run tasks in a centralized manner without switching between Alibaba Cloud services.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | JoinResourceGroup | The operation that you want to perform. Set the value to JoinResourceGroup. |
ResourceType | String | No | securitygroup | The type of the ECS resource. Valid values:
The values are case-sensitive. |
ResourceId | String | No | sg-bp67acfmxazb4p**** | The ID of the resource. This parameter depends on the ResourceType value. For example, if you set ResourceType to instance, ResourceId can be interpreted as InstanceId. |
RegionId | String | No | cn-hangzhou | The region ID of the resource. You can call the DescribeRegions operation to query the most recent region list. |
ResourceGroupId | String | No | rg-bp67acfmxazb4p**** | The ID of the resource group to which to add the resource. |
Response parameters
Parameter |
Type |
Example |
Description |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | The ID of the request. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=JoinResourceGroup
&RegionId=cn-hangzhou
&RsourceType=securitygroup
&ResourceId=sg-bp67acfmxazb4p****
&ResourceGroupId=rg-bp67acfmxazb4p****
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<JoinResourceGroupResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</JoinResourceGroupResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
Error codes
HTTP status code |
Error code |
Error message |
Description |
400 | EntityExists.AssociatedTransferTasks | An associated transfer task is in progress. Try again later. | A transfer task is being performed. Try again later. |
403 | InvalidResourceGroup.Duplicate | The ResourceId provided has a ResourceGroup in our records. | The resource has been added to other resource groups. |
403 | InvalidStatus.ResourceGroup | You cannot perform an operation on a resource group that is being created or deleted. | You cannot perform this operation on a resource group that is being created or deleted. |
404 | InvalidResourceType.NotFound | The ResourceType provided does not exist in our records. | The specified resource type is not found. |
404 | InvalidResourceGroup.NotFound | The ResourceGroup provided does not exist in our records. | The resource group is not found. |
404 | InvalidResourceId.NotFound | The ResourceId provided does not exist in our records. | The specified resource is not found. |
For a list of error codes, see Service error codes.