Tous les produits
Search
Centre de documentation

:CreateCrossZoneMigrationJob

Dernière mise à jour :Aug 06, 2026

Server Migration Center (SMC) vous permet de migrer une instance Elastic Compute Service (ECS) d'Alibaba Cloud vers une zone différente dans la même région et de modifier son type d'instance, y compris les vCPU et la mémoire, au sein de la même famille d'instances. Cette fonctionnalité vous aide à répondre aux exigences métier en matière de migration d'instances et de modification de spécifications. Appelez cette opération pour créer une tâche de migration interzones.

Description de l'opération

Pour plus d'informations sur les limites et les effets de la migration interzones, consultez la section Migration interzones.

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

create

*All Resource

*

Aucune 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.

Par exemple, si vous souhaitez migrer un serveur source vers la région Chine (Hangzhou), l'identifiant de la région est cn-hangzhou. Vous pouvez appeler DescribeRegions pour consulter la liste la plus récente des régions Alibaba Cloud.

cn-hangzhou

ClientToken

string

Non

Un jeton client pour garantir l'idempotence de la requête. Générez une valeur unique pour ce paramètre depuis votre client. ClientToken ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.

123e4567-e89b-12d3-a456-426655440000

InstanceId

string

Non

L'identifiant de l'instance ECS.

i-bp1ff25rzvnul6kr****

TargetVSwitchId

string

Non

L'identifiant du vSwitch de destination.

vsw-bp1mxqnssl8nafltc****

TargetZoneId

string

Non

L'identifiant de la zone de destination.

cn-hangzhou-i

TargetInstanceType

string

Non

Le type d'instance de destination.

ecs.g7.large

AutoPay

boolean

Non

Indique si le paiement automatique doit être activé. Valeurs valides :

  • true : (par défaut) Active le paiement automatique. Assurez-vous que votre compte dispose d'un solde suffisant.

  • false : Désactive le paiement automatique. Dans ce cas, vous devez effectuer le paiement manuellement. Pour plus d'informations, consultez Renouveler manuellement une instance par abonnement.

false

Disk

array<object>

Non

Les informations du disque.

object

Non

Un objet disque.

DiskId

string

Non

L'identifiant du disque.

d-bp1eeplkn4j29wf7****

Category

string

Non

La catégorie du disque. cloud_essd indique un disque SSD amélioré (ESSD).

cloud_essd

PerformanceLevel

string

Non

Le niveau de performance de l'ESSD. Valeurs valides :

  • PL0 : Un seul disque peut fournir jusqu'à 10 000 IOPS en lecture/écriture aléatoire.

  • PL1 : Un seul disque peut fournir jusqu'à 50 000 IOPS en lecture/écriture aléatoire.

  • PL2 : Un seul disque peut fournir jusqu'à 100 000 IOPS en lecture/écriture aléatoire.

  • PL3 : Un seul disque peut fournir jusqu'à 1 000 000 IOPS en lecture/écriture aléatoire.

PL0

ResourceGroupId

string

Non

L'identifiant du groupe de ressources.

rg-acfmw3ty5y7****

É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.

A9DBD2F8-DE5A-5844-BA6F-957A996CBD78

JobId

string

L'identifiant de la tâche de migration.

j-bp17bclvg344jlyt****

Exemples

JSON format

{
  "RequestId": "A9DBD2F8-DE5A-5844-BA6F-957A996CBD78",
  "JobId": "j-bp17bclvg344jlyt****"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

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 VSwitchIdVpcId.Mismatch The specified VSwitchId and VpcId does not match. The specified VSwitchId and VpcId does not match.
400 InvalidSecurityGroupId.IncorrectNetworkType The network type of the specified security group does not support this action. 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. 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. 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. 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. The specified source server status: %s is invalid. This operation can only be performed in the following status: %s.
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.
403 EntityNotExist.Role The account is unauthorized. Please assign the role AliyunServiceRoleForSMC to your account. The account does not have the operation permission, please assign the account AliyunServiceRoleForSMC role.

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

Notes de version

Consultez Notes de version pour la liste complète.