DescribeContainerGroupPrice - Elastic Container Instance

Queries the price of an elastic container instance.

Operation Description

This operation does not support resource group authentication.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The ID of the region where the instance resides. You can call the DescribeRegions operation to query the most recent region and zone list.	cn-hangzhou
Cpu	float	Yes	The number of vCPUs.	2.0
Memory	float	Yes	The size of the memory. Unit: GiB.	4.0
InstanceType	string	No	The instance type of the Elastic Compute Service (ECS) instance used to create the elastic container instance. For more information about ECS instance types that can be used to create elastic container instances, see Instance types.	ecs.c5.large
SpotStrategy	string	No	The bidding policy for the elastic container instance. Valid values: NoSpot: The instance is a regular pay-as-you-go instance. SpotWithPriceLimit: The instance is a preemptible instance with a user-defined maximum hourly price. SpotAsPriceGo: The instance is a preemptible instance for which the market price at the time of purchase is automatically used as the bid price. Default value: NoSpot.	SpotWithPriceLimit
ZoneId	string	No	The zone ID of the instance. You can call the DescribeRegions operation to query the most recent region and zone list.	cn-hangzhou-g
SpotPriceLimit	float	No	The maximum hourly price of the preemptible elastic container instance. The value can contain up to three decimal places. If you set the SpotStrategy parameter to SpotWithPriceLimit, you must specify the SpotPriceLimit parameter.	0.2
EphemeralStorage	integer	No	The storage size of the temporary storage space. Unit: GiB.	20

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request.	7A872585-33C7-4D69-AB8E-412E81EBA387
PriceInfo	object	The information about the price and discount rule.
SpotPrices	array	The details about the price of the preemptible elastic container instance.
	object
ZoneId	string	The zone ID of the instance.	cn-hangzhou-i
SpotPrice	float	The price of the preemptible elastic container instance.	0.056
InstanceType	string	The instance type of the ECS instance.	ecs.c5.large
OriginPrice	float	The original price.	0.622
Price	object	The price.
DiscountPrice	float	The discount.	0
TradePrice	float	The transaction price, which is equal to the original price minus the discount.	0.00012252
OriginalPrice	float	The original price.	0.00012252
DetailInfos	array	The details about the price.
	object
Resource	string	The name of the resource.	cpu
DiscountPrice	float	The discount.	0
TradePrice	float	The transaction price.	0.000098
OriginalPrice	float	The original price.	0.000098
Rules	array	Details about the pricing rules.
	object
Description	string	The description of the promotion rule.
RuleId	long	The ID of the promotion rule.	123456
Currency	string	The currency unit. Valid values: CNY: The value is available only on the China site (aliyun.com). USD: The value is available only on the international site (alibabacloud.com).	CNY
Rules	array	Details about the promotion rules.
	object
Description	string	The description of the promotion rule.
RuleId	long	The ID of the promotion rule.	123456

Examples

Sample success responses

JSONformat

{
  "RequestId": "7A872585-33C7-4D69-AB8E-412E81EBA387",
  "PriceInfo": {
    "SpotPrices": {
      "SpotPrice": [
        {
          "ZoneId": "cn-hangzhou-i",
          "SpotPrice": 0.056,
          "InstanceType": "ecs.c5.large",
          "OriginPrice": 0.622
        }
      ]
    },
    "Price": {
      "DiscountPrice": 0,
      "TradePrice": 0.00012252,
      "OriginalPrice": 0.00012252,
      "DetailInfos": {
        "DetailInfo": [
          {
            "Resource": "cpu",
            "DiscountPrice": 0,
            "TradePrice": 0.000098,
            "OriginalPrice": 0.000098,
            "Rules": {
              "Rule": [
                {
                  "Description": "",
                  "RuleId": 123456
                }
              ]
            }
          }
        ]
      },
      "Currency": "CNY"
    },
    "Rules": {
      "Rule": [
        {
          "Description": "",
          "RuleId": 123456
        }
      ]
    }
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParam.CpuOrMemorySpec	The specified specification is invalid.	The specified specification is invalid.
400	TradeBidCommodityNotMatch	The trade ID and the commodity do not match.	-
400	InvalidSpotCpuMemorySpec	The specified CPU and memory are not allowed. You must create spot ECI using standard ECS specifications for CPU and memory.	-
403	Spot.NotMatched	%s. We recommend that you use the create multi-zone function to avoid insufficient inventory. For more information, see https://help.aliyun.com/document_detail/157290.html	-

For a list of error codes, visit the Service error codes.