CreateReplicationJob - - Centre de documentation Alibaba Cloud

Crée une tâche de migration pour une source de migration en appelant CreateReplicationJob.

Description de l'opération

Description de l'opération.

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:CreateReplicationJob

create

*Tâche de réplication.

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

*Serveur source.

acs:smc:{#regionId}:{#accountId}:sourceserver/{#SourceServerId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région Alibaba Cloud de destination vers laquelle la source de migration doit être migrée.	cn-hangzhou
ClientToken	string	Non	Garantit l'idempotence de la requête. Vous pouvez générer une valeur de paramètre contenant jusqu'à 64 caractères ASCII à partir du client et l'attribuer à ClientToken pour garantir l'idempotence des requêtes de nouvelle tentative. Pour plus d'informations, consultez Comment garantir l'idempotence.	123e4567-e89b-12d3-a456-426655440000
Name	string	Non	Le nom de la tâche de migration. Le nom doit respecter les exigences suivantes : Le nom de la tâche doit être unique. Le nom doit comporter de 2 à 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. Il peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) ou des traits d'union (-).	testMigrationTaskName
Description	string	Non	La description de la tâche de migration. La description doit comporter de 2 à 128 caractères et 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 (_) ou des traits d'union (-).	This_is_a_migration_task
SourceId	string	Oui	L'identifiant de la source de migration.	s-bp1e2fsl57knvuug****
TargetType	string	Non	Le type cible de la tâche de migration. Valeurs valides : Image : Après une migration réussie, Server Migration Center (SMC) génère une image Alibaba Cloud pour votre source de migration. ContainerImage : Après une migration réussie, SMC génère une image de conteneur Docker pour votre source de migration. TargetInstance : Après une migration réussie, SMC migre votre source de migration directement vers l'instance cible. Si vous définissez ce paramètre sur TargetInstance, vous devez également spécifier le paramètre InstanceId.	Image
ScheduledStartTime	string	Non	L'heure d'exécution de la tâche de migration. La valeur de ce paramètre doit répondre aux exigences suivantes : L'heure doit suivre la norme ISO 8601 en UTC+0. Le format est YYYY-MM-DDThh:mm:ssZ. Par exemple, 2018-01-01T12:00:00Z correspond au 1er janvier 2018 à 20:00:00 (UTC+8). La valeur doit être postérieure à l'heure actuelle et se situer dans un délai de 30 jours à compter de l'heure actuelle. Remarque Si ce paramètre est laissé vide, Server Migration Center (SMC) ne démarre pas la tâche de migration. Vous devez appeler StartReplicationJob pour démarrer la tâche.	2019-06-04T13:35:00Z
ValidTime	string	Non	L'heure d'expiration de la tâche de migration. Valeurs valides : heure de création de la tâche de migration + 7 jours à heure de création de la tâche de migration + 90 jours.	2019-06-04T13:35:00Z
ImageName	string	Non	Le nom de l'image Alibaba Cloud de destination produite par la tâche de migration. Le nom de l'image 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 et ne peut pas commencer par `http://` ou `https://`. Il peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) ou des traits d'union (-). Remarque Pendant la tâche de migration, si une image portant le même nom existe déjà dans la région actuelle, le système ajoute par défaut l'identifiant de la tâche de migration (JobId) comme suffixe au nom de l'image, par exemple ImageName_j-2zexxxxxxxxxxxxx.	testAliCloudImageName
InstanceId	string	Non	L'identifiant de l'instance cible.	i-bp1f1dvfto1sigz5****
SystemDiskSize	integer	Non	La taille du disque cloud système de l'instance ECS Alibaba Cloud de destination. Unité : GiB. Valeurs valides : 20 à 2048. Remarque La valeur de ce paramètre doit être supérieure à l'espace réellement utilisé du disque cloud système source de la migration. Par exemple, si la taille du disque cloud système source est de 500 GiB mais que l'espace réellement utilisé est de 100 GiB, la valeur de ce paramètre doit être supérieure à 100 GiB.	80
VpcId	string	Non	L'identifiant du VPC pour lequel Express Connect ou VPN Gateway est configuré.	vpc-bp1vwnn14rqpyiczj****
VSwitchId	string	Non	L'identifiant du vSwitch dans le VPC spécifié.	vsw-bp1ddbrxdlrcbim46****
ReplicationParameters	string	Non	Les informations de paramètre du pilote de réplication. Les informations de paramètre sont au format de paires clé-valeur JSON avec des clés fixes. Longueur maximale : 2048 caractères.	{"bandwidth_limit":0,"compress_level":1,"checksum":true}
NetMode	integer	Non	Le mode réseau pour la transmission de données. Valeurs valides : 0 : mode de transmission sur réseau public. La source de migration doit avoir accès à Internet et les données de migration sont transmises via Internet. 2 : mode de transmission sur réseau interne. Si vous sélectionnez ce mode, vous devez définir le paramètre VSwitchId. Vous n'avez pas besoin de définir le paramètre VpcId, car le service peut obtenir automatiquement l'identifiant VPC via des appels d'API internes. Valeur par défaut : 0.	0
RunOnce	boolean	Non	Indique s'il faut créer une tâche de migration unique ou une tâche de migration incrémentielle. Valeurs valides : true (par défaut) : tâche de migration unique. La tâche s'exécute une seule fois après sa création. false : tâche de migration incrémentielle. Une fois la tâche créée, elle s'exécute automatiquement de manière périodique en fonction de la valeur du paramètre `Frequency`. Les tâches de migration incrémentielle vous permettent de synchroniser les données incrémentielles de la source de migration vers Alibaba Cloud sans interrompre votre activité, et de générer une image complète des données de la source de migration au moment de l'exécution de la tâche. Remarque Ce paramètre ne peut être spécifié que lors de la création d'une tâche de migration. Une fois la valeur spécifiée, elle ne peut plus être modifiée.	true
Frequency	integer	Non	L'intervalle auquel la tâche de migration incrémentielle s'exécute. Unité : heures. Valeurs valides : 1 à 168. Ce paramètre est requis lorsque RunOnce est défini sur false. Valeur par défaut : null.	12
MaxNumberOfImageToKeep	integer	Non	Le nombre maximal d'images conservées par défaut pour une tâche de migration incrémentielle. Valeurs valides : 1 à 10. Ce paramètre est requis lorsque RunOnce est défini sur false. Valeur par défaut : null.	10
InstanceType	string	Non	Le type d'instance de l'instance ECS intermédiaire. Appelez DescribeInstanceTypes pour interroger les types d'instances fournis par Elastic Compute Service (ECS). Si vous spécifiez ce paramètre, le système crée l'instance intermédiaire avec le type d'instance spécifié. 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 Quels types d'instances peuvent être utilisés pour les instances intermédiaires dans la FAQ SMC.	ecs.c6.large
LaunchTemplateId	string	Non	L'identifiant du modèle de lancement d'instance.	lt-bp16jovvln1cgaaq****
LaunchTemplateVersion	string	Non	La version du modèle de lancement d'instance.	1
InstanceRamRole	string	Non	Le nom du rôle RAM de l'instance.	SMCAdmin
ContainerNamespace	string	Non	L'espace de noms du conteneur Docker. Pour plus d'informations sur les images de conteneurs Docker, consultez Container Registry.	testNamespace
ContainerRepository	string	Non	Le référentiel d'images Docker. Pour plus d'informations sur les images de conteneurs Docker, consultez Container Registry.	testRepository
ContainerTag	string	Non	La balise d'image Docker. Pour plus d'informations sur les images de conteneurs Docker, consultez Container Registry.	CentOS:v1
LicenseType	string	Non	Le type de licence. Valeurs valides : Valeur vide : aucune licence. BYOL : apportez votre propre licence. Pour plus d'informations, consultez la FAQ SMC.	BYOL
DataDisk	array<object>	Non	La liste des informations de disque cloud de données.
	array<object>	Non	La liste des informations de disque cloud de données.
Index	integer	Non	L'index du disque cloud de données sur l'instance ECS Alibaba Cloud de destination. La valeur initiale est 1. Valeurs valides : 1 à 16. Remarque Vous pouvez créer des disques cloud de données de destination uniquement pour les disques de données présents sur la source de migration.	1
Part	array<object>	Non	La liste des partitions.
	object	Non	La liste des partitions.
SizeBytes	integer	Non	La taille de la partition N sur le disque cloud de données cible N. Unité : octets. Valeur par défaut : la taille de la partition du disque cloud de données source. Remarque La taille de la partition ne peut pas dépasser la taille du disque cloud de données, et la taille totale de toutes les partitions sur le même disque cloud de données ne peut pas dépasser la taille du disque cloud de données. Si `DataDisk.N.Part.N.Device` n'est pas vide, ce paramètre ne peut pas être vide non plus.	254803968
Block	boolean	Non	Indique s'il faut activer la réplication par blocs pour la partition N sur le disque cloud de données N. Valeurs valides :	true
Device	string	Non	L'identifiant du périphérique de la partition N sur le disque cloud de données N. Pour la valeur réelle de N, reportez-vous à l'identifiant du périphérique de la partition de la source de migration. Remarque Si DataDisk.N.Part.N.SizeBytes n'est pas vide, ce paramètre ne doit pas être vide non plus.	0_1
Size	integer	Non	La taille du disque cloud de données sur l'instance ECS Alibaba Cloud de destination. Unité : GiB. Valeurs valides : 20 à 32768. La valeur de ce paramètre doit être supérieure à l'espace réellement utilisé sur le disque cloud de données source de la migration. Par exemple, si la taille du disque cloud de données source est de 500 GiB avec 100 GiB réellement utilisés, la valeur de ce paramètre doit être supérieure à 100 GiB.	100
Tag	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de balise de la tâche de migration. Valeurs valides de N : 1 à 20.	TestKey
Value	string	Non	La valeur de balise de la tâche de migration. Valeurs valides de N : 1 à 20.	TestValue
SystemDiskPart	array<object>	Non	Les informations de partition du disque cloud système.
	object	Non	La liste des partitions du disque cloud système.
SizeBytes	integer	Non	La taille de la partition N du disque cloud système. Unité : octets. Valeur par défaut : la taille de la partition du disque cloud système source.	254803968
Block	boolean	Non	Indique s'il faut activer la réplication par blocs pour la partition N du disque cloud système. Valeurs valides :	true
Device	string	Non	L'identifiant du périphérique de la partition N du disque système. Pour la valeur réelle de N, reportez-vous à l'identifiant du périphérique de la partition de la source de migration. Remarque Si `SystemDiskPart.N.SizeBytes` n'est pas vide, ce paramètre ne doit pas être vide non plus.	0_1
JobType	integer	Non	Le type de la tâche de migration. Valeurs valides :	0
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-acfmw3ty5y7****
Disks	object	Non	Les informations de disque.
System	object	Non	Les informations du disque cloud système.
Size	integer	Non	La taille du disque système de la source de migration. Unité : GiB. Valeurs valides : 20 à 32768. Remarque La valeur doit être supérieure à l'espace réellement utilisé sur le disque système source. Par exemple, si le disque système source est de 500 GiB mais que seuls 100 GiB sont utilisés, définissez ce paramètre sur une valeur supérieure à 100 GiB.	100
LVM	boolean	Non	Indique s'il faut utiliser Logical Volume Manager (LVM). Valeurs valides : true : utilise LVM. false : n'utilise pas LVM. LVM ne peut pas être activé dans les scénarios suivants : La source de migration exécute un système d'exploitation Windows. Le disque cloud système ne possède pas de partition de démarrage. Une fois LVM activé, la fonctionnalité ne prend pas effet dans les scénarios suivants : La source de migration ne prend pas en charge lvm2 ou n'a pas le package lvm2 installé. La source de migration exécute un système Debian avec une version du noyau 3.x ou antérieure et possède un disque monté avec un système de fichiers XFS.	true
Part	array<object>	Non	Les informations de partition du disque cloud système.
	object	Non	Les informations de partition du disque cloud système.
SizeBytes	integer	Non	La taille de la partition du disque cloud système. Unité : octets.	254803968
Block	boolean	Non	Indique s'il faut activer la réplication par blocs pour la partition du disque cloud système.	true
Path	string	Non	Le chemin d'accès de la partition du disque cloud système.	/boot
Data	array<object>	Non	Les informations de partition du disque cloud de données.
	array<object>	Non	Les informations de partition du disque cloud de données.
Size	integer	Non	La taille du disque cloud de données sur la source de migration. Unité : GiB.	80
LVM	boolean	Non	Indique s'il faut utiliser LVM pour le disque cloud de données. Valeurs valides :
DiskId	string	Non	L'identifiant du disque cloud de données.	d-2ze8hyowhdgd6ou2m5z6
Part	array<object>	Non	Les informations de partition du disque cloud de données.
	object	Non	Les informations de partition du disque cloud de données.
SizeBytes	integer	Non	La taille de la partition du disque cloud de données. Unité : octets.	21474836480
Block	boolean	Non	Indique si la réplication par blocs est activée pour la partition du disque cloud de données. Valeurs valides :\n\n- true : la réplication par blocs est activée pour la partition du disque cloud de données.\n- false : la réplication par blocs n'est pas activée pour la partition du disque cloud de données.	true
Path	string	Non	Le chemin d'accès de la partition du disque cloud de données.	/home/date

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	C8B26B44-0189-443E-9816-D951F59623A9
JobId	string	L'identifiant de la tâche de migration.	j-bp17bclvg344jlyt****

Exemples

JSON format

{
  "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  "JobId": "j-bp17bclvg344jlyt****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	ReplicationJobDataDiskIndex.Invalid	The specified replication job contains data disk index not found in source server.
400	VSwitchIdVpcId.Mismatch	The specified VSwitchId and VpcId does not match.
400	InvalidSecurityGroupId.IncorrectNetworkType	The network type of the specified security group does not support this action.
400	InvalidSecurityGroupId.VPCMismatch	The specified security group and the specified virtual switch are not in the same VPC.
400	QuotaExceeded.ReplicationJob	The maximum number of replication jobs is exceeded. Please submit a ticket to raise the quota.
400	ReplicationJobName.Duplicate	The specified replication job name already exists.
400	SourceServerState.Invalid	The specified source server status: %s 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.
400	InvalidOsMigrationType.NotMatched	The SourceOsType: %s and TargetOsType: %s are not matched. The supported TargetOsType list is: %s.
500	InternalError	An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.
403	EntityNotExist.Role	The account is unauthorized. Please assign the role AliyunServiceRoleForSMC to your account.
403	RealNameAuthenticationError	You must perform real-name verification for your account.

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

Notes de version

Consultez Notes de version pour la liste complète.