Tous les produits
Search

Ce produit

    Data Transmission Service:CreateDtsInstance

    Centre de documentation

    Data Transmission Service:CreateDtsInstance

    Dernière mise à jour :Aug 12, 2026

    Achète une instance Data Transmission Service (DTS).

    Cette opération permet d'acheter une instance Data Transmission Service (DTS).

    • Avant d'appeler cette opération, assurez-vous de bien comprendre les modes de facturation et la tarification de DTS.

    • Pour exécuter une tâche DTS sur un cluster dédié, configurez-la avant d'acheter une instance. Appelez ConfigureDtsJob pour configurer la tâche.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Ce dernier génère dynamiquement des exemples de code pour différents SDK.

    Paramètres de requête

    Paramètre

    Type

    Obligatoire

    Exemple

    Description

    Action

    String

    Oui

    CreateDtsInstance

    Opération à effectuer. Définissez la valeur sur CreateDtsInstance.

    JobId

    String

    Non

    bi6e22ay243****

    ID de la tâche. Appelez ConfigureDtsJob pour obtenir cette valeur depuis DtsJobId.

    Remarque

    Si ce paramètre est spécifié, il prévaut sur SourceRegion, DestinationRegion, Type, SourceEndpointEngineName et DestinationEndpointEngineName.

    InstanceClass

    String

    Non

    xxlarge

    Classe de l'instance.

    • Instance de migration de données : xxlarge, xlarge, large, medium et small.

    • Instance de synchronisation de données : large, medium, small et micro.

    PayType

    String

    Oui

    PrePaid

    Mode de facturation. Valeurs valides :

    • PrePaid : abonnement.

    • PostPaid : paiement à l'utilisation.

    Remarque

    Period

    String

    Non

    Month

    Unité de durée de l'abonnement. Valeurs valides : Year et Month.

    Remarque

    Obligatoire uniquement si PayType est défini sur PrePaid.

    SyncArchitecture

    String

    Non

    oneway

    Topologie de synchronisation. Valeurs valides :

    • oneway (par défaut) : synchronisation unidirectionnelle.

    • bidirectional : synchronisation bidirectionnelle.

    AutoStart

    Boolean

    Non

    false

    Indique s'il faut démarrer automatiquement la tâche après l'achat. Valeurs valides :

    • false (par défaut)

    • true

    Remarque

    Prend effet uniquement si JobId est spécifié.

    UsedTime

    Integer

    Non

    5

    Durée de l'abonnement.

    • Valeurs valides si Period est défini sur Month : 1, 2, 3, 4, 5, 6, 7, 8 et 9.

    • Valeurs valides si Period est défini sur Year : 1, 2, 3 et 5.

      Remarque

      • Obligatoire uniquement si PayType est défini sur PrePaid.

      • Utilisez Period pour spécifier l'unité.

    Quantity

    Integer

    Non

    1

    Nombre d'instances DTS à acheter.

    Remarque

    Une seule instance peut être achetée par requête.

    AutoPay

    Boolean

    Non

    false

    Indique s'il faut renouveler automatiquement l'instance DTS à son expiration. Valeurs valides :

    • false (par défaut)

    • true

    Type

    String

    Non

    SYNC

    Type de l'instance DTS. Valeurs valides :

    • MIGRATION : instance de migration de données.

    • SYNC : instance de synchronisation de données.

    • SUBSCRIBE : instance de suivi des modifications.

      Remarque

      Spécifiez ce paramètre ou JobId.

    DatabaseCount

    Integer

    Non

    3

    Nombre d'instances ApsaraDB RDS personnalisées privées dans PolarDB-X. Par défaut : 1.

    Remarque

    Obligatoire uniquement si SourceEndpointEngineName est défini sur drds.

    SourceRegion

    String

    Non

    cn-hangzhou

    ID de région de l'instance source. Régions prises en charge.

    Remarque

    Spécifiez ce paramètre ou JobId.

    DestinationRegion

    String

    Non

    cn-hangzhou

    ID de région de l'instance de destination. Régions prises en charge.

    Remarque

    Spécifiez ce paramètre ou JobId.

    SourceEndpointEngineName

    String

    Non

    MySQL

    Moteur de base de données de l'instance source. Valeurs valides :

    • MySQL : instance ApsaraDB RDS for MySQL ou base de données MySQL auto-gérée.

    • PolarDB : cluster PolarDB for MySQL.

    • polardb_o : cluster PolarDB for Oracle.

    • polardb_pg : cluster PolarDB for PostgreSQL.

    • Redis : instance Tair (compatible Redis OSS) ou base de données Redis auto-gérée.

    • DRDS : instance PolarDB-X 1.0 ou PolarDB-X 2.0.

    • PostgreSQL : base de données PostgreSQL auto-gérée.

    • odps : projet MaxCompute.

    • oracle : base de données Oracle auto-gérée.

    • mongodb : instance ApsaraDB for MongoDB ou base de données MongoDB auto-gérée.

    • tidb : base de données TiDB.

    • ADS : cluster AnalyticDB for MySQL V2.0.

    • ADB30 : cluster AnalyticDB for MySQL V3.0.

    • Greenplum : instance AnalyticDB for PostgreSQL.

    • MSSQL : instance ApsaraDB RDS for SQL Server ou base de données SQL Server auto-gérée.

    • kafka : instance ApsaraMQ for Kafka ou cluster Kafka auto-géré.

    • DataHub : projet DataHub.

    • DB2 : base de données Db2 for LUW auto-gérée.

    • as400 : base de données Db2 for i (AS/400).

    • Tablestore : instance Tablestore.

    • OceanBase : base de données ApsaraDB for OceanBase (compatible avec MySQL), prise en charge uniquement dans les instances de migration de données.

    Remarque

    DestinationEndpointEngineName

    String

    Non

    MySQL

    Moteur de base de données de l'instance de destination. Valeurs valides :

    • MySQL : instance ApsaraDB RDS for MySQL ou base de données MySQL auto-gérée.

    • PolarDB : cluster PolarDB for MySQL.

    • polardb_o : cluster PolarDB for Oracle.

    • polardb_pg : cluster PolarDB for PostgreSQL.

    • Redis : instance Tair (compatible Redis OSS) ou base de données Redis auto-gérée.

    • DRDS : instance PolarDB-X 1.0 ou PolarDB-X 2.0.

    • PostgreSQL : base de données PostgreSQL auto-gérée.

    • odps : projet MaxCompute.

    • oracle : base de données Oracle auto-gérée.

    • mongodb : instance ApsaraDB for MongoDB ou base de données MongoDB auto-gérée.

    • tidb : base de données TiDB.

    • ADS : cluster AnalyticDB for MySQL V2.0.

    • ADB30 : cluster AnalyticDB for MySQL V3.0.

    • Greenplum : instance AnalyticDB for PostgreSQL.

    • MSSQL : instance ApsaraDB RDS for SQL Server ou base de données SQL Server auto-gérée.

    • kafka : instance ApsaraMQ for Kafka ou cluster Kafka auto-géré.

    • DataHub : projet DataHub.

    • DB2 : base de données Db2 for LUW auto-gérée.

    • as400 : base de données Db2 for i (AS/400).

    • Tablestore : instance Tablestore.

    Remarque

    ComputeUnit

    Integer

    Non

    5

    Spécifications de l'instance ETL en unités de calcul (CUs). Une CU équivaut à 1 vCPU et 4 Go de mémoire. Valeur minimale : 2.

    RegionId

    String

    Non

    cn-hangzhou

    ID de région de l'instance DTS. Régions prises en charge.

    FeeType

    String

    Non

    ONLY_CONFIGURATION_FEE

    Type de facturation pour une instance de suivi des modifications. Valeurs valides : ONLY_CONFIGURATION_FEE (frais de configuration uniquement) et CONFIGURATION_FEE_AND_DATA_FEE (frais de configuration et frais de trafic de données).

    Du

    Integer

    Non

    30

    Nombre d'unités DTS (DUs) attribuées à une tâche DTS sur un cluster dédié. Valeurs valides : 1 à 100.

    Remarque

    ResourceGroupId

    String

    Non

    rg-acfmzawhxxc****

    ID du groupe de ressources.

    MinDu

    double

    Non

    1

    Nombre minimal de DUs.

    Remarque

    Ce paramètre est pris en charge uniquement pour les instances serverless.

    MaxDu

    double

    Non

    16

    Nombre maximal de DUs.

    Remarque

    Ce paramètre est pris en charge uniquement pour les instances serverless.

    DtsRegion

    String

    Non

    cn-hangzhou

    ID de région de l'instance DTS. Définissez la même valeur que RegionId.

    Paramètres de réponse

    Paramètre

    Type

    Exemple

    Description

    RequestId

    String

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

    ID de la requête.

    ErrCode

    String

    InternalError

    Code d'erreur retourné en cas d'échec de la requête.

    Success

    String

    true

    Indique si la requête a réussi.

    JobId

    String

    bi6e22ay243****

    ID de la tâche.

    ErrMessage

    String

    The request processing has failed due to some unknown error.

    Message d'erreur retourné en cas d'échec de la requête.

    InstanceId

    String

    dtsbi6e22ay243****

    ID de l'instance.

    Exemples

    Exemples de requêtes

    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>

    Exemples de réponses réussies

    Format 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>

    Format JSON

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

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

    Codes d'erreur

    HttpCode

    Code d'erreur

    Message d'erreur

    Description

    403

    LXCreateOrderError

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

    La fonctionnalité de synchronisation transfrontalière de DTS n'est pas disponible pour tous les utilisateurs. Pour l'utiliser, soumettez <a href="https://page.aliyun.com/form/act409679078/index.htm" target="_blank">une demande</a> d'examen.

    403

    LXCreateOrder.NotFoundPricePlan

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

    Échec de la création de la commande. Aucun plan tarifaire trouvé. Causes possibles : paramètres non valides ou tarification manquante.

    403

    LXPayOrder.InsufficientBalance

    Insufficient balance, order payment failed.

    Échec du paiement en raison d'un solde insuffisant. Rechargez votre compte et réessayez.

    403

    DTS.Msg.LXCreateOrderError

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

    La fonctionnalité de synchronisation transfrontalière de DTS n'est pas disponible pour tous les utilisateurs. Pour l'utiliser, soumettez <a href="https://page.aliyun.com/form/act409679078/index.htm" target="_blank">une demande</a> d'examen.

    403

    DTS.Msg.LXCreateOrder.NotFoundPricePlan

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

    Échec de la création de la commande. Aucun plan tarifaire trouvé. Causes possibles : paramètres non valides ou tarification manquante.

    403

    DTS.Msg.LXPayOrder.InsufficientBalance

    Insufficient balance, order payment failed.

    Échec du paiement en raison d'un solde insuffisant. Rechargez votre compte et réessayez.

    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.

    La fonctionnalité de synchronisation transfrontalière de DTS n'est pas disponible pour tous les utilisateurs. Pour l'utiliser, soumettez <a href="https://page-intl.aliyun.com/form/act1633074550/index.htm" target="_blank">une demande</a> d'examen.

    403

    InvalidSecurityToken.Expired

    Specified SecurityToken is expired.

    La signature a expiré. Utilisez une nouvelle signature.

    400

    Throttling.User

    Request was denied due to user flow control.

    Le nombre d'appels par seconde dépasse la limite. Réessayez plus tard.

    500

    ServiceUnavailable

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

    Délai d'attente dépassé ou serveur indisponible. Réessayez. Si l'erreur persiste, contactez le support technique.

    Codes d'erreur du service.