ModifyReplicationJobAttribute - - Centre de documentation Alibaba Cloud

Modifie les informations d'une tâche de migration.

Description de l'opération

Description

Avant de modifier une tâche de migration, notez les points suivants :

Les paramètres Name et Description peuvent être modifiés à tout moment au cours du cycle de vie de la tâche de migration.
Les paramètres Frequency et MaxNumberOfImageToKeep ne peuvent être modifiés qu'avant l'exécution de la tâche de migration ou lorsque la tâche est dans l'état Waiting.
Les autres paramètres ne peuvent être modifiés qu'avant l'exécution de la tâche de migration.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

smc:ModifyReplicationJobAttribute

update

*ReplicationJob

acs:smc:{#regionId}:{#accountId}:replicationjob/{#JobId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
JobId	string	Oui	L'identifiant de la tâche de migration.	j-bp19vlwm0tyigbmj****
Name	string	Non	Le nom de la tâche de migration. Le nom doit respecter les exigences suivantes : Le nom doit être unique. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre ou un caractère chinois. Il ne peut pas commencer par http:// ou https://. Il peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).	testMigrationTaskName
Description	string	Non	La description de la tâche de migration. La description doit comporter entre 2 et 128 caractères. Elle doit commencer par une lettre ou un caractère chinois. Elle ne peut pas commencer par http:// ou https://. Elle peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).	This_is_my_migration_task
TargetType	string	Non	Le type de destination de la migration. Ce paramètre ne peut être modifié qu'avant le démarrage de la tâche de migration. Valeurs valides : Image : une fois la migration terminée, SMC génère une image Alibaba Cloud à partir du serveur source. Vous pouvez utiliser cette image pour créer une instance ECS. ContainerImage : une fois la migration terminée, SMC génère une image de conteneur à partir du serveur source. Vous pouvez utiliser cette image dans Container Registry. TargetInstance : une fois la migration terminée, SMC migre la source vers une instance de destination. Si vous définissez ce paramètre sur cette valeur, vous devez également spécifier le paramètre InstanceId. Remarque La valeur de ce paramètre n'est pas sensible à la casse. La migration de serveurs exécutant Windows ou un système d'exploitation basé sur Arm vers des images de conteneur n'est pas prise en charge.	Image
ScheduledStartTime	string	Non	L'heure à laquelle vous souhaitez démarrer la tâche de migration. SMC démarre automatiquement la tâche de migration à l'heure spécifiée. L'heure doit suivre la norme ISO 8601 et être en UTC. Le format est YYYY-MM-DDThh:mm:ssZ. Par exemple, 2018-01-01T12:00:00Z correspond à 20:00:00 le 1er janvier 2018 (UTC+8). Remarque Si vous laissez ce paramètre vide, SMC ne démarre pas automatiquement la tâche de migration. Vous devez appeler l'opération StartReplicationJob pour démarrer la tâche.	2019-06-04T13:35:00Z
ImageName	string	Non	Le nom de l'image de destination. Le nom doit respecter les exigences suivantes : Le nom de l'image doit être unique dans la même région Alibaba Cloud. Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre ou un caractère chinois. Il ne peut pas commencer par http:// ou https://. Il peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Remarque Si une image portant le même nom existe déjà dans la région actuelle lors de l'exécution de la tâche de migration, le système ajoute l'identifiant de la tâche de migration (JobId) à la fin du nom de l'image en tant que suffixe. Exemple : ImageName-JobId.	testAliCloudImageName
InstanceId	string	Non	L'identifiant de l'instance de destination.	i-bp1f1dvfto1sigz5****
SystemDiskSize	integer	Non	La taille du disque système de l'instance ECS de destination. Unité : Gio. Valeurs valides : de 20 à 500. Remarque La valeur de ce paramètre doit être supérieure à l'espace utilisé par le disque système du serveur source. Par exemple, si le disque système du serveur source a une taille de 500 Gio et que 100 Gio d'espace sont utilisés, vous devez définir ce paramètre sur une valeur supérieure à 100.	50
Frequency	integer	Non	L'intervalle d'exécution d'une tâche de migration incrémentielle. Unité : heures. Valeurs valides : de 1 à 168. Ce paramètre est requis si le paramètre RunOnce est défini sur false.	10
MaxNumberOfImageToKeep	integer	Non	Le nombre maximal d'images à conserver pour une tâche de migration incrémentielle. Valeurs valides : de 1 à 10. Ce paramètre est requis si le paramètre RunOnce est défini sur false.	5
InstanceType	string	Non	Le type d'instance de l'instance intermédiaire. Vous pouvez appeler l'opération DescribeInstanceTypes pour interroger les types d'instance fournis par ECS. Si vous spécifiez ce paramètre, le système crée une instance intermédiaire de ce type d'instance. Si le type d'instance spécifié est en rupture de stock, la création de la tâche de migration échoue. Si vous ne spécifiez pas ce paramètre, le système sélectionne un type d'instance dans un ordre spécifique pour créer l'instance intermédiaire. Pour plus d'informations, consultez la FAQ SMC.	ecs.c5.large
LaunchTemplateId	string	Non	L'identifiant du modèle de lancement.	lt-bp16jovvln1cgaaq****
LaunchTemplateVersion	string	Non	La version du modèle de lancement.	Latest
InstanceRamRole	string	Non	Le nom du rôle RAM pour l'instance.	SMCAdmin
ContainerNamespace	string	Non	L'espace de noms du conteneur Docker. Pour plus d'informations sur les images de conteneur Docker, consultez Container Registry.	testNamespace
ContainerRepository	string	Non	Le référentiel d'images pour le conteneur Docker. Pour plus d'informations sur les images de conteneur Docker, consultez Container Registry.	testRepository
ContainerTag	string	Non	La balise d'image pour le conteneur Docker. Pour plus d'informations sur les images de conteneur Docker, consultez Container Registry.	CentOS:v1
ValidTime	string	Non	L'heure d'expiration de la tâche de migration. La valeur peut être une heure située entre 7 et 90 jours après la création de la tâche de migration. Vous ne pouvez modifier l'heure d'expiration que lorsque la tâche de migration est dans l'état Ready, Running, Stopped, InError ou Waiting. L'heure doit suivre la norme ISO 8601 et être en UTC. Le format est YYYY-MM-DDThh:mm:ssZ. Par exemple, 2018-01-01T12:00:00Z correspond à 20:00:00 le 1er janvier 2018 (UTC+8). Si vous laissez ce paramètre vide, la tâche n'expire pas. Une fois qu'une tâche expire, elle est marquée comme Expired. La tâche est conservée pendant 7 jours. Après 7 jours, le système supprime automatiquement la tâche. Valeur par défaut : 30 jours après la création de la tâche de migration. Cela signifie que la tâche de migration est valide pendant 30 jours par défaut.	2019-06-04T13:35:00Z
SystemDiskPart	array<object>	Non	Les partitions du disque système.
	object	Non	Les partitions du disque système.
SizeBytes	integer	Non	La taille de la partition N du disque système de destination. Unité : octets. La valeur par défaut est la taille de la partition du disque système source. Remarque La taille d'une partition ne peut pas dépasser la taille du disque système. La taille totale de toutes les partitions d'un disque système ne peut pas dépasser la taille du disque système.	254803968
Block	boolean	Non	Indique si la réplication par blocs doit être activée pour la partition N du disque système de destination. Valeurs valides : true false	true
Device	string	Non	L'identifiant de périphérique de la partition N du disque système de destination. Remarque Pour la valeur de N, consultez l'identifiant de périphérique de la partition source.	0_1
DataDisk	array<object>	Non	Les disques de données.
	array<object>	Non	Les disques de données.
Index	integer	Non	Le numéro de séquence du disque de données sur l'instance ECS de destination. Valeurs valides : de 1 à 16. La valeur initiale est 1. Remarque Vous ne pouvez créer un disque de données de destination que pour un disque de données qui existe sur le serveur source.	1
Part	array<object>	Non	Les partitions.
	object	Non	Les partitions.
SizeBytes	integer	Non	La taille de la partition N du disque de données N. Unité : octets. La valeur par défaut est la taille de la partition du disque de données source. Remarque La taille d'une partition ne peut pas dépasser la taille du disque de données. La taille totale de toutes les partitions d'un disque de données ne peut pas dépasser la taille du disque de données.	254803968
Block	boolean	Non	Indique si la réplication par blocs doit être activée pour la partition N du disque de données N. Valeurs valides : true false	true
Device	string	Non	L'identifiant de périphérique de la partition N du disque de données N. Remarque Pour la valeur de N, consultez l'identifiant de périphérique de la partition source.	0_1
Size	integer	Non	La taille du disque de données sur l'instance ECS de destination. Unité : Gio. Valeurs valides : de 20 à 32768. Remarque La valeur de ce paramètre doit être supérieure à l'espace utilisé par le disque de données du serveur source. Par exemple, si le disque de données du serveur source a une taille de 500 Gio et que 100 Gio d'espace sont utilisés, vous devez définir ce paramètre sur une valeur supérieure à 100.	100
NetMode	integer	Non	Le mode réseau pour la transmission des données. Valeurs valides : 0 : mode de transfert par Internet. Le serveur source doit pouvoir accéder à Internet. Les données sont transférées via Internet. 2 : mode de transfert par réseau interne. Si vous sélectionnez ce mode, vous devez définir le paramètre VSwitchId. Le paramètre VpcId n'est pas requis car le service peut interroger automatiquement l'identifiant du VPC.	0
VSwitchId	string	Non	L'identifiant du vSwitch dans le VPC spécifié.	vsw-bp1ddbrxdlrcbim46****
VpcId	string	Non	L'identifiant du VPC configuré avec Express Connect ou une passerelle VPN.	vpc-bp1vwnn14rqpyiczj****
ReplicationParameters	string	Non	Les paramètres du pilote de réplication. Les paramètres sont des paires clé-valeur au format JSON. Les clés sont fixes. La valeur peut comporter jusqu'à 2 048 caractères. Le pilote de réplication est un outil utilisé pour répliquer les données du serveur source vers l'instance intermédiaire. Les paramètres pris en charge par les pilotes de réplication peuvent varier. Le pilote de réplication SMT prend en charge les paramètres suivants : bandwidth_limit : la limite de bande passante pour la transmission des données. compress_level : le taux de compression des données à transférer. checksum : indique si la vérification de la somme de contrôle doit être activée. Pour plus d'informations sur la valeur du pilote de réplication, consultez le paramètre SourceServers.ReplicationDriver dans la réponse de l'opération DescribeSourceServers.	{"bandwidth_limit":0,"compress_level":1,"checksum":true}

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	1C488B66-B819-4D14-8711-C4EAAA13AC01

Exemples

JSON format

{
  "RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	DataDisk.DuplicateIndex	The source server data disk cannot contain the same index.	The source server data disk cannot contain the same index.
400	ReplicationJobDataDiskIndex.Invalid	The specified replication job contains data disk index not found in source server.	The specified replication job contains data disk indexes that do not exist in the source server.
400	ReplicationJobName.Duplicate	The specified replication job name already exists.	The specified replication job name already exists.
400	ReplicationJob.InvalidStatus	The specified replication job status: %s is invalid. This operation can only be performed in the following status: %s.	The specified replication job status: %s is invalid. This operation can only be performed in the following status: %s.
400	ReplicationJob.InvalidBusinessStatus	The specified business status: %s of the replication job is invalid. This operation can only be performed in the following status: %s.	The specified business status: %s of the replication job is invalid. This operation can only be performed in the following status: %s.
400	ImageName.UsedByReplicationJob	The specified imageName: "%s" was used by another replication job in the current region.	The specified imageName: "%s" was used by another replication job in the current region.
500	InternalError	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.