Purchases a DTS instance.

Before you call this operation, make sure that you fully understand the billing methods and pricing of Data Transmission Service (DTS).

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 CreateDtsInstance

The operation that you want to perform. Set the value to CreateDtsInstance.

JobId String No bi6e22ay243****

The ID of the task.

InstanceClass String No 2xlarge

The specification of the instance. Valid values: 2xlarge, large, medium, micro, small, xlarge, and xmicro.

PayType String No POSTPAY

The billing method. Valid values:

  • PostPaid: pay-as-you-go
  • PrePaid: subscription
Period String No Month

The unit of the subscription length. Valid values: Year, Month, Day, Hour, and Minute.

Note You must specify this parameter only if you set the PayType parameter to PrePaid.
SyncArchitecture String No oneway

The synchronization topology. Valid values:

  • oneway: one-way synchronization
  • bidirectional: two-way synchronization
AutoStart Boolean No false

Specifies whether to automatically start the task after the purchase is completed. Valid values:

  • false: no
  • true: yes
UsedTime Integer No 5

The subscription length.

Note
  • You must specify this parameter only if you set the PayType parameter to PrePaid.
  • You can set the Period parameter to specify the unit of the subscription length.
Quantity Integer No 1

The number of instances that you want to purchase.

AutoPay Boolean No false

Specifies whether to automatically renew the instance when it expires. Valid values:

  • false: no
  • true: yes
Type String No MIGRATION

The type of the DTS instance. Valid values:

  • MIGRATION: data migration instance
  • SYNC: data synchronization instance
  • SUBSCRIBE: change tracking instance
DatabaseCount Integer No 3

The number of private custom RDS instances in PolarDB-X. Default value:1.

Note This parameter is required only when the SourceEndpointEngineName parameter is set to drds.
SourceRegion String No cn-hangzhou

The ID of the region where the source instance resides. For more information, see List of supported regions.

DestinationRegion String No cn-hangzhou

The ID of the region where the destination instance resides. For more information, see List of supported regions.

SourceEndpointEngineName String No MYSQL

The database engine of the source instance.

  • MySQL: ApsaraDB RDS for MySQL instance or self-managed MySQL database
  • PolarDB: PolarDB for MySQL cluster
  • polardb_o: PolarDB-O cluster
  • polardb_pg: PolarDB for PostgreSQL cluster
  • Redis: ApsaraDB for Redis instance or self-managed Redis database
  • DRDS: PolarDB-X instance V1.0 or V2.0
  • PostgreSQL: self-managed PostgreSQL database
  • odps: MaxCompute project
  • oracle: self-managed Oracle database
  • mongodb: ApsaraDB for MongoDB instance or self-managed MongoDB database
  • tidb: TiDB database
  • ADS: AnalyticDB for MySQL cluster V2.0
  • ADB30: AnalyticDB for MySQL cluster V3.0
  • Greenplum: AnalyticDB for PostgreSQL instance
  • MSSQL: ApsaraDB RDS for SQL Server instance or self-managed SQL Server database
  • kafka: Message Queue for Apache Kafka instance or self-managed Kafka cluster
  • DataHub: DataHub project
  • clickhouse: ApsaraDB for ClickHouse cluster
  • DB2: self-managed Db2 for Linux, UNIX, and Windows (LUW) database
  • as400: AS/400
  • Tablestore: Tablestore instance
Note
DestinationEndpointEngineName String No MYSQL

The database engine of the destination instance.

  • MySQL: ApsaraDB RDS for MySQL instance or self-managed MySQL database
  • PolarDB: PolarDB for MySQL cluster
  • polardb_o: PolarDB-O cluster
  • polardb_pg: PolarDB for PostgreSQL cluster
  • Redis: ApsaraDB for Redis instance or self-managed Redis database
  • DRDS: PolarDB-X instance V1.0 or V2.0
  • PostgreSQL: self-managed PostgreSQL database
  • odps: MaxCompute project
  • oracle: self-managed Oracle database
  • mongodb: ApsaraDB for MongoDB instance or self-managed MongoDB database
  • tidb: TiDB database
  • ADS: AnalyticDB for MySQL cluster V2.0
  • ADB30: AnalyticDB for MySQL cluster V3.0
  • Greenplum: AnalyticDB for PostgreSQL instance
  • MSSQL: ApsaraDB RDS for SQL Server instance or self-managed SQL Server database
  • kafka: Message Queue for Apache Kafka instance or self-managed Kafka cluster
  • DataHub: DataHub project
  • clickhouse: ApsaraDB for ClickHouse cluster
  • DB2: self-managed Db2 for LUW database
  • as400: AS/400
  • Tablestore: Tablestore instance
Note

Response parameters

Parameter Type Example Description
ErrCode String InternalError

The error code returned if the call failed.

ErrMessage String The request processing has failed due to some unknown error.

The error message returned if the call failed.

InstanceId String dtsbi6e22ay243****

The ID of the instance.

JobId String bi6e22ay243****

The ID of the task.

RequestId String C166D79D-436B-45F0-B5A5-25E1****

The ID of the request.

Success String true

Indicates whether the call was successful.

Examples

Sample requests

http(s)://dts.aliyuncs.com/?Action=CreateDtsInstance
&<Common request parameters>

Sample success responses

XML format

<CreateDtsInstanceResponse>
  <RequestId>C166D79D-436B-45F0-B5A5-25E1****</RequestId>
  <Success>true</Success>
</CreateDtsInstanceResponse>

JSON format

{
    "RequestId":"C166D79D-436B-45F0-B5A5-25E1****",
    "Success":"true"
}

Error codes

For a list of error codes, visit the API Error Center.