ModifyInstanceNetworkSpec - : Central de Documentação do Alibaba Cloud

Modifica as configurações de largura de banda de uma instância do Elastic Compute Service (ECS). Ajuste essas configurações para melhorar o desempenho da rede da instância.

Observações de uso

Antes de chamar esta operação, observe os seguintes pontos:

A partir de 27 de novembro de 2020, o valor máximo de largura de banda disponível para criar instâncias ECS ou alterar suas configurações está sujeito à política de limitação da sua conta. Para aumentar o limite de largura de banda, envie um ticket. As seguintes políticas de limitação se aplicam:
- Em uma única região, a soma das larguras de banda de pico reais de todas as instâncias ECS que usam o método de faturamento por tráfego para uso de rede não pode exceder 5 Gbit/s.
- Dentro de uma única região, a soma das larguras de banda de pico reais de todas as instâncias ECS que usam o método de faturamento por largura de banda para uso de rede não pode exceder 50 Gbit/s.
Ao modificar as configurações de largura de banda de uma instância de assinatura (PrePaid), se você aumentar a largura de banda pública de saída (InternetMaxBandwidthOut) de 0 Mbit/s, um endereço IP público será atribuído automaticamente à instância.
Caso aumente a largura de banda pública de saída (InternetMaxBandwidthOut) de uma instância de pagamento conforme o uso (PostPaid) partindo de 0 Mbit/s durante a modificação das configurações, nenhum endereço IP público será atribuído automaticamente. Defina AllocatePublicIp como true ou chame a operação AllocatePublicIpAddress para atribuir um endereço IP público à instância.
Uma instância na rede clássica deve estar no estado Stopped antes que seja possível aumentar sua largura de banda pública de saída (InternetMaxBandwidthOut) a partir de 0 Mbit/s.
Após o aumento da largura de banda, o AutoPay é definido como true por padrão e o pagamento é realizado automaticamente. Certifique-se de que o saldo da sua conta seja suficiente. Caso contrário, seu pedido se tornará inválido e será cancelado. Se o saldo for insuficiente, defina AutoPay como false. Nesse cenário, ao chamar a operação ModifyInstanceNetworkSpec, um pedido não pago será gerado. Em seguida, faça login no console ECS para efetuar o pagamento.
A diferença de preço é reembolsada na conta de pagamento utilizada. Vouchers ou cupons já resgatados não podem ser devolvidos.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyInstanceNetworkSpec	A operação a ser executada. Defina o valor como ModifyInstanceNetworkSpec.
InstanceId	String	Sim	i-bp67acfmxazb4****	O ID da instância cujas configurações de largura de banda serão modificadas.
InternetMaxBandwidthOut	Integer	Não	10	A largura de banda pública de saída máxima. Unidade: Mbit/s. Valores válidos: 0 a 100.
InternetMaxBandwidthIn	Integer	Não	10	A largura de banda pública de entrada máxima. Unidade: Mbit/s. Valores válidos: Se a largura de banda pública de saída adquirida for menor ou igual a 10 Mbit/s, os valores válidos deste parâmetro são de 1 a 10, sendo o valor padrão 10. Quando a largura de banda pública de saída adquirida for superior a 10 Mbit/s, os valores válidos variam de 1 até o valor de `InternetMaxBandwidthOut`, com o valor padrão igual ao próprio `InternetMaxBandwidthOut`.
ISP	String	Não	null	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.
NetworkChargeType	String	Não	PayByTraffic	O método de faturamento para uso de rede. Valores válidos: PayByBandwidth PayByTraffic Nota No método de faturamento pay-by-traffic, as larguras de banda máximas de entrada e saída funcionam como limites superiores, e não como desempenho garantido. Em cenários onde a demanda supera a oferta de recursos, os valores máximos podem não ser atingidos. Se sua instância exigir largura de banda garantida, utilize o método de faturamento pay-by-bandwidth.
AllocatePublicIp	Boolean	Não	false	Define se um endereço IP público deve ser atribuído à instância. Valores válidos: true false Valor padrão: false.
StartTime	String	Não	2017-12-05T22:40Z	A hora de início do aumento temporário de largura de banda. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddThh:mmZ. O horário deve estar em UTC e preciso até os minutos (mm).
EndTime	String	Não	2017-12-06T22Z	A hora de término do aumento temporário de largura de banda. Especifique a hora no padrão ISO 8601, no formato yyyy-MM-ddThhZ. O horário deve estar em UTC e preciso até as horas (hh). Nota O intervalo entre a hora de término e a hora de início do aumento temporário de largura de banda deve ser maior ou igual a 3 horas.
AutoPay	Boolean	Não	true	Indica se o pagamento deve ser concluído automaticamente. Valores válidos: true: Após a modificação das configurações de largura de banda, o pagamento é concluído automaticamente. Certifique-se de ter saldo suficiente na conta antes de definir AutoPay como true. Se o saldo for insuficiente, o pedido não poderá ser pago no console ECS e se tornará inválido, exigindo cancelamento. false: Após modificar as configurações de largura de banda, um pedido é gerado, mas o pagamento não é concluído. Se o saldo da conta for insuficiente, defina AutoPay como false para gerar um pedido não pago. Em seguida, faça login no console ECS para pagar o pedido. Valor padrão: true.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Utilize o cliente para gerar esse token. Garanta que cada solicitação use um token exclusivo. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
OrderId	String	123457890	O ID do pedido.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

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

Formato JSON

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

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

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidInternetMaxBandwidthIn.ValueNotSupported	The specified InternetMaxBandwidthIn is beyond the permitted range.	A largura de banda pública de entrada máxima especificada excede o valor máximo permitido.
400	InvalidInternetMaxBandwidthOut.ValueNotSupported	The specified InternetMaxBandwidthOut is beyond the permitted range.	A largura de banda pública de saída máxima especificada excede o valor máximo permitido.
400	OperationDenied	Specified instance is in VPC.	A instância reside em uma Virtual Private Cloud (VPC).
400	InvalidParameter.Conflict	%s	O parâmetro especificado é inválido. Verifique se há conflito de parâmetros. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
400	ChargeTypeViolation	The operation is not permitted due to billing method of the instance.	O método de faturamento da instância não suporta esta operação.
400	InvalidStartTime.ValueNotSupported	%s	A hora de término não pode ser anterior à hora de início.
400	Account.Arrearage	Your account has an outstanding payment.	Sua conta possui pedidos não pagos.
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is invalid.	O parâmetro InternetChargeType especificado é inválido.
400	DecreasedBandwidthNotAllowed	%s	A operação de redução de largura de banda é inválida.
400	BandwidthUpgradeDenied.EipBoundInstance	The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.	A instância está associada a um Elastic IP Address (EIP), portanto, o aumento temporário de largura de banda não é permitido.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	O valor de ClientToken é inválido.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Sua solicitação foi limitada. Tente novamente em 5 minutos.
400	InvalidAction	Specified action is not valid.	A operação é inválida.
400	IpAllocationError	Allocate public ip failed.	Não foi possível atribuir um endereço IP público.
400	InvalidParam.AllocatePublicIp	The specified param AllocatePublicIp is invalid.	O valor especificado para AllocatePublicIp é inválido.
400	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.	O número máximo de reduções de configuração permitidas para a instância foi excedido.
400	InvalidBandwidth.ValueNotSupported	Instance upgrade bandwidth of temporary not allow less then existed.	A nova largura de banda especificada para o aumento temporário é inferior à largura de banda atual.
400	InvalidInstanceStatus	The specified instance status does not support this action.	A instância está em um estado que não suporta a operação atual.
400	InvalidInstance.UnPaidOrder	Unpaid order exists in your account, please complete or cancel the payment in the expense center.	Sua conta possui um pedido não pago. Pague o pedido e tente novamente.
400	OperationDenied	After downgrade, you cannot upgrade or downgrade your instances again in the remaining time of the current billing cycle.	Após reduzir as configurações da instância, não é possível aumentar ou reduzir novamente até o início do novo ciclo de faturamento.
400	InvalidInternetChargeType.ValueNotSupported	%s	O valor de InternetChargeType é inválido.
400	LastOrderProcessing	The previous order is still processing, please try again later.	O pedido está sendo processado. Tente novamente mais tarde.
400	OperationDenied	The current user does not support this operation.	Sua conta não suporta esta operação.
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.	Não é possível executar a operação enquanto as configurações da instância passam por um aumento temporário. Isso ocorre quando a operação ModifyPrepayInstanceSpec é chamada com EndTime definido.
400	InvalidParameter.Bandwidth	%s	A largura de banda especificada é inválida. Verifique os valores dos parâmetros.
400	InvalidParameter.DedicatedRegionNotSupported	The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.	As instâncias ECS na região dedicada não suportam este parâmetro.
403	IncorrectInstanceStatus	The current status of the instance does not support this operation.	Esta operação não pode ser executada na instância no estado atual.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	A instância está bloqueada por motivos de segurança.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	A instância expirou ou possui pagamentos pendentes. Renove ou conclua o pagamento da instância e tente novamente.
403	OperationDenied	The operation is denied due to the instance is PrePaid.	A instância é do tipo assinatura e não suporta esta operação.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	O saldo da sua conta é insuficiente. Adicione fundos à conta e tente novamente.
403	InvalidInstance.UnPaidOrder	The specified Instance has unpaid order.	Existem pedidos não pagos para a instância especificada. Pague os pedidos e tente novamente.
403	InvalidInstance.InstanceNotSupported	The special vpc instance with eip not need bandwidth.	A instância reside em uma VPC e está associada a um EIP. Não é possível especificar uma largura de banda pública para ela.
403	InvalidInstanceStatus	The current status of the instance does not support this operation.	Esta operação não pode ser executada na instância no estado atual.
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	Esta operação não pode ser realizada em instâncias associadas a um EIP. Desassocie o EIP primeiro.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Existem pedidos não pagos para a instância. Faça login no console ECS para efetuar o pagamento.
403	InvalidNetworkType.ValueNotSupported	The specified parameter NetworkType is not valid.	O tipo de rede especificado é inválido.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Esta operação não pode ser executada no recurso no estado atual.
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.	Foram detectados riscos no seu cartão de crédito ou débito padrão. Clique em URL no e-mail para verificação.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.