ModifyInstanceDeployment - - Centre de documentation Alibaba Cloud

Description

Lors de l'appel à cette opération pour une instance ECS, tenez compte des points suivants :

L'instance ECS doit être à l'état Stopped. L'instance redémarre automatiquement après sa migration.
Le type de réseau de l'instance ECS doit être Virtual Private Cloud (VPC).
L'instance ECS et l'hôte dédié de destination doivent appartenir au même compte et se trouver dans la même région et la même zone.
Une instance ECS en paiement à l'utilisation peut être migrée vers un hôte dédié par abonnement. Une instance ECS par abonnement ne peut être migrée qu'entre hôtes dédiés par abonnement. La date d'expiration de l'instance ECS par abonnement ne peut pas être postérieure à celle de l'hôte dédié de destination.
Seules les instances ECS en paiement à l'utilisation peuvent être migrées d'un hôte partagé vers un hôte dédié. Les instances par abonnement ou préemptibles ne peuvent pas être migrées d'un hôte partagé vers un hôte dédié.
Vous pouvez redéployer une instance ECS sur un cluster d'hôtes dédiés spécifique.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyInstanceDeployment	Opération à effectuer. Définissez la valeur sur ModifyInstanceDeployment.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
InstanceId	String	Yes	i-bp67acfmxazb4ph***	ID des instances.
DedicatedHostId	String	No	dh-bp67acfmxazb4ph****	ID de l'hôte dédié de destination. Appelez l'opération DescribeDedicatedHosts pour obtenir la liste des hôtes dédiés la plus récente. Lors de la migration d'une instance d'un hôte partagé vers un hôte dédié ou entre hôtes dédiés, tenez compte des éléments suivants : Pour migrer l'instance vers un hôte dédié spécifique, spécifiez une valeur pour ce paramètre. Pour migrer l'instance vers un hôte dédié sélectionné par le système, laissez ce paramètre vide et définissez `Tenancy` sur host. Pour plus d'informations sur la fonctionnalité de déploiement automatique, consultez la rubrique Features of dedicated hosts.
DeploymentSetId	String	No	ds-bp67acfmxazb4ph****	ID du groupe de déploiement de destination. Ce paramètre est requis pour ajouter une instance ECS à un groupe de déploiement ou modifier le groupe de déploiement d'une instance. Remarque Vous ne pouvez pas modifier le groupe de déploiement lorsque vous modifiez les configurations des hôtes dédiés, y compris des paramètres tels que `Tenancy`, `Affinity` et `DedicatedHostId`.
DeploymentSetGroupNo	Integer	No	3	Numéro du groupe de déploiement dans lequel déployer l'instance au sein du groupe de déploiement de destination. Ce paramètre n'est valide que si le groupe de déploiement de destination utilise la stratégie de groupe haute disponibilité (AvailabilityGroup). Valeurs possibles : 1 à 7. Remarque Si vous appelez cette opération pour déployer une instance dans un groupe de déploiement utilisant la stratégie de groupe haute disponibilité (`AvailabilityGroup`) et que ce paramètre est laissé vide, le système répartit uniformément les instances ECS entre les groupes de déploiement. Si vous appelez cette opération pour modifier le groupe de déploiement d'une instance et spécifiez le groupe de déploiement actuel comme destination, le système redistribue uniformément les instances ECS entre les groupes de déploiement.
Force	Boolean	No	false	Indique s'il faut forcer le changement d'hôte de l'instance lors de la modification de son groupe de déploiement. Valeurs possibles : true : force le changement d'hôte de l'instance lors de la modification du groupe de déploiement. Les hôtes ne peuvent être changés de force que pour les instances à l'état Running ou Stopped. Les instances à l'état Stopped n'incluent pas les instances en paiement à l'utilisation arrêtées en mode économique. Remarque Si l'instance ECS spécifiée dispose de disques locaux attachés, ces derniers sont modifiés de force lors du changement d'hôte. Cela peut entraîner une perte de données sur les disques locaux. Procédez avec prudence. false : ne force pas le changement d'hôte de l'instance lors de la modification du groupe de déploiement. Vous ne pouvez ajouter l'instance à un groupe de déploiement que si elle reste sur l'hôte actuel. Lorsque le paramètre Force est défini sur false, la modification du groupe de déploiement peut échouer. Valeur par défaut : false.
Affinity	String	No	host	Indique s'il faut associer l'instance à un hôte dédié. Valeurs possibles : host : associe l'instance à un hôte dédié. Lorsque vous démarrez une instance arrêtée en mode économique, l'instance reste sur son hôte dédié d'origine. default : n'associe pas l'instance à un hôte dédié. Lorsque vous démarrez une instance arrêtée en mode économique, l'instance peut être automatiquement déployée sur un autre hôte dédié du pool de ressources de déploiement automatique si les ressources de l'hôte dédié d'origine sont insuffisantes. Si vous souhaitez migrer l'instance d'un hôte partagé vers un hôte dédié, utilisez la valeur par défaut. Valeur par défaut : default.
Tenancy	String	No	host	Indique s'il faut déployer l'instance sur un hôte dédié. Définissez la valeur sur host pour déployer l'instance sur un hôte dédié.
MigrationType	String	No	live	Indique s'il faut arrêter l'instance avant sa migration vers l'hôte dédié de destination. Valeurs possibles : reboot : arrête l'instance avant sa migration. live : migre l'instance sans l'arrêter. Si vous définissez le paramètre MigrationType sur live, vous devez spécifier le paramètre DedicatedHostId. Dans ce cas, vous ne pouvez pas modifier le type d'instance ECS lors de la migration. Valeur par défaut : reboot.
InstanceType	String	No	ecs.c6.large	Type d'instance vers lequel l'instance est modifiée. Appelez l'opération DescribeInstanceTypes pour obtenir la liste des types d'instance la plus récente. Vous pouvez modifier le type d'instance ECS lors de sa migration vers un hôte dédié. Le nouveau type d'instance doit correspondre au type de l'hôte dédié spécifié. Pour plus d'informations, consultez la rubrique Dedicated host types. Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre `DedicatedHostId`. Vous ne pouvez pas modifier le type d'instance ECS si vous utilisez la fonctionnalité de déploiement automatique pour migrer l'instance.
DedicatedHostClusterId	String	No	dc-bp67acfmxazb4ph****	ID du cluster d'hôtes dédiés.
RemoveFromDeploymentSet	Boolean	No	false	Indique s'il faut supprimer l'instance sélectionnée du groupe de déploiement sélectionné. Valeurs possibles : true. false. Valeur par défaut : false. Remarque Si vous définissez ce paramètre sur true, vous devez spécifier l'InstanceId de l'instance ECS sélectionnée et le DeploymentSetId du groupe de déploiement auquel appartient l'instance ECS.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

04F0F334-1335-436C-A1D7-6C044FE7****

ID de la requête.

Exemples

Exemple de requête

http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceDeployment
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph***
&DedicatedHostId=dh-bp67acfmxazb4ph****
&DeploymentSetId=ds-bp67acfmxazb4ph****
&Tenancy=host
&MigrationType=live
&DedicatedHostClusterId=dc-bp67acfmxazb4ph****
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<ModifyInstanceDeploymentResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE7****</RequestId>
</ModifyInstanceDeploymentResponse>

JSON format

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE7****"
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	OperationDenied.UnstoppedInstance	Operation denied due to unstopped instance.	L'opération actuelle n'est pas valide. Vérifiez si l'instance est à l'état Stopped.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	L'opération n'est pas prise en charge tant que l'hôte dédié se trouve dans l'état actuel.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.	La date d'expiration de l'instance est postérieure à celle de l'hôte dédié.
400	InvalidParam.Tenancy	The specified Tenancy is invalid.	Le paramètre Tenancy spécifié n'est pas valide.
400	OperationDenied.InvalidInstance	The specified instance is not dedicated instance.	L'instance spécifiée n'est pas déployée sur un hôte dédié.
400	ChargeTypeViolation.PostPaidDedicatedHost	Prepaid instance onto postpaid dedicated host is not allowed.	Les instances par abonnement ne peuvent pas être déployées sur des hôtes dédiés en paiement à l'utilisation.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Le paramètre DedicatedHostId spécifié n'existe pas.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Le paramètre InstanceType spécifié n'existe pas ou vous n'êtes pas autorisé à gérer des instances du type d'instance spécifié.
403	IncorrectInstanceStatus	%s	L'opération n'est pas prise en charge tant que l'instance se trouve dans l'état actuel.
403	OperationDenied.NoStock	The resource is out of usage.	L'instance n'est pas à l'état Running. Démarrez l'instance ou vérifiez si l'opération est valide.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'ID d'instance spécifié n'existe pas. Vérifiez si l'ID d'instance est correct.
404	InvalidInstanceNetworkType.NotSupport	The specified Instance network type not support.	Le type de réseau de l'instance ne prend pas en charge cette opération.
404	InvalidInstanceType.NotSupport	The Dedicated host not support the specified instance type.	L'hôte dédié actuel ne prend pas en charge le type d'instance spécifié.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.