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

Consulta o preço de renovação de recursos do Elastic Compute Service (ECS). Apenas recursos por assinatura são suportados.

Descrição da operação

Apenas o preço para renovar uma instância ECS por assinatura por uma duração especificada ou o preço para renovar uma instância até uma data de expiração unificada é suportado.
Precauções para configurações de parâmetros:
- Se apenas os parâmetros obrigatórios forem definidos, o preço para renovar a instância por um mês será consultado por padrão.
- Você não pode consultar o preço da duração da renovação e o preço da renovação até uma data de expiração unificada ao mesmo tempo. Os parâmetros de duração da renovação (Period e PeriodUnit) e o parâmetro de data de expiração unificada (ExpectedRenewDay) não podem ser definidos simultaneamente.

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

get

DedicatedHost

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

Instance

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ResourceType	string	Não	O tipo do recurso para o qual consultar o preço de renovação. Valores válidos: instance. Valor padrão: instance.	instance
ResourceId	string	Sim	O ID do recurso para o qual consultar o preço de renovação. Quando `ResourceType` está definido como `instance`, `ResourceId` equivale a `InstanceId`.	i-bp1f2o4ldh8l29zv****
Period	integer	Não	A duração da renovação. Valores válidos: Quando `PriceUnit` está definido como `Month`: 1 a 9. Quando `PriceUnit` está definido como `Year`: 1 a 3. Valor padrão: 1. Nota Os parâmetros de duração da renovação (`Period` e `PeriodUnit`) e o parâmetro de data de expiração unificada (`ExpectedRenewDay`) não podem ser definidos simultaneamente.	1
PriceUnit	string	Não	A unidade da duração da renovação. Valores válidos: Month: A duração da renovação é medida em meses. Year: A duração da renovação é medida em anos. Valor padrão: Month.	Month
ExpectedRenewDay	integer	Não	A data de expiração unificada. Se você especificar este parâmetro, o preço para renovar a instância até a data de expiração unificada será consultado. Valores válidos: 1 a 28. Para obter mais informações sobre o recurso de data de expiração unificada, consulte Data de expiração unificada da instância. Nota Os parâmetros de duração da renovação (`Period` e `PeriodUnit`) e o parâmetro de data de expiração unificada (`ExpectedRenewDay`) não podem ser definidos simultaneamente.	5

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
PriceInfo	object	As informações de preço, incluindo o preço e os detalhes das regras de desconto.
Rules	object
Rule	array<object>	A regra promocional.
	object
Description	string	A descrição da regra promocional.	Obtenha 15% de desconto sobre o preço de tabela para uma assinatura de um ano
RuleId	integer	O ID da promoção.	1234567890
Price	object	O preço.
OriginalPrice	number	O preço original.	4368
DiscountPrice	number	O desconto.	655.2
Currency	string	A unidade monetária. Site da China: CNY. Site internacional: USD.	CNY
TradePrice	number	O preço da transação, que é igual ao preço original menos o desconto.	3712.8
DetailInfos	object
DetailInfo	array<object>	Os detalhes de precificação do recurso.
	array<object>
Resource	string	O nome do recurso correspondente ao preço.	instance
OriginalPrice	number	O preço original.	4368
DiscountPrice	number	O preço com desconto.	655.2
TradePrice	number	O preço da transação.	3712.8
SubRules	object
Rule	array<object>	O subconjunto de regras de precificação.
	object
Description	string	A descrição da regra de precificação.	Obtenha 15% de desconto sobre o preço de tabela para uma assinatura de um ano
RuleId	integer	O ID da regra de precificação.	1234567890
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
OriginalPrice	number	O preço original.	200
DiscountPrice	number	O desconto.	0
TradePrice	number	O preço da transação, que é igual ao preço original menos o desconto.	200

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PriceInfo": {
    "Rules": {
      "Rule": [
        {
          "Description": "Obtenha 15% de desconto sobre o preço de tabela para uma assinatura de um ano",
          "RuleId": 1234567890
        }
      ]
    },
    "Price": {
      "OriginalPrice": 4368,
      "DiscountPrice": 655.2,
      "Currency": "CNY",
      "TradePrice": 3712.8,
      "DetailInfos": {
        "DetailInfo": [
          {
            "Resource": "instance",
            "OriginalPrice": 4368,
            "DiscountPrice": 655.2,
            "TradePrice": 3712.8,
            "SubRules": {
              "Rule": [
                {
                  "Description": "Obtenha 15% de desconto sobre o preço de tabela para uma assinatura de um ano",
                  "RuleId": 1234567890
                }
              ]
            }
          }
        ]
      }
    },
    "RelatedPrice": {
      "MarketplaceImagePrice": {
        "Currency": "CNY",
        "OriginalPrice": 200,
        "DiscountPrice": 0,
        "TradePrice": 200
      }
    }
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidResourceType.ValueNotSupported	The specified parameter ResourceType is not valid.	O tipo de recurso especificado é inválido.
400	InvalidPeriod	The specified period is not valid.	O período de tempo especificado é inválido.
400	InvalidPriceUnit.ValueNotSupported	The specified parameter PriceUnit is not valid.	O parâmetro PriceUnit especificado é inválido.
400	Throttling	Request was denied due to request throttling.	A solicitação foi limitada.
400	Throttling.User	Request was denied due to user flow control.
400	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente.
400	InvalidPeriod.ExceededMaximumExpirationDate	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.	O período de renovação especificado não pode exceder o período máximo de validade. Reduza o período de renovação e tente novamente.
400	InvalidExpectedRenewDay.Conflict	The specified expectedRenewDay is in conflict with period.
400	InvalidExpectedRenewDay.ValueNotSupported	The specified parameter ExpectedRenewDay is not valid.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can not exceed dedicated host expired date.	A data de expiração da instância não pode exceder a data de expiração do host dedicado.
400	OperationRestricted.Renewal	The renewal operation has been restricted because the zone is closed. %s
400	InvalidOperation.ClassicNetworkTypeNotSupported	The classic network instance does not support this operation.	A instância baseada na arquitetura de rede clássica não pode ser renovada. Realize a migração para uma VPC antes de executar a renovação normal.
400	LastOrderProcessing	The previous order is still processing, please try again later.	A solicitação está sendo processada. Tente novamente mais tarde.
400	InvalidParam.ExpectedRenewDay	The specified parameter ExpectedRenewDay is not valid.	O parâmetro de período de renovação é inválido. Consulte a documentação da API para redefinir o parâmetro.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	InvalidAction.Unauthorized	The specified action is not valid.	A operação especificada é inválida.
403	InvalidStatus.DiskNotReady	This specified disk is not ready, status needs to be either In_use or Available.	O disco especificado deve estar no estado In_use ou Available.
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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.