ModifyInstanceNetworkSpec - - Centre de documentation Alibaba Cloud

Modifie les configurations de bande passante d'une instance Elastic Compute Service (ECS). Vous pouvez modifier les configurations de bande passante d'une instance pour améliorer les performances du réseau.

Notes d'utilisation

Avant d'appeler cette opération, tenez compte des éléments suivants :

Depuis le 27 novembre 2020, la valeur maximale de bande passante disponible pour créer des instances ECS ou modifier leurs configurations est soumise à la politique de limitation de votre compte. Pour augmenter la limite de bande passante, soumettez un ticket. Les politiques de limitation suivantes s'appliquent :
- Dans une seule région, la somme des bandes passantes de pointe réelles de toutes les instances ECS utilisant la méthode de facturation au trafic pour l'utilisation du réseau ne peut pas dépasser 5 Gbit/s.
- Au sein d'une même région, la somme des bandes passantes de pointe réelles de toutes les instances ECS utilisant la méthode de facturation par bande passante pour l'utilisation du réseau ne peut pas dépasser 50 Gbit/s.
Si vous augmentez la bande passante publique sortante (InternetMaxBandwidthOut) d'une instance par abonnement (PrePaid) depuis 0 Mbit/s lors de la modification des configurations de bande passante de l'instance, une adresse IP publique est automatiquement attribuée à l'instance.
Si vous augmentez la bande passante publique sortante (InternetMaxBandwidthOut) d'une instance à la demande (PostPaid) depuis 0 Mbit/s lors de la modification des configurations de bande passante de l'instance, aucune adresse IP publique n'est automatiquement attribuée à l'instance. Vous devez définir AllocatePublicIp sur true ou appeler l'opération AllocatePublicIpAddress pour attribuer une adresse IP publique à l'instance.
Une instance dans le réseau classique doit être à l'état Arrêté avant que vous puissiez augmenter sa bande passante publique sortante (InternetMaxBandwidthOut) depuis 0 Mbit/s.
Après la mise à niveau de la bande passante, AutoPay est défini sur true par défaut et le paiement est effectué automatiquement. Assurez-vous que le solde de votre compte est suffisant. Dans le cas contraire, votre commande devient invalide et est annulée. Si le solde de votre compte est insuffisant, vous pouvez définir AutoPay sur false. Dans ce cas, lorsque vous appelez l'opération ModifyInstanceNetworkSpec, une commande non payée est générée. Ensuite, vous pouvez vous connecter à la console ECS pour payer la commande.
La différence de prix est remboursée sur le compte de paiement que vous avez utilisé. Les bons ou coupons qui ont été échangés ne peuvent pas être retournés.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyInstanceNetworkSpec	L'opération que vous souhaitez effectuer. Définissez la valeur sur ModifyInstanceNetworkSpec.
InstanceId	String	Yes	i-bp67acfmxazb4****	L'ID de l'instance pour laquelle vous souhaitez modifier les configurations de bande passante.
InternetMaxBandwidthOut	Integer	No	10	La bande passante publique sortante maximale. Unité : Mbit/s. Valeurs valides : 0 à 100.
InternetMaxBandwidthIn	Integer	No	10	La bande passante publique entrante maximale. Unité : Mbit/s. Valeurs valides : Si la bande passante publique sortante achetée est inférieure ou égale à 10 Mbit/s, les valeurs valides de ce paramètre sont de 1 à 10 et la valeur par défaut est 10. Si la bande passante publique sortante achetée est supérieure à 10 Mbit/s, les valeurs valides de ce paramètre sont de 1 à la valeur `InternetMaxBandwidthOut` et la valeur par défaut est la valeur `InternetMaxBandwidthOut`.
ISP	String	No	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
NetworkChargeType	String	No	PayByTraffic	La méthode de facturation pour l'utilisation du réseau. Valeurs valides : PayByBandwidth PayByTraffic Remarque Si la méthode de facturation au trafic est utilisée pour l'utilisation du réseau, les bandes passantes maximales entrantes et sortantes sont utilisées comme limites supérieures de bande passante plutôt que comme performances garanties. Dans les scénarios où la demande dépasse l'offre de ressources, les valeurs maximales de bande passante peuvent ne pas être atteintes. Si vous avez besoin de bandes passantes garanties pour votre instance, utilisez la méthode de facturation par bande passante pour l'utilisation du réseau.
AllocatePublicIp	Boolean	No	false	Indique s'il faut attribuer une adresse IP publique à l'instance. Valeurs valides : true false Valeur par défaut : false.
StartTime	String	No	2017-12-05T22:40Z	L'heure de début de la mise à niveau temporaire de la bande passante. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddThh:mmZ. L'heure doit être en UTC et précise à la minute (mm).
EndTime	String	No	2017-12-06T22Z	L'heure de fin de la mise à niveau temporaire de la bande passante. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddThhZ. L'heure doit être en UTC et précise à l'heure (hh). Remarque L'intervalle entre l'heure de fin et l'heure de début de la mise à niveau temporaire de la bande passante doit être supérieur ou égal à 3 heures.
AutoPay	Boolean	No	true	Indique s'il faut effectuer automatiquement le paiement. Valeurs valides : true : Après avoir modifié les configurations de bande passante, le paiement est automatiquement effectué. Assurez-vous d'avoir un solde suffisant dans votre compte avant de définir AutoPay sur true. Si le solde de votre compte est insuffisant, votre commande ne peut pas être payée dans la console ECS et devient invalide. Vous devez annuler la commande. false : Après avoir modifié les configurations de bande passante, une commande est générée mais le paiement n'est pas effectué. Si le solde de votre compte est insuffisant, vous pouvez définir AutoPay sur false pour générer une commande non payée. Ensuite, vous pouvez vous connecter à la console ECS pour payer la commande. Valeur par défaut : true.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Le jeton client que vous souhaitez utiliser pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer un jeton. Assurez-vous qu'un jeton client unique est utilisé pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères de longueur. Pour plus d'informations, consultez Comment garantir l'idempotence.

Paramètres de réponse

Parameter	Type	Example	Description
OrderId	String	123457890	L'ID de la commande.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	L'ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=ModifyInstanceNetworkSpec
&InstanceId=i-bp67acfmxazb4p****
&InternetMaxBandwidthOut=10
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ModifyInstanceNetworkSpecResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <OrderId>123457890</OrderId>
</ModifyInstanceNetworkSpecResponse>

JSON format

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368",
  "OrderId" : "123457890"
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	InvalidInternetMaxBandwidthIn.ValueNotSupported	The specified InternetMaxBandwidthIn is beyond the permitted range.	La bande passante publique entrante maximale spécifiée dépasse la valeur maximale autorisée.
400	InvalidInternetMaxBandwidthOut.ValueNotSupported	The specified InternetMaxBandwidthOut is beyond the permitted range.	La bande passante publique sortante maximale spécifiée dépasse la valeur maximale autorisée.
400	OperationDenied	Specified instance is in VPC.	L'instance réside dans un cloud privé virtuel (VPC).
400	InvalidParameter.Conflict	%s	Le paramètre spécifié n'est pas valide. Vérifiez s'il existe un conflit de paramètres. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
400	ChargeTypeViolation	The operation is not permitted due to billing method of the instance.	La méthode de facturation de l'instance ne prend pas en charge l'opération.
400	InvalidStartTime.ValueNotSupported	%s	L'heure de fin ne peut pas être antérieure à l'heure de début.
400	Account.Arrearage	Your account has an outstanding payment.	Votre compte comporte des commandes impayées.
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is invalid.	Le paramètre InternetChargeType spécifié n'est pas valide.
400	DecreasedBandwidthNotAllowed	%s	L'opération de réduction de bande passante n'est pas valide.
400	BandwidthUpgradeDenied.EipBoundInstance	The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.	L'instance est associée à une adresse IP élastique (EIP) et la bande passante réseau de l'instance ne peut pas être temporairement mise à niveau.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	La valeur de ClientToken n'est pas valide.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Votre requête est limitée. Réessayez dans 5 minutes.
400	InvalidAction	Specified action is not valid.	L'opération n'est pas valide.
400	IpAllocationError	Allocate public ip failed.	Une adresse IP publique ne peut pas être attribuée.
400	InvalidParam.AllocatePublicIp	The specified param AllocatePublicIp is invalid.	La valeur spécifiée de AllocatePublicIp n'est pas valide.
400	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.	Le nombre maximal de réductions de configuration autorisées pour l'instance est dépassé.
400	InvalidBandwidth.ValueNotSupported	Instance upgrade bandwidth of temporary not allow less then existed.	La nouvelle bande passante spécifiée pour la mise à niveau temporaire de la bande passante est inférieure à la bande passante actuelle.
400	InvalidInstanceStatus	The specified instance status does not support this action.	L'instance se trouve dans un état qui ne prend pas en charge l'opération actuelle.
400	InvalidInstance.UnPaidOrder	Unpaid order exists in your account, please complete or cancel the payment in the expense center.	Votre compte comporte une commande impayée. Payez la commande et réessayez.
400	OperationDenied	After downgrade, you cannot upgrade or downgrade your instances again in the remaining time of the current billing cycle.	Après avoir réduit les configurations de l'instance, vous ne pouvez pas mettre à niveau ou réduire à nouveau les configurations jusqu'au début du nouveau cycle de facturation.
400	InvalidInternetChargeType.ValueNotSupported	%s	La valeur de InternetChargeType n'est pas valide.
400	LastOrderProcessing	The previous order is still processing, please try again later.	La commande est en cours de traitement. Réessayez plus tard.
400	OperationDenied	The current user does not support this operation.	Votre compte ne prend pas en charge cette opération.
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.	L'opération ne peut pas être effectuée sur l'instance pendant que les configurations de l'instance sont temporairement mises à niveau. Les configurations de l'instance subissent une mise à niveau temporaire si l'opération ModifyPrepayInstanceSpec est appelée avec EndTime défini.
400	InvalidParameter.Bandwidth	%s	La bande passante spécifiée n'est pas valide. Vérifiez les valeurs des paramètres.
400	InvalidParameter.DedicatedRegionNotSupported	The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.	Les instances ECS dans la région dédiée ne prennent pas en charge le paramètre.
403	IncorrectInstanceStatus	The current status of the instance does not support this operation.	Cette opération ne peut pas être effectuée sur l'instance dans l'état actuel.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	L'instance est verrouillée pour des raisons de sécurité.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	L'instance a expiré ou présente un paiement en retard. Renouvelez ou effectuez le paiement pour l'instance et réessayez.
403	OperationDenied	The operation is denied due to the instance is PrePaid.	L'instance est une instance par abonnement et ne prend pas en charge l'opération.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Le solde de votre compte est insuffisant. Ajoutez des fonds à votre compte et réessayez.
403	InvalidInstance.UnPaidOrder	The specified Instance has unpaid order.	Vous avez des commandes impayées pour l'instance spécifiée. Payez les commandes et réessayez.
403	InvalidInstance.InstanceNotSupported	The special vpc instance with eip not need bandwidth.	L'instance réside dans un VPC et est associée à une EIP. Vous ne pouvez pas spécifier de bande passante publique pour l'instance.
403	InvalidInstanceStatus	The current status of the instance does not support this operation.	Cette opération ne peut pas être effectuée sur l'instance dans l'état actuel.
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	Cette opération ne peut pas être effectuée sur l'instance associée à une EIP. Dissociez d'abord l'EIP.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Vous avez des commandes impayées pour l'instance. Vous pouvez vous connecter à la console ECS pour payer les commandes.
403	InvalidNetworkType.ValueNotSupported	The specified parameter NetworkType is not valid.	Le type de réseau spécifié n'est pas valide.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Cette opération ne peut pas être effectuée sur la ressource dans l'état actuel.
403	SecurityRisk.3DVerification	We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.	Des risques sont détectés sur votre carte de crédit ou de débit par défaut. Cliquez sur l'URL dans l'e-mail pour la vérification.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez plus tard.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur interne s'est produite. Réessayez plus tard.

Pour une liste des codes d'erreur, consultez les Codes d'erreur de service.