：DescribeRenewalPrice

Description

• You can call this operation to query the price for renewing a subscription instance for a specific period of time or to a synchronized expiration date.
• Take note of the following items:
  • If you set only the required parameters, the price for renewing a specified instance for one month is queried by default.
  • The renewal period-related parameter pair (Period andPeriodUnit) and the synchronized expiration date-related parameter (ExpectedRenewDay) are mutually exclusive. You cannot set these parameters together to query the prices for renewing a specified instance for a period of time and to a synchronized expiration date at the same time.

Request parameters

Response parameters

Examples

Sample requests

http(s)://ecs.aliyuncs.com/?Action=DescribeRenewalPrice
&RegionId=cn-hangzhou
&ResourceType=instance
&ResourceId=i-bp1f2o4ldh8l29zv****
&Period=1
&PriceUnit=Month
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeRenewalPriceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <PriceInfo>
        <Rules>
            <Rule>
                <Description>Receive a 15% discount on a 1-year subscription. </Description>
                <RuleId>1234567890</RuleId>
            </Rule>
        </Rules>
    </PriceInfo>
    <Price>
        <OriginalPrice>4368</OriginalPrice>
        <DiscountPrice>655.2</DiscountPrice>
        <Currency>CNY</Currency>
        <TradePrice>3712.8</TradePrice>
        <DetailInfos>
            <DetailInfo>
                <Resource>instance</Resource>
                <OriginalPrice>4368</OriginalPrice>
                <DiscountPrice>655.2</DiscountPrice>
                <TradePrice>3712.8</TradePrice>
                <SubRules>
                    <SubRule>
                        <Description>Receive a 15% discount on a 1-year subscription. </Description>
                        <RuleId>1234567890</RuleId>
                    </SubRule>
                </SubRules>
            </DetailInfo>
        </DetailInfos>
    </Price>
</DescribeRenewalPriceResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PriceInfo" : {
    "Rules" : {
      "Rule" : [ {
        "Description" : "Receive a 15% discount on 1-year subscription.",
        "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" : {
          "SubRule" : [ {
            "Description" : "Receive a 15% discount on 1-year subscription.",
            "RuleId" : 1234567890
          } ]
        }
      } ]
    }
  }
}

Error codes

For a list of error codes, visit the API Error Center.