ModifyInstanceVpcAttribute - Elastic Compute Service - Centre de documentation Alibaba Cloud

Modifie le VPC, l'adresse IP privée, le groupe de sécurité ou le vSwitch d'une instance ECS de type VPC.

Description de l'opération

Lorsque vous appelez cette opération, l'instance ECS doit être dans l'état Stopped (Stopped).

Lorsque vous modifiez l'adresse IP privée ou le vSwitch d'une instance, prenez note des éléments suivants :
- Une instance ECS nouvellement créée doit être redémarrée avant que vous puissiez appeler cette opération.
- Après une modification réussie, l'instance ECS doit être redémarrée avant que vous puissiez appeler à nouveau cette opération.
Lorsque vous modifiez le VPC d'une instance, prenez note des éléments suivants :
- Instance :
  - État de l'instance : l'instance ne doit pas être verrouillée, en attente de libération, expirée, en cours de recyclage après expiration ou en cours de recyclage pour impayé. Pour plus d'informations, consultez Durée de vie de l'instance.
  - Les instances ECS associées à des instances d'équilibrage de charge ne sont pas prises en charge.
  - L'instance ne peut pas être utilisée par d'autres services cloud. Par exemple, l'instance ne peut pas être en cours de migration, ne peut pas subir de changement de VPC, et les bases de données déployées sur l'instance ne peuvent pas être gérées par Data Transmission Service (DTS).
- Réseau :
  - Les instances configurées avec une EIP en mode visible pour la carte réseau (NIC) ou en mode multi-EIP visible pour la NIC ne sont pas prises en charge.
  - Les instances associées à des adresses IP virtuelles haute disponibilité (HaVips) ne sont pas prises en charge.
  - Les instances dont les vSwitches sont associés à des tables de routage personnalisées ne sont pas prises en charge.
  - Les instances pour lesquelles Global Accelerator (GA) est activé ne sont pas prises en charge.
  - Les instances associées à des interfaces réseau élastiques (ENI) secondaires ne sont pas prises en charge.
  - Les instances auxquelles des adresses IPv6 ont été attribuées ne sont pas prises en charge.
  - Les instances dont la NIC principale possède plusieurs adresses IP ne sont pas prises en charge.
  - Le vSwitch spécifié doit appartenir au VPC de destination.
  - La zone du vSwitch doit rester la même avant et après la modification.
  - Si vous spécifiez une adresse IP privée pour la NIC principale, l'adresse IP doit se trouver dans le bloc CIDR du vSwitch et être disponible. Si vous n'en spécifiez pas, une adresse IP est attribuée de manière aléatoire. Assurez-vous que le vSwitch de destination dispose de suffisamment d'adresses IP disponibles.
  - Si vous utilisez un VPC partagé par un autre compte, assurez-vous que le groupe de sécurité de destination est créé par votre compte dans le VPC partagé, et non par le compte du propriétaire du VPC.

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.

ecs:ModifyInstanceVpcAttribute

update

*Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

*VSwitch.

acs:vpc:{#regionId}:{#accountId}:vswitch/{#vswitchId}

vpc:tag
vpc:VPC

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
InstanceId	string	Oui	L'identifiant de l'instance. Remarque Lorsque vous appelez cette opération, l'instance ECS doit être dans l'état Stopped (Stopped). Pour connaître les autres restrictions applicables à l'instance, lisez attentivement la section description de l'opération.	i-bp1iudwa5b1tqag1****
VSwitchId	string	Oui	L'identifiant du vSwitch. Si l'identifiant spécifié est celui du vSwitch actuel de l'instance, le vSwitch reste inchangé. Si l'identifiant spécifié est celui d'un nouveau vSwitch et que le paramètre VpcId est vide, les nouveau et ancien vSwitches doivent appartenir à la même zone et au même VPC. Si le paramètre VpcId n'est pas vide, le vSwitch spécifié par ce paramètre doit appartenir au VPC spécifié et se trouver dans la même zone que le vSwitch d'origine.	vsw-bp1s5fnvk4gn3tw12****
PrivateIpAddress	string	Non	La nouvelle adresse IP privée. Remarque Le paramètre PrivateIpAddress dépend de VSwitchId. L'adresse IP spécifiée doit se trouver dans le bloc CIDR du vSwitch. Valeur par défaut : si ce paramètre n'est pas spécifié, une adresse IP privée est attribuée de manière aléatoire à partir du bloc CIDR du vSwitch.	172.17..
VpcId	string	Non	L'identifiant du VPC de destination.	vpc-bp1vwnn14rqpyiczj****
SecurityGroupId	array	Non	Les identifiants des groupes de sécurité auxquels l'instance est ajoutée après le changement de VPC. Ce paramètre est requis uniquement lorsque le paramètre VpcId est spécifié. Les groupes de sécurité doivent appartenir au même VPC que le VPC de destination. Vous pouvez spécifier un ou plusieurs groupes de sécurité pour l'instance. Le nombre de groupes de sécurité est soumis aux limites du nombre de groupes de sécurité auxquels une instance peut appartenir. Pour plus d'informations, consultez Limites. Tous les groupes de sécurité de la liste doivent être du même type. Le basculement entre les types de groupes de sécurité est pris en charge. Lorsque vous basculez une instance ECS entre différents types de groupes de sécurité, assurez-vous de bien comprendre les différences de configuration des règles de groupe de sécurité entre les deux types afin d'éviter tout impact sur le réseau de l'instance. Pour plus d'informations, consultez Présentation des groupes de sécurité.	sg-o6w9l8bc8dgmkw87****
	string	Non	L'identifiant du groupe de sécurité.	sg-o6w9l8bc8dgmkw87****

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidTarget.TrafficMirrorSession	Instance is target of traffic mirror session.
400	InvalidSource.TrafficMirrorSession	Instance is source of traffic mirror session.
400	InvalidPrivateIpAddress.Malformed	Specified private IP address is malformed.	L'adresse PrivateIpAddress spécifiée n'est pas valide.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.
400	IncorrectVSwitchStatus	The current status of virtual switch does not support this operation.	Le vSwitch spécifié est en état d'attente et ne peut pas être supprimé.
400	IncorrectInstanceStatus	The current status of instance does not support this operation.	L'état actuel de l'instance ne prend pas en charge cette opération.
400	OperationDenied	Specified operation is denied as your instance is not in VPC.	L'instantané spécifié ne permet pas la création de disques cloud de données.
400	InvalidVSwitchId.Mismatch	Specified instance and virtual switch are not in the same zone.	L'instance spécifiée et le vSwitch spécifié ne se trouvent pas dans la même zone.
400	InvalidPrivateIpAddress.Mismatch	Specified private IP address is not in the CIDR block of virtual switch.	L'adresse IP privée spécifiée ne se trouve pas dans le bloc CIDR du vSwitch spécifié.
400	InvalidPrivateIp.Changing	Previous action is not finished yet.	La modification de l'adresse IP privée de l'instance n'est pas terminée. Vous ne pouvez pas la modifier à nouveau.
400	PrimaryEniHasSubIp	Primary network interface of the specified instance has more than one private ip.	L'opération est rejetée. Les instances dont l'ENI principale possède plusieurs adresses IP ne sont pas prises en charge.
400	VSwitchIdNotMatch	The subnet of private ip is different to the instance, please unbind ha vip.	Le bloc CIDR du vSwitch ne contient pas l'adresse IP spécifiée. Vérifiez la configuration.
400	InvalidOperation.EniCountExceeded	The number of ENIs in an enterprise security group has reached the maximum limit.
400	InvalidParameter.SecurityGroupId	Security group ids are invalid.	L'identifiant du groupe de sécurité n'est pas valide.
400	InvalidVSwitch.IllegalStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".	L'état actuel du vSwitch ne prend pas en charge cette opération.
400	QuotaExceeded.PrivateIpAddress	There are not enough private IPs in the specified VSwitch.	Les adresses IP privées du vSwitch ont été épuisées. Utilisez un autre vSwitch.
401	InvalidOperation.SecurityGroupNotAuthorized	The specified security group is not authorized to operate.	Vous n'avez pas l'autorisation d'effectuer des opérations sur le groupe de sécurité spécifié.
500	InternalError	The request processing has failed due to some unknown error.
403	OperationDenied	The Specified operation is denied as your instance is locked for security reasons.
403	InvalidIp.Ipv6Assigned	The specified instance has been assigned IPv6 address.
403	SecurityGroupInstanceLimitExceed	%s	Le nombre maximal d'instances dans le groupe de sécurité a été atteint.
403	InvalidInstance.HasTransitionRecord	The operation is denied because the specified instance has a migration plan.
403	InvalidInstanceStatus.NotNormal	The Specified operation is denied due to instance status.
403	InvalidVpcId.SharedVpc	The Specified operation is denied as your targe vpc is SharedVpc.
403	InvalidOperation.NotAllowed	The operation is denied because the specified VPC has advanced features enabled.
403	InvalidParameter.ToSecurityGroupId	%s
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Les groupes de sécurité gérés des services cloud ne prennent pas en charge les opérations de modification.
403	InvalidOperation.VswAndEcsAvailabilityZoneMismatch	Specified instance and virtual switch are not in the same zone.	L'instance et le vSwitch de destination ne se trouvent pas dans la même zone.
403	InvalidOperation.CloudBoxEcsNotSupport	Cloud box ecs instance does not support modifying VPC.	Les instances Cloud Box ne prennent pas en charge la modification du VPC.
403	AclLimitExceed	%s	Le nombre de règles de groupe de sécurité pour l'ENI ou l'instance dépasse le quota.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'instance spécifiée n'existe pas. Vérifiez que l'identifiant de l'instance est correct.
404	InvalidVSwitchId.NotFound	Specified virtual switch does not exist.	L'identifiant de vSwitch spécifié n'existe pas.
404	NoSuchResource	The specified resource is not found.	La ressource spécifiée n'existe pas.
404	InvalidParameter.InvalidInstanceId	The specified InstanceId does not exist.
404	InvalidParameter.VSwitchId	The specified virtual vswitch does not exist.	Le VSwitchId spécifié n'existe pas. Vous pouvez appeler DescribeVSwitches pour obtenir les informations sur les vSwitches créés.
404	InvalidRegion.ValueNotSupported	The specified Region does not exist.
404	InvalidInstance.AttachedEni	The Specified operation is denied due to elastic network interface.	L'état de l'ENI de l'instance spécifiée ne prend pas en charge l'opération de modification. Vous devez prendre connaissance des précautions à prendre pour cette opération. Pour plus d'informations, reportez-vous à la documentation de l'API ModifyInstanceVpcAttribute.
404	InvalidIp.MultiPrimaryIp	The Specified operation is denied due to multi private ip.	L'instance spécifiée possède plusieurs adresses IP privées et ne prend pas en charge l'opération de modification. Vous devez prendre connaissance des précautions à prendre pour cette opération. Pour plus d'informations, reportez-vous à la documentation de l'API ModifyInstanceVpcAttribute.
404	InvalidIp.Ipv6	The Specified operation is denied due to ipv6.
404	InvalidVSwitch.NotBelongToVpc	%s	Le VSwitchId spécifié n'appartient pas au VPC spécifié. Vérifiez si la valeur du paramètre est correcte.
404	InvalidParameter.EniNo	%s
404	InvalidSecurityGroupId.NotFound	%s	Le groupe de sécurité spécifié n'existe pas sous votre compte. Vérifiez si l'identifiant du groupe de sécurité est correct.
404	InvalidParameter.SecurityGroupIdRepeated	%s
404	InvalidSecurityGroupType.NotSupportClassic	The specified SecurityGroupIds have classic group type.	Le type de réseau du groupe de sécurité spécifié est le réseau classique. Vérifiez si la valeur du paramètre SecurityGroupIds est correcte.
404	InvalidSecurityGroupVpc.NotBelongToOneVpc	The specified SecurityGroupIds are belong to different vpc.	Les identifiants de groupe de sécurité spécifiés appartiennent à différents VPC. Vérifiez si la valeur du paramètre SecurityGroupIds est correcte. Vous pouvez appeler DescribeSecurityGroups pour consulter le VPC auquel appartient le groupe de sécurité spécifié.
404	EnterpriseGroupLimited.MutliGroupType	The specified instance can not join multi SecurityGroup types.
404	InvalidParameter.AlreadyInTargetVpc	The specified instance is already in the destination VPC.
404	InvalidParameter.SecurityGroupId	The specified SecurityGroupId.N is invalid or does not exist.
404	JoinedGroupLimitExceed	The specified instance has exceed quota of SecurityGroup.
404	InvalidParameter.MustBeEmpty	The specified parameter SecurityGroupId.N and VpcId need be empty.	Les paramètres SecurityGroupId.N et VpcId spécifiés doivent être vides. Si vous devez uniquement modifier le vSwitch, il n'est pas nécessaire de spécifier les paramètres SecurityGroupId.N et VpcId.
404	InvalidParameter.NotEnoughIpInVSwitch	The specified virtual switch has not enough available ip.
404	InvalidDependence.MutliDirectlyEip	The Specified operation is denied due to multi directly Eips.
404	InvalidDependence.HaVip	The Specified operation is denied due to HaVip.
404	InvalidDependence.NextHopOfCustomRouter	The Specified operation is denied due to next hop of Custom Router.	Une route personnalisée pointe actuellement vers cette instance. La modification du VPC n'est pas prise en charge.
404	InvalidDependence.BeenUsedAsAppServer	The Specified operation is denied due to AppServer.
404	InvalidDependence.GrantAccess	The Specified operation is denied due to grant access.	L'instance actuelle possède des règles d'accès inverses. La modification du VPC n'est pas prise en charge.
404	InvalidDependence.BindGA	The Specified operation is denied due to GA.
404	InvalidDependence.SLB	The Specified operation is denied as your instance with alb or clb.	L'opération est refusée. Les instances ECS associées à des instances d'équilibreur de charge ne sont pas prises en charge.

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

Notes de version

Consultez Notes de version pour la liste complète.