Consultar a taxa de renovação - : Central de Documentação do Alibaba Cloud

Esta operação é compatível apenas com instâncias de assinatura.

Depuração

O OpenAPI Explorer calcula automaticamente a assinatura. Por conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Yes	DescribeRenewalPrice	A operação que você deseja executar. Defina o valor como DescribeRenewalPrice.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxx	O ID da instância.
TimeType	String	Yes	Year	O ciclo de renovação da instância. Valores válidos: Year Month
UsedTime	Integer	Yes	1	O período de assinatura da instância. Valores válidos: Se você definir o parâmetro TimeType como Year, o valor do parâmetro UsedTime deverá estar no intervalo de 1 a 3. Se você definir o parâmetro TimeType como Month, o valor do parâmetro UsedTime deverá estar no intervalo de 1 a 9.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxxxxx	O token de cliente que garante a idempotência da solicitação.
RegionId	String	No	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
PayType	String	No	Postpaid	O método de faturamento da instância. Valores válidos: Postpaid: o método de faturamento de pagamento conforme o uso Prepaid: o método de faturamento por assinatura
DBInstanceClass	String	No	mysql.n2.medium.2c	O tipo da instância. Para mais informações, consulte Primary instance types. Por padrão, o tipo atual da instância é mantido.
Quantity	Integer	No	1	O número de instâncias que você deseja renovar. Valor padrão: 1.
OrderType	String	No	BUY	O tipo do pedido de compra. Defina o valor como BUY.
BusinessInfo	String	No	121436975448952	As informações comerciais adicionais da instância.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Rules	Array of Rule		As especificações da promoção.
Rule
RuleId	Long	1001199213	O ID da promoção.
Name	String	test	O nome da promoção.
Description	String	Content	A descrição da promoção.
PriceInfo	Struct		Uma estrutura que contém informações de preço.
Currency	String	CNY	A unidade monetária usada para calcular a taxa de renovação.
ActivityInfo	Struct		O preço da renovação.
CheckErrMsg	String	Error	A descrição do erro ocorrido.
ErrorCode	String	123456	O código do erro ocorrido.
Success	String	Success	Indica se a renovação foi bem-sucedida.
OriginalPrice	Float	138	O preço original da renovação.
DiscountPrice	Float	27	O desconto da renovação.
TradePrice	Float	111	O preço com desconto da renovação. O preço com desconto equivale ao preço original menos o desconto.
Coupons	Array of Coupon		Um array que contém vouchers.
Coupon
Name	String	test	O nome do voucher.
Description	String	test	A descrição do voucher.
CouponNo	String	123456	O ID do voucher.
IsSelected	String	true	Indica se um voucher está selecionado.
RuleIds	List	1001199213	O ID da promoção.
RequestId	String	DC9F4EF6-D038-4405-B497-1F48E722C9F2	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/? Action=DescribeRenewalPrice
&TimeType=Year
&UsedTime=1
&DBInstanceId=rm-uf6wjk5xxxxxx
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeRenewalPriceResponse>
  <RequestId>BA34B8E6-4119-49B0-BDA3-6ECD9B097A98</RequestId>
  <Rules>
        <Rule>
              <RuleId>1020021003939076</RuleId>
              <Name>test</Name>
        </Rule>
  </Rules>
  <PriceInfo>
        <OriginalPrice>1070</OriginalPrice>
        <Currency>CNY</Currency>
        <DiscountPrice>1070</DiscountPrice>
        <RuleIds>
              <RuleId>1020021003939076</RuleId>
        </RuleIds>
        <TradePrice>0</TradePrice>
        <Coupons>
    </Coupons>
  </PriceInfo>
</DescribeRenewalPriceResponse>

Formato JSON

{
	"RequestId": "BA34B8E6-4119-49B0-BDA3-6ECD9B097A98",
	"Rules": {
		"Rule": [
			{
				"RuleId": "1020021003939076",
				"Name": "test"
			}
		]
	},
	"PriceInfo": {
		"OriginalPrice": 1070,
		"Currency": "CNY",
		"DiscountPrice": 1070,
		"RuleIds": {
			"RuleId": [
				"1020021003939076"
			]
		},
		"TradePrice": 0,
		"Coupons": {
			"Coupon": []
		}
	}
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.