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

Consulta as informações de preço do tipo de instância de destino para a atualização de uma instância ECS por assinatura não expirada e as informações de preço de novos discos de dados por assinatura.

Descrição da operação

Você só pode consultar as informações de preço para a atualização de instâncias ECS por assinatura não expiradas. A consulta de informações de preço para o downgrade de instâncias não é suportada.
A consulta de informações de preço para a alteração das configurações de instâncias ECS pagas conforme o uso não é suportada. Como o preço de uma instância ECS paga conforme o uso após uma alteração de configuração é o mesmo de uma instância recém-criada, você pode chamar diretamente DescribePrice para consultar o preço mais recente da instância ECS.
Antes de atualizar uma instância, chame DescribeResourcesModification para consultar os tipos de instância disponíveis para atualização na zona especificada.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para visualizar a lista mais recente de regiões da Alibaba Cloud.	cn-hangzhou
InstanceId	string	Sim	O ID da instância para a qual você deseja consultar o preço de atualização.	i-bp1f2o4ldh8l****
InstanceType	string	Não	O tipo de instância de destino para a atualização da instância. Chame DescribeResourcesModification para consultar os tipos de instância disponíveis para atualização na zona especificada. Nota Ao consultar o preço, o parâmetro de tipo de instância (InstanceType) e o parâmetro de disco de dados (DataDisk.N.*) não podem estar ambos vazios. Você deve especificar pelo menos um deles.	ecs.g6e.large
SystemDisk.Category	string	Não	A categoria do disco do sistema. Este parâmetro é necessário apenas quando você atualiza de um tipo de instância descontinuado para um tipo de instância disponível e atualiza uma instância não otimizada para E/S para uma instância otimizada para E/S. Para obter mais informações sobre os tipos de instância, consulte Famílias de instâncias e Tipos de instância descontinuados. Valores válidos: cloud_efficiency: disco ultra. cloud_ssd: SSD padrão. Valor padrão: nenhum.	cloud_ssd
SystemDisk	object	Não	A modificação do disco do sistema.
Category	string	Não	A categoria do disco do sistema.	cloud_ssd
PerformanceLevel	string	Não	O nível de desempenho do disco do sistema.	PL0
Size	integer	Não	O tamanho do disco do sistema.	40
DataDisk	array<object>	Não	As informações de categoria do disco de dados.
	object	Não	As informações de categoria do disco de dados.
Category	string	Não	A categoria do disco de dados. Especifique este parâmetro quando precisar consultar o preço de um novo disco de dados por assinatura anexado à instância ECS. Valores válidos de N: 1 a 16. Valores válidos: cloud_efficiency: disco ultra. cloud_ssd: SSD padrão. cloud_essd: SSD empresarial. cloud: disco básico. Valor padrão: nenhum. Nota Ao consultar o preço, o parâmetro de tipo de instância (InstanceType) e o parâmetro de disco de dados (DataDisk.N.*) não podem estar ambos vazios. Você deve especificar pelo menos um deles.	cloud_essd
DiskId	string	Não	O ID do disco de dados. Se DiskId estiver vazio, um novo disco de dados será adicionado. Se DiskId não estiver vazio, o disco de dados será modificado.	d-bf4rupt9****
PerformanceLevel	string	Não	O nível de desempenho do disco de dados quando a categoria do disco de dados é SSD empresarial. O valor de N deve ser igual ao valor de N em DataDisk.N.Category=cloud_essd. Valores válidos: PL0: Um único disco pode oferecer até 10.000 IOPS de leitura/gravação aleatória. PL1: Um único disco pode oferecer até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único disco pode oferecer até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único disco pode oferecer até 1.000.000 IOPS de leitura/gravação aleatória. Valor padrão: PL1. Para obter mais informações sobre como selecionar um nível de desempenho de SSD empresarial, consulte SSDs empresariais.	PL1
Size	integer	Não	A capacidade do disco de dados. Valores válidos de N: 1 a 16. Unidade: GiB. Valores válidos: cloud_efficiency: 20 a 32768. cloud_ssd: 20 a 32768. cloud_essd: Os valores válidos variam de acordo com o valor de DataDisk.N.PerformanceLevel. PL0: 1 a 32768. PL1: 20 a 32768. PL2: 461 a 32768. PL3: 1261 a 32768. cloud: 5 a 2000. Valor padrão: A capacidade mínima permitida para a categoria de disco de dados especificada.	100
ImageId	string	Não	O ID da imagem.	aliyun_2_1903_x64_20G_alibase_20200324.vhd
InternetMaxBandwidthOut	integer	Não	A largura de banda pública de saída máxima.	10
ISP	string	Não	O provedor de serviços de Internet (ISP).	BGP
InternetChargeType	string	Não	O método de cobrança de rede. PayByBandwidth: pagamento por largura de banda. PayByTraffic: pagamento por tráfego.	PayByTraffic
StartTime	string	Não	A hora de início da alteração temporária de largura de banda. A hora segue o padrão ISO 8601 e é exibida em UTC. Este parâmetro entra em vigor apenas quando InternetMaxBandwidthOut é especificado.	2025-12-05T22:40Z
EndTime	string	Não	A hora de término da alteração temporária de largura de banda. A hora segue o padrão ISO 8601 e é exibida em UTC. Este parâmetro entra em vigor apenas quando InternetMaxBandwidthOut é especificado.	2025-12-06T22Z

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PriceInfo	object	As informações de preço, incluindo o preço e as informações da regra de desconto.
Price	object	O preço.
Currency	string	A unidade monetária. Valores válidos: Site da China: CNY. Site internacional: USD.	CNY
DetailInfos	object
DetailInfo	array<object>	As informações detalhadas de preço da configuração. Nota Este parâmetro é retornado apenas quando ResourceType está definido como instance.
	array<object>	As informações detalhadas de preço da configuração.
DiscountPrice	number	O preço com desconto.	655.2
OriginalPrice	number	O preço original.	4368
Resource	string	O nome da configuração. Valores válidos: instanceType: instância. bandwidth: largura de banda. image: imagem. systemDisk: disco do sistema. dataDisk: disco de dados.	instanceType
SubRules	object
Rule	array<object>	O subconjunto de regras de preço.
	object	O subconjunto de regras de preço.
Description	string	A descrição do subconjunto de regras.	15% off the list price for a 1-year subscription
RuleId	integer	O ID da regra de promoção.	315716429631488
TradePrice	number	O preço da transação.	3712.8
DiscountPrice	number	O desconto.	61.320
OriginalPrice	number	O preço original.	175.200
TradePrice	number	O preço final, que é o preço original menos o desconto.	113.880
RelatedPrice	object	O preço relacionado.
MarketplaceImagePrice	object	O preço da imagem do Alibaba Cloud Marketplace.
Currency	string	A unidade monetária. Site da China: CNY. Site internacional: USD.	CNY
DiscountPrice	number	O desconto.	0
OriginalPrice	number	O preço original.	100
TradePrice	number	O preço final, que é o preço original menos o desconto.	100
Rules	object
Rule	array<object>	A regra de promoção.
	object
Description	string	A descrição da regra de promoção.	Upgrade discount
RuleId	integer	O ID da promoção.	1234567890
RequestId	string	O ID da solicitação.	A3DC3196-379B-4F32-A2C5-B937134FAD8A

Exemplos

Resposta de sucesso

JSON formato

{
  "PriceInfo": {
    "Price": {
      "Currency": "CNY",
      "DetailInfos": {
        "DetailInfo": [
          {
            "DiscountPrice": 655.2,
            "OriginalPrice": 4368,
            "Resource": "instanceType",
            "SubRules": {
              "Rule": [
                {
                  "Description": "15% discount on the list price for a 1-year subscription",
                  "RuleId": 315716429631488
                }
              ]
            },
            "TradePrice": 3712.8
          }
        ]
      },
      "DiscountPrice": 61.32,
      "OriginalPrice": 175.2,
      "TradePrice": 113.88
    },
    "RelatedPrice": {
      "MarketplaceImagePrice": {
        "Currency": "CNY",
        "DiscountPrice": 0,
        "OriginalPrice": 100,
        "TradePrice": 100
      }
    },
    "Rules": {
      "Rule": [
        {
          "Description": "Upgrade discount",
          "RuleId": 1234567890
        }
      ]
    }
  },
  "RequestId": "A3DC3196-379B-4F32-A2C5-B937134FAD8A"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter.InstanceTypeOrDataDisk	You must specify the parameter InstanceType or DataDisk.	Você deve especificar o tipo de instância ou o parâmetro do disco de dados. Ambos os parâmetros não podem estar vazios.
400	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter "SystemDisk.Category" is not valid.	O parâmetro SystemDisk.Size especificado é inválido.
400	InvalidDiskCategory.Missing	The DataDisk.1.Category parameter that is mandatory for processing the request is not provided.	O tipo de disco de dados não foi especificado.
400	InvalidDataDiskCategory.ValueNotSupported	The specified parameter "DataDisk.n.Category" is not valid.
400	InvalidDiskCategory.ValueNotSupported	The specified parameter "DiskCategory" is not valid.	Os tipos de disco de sistema e de disco de dados especificados não são suportados.
400	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size beyond the permitted range.	O valor especificado do parâmetro DataDisk.n.Size está fora do intervalo.
400	InvalidPerformanceLevel.Malformed	The specified parameter DataDisk.n.PerformanceLevel is not valid.	O parâmetro PerformanceLevel especificado é inválido.
400	InvalidDiskSize.TooSmall	Specified disk size is too small when choose PL0 of cloud_essd.
400	OperationDenied.PerformanceLevelNotMatch	The specified DataDisk.n.PerformanceLevel and DataDisk.n.Size do not match.	O nível de desempenho especificado não corresponde ao tamanho do disco.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	O tipo de instância especificado é inválido (fora do intervalo disponível).
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.
400	PriceNotFound	The price of your queried resource is not available now, please try other resources.	Nenhuma informação de preço foi encontrada. Modifique os valores dos parâmetros relevantes e tente novamente.
400	InvalidBandwidth.ValueNotSupported	Instance upgrade bandwidth of temporary not allow less then existed.	O valor de largura de banda especificado não é suportado.
400	InvalidParameter.InstanceTypeAndNetworkConflict	The current operation does not allow both InstanceType and network modification parameter to be set.	Você não pode especificar ambos os parâmetros de tipo de instância e de alteração de rede na solicitação atual.
400	InvalidParameter.InstanceTypeAndImageConflict	The current operation does not allow both InstanceType and ImageId parameter to be set.	Você não pode especificar ambos os parâmetros InstanceType e ImageId na solicitação atual.
400	InvalidParameter.InstanceTypeAndDiskConflict	The current operation does not allow both InstanceType and Disk parameter to be set.	Você não pode especificar ambos os parâmetros InstanceType e Disk na solicitação atual.
400	InvalidParameter.NetworkAndImageConflict	The current operation does not allow both network modification parameter and ImageId to be set.	Você não pode especificar ambos os parâmetros de alteração de rede e ImageId na solicitação atual.
400	InvalidParameter.NetworkAndDiskConflict	The current operation does not allow both network modification parameter and disk parameter to be set.	Você não pode especificar ambos os parâmetros de alteração de rede e Disk na solicitação atual.
400	InvalidParameter.ImageAndDiskConflict	The current operation does not allow both ImageId and DataDisk parameter to be set.	Você não pode especificar ambos os parâmetros ImageId e Disk na solicitação atual.
400	InvalidParameter.CategoryAndSizeConflict	The current operation does not allow both Category and Size parameter to be set.	Você não pode especificar ambos os parâmetros Category e Size na solicitação atual.
400	MissingParameter.Instance	The instance modification parameter can not be empty.	Os parâmetros de alteração de especificação da instância não podem estar vazios.
400	InvalidDiskId.NotFound	The specified disk do not exist.	O DiskId especificado não existe. Verifique o ID do disco e a região atual.
400	InvalidEndTime.ValueNotSupported	The specified endTime is out of the permitted range.	O parâmetro EndTime é inválido.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	Esta conta não tem as permissões para processar reembolsos. A conta Alibaba Cloud deve conceder permissões relacionadas a reembolsos.
400	InvalidStartTime.ValueNotSupported	The specified startTime is out of the permitted range.	A hora de início especificada está fora do intervalo permitido.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	O ResourceOwnerAccount especificado é inválido.
403	ChargeTypeViolation	PostPaid instance do not support this operation.
403	InvalidInstanceType.NotSupportUpgrade	The specified InstanceType can only be downgraded. This API supports querying prices only of InstanceType that can be upgraded.	O tipo de instância especificado é um tipo com downgrade. Esta API suporta apenas a consulta de preços para tipos de instância com upgrade. Recomendamos que você chame a operação DescribeResourcesModification para obter os tipos de instância disponíveis para upgrade.
403	InstanceExpired	The PrePaid instance has been expired.	A instância por assinatura expirou. Renove a instância antes de realizar esta operação.
403	Throttling.User	Request was denied due to user flow control.
403	Throttling	Request was denied due to request throttling.
403	InstanceType.Offline	The specified InstanceType has been offline	O tipo de instância especificado foi descontinuado. Selecione um tipo de instância diferente.
403	RegionUnauthorized	There is no authority to create instance in the specified region.	O usuário não está autorizado a criar instâncias na região especificada.
403	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter SystemDisk.Category is not valid.	O parâmetro SystemDisk.Size especificado é inválido.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	O parâmetro DataDisk.n.Category especificado é inválido.
403	OperationDenied.PerformanceLevelNotMatch	The specified PerformanceLevel and disk size do not match.	O nível de desempenho especificado não corresponde ao tamanho do disco.
403	InvalidDiskCategory.ValueNotSupported	The current disk category of the resource does not support this operation.	Os tipos de disco de sistema e de disco de dados especificados não são suportados.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	O tipo de instância especificado não suporta a categoria de disco da instância atual. Tente outro tipo de instância. Para obter informações sobre os tipos de disco suportados pelos tipos de instância, consulte a documentação da família de instâncias.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	O RegionId especificado não existe. Verifique se o serviço está disponível na região.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos especificado não existe.
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.
404	InvalidDiskId.NotFound	The specified DiskId does not exist.	O DiskId especificado não existe. Verifique o ID do disco e a região atual.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.