ModifyDtsJobEndpoint - Data Transmission Service - Centre de documentation Alibaba Cloud

Remarque

Après le changement de base de données, DTS rétablit le décalage d'écriture incrémentielle pendant 10 secondes. Si les données synchronisées ou migrées ne possèdent pas de clé primaire, assurez-vous qu'aucune écriture n'est effectuée dans la base de données source lors du remplacement de la base de données source ou de destination. Dans le cas contraire, des données en double peuvent apparaître.

Débogage

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

Paramètres de requête

Paramètre	Type	Required	Exemple	Description
Action	String	Yes	ModifyDtsJobEndpoint	Opération à effectuer. Définissez la valeur sur ModifyDtsJobEndpoint.
RegionId	String	No	cn-hangzhou	ID de la région de l'instance DTS.
DtsJobId	String	No	m4312mab158****	ID de la tâche de synchronisation ou de migration de données. Appelez l'opération DescribeDtsJobs pour interroger l'ID de la tâche. Remarque DtsInstanceId est requis si vous laissez ce paramètre vide.
DtsInstanceId	String	No	dtsaw012y2g15q****	ID de l'instance de synchronisation ou de migration de données. Remarque DtsJobId est requis si vous laissez ce paramètre vide.
SynchronizationDirection	String	No	Forward	Direction de la synchronisation. Valeurs valides : Forward (par défaut) : Les données sont synchronisées de la base de données source vers la base de données de destination. Reverse : Les données sont synchronisées de la base de données de destination vers la base de données source.
Endpoint	String	Yes	src	Base de données à modifier. Valeurs valides : src : la base de données source. dest : la base de données de destination.
EndpointRegionId	String	No	cn-hangzhou	Région dans laquelle se trouve la base de données.
EndpointInstanceType	String	Yes	rds	Type de la base de données. Valeurs valides : rds : Instance ApsaraDB RDS for MySQL ou ApsaraDB RDS for PostgreSQL. polardb : Cluster PolarDB for MySQL ou PolarDB for PostgreSQL. mongodb : Instances source ApsaraDB for MongoDB en replica set et instances de destination ApsaraDB for MongoDB en replica set ou cluster fragmenté. distributed_mongodb : Instances distribuées source ApsaraDB for MongoDB en cluster fragmenté. Remarque Pour les tâches de synchronisation ou de migration de données incrémentielles sur des instances distribuées, vous devez d'abord utiliser l'oplog pour enregistrer les modifications de données dans la base de données source. greenplum : Instance AnalyticDB for PostgreSQL. kafka : Instance ApsaraMQ for Kafka. ecs : Base de données autogérée hébergée sur une instance Elastic Compute Service (ECS). express : Base de données connectée via Express Connect. other : Base de données connectée via Internet. Remarque Les types de bases de données suivants sont pris en charge : MySQL, PolarDB for MySQL, PostgreSQL, PolarDB for PostgreSQL, MongoDB, Kafka et AnalyticDB for PostgreSQL. Si la base de données que vous souhaitez modifier est une base de données MongoDB avec une architecture de cluster fragmenté, la nouvelle base de données MongoDB doit avoir le même nombre de fragments que la base de données MongoDB d'origine. Si la base de données que vous souhaitez modifier est une base de données PostgreSQL source, assurez-vous que la latence de l'instance DTS est inférieure à 30 secondes et qu'aucune donnée n'est écrite dans la base de données source pendant la modification. Dans le cas contraire, une incohérence des données peut se produire. La valeur de ce paramètre n'est pas sensible à la casse.
EndpointInstanceId	String	No	rm-bp10k50h8374w****	ID de la base de données.
EndpointIp	String	No	172.168.XX.XXX	Adresse IP de la base de données.
EndpointPort	String	No	3306	Numéro de port de la base de données.
ModifyAccount	Boolean	No	false	Indique s'il faut modifier le mot de passe du compte de la base de données. Valeurs valides : true : Oui. false (par défaut) : Non.
Username	String	No	dtstest	Compte de la base de données de l'instance. Remarque Ce paramètre n'est valide que si ModifyAccount est défini sur true.
Password	String	No	DTStest****	Mot de passe du compte de la base de données. Remarque Ce paramètre n'est valide que si ModifyAccount est défini sur true.
Database	String	No	admin	Si le type de la base de données à modifier est PostgreSQL, PolarDB for PostgreSQL ou AnalyticDB for PostgreSQL, définissez ce paramètre sur le nom de la base de données. Si le type de la base de données à modifier est MongoDB, définissez ce paramètre sur le nom de la base de données d'authentification. Remarque Ce paramètre est valide et requis uniquement si le type de base de données est PostgreSQL, PolarDB for PostgreSQL, AnalyticDB for PostgreSQL ou MongoDB.
ShardUsername	String	No	shard	Nom d'utilisateur du compte utilisé pour se connecter à l'instance ApsaraDB for MongoDB en cluster fragmenté. Remarque Ce paramètre est valide et requis uniquement si la base de données source est une instance ApsaraDB for MongoDB en cluster fragmenté. Ce paramètre n'est valide que si ModifyAccount est défini sur true.
ShardPassword	String	No	DTStest****	Mot de passe du compte utilisé pour se connecter à l'instance ApsaraDB for MongoDB en cluster fragmenté. Remarque Ce paramètre est valide et requis uniquement si la base de données source est une instance ApsaraDB for MongoDB en cluster fragmenté. Ce paramètre n'est valide que si ModifyAccount est défini sur true.
RoleName	String	No	ram-for-dts	Nom du rôle Resource Access Management (RAM) spécifié pour accéder aux ressources entre différents comptes Alibaba Cloud. Remarque Ce paramètre est requis si vous synchronisez ou migrez des données entre différents comptes Alibaba Cloud. Pour plus d'informations, consultez Configurer l'autorisation RAM pour les tâches DTS intercomptes.
AliyunUid	String	No	150780020300****	ID du compte Alibaba Cloud auquel appartient l'instance de base de données. Remarque Si vous spécifiez ce paramètre, les données sont synchronisées ou migrées entre différents comptes Alibaba Cloud. Vous devez également spécifier RoleName.
DryRun	Boolean	No	true	Indique s'il faut effectuer uniquement une prévalidation. Valeurs valides : true : Oui. Après la réussite de la prévalidation, la base de données n'est pas modifiée. false (par défaut) : Non. Après la réussite de la prévalidation, la base de données est modifiée et la tâche DTS est exécutée.
ResourceGroupId	String	No	rg-acfmzawhxxc****	ID du groupe de ressources.

Paramètres de réponse

Paramètre	Type	Exemple	Description
HttpStatusCode	String	200	Code d'état HTTP.
RequestId	String	3FA98DF2-2F81-51FF-8A38-AA5112DD****	ID de la requête.
Success	Boolean	true	Indique si la requête a abouti. Valeurs valides :
ErrCode	String	DTS.Msg.InvalidEndpoint	Code d'erreur renvoyé en cas d'échec de la requête.
ErrMessage	String	The endpoint is invalid.	Message d'erreur renvoyé en cas d'échec de la requête.

Exemples

Exemple de requêtes

http(s)://dts.aliyuncs.com/?Action=ModifyDtsJobEndpoint
&RegionId=cn-hangzhou
&DtsInstanceId=dtsaw012y2g15q****
&SynchronizationDirection=Forward
&Endpoint=src
&EndpointInstanceType=rds
&EndpointInstanceId=rm-bp10k50h8374w****
&Username=dtstest
&Password=DTStest****
&DryRun=true
& Common request parameters

Exemple de réponses réussies

XML format

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

<ModifyDtsJobEndpointResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <RequestId>3FA98DF2-2F81-51FF-8A38-AA5112DD****</RequestId>
    <Success>true</Success>
</ModifyDtsJobEndpointResponse>

JSON format

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

{
  "HttpStatusCode" : "200",
  "RequestId" : "3FA98DF2-2F81-51FF-8A38-AA5112DD****",
  "Success" : true
}

Codes d'erreur

HttpCode	Code d'erreur	Message d'erreur	Description
400	InvalidParameter.TagKey	The Tag.N.Key parameter is invalid.	La clé de tag spécifiée n'est pas valide. Saisissez une clé de tag valide.
400	InvalidParameter.TagValue	The Tag.N.Value parameter is invalid.	La valeur de tag spécifiée n'est pas valide. Saisissez une valeur de tag valide.
400	InvalidParameter.Tags	The specified value of parameter Tags is not valid.	La clé ou la valeur de tag spécifiée n'est pas valide. Saisissez une clé ou une valeur de tag valide.
400	Missing.TagKey	You must specify the key for value %s in Tag.N.Key.	La clé de tag n'est pas spécifiée.
400	MissingParameter.TagOrResourceId	Either Tags or ResourceIds must be specified.	Le tag ou l'ID d'instance n'est pas spécifié.
400	NumberExceed.Tags	The maximum number of Tags is exceeded. The maximum value is 20.	Le nombre maximal de tags est atteint, soit 20. Supprimez les tags inutiles.
400	NumberExceed.ResourceIds	The maximum number of ResourceIds is exceeded. The maximum value is 50.	Le nombre maximal d'ID d'instance est atteint, soit 20. Supprimez les ID d'instance inutiles.
400	InvalidParameter.Category	The specified Category is invalid. Valid values are Custom and System.	La valeur de Category n'est pas valide. Valeurs valides : Custom et System.
400	InvalidParameter.NextToken	The parameter NextToken is invalid.	La valeur de NextToken n'est pas valide. Saisissez un jeton valide.
400	InvalidParameter.ResourceType	The ResourceType parameter is invalid.	La valeur de ResourceType n'est pas valide. Définissez la valeur sur ALIYUN::DTS::INSTANCE.
400	InvalidParameter.Scope	The specified Scope is invalid. Valid value: public, private.	L'étendue spécifiée autorisée pour afficher le tag n'est pas valide. Valeurs valides : public et private.
400	Throttling.User	Request was denied due to user flow control.	Le nombre de requêtes a atteint la limite et la requête a été rejetée. Réessayez ultérieurement.
403	Duplicate.TagKey	The Tag.N.Key contains duplicate keys.	La clé de tag spécifiée existe déjà. Supprimez la clé de tag en double.
403	NoPermission.SystemTag	You are not authorized to operate system tag because the product code is invalid.	Vous n'êtes pas autorisé à effectuer des opérations sur les valeurs de tag en raison d'un code non valide.
403	QuotaExceed.TagsPerResource	The maximum number of tags for each resource is exceeded.	Le nombre maximal de tags est atteint. Supprimez les tags inutiles.
403	NoPermission.Operator	The user is not authorized to operate on the specified resource.	Vous n'êtes pas autorisé à effectuer des opérations sur la ressource spécifiée.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	La signature a expiré. Utilisez une nouvelle signature.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Le délai d'attente de la réponse du serveur est dépassé ou le serveur n'est pas disponible. Réessayez. Si l'erreur persiste, contactez le support technique.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur.