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

Modifica a configuração de largura de banda de uma instância ECS, aloca um endereço IP público e converte o método de faturamento de rede. Tanto upgrades quanto downgrades são suportados.

Descrição da operação

Ao modificar a configuração de largura de banda de uma instância por assinatura (PrePaid) e a largura de banda pública de saída (InternetMaxBandwidthOut) for atualizada de 0 Mbit/s para um valor diferente de zero, um endereço IP público é atribuído automaticamente.
Ao modificar a configuração de largura de banda de uma instância pay-as-you-go (PostPaid) e a largura de banda pública de saída (InternetMaxBandwidthOut) for atualizada de 0 Mbit/s para um valor diferente de zero, um endereço IP público não é atribuído automaticamente. Defina o parâmetro AllocatePublicIp como true para atribuir um endereço IP público.

Nota

Em uma única região, o pico total de largura de banda pública com pagamento por largura de banda para uma única conta Alibaba Cloud é limitado. Para mais informações, consulte Limites de largura de banda pública.

Taxas:
- Após o upgrade da largura de banda, as taxas são deduzidas automaticamente por padrão. Certifique-se de que seu método de pagamento tenha saldo suficiente. Caso contrário, um pedido anormal será gerado e você só poderá cancelar o pedido. Se o saldo da sua conta for insuficiente, defina o parâmetro AutoPay como false. Um pedido normal não pago será gerado e você poderá fazer login no console ECS para concluir o pagamento.
- Após o downgrade da largura de banda, a diferença de preço é reembolsada ao método de pagamento original. Vouchers utilizados não são reembolsados.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:ModifyInstanceNetworkSpec

update

*Instance

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

ecs:AssociatePublicIpAddress

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância para a qual você deseja modificar a configuração de rede.	i-bp67acfmxazb4****
InternetMaxBandwidthOut	integer	Não	A largura de banda pública máxima de saída. Unidade: Mbit/s (Megabit por segundo). Valores válidos: Pagamento por tráfego: 0 a 100. Pagamento por largura de banda: Instâncias por assinatura: 0 a 200. Instâncias pay-as-you-go: 0 a 100. Nota A largura de banda máxima de saída de uma única instância também é limitada pela métrica Linha de base/burst de largura de banda de rede (Gbit/s) do tipo de instância ECS. Para mais informações, consulte Famílias de instâncias.	10
InternetMaxBandwidthIn	integer	Não	A largura de banda pública máxima de entrada. Unidade: Mbit/s (Megabit por segundo). Valores válidos: Se a largura de banda pública de saída adquirida for menor ou igual a 10 Mbit/s: 1 a 10. Valor padrão: 10. Se a largura de banda pública de saída adquirida for maior que 10 Mbit/s: 1 até o valor de `InternetMaxBandwidthOut`. Valor padrão: o valor de `InternetMaxBandwidthOut`.	10
ISP	string	Não	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.	null
NetworkChargeType	string	Não	Converte o método de faturamento de rede. Valores válidos: PayByBandwidth: pagamento por largura de banda. PayByTraffic: pagamento por tráfego. Nota No modo pagamento por tráfego, os picos de largura de banda de entrada e saída são limites máximos e não garantidos. Quando ocorre contenção de recursos, os picos de largura de banda podem ser limitados. Se suas cargas de trabalho exigirem largura de banda garantida, use o modo pagamento por largura de banda.	PayByTraffic
AllocatePublicIp	boolean	Não	Especifica se deve atribuir um endereço IP público. Valores válidos: true: Um endereço IP público é atribuído. false: Nenhum endereço IP público é atribuído. Valor padrão: false.	false
StartTime	string	Não	A hora de início do upgrade temporário de largura de banda. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mmZ. A hora deve estar em UTC+0. O valor é preciso até o minuto (mm).	2017-12-05T22:40Z
EndTime	string	Não	A hora de término do upgrade temporário de largura de banda. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHHZ. A hora deve estar em UTC+0. O valor é preciso até a hora (HH). Nota O intervalo entre a hora de término e a hora de início do upgrade temporário de largura de banda deve ser maior ou igual a 3 horas.	2017-12-06T22Z
AutoPay	boolean	Não	Especifica se deve concluir o pagamento automaticamente. Valores válidos: true: O pagamento é concluído automaticamente após a alteração da configuração de largura de banda. Certifique-se de que o saldo da sua conta seja suficiente. Se o saldo for insuficiente, um pedido anormal será gerado. Você não pode pagar por este pedido no console ECS. Você só pode cancelar o pedido. false: Um pedido é gerado, mas o pagamento não é concluído após a alteração da configuração de largura de banda. Se seu método de pagamento tiver saldo insuficiente, defina o parâmetro Autopay como false para cancelar o pagamento automático. Nesse caso, um pedido normal não pago é gerado. Você pode fazer login no console ECS para concluir o pagamento. Valor padrão: true.	true
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
OrderId	string	O ID do pedido. Este parâmetro é retornado apenas quando você modifica a configuração de largura de banda de uma instância por assinatura (PrePaid).	123457890
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInternetMaxBandwidthIn.ValueNotSupported	The specified InternetMaxBandwidthIn is beyond the permitted range.	O parâmetro InternetMaxBandwidthIn especificado excede o valor máximo permitido.
400	InvalidInternetMaxBandwidthOut.ValueNotSupported	The specified InternetMaxBandwidthOut is beyond the permitted range.	A largura de banda da máquina virtual especificada é inválida.
400	OperationDenied	Specified instance is in VPC.	O snapshot especificado não permite a criação de volumes de dados.
400	InvalidParameter.Conflict	%s	Os parâmetros estão em conflito entre si.
400	InvalidStartTime.ValueNotSupported	The specified StartTime is out of the permitted range.
400	InvalidEndTime.ValueNotSupported	The specified EndTime is out of the permitted range.
400	ChargeTypeViolation	The operation is not permitted due to billing method of the instance.	O método de cobrança não suporta esta operação. Verifique se o método de cobrança da instância entra em conflito com esta operação.
400	Account.Arrearage	Your account has an outstanding payment.	O saldo da sua conta é insuficiente. Recarregue sua conta antes de prosseguir.
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is invalid.	O método de cobrança de rede especificado é inválido.
400	DecreasedBandwidthNotAllowed	%s	O downgrade de largura de banda não é permitido.
400	BandwidthUpgradeDenied.EipBoundInstance	The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.	A instância VPC especificada já está associada a um EIP.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	O ClientToken especificado é inválido.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	A solicitação foi limitada.
400	InvalidInstanceStatus.NotStopped	The specified Instance status is not Stopped.
400	InvalidAction	Specified action is not valid.	A operação é inválida.
400	IpAllocationError	Allocate public ip failed.	Falha ao atribuir um endereço IP público.
400	InvalidParam.AllocatePublicIp	The specified param AllocatePublicIp is invalid.	O parâmetro AllocatePublicIp especificado é inválido.
400	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.	A cota de downgrade de instância foi excedida. Esta operação não pode ser realizada.
400	InvalidBandwidth.ValueNotSupported	Instance upgrade bandwidth of temporary not allow less then existed.	O valor de largura de banda especificado não é suportado.
400	InvalidInstanceStatus	The specified instance status does not support this action.	O estado atual da instância não suporta esta operação.
400	InvalidInstance.UnPaidOrder	Unpaid order exists in your account, please complete or cancel the payment in the expense center.	A instância especificada possui pedidos não pagos. Conclua o pagamento antes de prosseguir.
400	LastOrderProcessing	The previous order is still processing, please try again later.	A solicitação está sendo processada. Tente novamente mais tarde.
400	LastRequestProcessing	The previous request is still processing, please try again later.
400	InvalidStartTime.BeyondLifeCycle	The specified start time exceeds the expiration time.	O StartTime especificado é posterior ao horário de expiração do recurso.
400	InvalidEndTime.BeyondLifeCycle	The specified end time exceeds the expiration time.	O parâmetro EndTime excede o ciclo de vida do recurso.
400	InvalidPayMethod.SyncPaymentNotSupport	Synchronous payment is not supported. Use another payment method.
400	InvalidBandwidthOut.LessThanZero	The bandwidth must be larger than 0 when specifying isp.
400	InvalidParameter.BandwidthBiggerThanBaseBandwidth	%s
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.
400	InvalidParameter.CloudboxNotSupported	%s
400	InvalidParameter.Bandwidth	%s	O parâmetro de largura de banda é inválido.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	Esta operação requer permissões de precificação. Solicite permissões à sua conta principal ou defina o parâmetro AutoPay como true para pagamento automático.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	A conta não tem permissão para realizar um reembolso. A conta primária deve conceder as permissões relacionadas ao reembolso.
400	InvalidParameter.DedicatedRegionNotSupported	The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.	Um parâmetro inválido foi especificado em nuvem dedicada.
400	InvalidOperation.InstanceStatusUnsupported	The specified instance status is not supported for this operation, expect status is Running or Stopped.	O status atual da instância não suporta a modificação do tipo de topologia de CPU.
400	QuotaExceeded.InternetBandwidth	%s.	A largura de banda pública total cobrada por largura de banda das instâncias ECS pós-pagas em sua conta excedeu o limite total da cota de largura de banda.
400	UnsupportedIspNetworkChargeType	The network charge type is not supported when specifying ISP.	O tipo de cobrança de rede desta instância não suporta a especificação de um ISP.
400	IncorrectInstanceStatus	Current instance status does not support this operation.	O status atual da instância não oferece suporte a esta operação.
400	TaskConflict	The operation is too frequent, please wait a moment and try again.	As operações de EIP são muito frequentes.
400	InvalidOperation.InternetMaxBandwidthOutUnsupported	The InternetMaxBandwidthOut is not allowed to modify.	Sua conta possui um pagamento em atraso. Você não pode modificar a largura de banda pública de saída máxima.
500	InternalError	The request processing has failed due to some unknown error.
500	Image.OrderFailed	Create marketplace image order failed.	Falha ao criar um pedido no Alibaba Cloud Marketplace.
403	IncorrectInstanceStatus	The current status of the instance does not support this operation.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	A instância à qual o disco está anexado 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).
403	ChargeTypeViolation	The operation is not permitted due to billing method of the instance.
403	OperationDenied	The operation is denied due to the instance is PrePaid.	O snapshot especificado não permite a criação de volumes de dados.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidInstance.UnPaidOrder	The specified Instance has unpaid order.
403	Throttling	Request was denied due to request throttling, please try again after 5 minutes.
403	InvalidInstance.InstanceNotSupported	The special vpc instance with eip not need bandwidth.	Não é necessário especificar largura de banda pública para uma instância do tipo VPC associada a um EIP.
403	InstanceDowngrade.QuotaExceed	Quota of instance downgrade is exceed.
403	InvalidInstanceStatus	The current status of the instance does not support this operation.	O estado atual da instância não suporta esta operação.
403	InvalidOperation.StarterPackage	StarterPackage not support modification.
403	NAT_PUBLIC_IP_BINDING_FAILED	Binding nat public ip failed.
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	Esta operação não é suportada para instâncias associadas a um EIP. Desassocie o EIP primeiro.
403	InvalidInstance.NatPortMapNotSupport	The special instance with nat port map not support operate, please remove nat port map first.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Já existe um pedido não pago para o ID da instância especificado. Você pode fazer login no console ECS para concluir o pagamento.
403	Mayi.InternalError	The request processing has failed due to some unknown error.
403	InvalidNetworkType.ValueNotSupported	The specified parameter NetworkType is not valid.
403	OperationDenied.ImageNotValid	The specified marketplace image is not authorized. Please verify the marketplace image authorization and try again.
403	InvalidInstanceChargeType.ValueNotSupported	The specified parameter ChargeType is not valid.	O método de faturamento da instância especificado não existe.
403	InvalidIspType.ValueNotSupported	%s
403	UnsupportedIspChargeType	%s	O método de cobrança especificado não suporta o parâmetro Isp.
403	UnsupportedIspClassicNetwork	%s
403	InvalidIspBandwidthOut	%s
403	UnsupportedChangeIsp	%s
403	InvalidIspUID	%s
403	UnsupportedIspRegion	%s
403	BandIncreaseNotSupportIsp	%s	Instâncias ISP não suportam upgrades temporários de largura de banda.
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.	Um risco de segurança foi detectado no seu cartão de crédito ou débito padrão. Verifique sua identidade usando o link no e-mail.
403	InvalidOperation.PublicIpAddressNoStock	The public IP address for the specified Region or ChargeType of the instance is out of stock. Please try another Region or ChargeType.	O inventário de endereços IP públicos é insuficiente para a região ou método de cobrança especificado. Tente uma região ou método de cobrança diferente.
403	InvalidOperation.NetworkTypeUnsupported	The specified network type is not supported in this region.	O tipo de rede especificado não é suportado nesta região.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	A instância especificada não existe. Verifique se o ID da instância está correto.
409	OperationConflict	Request was denied due to conflict with a previous request,please try again later.	Ocorreu um conflito de solicitação. Aguarde um momento e tente novamente ou abra um ticket.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.