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 de assinatura são suportados.

Descrição da operação

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

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 cujo preço de renovação você deseja consultar. Valores válidos: instance. Valor padrão: instance.	instance
ResourceId	string	Sim	O ID do recurso cujo preço de renovação você deseja consultar. Quando `ResourceType` é definido como `instance`, `ResourceId` é equivalente a `InstanceId`.	i-bp1f2o4ldh8l29zv****
Period	integer	Não	A duração da renovação. Valores válidos: Quando `PriceUnit` é definido como `Month`: 1 a 9. Quando `PriceUnit` é definido como `Year`: 1 a 3. Valor padrão: 1. Nota Os parâmetros de duração de renovação (`Period` e `PeriodUnit`) e o parâmetro de data de expiração unificada (`ExpectedRenewDay`) não podem ser definidos ao mesmo tempo.	1
PriceUnit	string	Não	A unidade da duração de renovação. Valores válidos: Month: a duração de renovação é medida em meses. Year: a duração de renovação é medida em anos. Valor padrão: Month.	Month
ExpectedRenewDay	integer	Não	A data de expiração unificada. Após especificar este parâmetro, o preço para renovar a instância até a data de expiração unificada é retornado. Valores válidos: 1 a 28. Para mais informações sobre o recurso de data de expiração unificada, consulte Configurações de expiração de instância. Nota Os parâmetros de duração de renovação (`Period` e `PeriodUnit`) e o parâmetro de data de expiração unificada (`ExpectedRenewDay`) não podem ser definidos ao mesmo tempo.	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>	The promotion rule.
	object
Description	string	The description of the promotion rule.	买满1年，立享官网价格8.5折优惠。
RuleId	integer	The promotion ID.	1234567890
Price	object	O preço.
OriginalPrice	number	The original price.	4368
DiscountPrice	number	The discount.	655.2
Currency	string	The currency unit. China site: CNY. International site: USD.	CNY
TradePrice	number	The transaction price, which is equal to the original price minus the discount.	3712.8
DetailInfos	object
DetailInfo	array<object>	The resource pricing details.
	array<object>
Resource	string	The name of the resource that corresponds to the price.	instance
OriginalPrice	number	The original price.	4368
DiscountPrice	number	The discount price.	655.2
TradePrice	number	The transaction price.	3712.8
SubRules	object
Rule	array<object>	The subset of pricing rules.
	object
Description	string	The description of the pricing rule.	买满1年，立享官网价格8.5折优惠。
RuleId	integer	The ID of the pricing rule.	1234567890
RelatedPrice	object
MarketplaceImagePrice	object
Currency	string		CNY
OriginalPrice	number		200
DiscountPrice	number		0
TradePrice	number		200

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PriceInfo": {
    "Rules": {
      "Rule": [
        {
          "Description": "买满1年，立享官网价格8.5折优惠。",
          "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": "买满1年，立享官网价格8.5折优惠。",
                  "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.	The specified resource type is not supported.
400	InvalidPeriod	The specified period is not valid.	The specified period is invalid.
400	InvalidPriceUnit.ValueNotSupported	The specified parameter PriceUnit is not valid.	The specified PriceUnit parameter is invalid.
400	Throttling	Request was denied due to request throttling.
400	Throttling.User	Request was denied due to user flow control.
400	InternalError	The request processing has failed due to some unknown error.	An internal error has occurred. Try again later.
400	InvalidPeriod.ExceededMaximumExpirationDate	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.	The specified renewal period exceeds the maximum allowed value. We recommend that you shorten the renewal period at your next attempt.
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.	The expiration date of the instance is later than that of the dedicated host.
400	OperationRestricted.Renewal	The renewal operation has been restricted because the zone is closed. %s
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred. Try again later.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	InvalidAction.Unauthorized	The specified action is not valid.	The specified operation is invalid.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	The specified instanceId is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.