DescribeContainerGroupPrice - Elastic Container Instance

Queries the price of an elastic container instance.

Operation description

When you call this operation, you cannot use resource groups to control the permissions of a RAM user.
You can create an elastic container instance by specifying vCPU and memory resource specifications or by specifying ECS instance types. When you call this operation to query the prices of elastic container instances, pass in specifications of the elastic container instances.
- vCPU and memory specifications.
- ECS instance types that are supported by Elastic Container Instance.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
eci:DescribeContainerGroupPrice	get	All Resources ``	none	none

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID of the instance. You can call the DescribeRegions operation to query the most recent region and zone list.	cn-hangzhou
Cpu	float	Yes	The number of vCPUs. For information about the vCPU and memory specifications that are supported by Elastic Container Instance, see vCPU and memory specifications.	2.0
Memory	float	Yes	The size of the memory. Unit: GiB. For information about the vCPU and memory specifications that are supported by Elastic Container Instance, see vCPU and memory specifications.	4.0
InstanceType	string	No	The instance type of the Elastic Compute Service (ECS) instance that is used to create the elastic container instance. For information about the ECS instance types that are supported by Elastic Container Instance, see ECS instance types that are supported by Elastic Container Instance. Note If you specify this parameter, the specified specifications of vCPUs and memory are ignored. Only the price of the ECS instance type is returned.	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 SpotStrategy to SpotWithPriceLimit, you must specify SpotPriceLimit.	0.2
EphemeralStorage	integer	No	The storage size of the temporary storage space. Unit: GiB.	20
SpotDuration	integer	No	The protection period of the preemptible instance. Unit: hours. Default value: 1. The value of 0 indicates no protection period.	1
ComputeCategory	string	No	The computing power type. A value of economy specifies economic instances.	economy

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The request ID.	7A872585-33C7-4D69-AB8E-412E81EBA387
PriceInfo	object	The information about the prices and discount rules.
SpotPrices	array<object>	The information about the prices of preemptible elastic container instances.
SpotPrice	object
ZoneId	string	The zone ID of the instance.	cn-hangzhou-i
SpotPrice	float	The prices of preemptible elastic container instances.	0.056
InstanceType	string	The ECS instance type.	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<object>	The information about the price.
DetailInfo	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<object>	Details about the pricing rules.
Rule	object
Description	string	The description of the rule.	Receive a 15% discount on a 1-year subscription
RuleId	long	The rule ID.	123456
Currency	string	The currency unit. Valid values: CNY: This value only applies to the China site (aliyun.com). USD: This value only applies to the International site (alibabacloud.com).	CNY
Rules	array<object>	Details about the promotion rules.
Rule	object
Description	string	The description of the promotion rule.	Receive a 15% discount on a 1-year subscription
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": "Receive a 15% discount on a 1-year subscription\n",
                  "RuleId": 123456
                }
              ]
            }
          }
        ]
      },
      "Currency": "CNY"
    },
    "Rules": {
      "Rule": [
        {
          "Description": "Receive a 15% discount on a 1-year subscription\n",
          "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.	-
400	FeatureBasedConstraintConflict	A conflict occurs in specified feature constraints: [%s].	A conflict occurs in specified feature constraints
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	-
403	FeatureAccessRestricted	Access to this feature:[%s] is restricted. Please contact Alibaba Cloud ECI support to request access.	Access to this feature is restricted. Please contact Alibaba Cloud ECI support to request access.

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

Change history

Change time	Summary of changes	Operation
2023-12-27	The Error code has changed. The request parameters of the API has changed	View Change Details
2023-12-25	The Error code has changed	View Change Details