All Products
Search
Document Center

Data Transmission Service:Modifies the resource group of a DTS instance

Last Updated:Feb 28, 2025

You can call the ConvertInstanceResourceGroup operation to modify the resource group of a DTS instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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.