Todos os produtos
Search

Este produto

    Data Transmission Service:CreateDtsInstance

    Central de documentação

    Data Transmission Service:CreateDtsInstance

    Última atualização: Jun 27, 2026

    Adquire uma instância do Data Transmission Service (DTS).

    Adquire uma instância do Data Transmission Service (DTS).

    • Antes de chamar esta operação, certifique-se de compreender os métodos de faturamento e os preços do DTS.

    • Para executar uma tarefa do DTS em um cluster dedicado, configure-a antes de adquirir uma instância. Chame ConfigureDtsJob para configurar a tarefa.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Exemplo

    Descrição

    Action

    String

    Sim

    CreateDtsInstance

    Operação a executar. Defina o valor como CreateDtsInstance.

    JobId

    String

    Não

    bi6e22ay243****

    ID da tarefa. Chame ConfigureDtsJob para obter este valor de DtsJobId.

    Nota

    Se especificado, este parâmetro tem precedência sobre SourceRegion, DestinationRegion, Type, SourceEndpointEngineName e DestinationEndpointEngineName.

    InstanceClass

    String

    Não

    xxlarge

    Classe da instância.

    • Instância de migração de dados: xxlarge, xlarge, large, medium e small.

    • Instância de sincronização de dados: large, medium, small e micro.

    PayType

    String

    Sim

    PrePaid

    Método de faturamento. Valores válidos:

    • PrePaid: assinatura.

    • PostPaid: pagamento conforme o uso.

    Nota

    Period

    String

    Não

    Month

    Unidade da duração da assinatura. Valores válidos: Year e Month.

    Nota

    Obrigatório apenas se PayType estiver definido como PrePaid.

    SyncArchitecture

    String

    Não

    oneway

    Topologia de sincronização. Valores válidos:

    • oneway (padrão): sincronização unidirecional.

    • bidirectional: sincronização bidirecional.

    AutoStart

    Boolean

    Não

    false

    Indica se a tarefa inicia automaticamente após a compra. Valores válidos:

    • false (padrão)

    • true

    Nota

    Tem efeito apenas se JobId for especificado.

    UsedTime

    Integer

    Não

    5

    Duração da assinatura.

    • Valores válidos se Period estiver definido como Month: 1, 2, 3, 4, 5, 6, 7, 8 e 9.

    • Valores válidos se Period estiver definido como Year: 1, 2, 3 e 5.

      Nota

      • Obrigatório apenas se PayType estiver definido como PrePaid.

      • Use Period para especificar a unidade.

    Quantity

    Integer

    Não

    1

    Número de instâncias do DTS a adquirir.

    Nota

    Apenas uma instância pode ser adquirida por solicitação.

    AutoPay

    Boolean

    Não

    false

    Indica se a instância do DTS renova automaticamente ao expirar. Valores válidos:

    • false (padrão)

    • true

    Type

    String

    Não

    SYNC

    Tipo da instância do DTS. Valores válidos:

    • MIGRATION: instância de migração de dados.

    • SYNC: instância de sincronização de dados.

    • SUBSCRIBE: instância de rastreamento de alterações.

      Nota

      Especifique este parâmetro ou JobId.

    DatabaseCount

    Integer

    Não

    3

    Número de instâncias privadas personalizadas do ApsaraDB RDS no PolarDB-X. Padrão: 1.

    Nota

    Obrigatório apenas se SourceEndpointEngineName estiver definido como drds.

    SourceRegion

    String

    Não

    cn-hangzhou

    ID da região da instância de origem. Regiões suportadas.

    Nota

    Especifique este parâmetro ou JobId.

    DestinationRegion

    String

    Não

    cn-hangzhou

    ID da região da instância de destino. Regiões suportadas.

    Nota

    Especifique este parâmetro ou JobId.

    SourceEndpointEngineName

    String

    Não

    MySQL

    Mecanismo de banco de dados da instância de origem. Valores válidos:

    • MySQL: instância do ApsaraDB RDS for MySQL ou banco de dados MySQL auto-gerenciado.

    • PolarDB: cluster do PolarDB for MySQL.

    • polardb_o: cluster do PolarDB for Oracle.

    • polardb_pg: cluster do PolarDB for PostgreSQL.

    • Redis: instância do Tair (compatível com Redis OSS) ou banco de dados Redis auto-gerenciado.

    • DRDS: instância do PolarDB-X 1.0 ou PolarDB-X 2.0.

    • PostgreSQL: banco de dados PostgreSQL auto-gerenciado.

    • odps: projeto do MaxCompute.

    • oracle: banco de dados Oracle auto-gerenciado.

    • mongodb: instância do ApsaraDB for MongoDB ou banco de dados MongoDB auto-gerenciado.

    • tidb: banco de dados TiDB.

    • ADS: cluster do AnalyticDB for MySQL V2.0.

    • ADB30: cluster do AnalyticDB for MySQL V3.0.

    • Greenplum: instância do AnalyticDB for PostgreSQL.

    • MSSQL: instância do ApsaraDB RDS for SQL Server ou banco de dados SQL Server auto-gerenciado.

    • kafka: instância do ApsaraMQ for Kafka ou cluster Kafka auto-gerenciado.

    • DataHub: projeto do DataHub.

    • DB2: banco de dados Db2 for LUW auto-gerenciado.

    • as400: banco de dados Db2 for i (AS/400).

    • Tablestore: instância do Tablestore.

    • OceanBase: banco de dados ApsaraDB for OceanBase (compatível com MySQL), suportado apenas em instâncias de migração de dados.

    Nota

    DestinationEndpointEngineName

    String

    Não

    MySQL

    Mecanismo de banco de dados da instância de destino. Valores válidos:

    • MySQL: instância do ApsaraDB RDS for MySQL ou banco de dados MySQL auto-gerenciado.

    • PolarDB: cluster do PolarDB for MySQL.

    • polardb_o: cluster do PolarDB for Oracle.

    • polardb_pg: cluster do PolarDB for PostgreSQL.

    • Redis: instância do Tair (compatível com Redis OSS) ou banco de dados Redis auto-gerenciado.

    • DRDS: instância do PolarDB-X 1.0 ou PolarDB-X 2.0.

    • PostgreSQL: banco de dados PostgreSQL auto-gerenciado.

    • odps: projeto do MaxCompute.

    • oracle: banco de dados Oracle auto-gerenciado.

    • mongodb: instância do ApsaraDB for MongoDB ou banco de dados MongoDB auto-gerenciado.

    • tidb: banco de dados TiDB.

    • ADS: cluster do AnalyticDB for MySQL V2.0.

    • ADB30: cluster do AnalyticDB for MySQL V3.0.

    • Greenplum: instância do AnalyticDB for PostgreSQL.

    • MSSQL: instância do ApsaraDB RDS for SQL Server ou banco de dados SQL Server auto-gerenciado.

    • kafka: instância do ApsaraMQ for Kafka ou cluster Kafka auto-gerenciado.

    • DataHub: projeto do DataHub.

    • DB2: banco de dados Db2 for LUW auto-gerenciado.

    • as400: banco de dados Db2 for i (AS/400).

    • Tablestore: instância do Tablestore.

    Nota

    ComputeUnit

    Integer

    Não

    5

    Especificações da instância ETL em unidades de computação (CUs). Uma CU equivale a 1 vCPU e 4 GB de memória. Valor mínimo: 2.

    RegionId

    String

    Não

    cn-hangzhou

    ID da região da instância do DTS. Regiões suportadas.

    FeeType

    String

    Não

    ONLY_CONFIGURATION_FEE

    Tipo de faturamento para uma instância de rastreamento de alterações. Valores válidos: ONLY_CONFIGURATION_FEE (apenas taxas de configuração) e CONFIGURATION_FEE_AND_DATA_FEE (taxas de configuração e taxas de tráfego de dados).

    Du

    Integer

    Não

    30

    Número de unidades DTS (DUs) atribuídas a uma tarefa do DTS em um cluster dedicado. Valores válidos: 1 a 100.

    Nota

    ResourceGroupId

    String

    Não

    rg-acfmzawhxxc****

    ID do grupo de recursos.

    MinDu

    double

    Não

    1

    Número mínimo de DUs.

    Nota

    Este parâmetro é suportado apenas para instâncias serverless.

    MaxDu

    double

    Não

    16

    Número máximo de DUs.

    Nota

    Este parâmetro é suportado apenas para instâncias serverless.

    DtsRegion

    String

    Não

    cn-hangzhou

    ID da região da instância do DTS. Defina com o mesmo valor de RegionId.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

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

    ID da solicitação.

    ErrCode

    String

    InternalError

    Código de erro retornado se a solicitação falhar.

    Success

    String

    true

    Indica se a solicitação foi bem-sucedida.

    JobId

    String

    bi6e22ay243****

    ID da tarefa.

    ErrMessage

    String

    The request processing has failed due to some unknown error.

    Mensagem de erro retornada se a solicitação falhar.

    InstanceId

    String

    dtsbi6e22ay243****

    ID da instância.

    Exemplos

    Exemplos de solicitações

    http(s)://dts.aliyuncs.com/?Action=CreateDtsInstance
&InstanceClass=large
&PayType=PostPaid
&SyncArchitecture=oneway
&AutoStart=false
&Quantity=1
&AutoPay=false
&Type=SYNC
&SourceRegion=cn-hangzhou
&DestinationRegion=cn-hangzhou
&SourceEndpointEngineName=MySQL
&DestinationEndpointEngineName=MySQL
&RegionId=cn-hangzhou
&<Common request parameters>

    Exemplos de respostas de sucesso

    Formato XML

    HTTP/1.1 200 OK
Content-Type:application/xml

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

    Formato JSON

    HTTP/1.1 200 OK
Content-Type:application/json

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

    Códigos de erro

    HttpCode

    Código de erro

    Mensagem de erro

    Descrição

    403

    LXCreateOrderError

    Failed to create order, failure message: The module is invalid

    O recurso de sincronização transfronteiriça do DTS não está disponível para todos os usuários. Para usar este recurso, envie <a href="https://page.aliyun.com/form/act409679078/index.htm" target="_blank">uma solicitação</a> para análise.

    403

    LXCreateOrder.NotFoundPricePlan

    Pricing plan price result not found, please check the parameters of the task configuration.

    Falha ao criar um pedido. Nenhum plano de preços encontrado. As possíveis causas incluem parâmetros inválidos e falta de precificação.

    403

    LXPayOrder.InsufficientBalance

    Insufficient balance, order payment failed.

    Falha ao concluir o pagamento devido a saldo insuficiente. Recarregue sua conta e tente novamente.

    403

    DTS.Msg.LXCreateOrderError

    Failed to create order, failure message: The module is invalid

    O recurso de sincronização transfronteiriça do DTS não está disponível para todos os usuários. Para usar este recurso, envie <a href="https://page.aliyun.com/form/act409679078/index.htm" target="_blank">uma solicitação</a> para análise.

    403

    DTS.Msg.LXCreateOrder.NotFoundPricePlan

    Pricing plan price result not found, please check the parameters of the task configuration.

    Falha ao criar um pedido. Nenhum plano de preços encontrado. As possíveis causas incluem parâmetros inválidos e falta de precificação.

    403

    DTS.Msg.LXPayOrder.InsufficientBalance

    Insufficient balance, order payment failed.

    Falha ao concluir o pagamento devido a saldo insuficiente. Recarregue sua conta e tente novamente.

    403

    DTS.Msg.LXCreateOrderErrorIntl

    DTS supports cross-border data synchronization only in specific scenarios. To purchase a data synchronization instance used to synchronize data across countries, application for DTS cross-border data synchronization.

    O recurso de sincronização transfronteiriça do DTS não está disponível para todos os usuários. Para usar este recurso, envie <a href="https://page-intl.aliyun.com/form/act1633074550/index.htm" target="_blank">uma solicitação</a> para análise.

    403

    InvalidSecurityToken.Expired

    Specified SecurityToken is expired.

    A assinatura expirou. Use uma nova assinatura.

    400

    Throttling.User

    Request was denied due to user flow control.

    O número de chamadas por segundo excede o limite. Tente novamente mais tarde.

    500

    ServiceUnavailable

    The request has failed due to a temporary failure of the server.

    A resposta do servidor atingiu o tempo limite ou o servidor estava indisponível. Tente novamente. Se o erro persistir, entre em contato com o suporte técnico.

    Códigos de erro do serviço.