QuerySkuPriceList - 查询商品定价对象下sku列表 - 阿里云交易和账单管理API

通常一个产品功能会有1到多个SKU，有的产品会多达数万级别的SKU。本API是用来查询一个指定的产品功能下的SKU列表及其目录价。接口入参支持按照某种SKU配置的条件来进行过滤查询。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
bss:DescribeProduct	Read	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
CommodityCode	string	是	商品 code，可通过 QueryCommodityList 接口查询商品 code。	ecs
PriceEntityCode	string	是	定价对象 code，可通过 QueryPriceEntityList 接口查询定价对象 code。	instance_type
PageSize	integer	是	每页返回的数量，最大不能超过 50	20
NextPageToken	string	否	分页 token，首页查询时传空，查询结果中返回下一页 token 地址。当结果 token 为空时表示全部查完。可通过查询结果中的 NextPageToken 字段获取下一页 token。	080112060a0422020800180022490a470342000000315333303332363436363336333433393636333136333338333733373333333133373336363336323634363336363337333836333636333636313336363433363332
PriceFactorConditionMap	object	否	定价因子条件集合，可通过 QueryPriceEntityList 接口查询定价因子 code 和定价因子值。
	array	否	定价对象因值集合
	string	否	定价因子值对	{"vm_region_no":"cn-shiwei-shenshu"}
Lang	string	否	语言，不填时默认为 zh(中文) 枚举值： en：英文。 zh：中文。	en

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	Id of the request	F5B803CF-94D8-43AF-ADB3-D819AAD30E27
Code	string	状态码。	Success
Message	string	返回消息	Successful!
Success	boolean	是否成功。	true
Data	object	返回数据。
SkuPricePage	object	定价对象 sku 信息
TotalCount	integer	sku 总数量	18732
NextPageToken	string	下一页的 token	080112060a0422020800180022490a470342000000315333303332363436363336333433393636333136333338333733373333333133373336363336323634363336363337333836333636333636313336363433363332
SkuPriceList	object []	sku 列表
SkuCode	string	sku code	017c15a31507bc6de22aa93777461adc
CskuPriceList	object []	sku 价格列表
CskuCode	string	csku code，价格唯一编码	ac74dd7b52ae6389ddef099283fb8275
Currency	string	币种枚举值： JPY：日元。 SAR：沙特币。 USD：美元。 CNY：人民币。	CNY
UsageUnit	string	用量单位	个
PriceType	string	价格类型枚举值： usagePrice：使用量价。 monthPrice：月价。 dayPrice：天价。 hourPrice：小时价。 weekPrice：周价。 yearPrice：年价。 fixedPrice：一口价。	hourPrice
PriceMode	string	定价模式枚举值： STEP_ACCUMULATION：阶梯累计。 STEP_ARRIVE：阶梯到达。 NORMAL_PRICE：非阶梯价。	STEP_ARRIVE
Price	string	价格	100
PriceUnit	string	价格单位	美元/个
RangeList	object []	当 PriceMode 是 STEP_ACCUMULATION 、STEP_ARRIVE 时，本字段有值，指定 Range 范围；当 PriceMode 是 NORMAL_PRICE 时，本字段值是 NULL
FactorCode	string	因子 code	212fbd27866307fc79ecf06934a88b2c
Min	string	最小值	1
Max	string	最大值	10
Type	string	区间闭合类型枚举值： LORC：左开右闭。 LCRO：左闭右开。 LCRC：左闭右闭。 LORL：左开右开。	LORC
SkuFactorMap	object	因子值集合
	string	因子值对不同的商品的定价对象下有各自的因子，比如 ecs 商品的 instance_type 的因子有`vm_region_no，iooptimized，vm_os_kind，instance_type`	{ "vm_region_no": "cn-zhangjiakou-na62-a01", "iooptimized": "optimized", "vm_os_kind": "windows", "instance_type": "ecs.i1.xlarge" }

示例

正常返回示例

JSON格式

{
  "RequestId": "F5B803CF-94D8-43AF-ADB3-D819AAD30E27",
  "Code": "Success",
  "Message": "Successful!",
  "Success": true,
  "Data": {
    "SkuPricePage": {
      "TotalCount": 18732,
      "NextPageToken": "080112060a0422020800180022490a470342000000315333303332363436363336333433393636333136333338333733373333333133373336363336323634363336363337333836333636333636313336363433363332",
      "SkuPriceList": [
        {
          "SkuCode": "017c15a31507bc6de22aa93777461adc",
          "CskuPriceList": [
            {
              "CskuCode": "ac74dd7b52ae6389ddef099283fb8275",
              "Currency": "CNY",
              "UsageUnit": "个",
              "PriceType": "hourPrice",
              "PriceMode": "STEP_ARRIVE",
              "Price": "100",
              "PriceUnit": "美元/个",
              "RangeList": [
                {
                  "FactorCode": "212fbd27866307fc79ecf06934a88b2c",
                  "Min": "1",
                  "Max": "10",
                  "Type": "LORC"
                }
              ]
            }
          ],
          "SkuFactorMap": {
            "key": "{             \"vm_region_no\": \"cn-zhangjiakou-na62-a01\",             \"iooptimized\": \"optimized\",             \"vm_os_kind\": \"windows\",             \"instance_type\": \"ecs.i1.xlarge\"           }"
          }
        }
      ]
    }
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2023-09-04

OpenAPI 入参发生变更

看变更集

变更项	变更内容
入参	OpenAPI 入参发生变更。
	新增入参：Lang