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

Modifica o tipo de instância ou a largura de banda pública de uma instância ECS pós-paga.

Descrição da operação

Antes de usar esta operação, certifique-se de compreender totalmente os métodos de cobrança e os preços do ECS.

Antes de alterar o tipo de instância de uma instância pós-paga, você pode chamar DescribeResourcesModification para consultar os tipos de instância para os quais a instância atual pode ser alterada.

Precauções

Sua conta não deve ter pagamentos em atraso.
Cada invocação pode modificar apenas uma configuração. Você pode modificar apenas o tipo de instância ou ajustar apenas a largura de banda pública em uma única solicitação.
O status da instância deve ser Running (Running) ou Stopped (Stopped) antes que você possa ajustar a largura de banda pública. A alteração entra em vigor imediatamente.
O status da instância deve ser Stopped (Stopped) antes que você possa modificar o tipo de instância. Após a modificação, você deve iniciar a instância para que a alteração entre em vigor.

Nota

A largura de banda pública de pico total cobrada com base na largura de banda em uma única região para uma única conta Alibaba Cloud está sujeita a limites. Para mais informações, consulte Limites de largura de banda pública.

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:ModifyInstanceSpec

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.	i-bp67acfmxazb4p****
InstanceType	string	Não	O tipo de instância de destino. Para mais informações, consulte Família de instâncias. Você também pode invocar DescribeInstanceTypes para consultar a lista mais recente de tipos de instância.	ecs.g6.large
InternetMaxBandwidthOut	integer	Não	A largura de banda pública de saída máxima. Unidade: Mbit/s. Valores válidos: 0 a 100. Nota No modo pay-by-traffic, as larguras de banda de entrada e saída de pico são usadas como limites superiores de largura de banda e não são garantidas. Quando ocorre contenção de recursos, as larguras de banda de pico podem ser limitadas. Se o seu negócio exigir largura de banda garantida, use o modo pay-by-bandwidth.	10
InternetMaxBandwidthIn	integer	Não	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: 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`. Nota No modo pay-by-traffic, as larguras de banda de entrada e saída de pico são usadas como limites superiores de largura de banda e não são garantidas. Quando ocorre contenção de recursos, as larguras de banda de pico podem ser limitadas. Se o seu negócio exigir largura de banda garantida, use o modo pay-by-bandwidth.	10
Temporary.StartTime	string	Não	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.	null
Temporary.EndTime	string	Não	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.	null
Temporary.InternetMaxBandwidthOut	integer	Não	Nota Este parâmetro está em visualização por convite e não está disponível publicamente.	null
Async	boolean	Não	Especifica se deve enviar uma solicitação assíncrona. Valores válidos: true: A solicitação é enviada de forma assíncrona. false: A solicitação não é enviada de forma assíncrona. Valor padrão: false.	false
AllowMigrateAcrossZone	boolean	Não	Especifica se há suporte para atualização de tipo de instância entre clusters. Valores válidos: true: Suportado. false: Não suportado. Valor padrão: false. Se você definir o parâmetro `AllowMigrateAcrossZone` como true e atualizar a instância Elastic Compute Service com base na resposta, observe o seguinte: Instâncias do tipo de rede clássica: Para tipos de instância descontinuados, quando uma instância não otimizada para I/O é alterada para uma instância otimizada para I/O, o endereço IP privado, os nomes dos dispositivos de disco e os códigos de autorização de software da instância mudam. Para instâncias Linux, discos básicos (`cloud`) são identificados como xvda ou xvdb, e ultra disks (`cloud_efficiency`) e SSDs padrão (`cloud_ssd`) são identificados como vda ou vdb. Para famílias de instâncias disponíveis para compra, o endereço IP privado da instância muda. Instâncias do tipo VPC: Para tipos de instância descontinuados, quando uma instância não otimizada para I/O é alterada para uma instância otimizada para I/O, os nomes dos dispositivos de disco do servidor e os códigos de autorização de software da instância mudam. Para instâncias Linux, discos básicos (`cloud`) são identificados como xvda ou xvdb, e ultra disks (`cloud_efficiency`) e SSDs padrão (`cloud_ssd`) são identificados como vda ou vdb.	false
SystemDisk.Category	string	Não	A nova categoria do disco do sistema. Valores válidos: cloud_efficiency: ultra disk cloud_ssd: SSD padrão Nota Este parâmetro é válido apenas quando você atualiza de um tipo de instância descontinuado para uma família de instâncias disponível para compra e altera uma instância não otimizada para I/O para uma instância otimizada para I/O.	cloud_ssd
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 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.	0c593ea1-3bea-11e9-b96b-88e9fe637760
ModifyMode	string	Não	Nota Este parâmetro não está disponível publicamente.	null
Disk	array<object>	Não	Nota Este parâmetro não está disponível publicamente.
	object	Não	Nota Este parâmetro não está disponível publicamente.
DiskId	string	Não	Nota Este parâmetro não está disponível publicamente.	null
Category	string	Não	Nota Este parâmetro não está disponível publicamente.	null
PerformanceLevel	string	Não	Nota Este parâmetro não está disponível publicamente.	null
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos: true: Realiza apenas um dry run. O tipo de instância e a largura de banda pública não são modificados. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido, se as restrições de negócios são atendidas e se os recursos ECS estão disponíveis. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro `DryRunOperation` será retornado. false (padrão): Realiza um dry run e envia a solicitação. Se a verificação for bem-sucedida, o tipo de instância e a largura de banda pública serão modificados diretamente.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "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	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	O método de cobrança para uso de rede especificado não é suportado. Verifique se os parâmetros relacionados estão corretos.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType does not exist or beyond the permitted range.	O tipo de instância especificado não existe ou você não tem permissão para operar instâncias deste tipo.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	O tipo de instância especificado não suporta o tipo de disco de dados anexado à instância atual.
400	InvalidParameter	The specified parameter "InternetMaxBandwidthOut" is not valid.
400	InvalidParameter.Mismatch	Too many parameters in one request.	Um disco não criptografado não pode ser redefinido usando um snapshot criptografado.
400	BandwidthUpgradeDenied.EipBoundInstance	The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.	A instância atual está associada a um EIP.
400	InvalidTemporary.StartTime	The specifed Temporary.StartTime is not valid.	A hora de início do upgrade temporário especificada é inválida.
400	InvalidTemporary.EndTime	The specifed Temporary.EndTime is not valid.	A hora de término do upgrade temporário especificada é inválida.
400	Downgrade.NotSupported	Downgrade operation is not supported.	O downgrade não é suportado.
400	DependencyViolation.InstanceType	The current InstanceType cannot be changed to the specified InstanceType.	O tipo de instância da instância atual não pode ser alterado para o tipo de instância especificado.
400	Account.Arrearage	Your account has an outstanding payment.	Sua conta possui pagamentos pendentes.
400	InvalidParameter.Bandwidth	The specified parameter Bandwidth is not valid.	A largura de banda especificada é inválida. Verifique se o parâmetro está correto.
400	InvalidParameter.Conflict	The specified image does not support the specified instance type.	A operação atual não permite que diskId e imageId sejam especificados simultaneamente. Certifique-se de que diskId ou imageId não esteja vazio.
400	InvalidParameter.AllowMigrateAcrossZone	The specified parameter CanMigrateAcrossZone is not valid.	O parâmetro CanMigrateAcrossZone especificado é inválido.
400	InvalidParam.SystemDiskCategory	The specified param SystemDisk.Category is not valid.	O parâmetro de tipo de disco do sistema especificado é inválido.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	A solicitação foi limitada. Use o método de paginação baseado em NextToken em vez do método de paginação baseado em PageNumber para consultas.
400	InvalidInstanceStatus.NotStopped	The specified Instance status is not stopped.	As configurações de Secure Boot não podem ser modificadas porque a instância não está no estado Stopped.
400	InvalidAction	Specified action is not valid.	O tipo de operação especificado não é suportado.
400	IdempotenceParamNotMatch	There is a idempotence signature mismatch between this and last request.	Os parâmetros de idempotência não correspondem.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	O ClientToken especificado é inválido.
400	Price.PricePlanResultNotFound	The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid.	O internetMaxBandwidthIn ou internetMaxBandwidthOut especificado é inválido.
400	InvalidAction.NotSupport	The ecs on dedicatedHost not support modify instanceType.	Instâncias em hosts dedicados não suportam alterações de tipo de instância.
400	InvalidMarketImageStatus.NotSupported	The status of specified market image does not support this operation.	O status da imagem especificada do Alibaba Cloud Marketplace não suporta esta operação.
400	InvalidOperation.VpcHasEnabledAdvancedNetworkFeature	The specified vpc has enabled advanced network feature.	A VPC possui recursos avançados ativados. Instâncias ECS de baixa especificação não podem ser criadas nesta VPC.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	O parâmetro especificado PrivatePoolOptions.MatchCriteria é inválido.
400	InstanceTypeNotSupported.TooManyDisksAttached	%s
400	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.
400	InvalidParameter.CloudboxNotSupported	%s
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	A capacidade utilizada do tipo de disco especificado excedeu o limite de cota na zona ativa. Acesse o Centro de Cotas para consultar e solicitar um aumento da cota de capacidade de disco.
400	InvalidParam.Async	The specified parameter async is not valid.	O parâmetro Async é inválido.
400	MissingParameter.DiskCategory	The specified parameter Disk.Category can not be null when Disk.DiskId is specified.
400	InvalidParameter.DiskCategory	The specified parameter Disk.Category is not valid.
400	InvalidPerformanceLevel.Malformed	The specified parameter Disk.n.PerformanceLevel is not valid.
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 Alibaba Cloud ou defina o parâmetro AutoPay como true para pagamento automático.
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 na região de nuvem dedicada não suportam parâmetros relacionados a IP público.
400	InvalidOperation.OnlineModificationUnsupported	Online modification of instance type is not supported for the specified instance due to its CPU topology.	O tipo de topologia de CPU atual não suporta alterações de especificação a quente.
400	QuotaExceeded.InternetBandwidth	%s.	A largura de banda pública total faturada por largura de banda das instâncias ECS pós-pagas em sua conta excede o limite total de cota de largura de banda.
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support Rss.	O tipo de instância da instância especificada não suporta a ativação de RSS.
400	InvalidInstanceType.NotSupportCpuOptionsNestedVirtualization	The specified instance type does not support CpuOptions.NestedVirtualization: %s.	O tipo de instância atual não suporta a capacidade de virtualização aninhada especificada.
401	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	O tipo de instância especificado não existe ou você não tem permissão para operar instâncias deste tipo.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
403	CategoryViolation	The specified instance does not support this operation because of its disk category.
403	InvalidStatus.ValueNotSupported	The current status of the resource does not support this operation.	O repairStatus do problema especificado é inválido. O status esperado é vazio ou falha.
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. Entre em contato com o suporte técnico de segurança.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	OperationDenied	The specified instance is out of usage.	O EIP especificado está indisponível ou não autorizado.
403	LastTokenProcessing	The last token request is processing.
403	InvalidInstance.UnpaidOrder	The specified instance has unpaid order.
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 especificada está reservada devido a uma alteração de especificação e não pode entrar 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 especificado não suporta o tipo de disco de dados anexado à instância atual.
403	ImageNotSupportInstanceType	The specified image do not support the InstanceType instance.	A imagem especificada não suporta instâncias do tipo de instância selecionado.
403	InstanceType.Offline	The specified InstanceType has been offline.	O tipo de instância especificado foi descontinuado.
403	InvalidParameter.NotMatch	%s	O tipo de instância especificado suporta apenas imagens específicas. Você pode chamar a operação DescribeImages para consultar as imagens disponíveis.
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	Esta operação não é suportada para instâncias que possuem um EIP associado. Desassocie o EIP primeiro.
403	InvalidInstance.NatPortMapNotSupport	The special instance with nat port map not support operate, please remove nat port map first.
403	InvalidOperation.StarterPackage	StarterPackage not support modification.
403	OperationDenied.NoStock	The resource is out of usage.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	O ID da instância especificado possui um pedido não pago. Você pode fazer login no console ECS para concluir o pagamento.
403	InvalidOperation.EipNotSupport	The special instance with eip not support operate, please unassociate eip first.
403	InvalidParameter.InternetMaxBandwidthOut	The specified parameter InternetMaxBandwidthOut is invalid.
403	InvalidOperation.EniCountExceeded	%s
403	InvalidOperation.Ipv4CountExceeded	%s	O número de endereços IPv4 nas Elastic Network Interfaces (ENIs) anexadas à instância ECS atual excede o limite do tipo de instância de destino.
403	InvalidOperation.Ipv6CountExceeded	%s	O número de endereços IPv6 nas Elastic Network Interfaces (ENIs) anexadas à instância ECS atual excede o limite do tipo de instância de destino.
403	InvalidOperation.Ipv6NotSupport	%s	O tipo de instância atual não suporta IPv6.
403	InvalidOperation.Ipv4NotSupport	%s
403	InvalidOperation.InstanceWithEipNotSupport	The special instance with eip not support operate, please unassociate eip first.	Esta operação não é suportada para 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.	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	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	O tipo de instância especificado (InstanceType) não suporta a categoria de disco da instância atual. Tente um tipo de instância diferente. Para obter informações sobre os tipos de disco suportados por cada tipo de instância, 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 uso do ECS excede a cota. Faça login no Console de Gerenciamento do Alibaba Cloud e envie uma solicitação para aumentar a cota.
403	InvalidResourceType.NotSupported	%s	A combinação de recursos especificada não existe. Tente uma zona ou tipo de instância diferente.
403	InvalidOperation.NotAllowed	The specified vpc %s has enabled senior network feature.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	O tipo de instância não suporta operações de modo trunk em Elastic Network Interfaces (ENIs).
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número de filas da Elastic Network Interface (ENI) excede o limite superior. Para mais informações, consulte o resultado de retorno real do espaço reservado %s na mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número de filas da Elastic Network Interface (ENI) anexadas à instância ECS atual excede o limite de filas do controlador de interface de rede (NIC) do tipo de instância de destino.
403	InvalidParameter.InvalidEniQueueNumber	%s	O número da fila do controlador de interface de rede (NIC) está incorreto. Para mais informações, consulte o resultado real retornado no espaço reservado %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 é permitida porque a instância não atende aos requisitos para ativar a opção de hibernação.
403	InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode	%s	O tipo de instância atual não suporta a anexação de ENIs RDMA.
403	InvalidOperation.EniQueuePairNumberOverflow	%s
403	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	%s
403	InvalidOperation.MaxEniQueuePairNumberExceed	%s
403	InvalidOperation.MaxModifyOnlineNumberExceeded	The specified instance has reached the maximum number of modify online attempts and needs to be rebooted.
403	InvalidOperation.RebootingRequired	The specified instance needs to be rebooted.
403	InvalidOperation.OSTypeNotSupported	The specified OS type is not supported.
403	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter SystemDisk.Category is not valid.	O parâmetro de especificação do disco do sistema especificado é inválido.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	O parâmetro DataDisk.Category especificado é inválido.
403	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.	O tipo de disco especificado não é suportado na zona atual. Modifique o tipo de disco ou altere a zona e tente novamente.
403	InvalidOperation.InstanceTypeSecureBootUnsupported	The instance type does not support secure boot.	O tipo de instância não suporta Secure Boot.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	O ID da instância especificado é inválido.
404	MissingTemporary.StartTime	Temporary.StartTime is not specified.	A hora de início do upgrade temporário não foi especificada.
404	MissingTemporary.EndTime	Temporary.EndTime is not specified.	A hora de término do upgrade temporário não foi especificada.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	O serviço está indisponível no momento. Tente novamente mais tarde.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.