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

Altera o tipo de instância e a largura de banda pública de uma instância do Elastic Compute Service (ECS) com pagamento conforme o uso.

Observações de uso

Para obter informações sobre como usar o ECS SDK for Python para alterar configurações de recursos, consulte Consultar recursos disponíveis para alterações de configuração.

Observe os seguintes itens:

Verifique se não há pagamentos pendentes em sua conta.
Ajuste a largura de banda pública de uma instância apenas quando ela estiver no estado Running (Em execução) ou Stopped (Parada).
Antes de alterar o tipo de uma instância com pagamento conforme o uso, chame a operação DescribeResourcesModification para consultar os tipos de instância compatíveis.
Altere o tipo de instância apenas quando a instância estiver no estado Stopped (Parada).
Não é possível modificar simultaneamente o tipo de instância e a largura de banda pública.
Desde 27 de novembro de 2020, a largura de banda total disponível para todas as instâncias (novas e modificadas) está sujeita às políticas de limitação da sua conta. Para aumentar o limite de largura de banda, abra 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 utilizam o método de faturamento por tráfego para uso de rede não pode exceder 5 Gbit/s.
- Em uma única região, a soma das larguras de banda de pico reais de todas as instâncias ECS que utilizam o método de faturamento por largura de banda para uso de rede não pode exceder 50 Gbit/s.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para sua conveniência. 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	ModifyInstanceSpec	A operação a ser executada. Defina o valor como ModifyInstanceSpec.
InstanceId	String	Sim	i-bp67acfmxazb4p****	O ID da instância.
InstanceType	String	Não	ecs.g6.large	O novo tipo de instância. Para mais informações, consulte Visão geral das famílias de instâncias. Alternativamente, chame a operação DescribeInstanceTypes para consultar a lista mais recente de tipos de instância.
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. Nota Quando o método de faturamento pay-by-traffic é utilizado para uso de rede, os valores máximos de largura de banda 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, esses valores máximos podem não ser atingidos. Caso necessite de largura de banda garantida para sua instância, recomendamos o uso do método de faturamento pay-by-bandwidth.
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 variam de 1 a 10, sendo o valor padrão 10. Se a largura de banda pública de saída adquirida for superior a 10 Mbit/s, os valores válidos deste parâmetro variam de 1 até o valor de `InternetMaxBandwidthOut`, sendo o valor padrão igual ao valor de `InternetMaxBandwidthOut`. Nota Quando o método de faturamento pay-by-traffic é utilizado para uso de rede, 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, esses valores máximos podem não ser atingidos. Caso necessite de largura de banda garantida para sua instância, recomendamos o uso do método de faturamento pay-by-bandwidth.
Temporary.StartTime	String	Não	null	Nota Este parâmetro está em visualização apenas por convite e não está disponível publicamente.
Temporary.EndTime	String	Não	null	Nota Este parâmetro está em visualização apenas por convite e não está disponível publicamente.
Temporary.InternetMaxBandwidthOut	Integer	Não	null	Nota Este parâmetro está em visualização apenas por convite e não está disponível publicamente.
Async	Boolean	Não	false	Especifica se a solicitação deve ser assíncrona. Valores válidos: true false Valor padrão: false.
AllowMigrateAcrossZone	Boolean	Não	false	Indica se há suporte para upgrades de tipo de instância entre clusters. true false Valor padrão: false. Quando `AllowMigrateAcrossZone` é definido como true e você realiza o upgrade da instância com base nas informações retornadas, atente-se aos seguintes pontos: Instância residente na rede clássica: Para tipos de instância descontinuados, o endereço IP privado, os nomes dos dispositivos de disco e os códigos de autorização de software de uma instância não otimizada para I/O são alterados ao fazer o upgrade para uma instância otimizada para I/O. Em instâncias Linux, discos básicos (`cloud`) são identificados como xvd* (por exemplo, xvda e xvdb), enquanto discos ultra (`cloud_efficiency`) e SSDs padrão (`cloud_ssd`) são identificados como vd* (por exemplo, vda e vdb). Nas famílias de instâncias disponíveis para compra, a alteração do tipo de instância também modifica o endereço IP privado da instância. Para mais detalhes, consulte Visão geral das famílias de instâncias. Instância residente em uma Virtual Private Cloud (VPC): No caso de tipos de instância descontinuados, ao fazer o upgrade de uma instância não otimizada para I/O para uma otimizada para I/O, os nomes dos dispositivos de disco e os códigos de autorização de software da instância são alterados. Para mais informações, consulte Tipos de instância descontinuados. Em instâncias Linux, discos básicos (`cloud`) são identificados como xvd (por exemplo, xvda e xvdb), enquanto discos ultra (`cloud_efficiency`) e SSDs padrão (`cloud_ssd`) são identificados como vd (por exemplo, vda e vdb).
SystemDisk.Category	String	Não	cloud_ssd	A nova categoria do disco do sistema. Valores válidos: cloud_efficiency: disco ultra. cloud_ssd: SSD padrão. Nota Este parâmetro é válido apenas ao fazer o upgrade de uma instância de um tipo descontinuado para um tipo disponível, ou ao converter uma instância não otimizada para I/O em uma otimizada para I/O. Para mais informações, consulte Tipos de instância descontinuados e Visão geral das famílias de instâncias.
ClientToken	String	Não	0c593ea1-3bea-11e9-b96b-88e9fe637760	O token de cliente usado para garantir a idempotência da solicitação. O cliente pode gerar o token, mas é necessário garantir que ele seja único entre solicitações diferentes. O token deve conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.
ModifyMode	String	Não	null	Nota Este parâmetro não está disponível publicamente.
Disk.N.DiskId	String	Não	null	Nota Este parâmetro não está disponível publicamente.
Disk.N.Category	String	Não	null	Nota Este parâmetro não está disponível publicamente.
Disk.N.PerformanceLevel	String	Não	null	Nota Este parâmetro não está disponível publicamente.

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ModifyInstanceSpec
&InstanceId=i-bp67acfmxazb4p****
&InstanceType=ecs.g6.large
&InternetMaxBandwidthOut=10
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe637760
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyInstanceSpecResponse>
   <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</ModifyInstanceSpecResponse>

Formato JSON

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

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	Método de faturamento para uso de rede inválido.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType does not exist or beyond the permitted range.	Tipo de instância não encontrado ou fora do intervalo permitido, ou você não tem autorização para gerenciar instâncias desse tipo.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Você não tem autorização para usar este tipo de instância.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Tipo de instância não encontrado ou fora do intervalo permitido, ou você não tem autorização para gerenciar instâncias desse tipo.
400	InvalidParameter.Mismatch	Too many parameters in one request.	O número máximo de parâmetros na solicitação foi excedido.
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 upgrade temporário de largura de banda não é permitido.
400	InvalidTemporary.StartTime	The specifed Temporary.StartTime is not valid.	A hora de início especificada para o período de upgrade temporário é inválida.
400	InvalidTemporary.EndTime	The specifed Temporary.EndTime is not valid.	Valor de Temporary.EndTime inválido.
400	Downgrade.NotSupported	Downgrade operation is not supported.	Não há suporte para downgrade de configuração.
400	DependencyViolation.InstanceType	The current InstanceType cannot be changed to the specified InstanceType.	Não é possível alterar a instância para o tipo especificado.
400	Account.Arrearage	Your account has an outstanding payment.	Existem pedidos não pagos em sua conta.
400	InvalidParameter.Bandwidth	The specified parameter Bandwidth is not valid.	Largura de banda inválida.
400	InvalidParameter.Conflict	The specified image does not support the specified instance type.	A imagem especificada não é compatível com o tipo de instância indicado.
400	InvalidParameter.AllowMigrateAcrossZone	The specified parameter CanMigrateAcrossZone is not valid.	Valor de AllowMigrateAcrossZone inválido.
400	InvalidParam.SystemDiskCategory	The specified param SystemDisk.Category is not valid.	Valor de SystemDisk.Category inválido.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Sua solicitação está sendo limitada. Tente novamente em 5 minutos.
400	InvalidInstanceStatus.NotStopped	The specified Instance status is not stopped.	A instância especificada não está no estado Stopped.
400	InvalidAction	Specified action is not valid.	A operação é inválida.
400	IdempotenceParamNotMatch	There is a idempotence signature mismatch between this and last request.	Esta solicitação e a anterior contêm o mesmo token de cliente, mas outros parâmetros diferentes.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Valor de ClientToken inválido.
400	Price.PricePlanResultNotFound	The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid.	Valor de InternetMaxBandwidthIn ou InternetMaxBandwidthOut inválido.
400	InvalidAction.NotSupport	The ecs on dedicatedHost not support modify instanceType.	Não é possível alterar os tipos de instâncias hospedadas em dedicated hosts.
400	InvalidMarketImageStatus.NotSupported	The status of specified market image does not support this operation.	Esta operação não pode ser realizada na imagem do Alibaba Cloud Marketplace no estado atual.
400	InvalidOperation.VpcHasEnabledAdvancedNetworkFeature	The specified vpc has enabled advanced network feature.	Recursos avançados estão habilitados para a VPC. Não é possível criar instâncias ECS com especificações baixas nesta VPC.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	Esta operação não pode ser executada quando PrivatePoolOptions.MatchCriteria está definido como Target.
400	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.	A operação de upgrade de configuração de instâncias não suporta esta categoria de disco.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	A capacidade dos discos pertencentes à categoria especificada excede o limite de cota da zona. Acesse o Quota Center para visualizar e aumentar a cota.
400	InvalidParam.Async	The specified parameter async is not valid.	Valor de Async inválido.
403	CategoryViolation	The specified instance does not support this operation because of its disk category.	Não é possível alterar as configurações de instâncias com discos locais anexados.
403	InvalidStatus.ValueNotSupported	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	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	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Saldo insuficiente na conta. Adicione fundos e tente novamente.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.	Esta operação não pode ser realizada em instâncias com o método de faturamento atual.
403	OperationDenied	The specified instance is out of usage.	Estoque insuficiente para o tipo de instância especificado.
403	LastTokenProcessing	The last token request is processing.	Uma solicitação de token está sendo processada. Tente novamente mais tarde.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	A instância foi reservada para alteração de tipo. As modificações não entrarão em vigor durante o período contratual atual.
403	InvalidInstanceType.ValueNotSupported	The specified zone does not offer the specified instancetype.	O tipo de instância não está disponível na região especificada.
403	ImageNotSupportInstanceType	The specified image do not support the InstanceType instance.	A imagem especificada não suporta este tipo de instância.
403	InvalidParameter.NotMatch	%s	Parâmetro inválido. Verifique se existem conflitos de parâmetros.
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	Esta operação não pode ser executada em instâncias associadas a um EIP. Desassocie o EIP primeiro.
403	OperationDenied.NoStock	The resource is out of usage.	A instância não está no estado Running. Inicie a instância ou verifique se a operação é válida.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Existem pedidos não pagos para esta instância. Faça login no console ECS para quitar os pedidos.
403	OperationDenied	%s	Operação negada.
403	InvalidOperation.Ipv4CountExceeded	%s	O número máximo de endereços IPv4 foi excedido.
403	InvalidOperation.Ipv6CountExceeded	%s	O número máximo de endereços IPv6 foi excedido.
403	InvalidOperation.Ipv6NotSupport	%s	Endereços IPv6 não suportam esta operação.
403	InvalidOperation.InstanceWithEipNotSupport	The special instance with eip not support operate, please unassociate eip first.	Esta operação não pode ser executada em instâncias associadas a um EIP. Desassocie o EIP primeiro.
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.	Riscos detectados no seu cartão de crédito ou débito padrão. Clique em na URL no e-mail para verificação.
403	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	A instância não possui disco do sistema anexado. Certifique-se de que a instância tenha um disco do sistema. Chame a operação DescribeInstances para consultar os detalhes da instância.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	O tipo de instância especificado não suporta as categorias de disco da instância. Tente outro tipo de instância. Para informações sobre as categorias de disco suportadas, consulte a documentação da família de instâncias.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	O número máximo de instâncias do tipo especificado na região foi excedido. Tente outra região ou tipo de instância, ou reduza a quantidade de instâncias a serem criadas. Você também pode acessar o console ECS ou o Quota Center para solicitar aumento de cota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	O número máximo de instâncias do tipo especificado na região foi excedido. Tente outra região ou tipo de instância, ou reduza a quantidade de instâncias a serem criadas. Você também pode acessar o console ECS ou o Quota Center para solicitar aumento de cota.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	O número máximo de vCPUs para todos os tipos de instância foi excedido. Acesse o console ECS ou o Quota Center para solicitar aumento de cota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	O número máximo de instâncias do tipo especificado na região ou o número máximo de vCPUs para todos os tipos de instância foi excedido. Acesse o console ECS ou o Quota Center para solicitar aumento de cota.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	Operação não suportada. Para mais informações, consulte o valor retornado no placeholder %s da mensagem de erro.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número máximo de filas na ENI foi excedido. Para mais informações, consulte o valor retornado no placeholder %s da mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número máximo de filas para todas as ENIs em uma instância foi excedido. Para mais informações, consulte o valor retornado no placeholder %s da mensagem de erro.
403	InvalidParameter.InvalidEniQueueNumber	%s	Número de filas para ENI inválido. Para mais informações, consulte o valor retornado no placeholder %s da mensagem de erro.
403	HibernationConfigured.InstanceOperationForbidden	The operation is not permitted due to limit of the hibernation configured instance.	A operação não pode ser executada devido às limitações de instâncias com o recurso de hibernação habilitado.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	ID da instância não encontrado.
404	MissingTemporary.StartTime	Temporary.StartTime is not specified.	A hora de início do período de upgrade temporário não foi especificada.
404	MissingTemporary.EndTime	Temporary.EndTime is not specified.	A hora de término do período de upgrade temporário não foi especificada.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	Método de faturamento da instância não encontrado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error.	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.