You can call the ConvertInstanceResourceGroup operation to modify the resource group of a DTS instance.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | ConvertInstanceResourceGroup | The operation that you want to perform. Valid value: ConvertInstanceResourceGroup. |
DtsJobId | String | No | m4312mab158**** | The historical parameter. This parameter does not take effect and is not required. |
RegionId | String | No | cn-hangzhou | The region ID of the DTS instance. |
ResourceId | String | No | dtszhc12zp727o**** | The ID of the DTS instance. You can view the ID in the ID/Name column on the task page in the console. Note This parameter is required. |
NewResourceGroupId | String | No | rg-aek2r4fkrqw**** | The ID of the new resource group. You can view the ID in the gResource Management consoleg. For more information, see View the basic information about a resource group. |
ZeroEtlJob | Boolean | No | true | This parameter is only for special services and not required. |
ResourceGroupId | String | No | rg-3m1213ye7l**** | This parameter is only for special services and not required. |
Response parameters
Parameter |
Type |
Example |
Description |
HttpStatusCode | Integer | 200 | The HTTP status code. |
RequestId | String | AD823BD3-1BA6-4117-A536-165CB280**** | The ID of the request. |
ErrCode | String | InternalError | The error code returned if the request failed. |
Success | Boolean | true | Indicates whether the request was successful. |
ErrMessage | String | The Value of Input Parameter %s is not valid. | The error message returned if the request failed. |
Code | String | 500 | The error code returned by the backend service. The number is incremented. |
DynamicMessage | String | DtsJobId | The dynamic part in the error message. The value of this parameter is used to replace %s in the value of ErrMessage. Note If The Value of Input Parameter %s is not valid is returned and and DtsJobId is returned for DynamicMessage, it indicates that the request parameter DtsJobId is invalid. |
Examples
Sample requests
http(s)://dts.aliyuncs.com/?Action=ConvertInstanceResourceGroup
&RegionId=cn-hangzhou
&ResourceId=dtszhc12zp727o****
&NewResourceGroupId=rg-aek2r4fkrqw****
& Common request parameters
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<ConvertInstanceResourceGroupResponse>
<RequestId>AA9B0557-2424-5D56-83DF-CF68F588****</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Success>true</Success>
</ConvertInstanceResourceGroupResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "AA9B0557-2424-5D56-83DF-CF68F588****",
"HttpStatusCode" : 200,
"Success" : true
}
Error codes
HttpCode |
Error code |
Error message |
Description |
400 | Throttling.User | Request was denied due to user flow control. | The number of requests reached the limit and the request was rejected. Try again later. |
403 | InvalidSecurityToken.Expired | Specified SecurityToken is expired. | The signature expired. Use a new signature. |
500 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | The response of the server timed out or the server was unavailable. Try again. If the error persists, contact technical support. |
For a list of error codes, see Error Codes.