文档首页/ 客户运营能力/ API参考/ 管理交易/ 管理优惠折扣/ 查询商务折扣信息-ListBusinessDiscountInfo
更新时间：2026-09-17 GMT+08:00
查看PDF
分享

查询商务折扣信息-ListBusinessDiscountInfo

功能介绍

客户可以查询正在生效中的华为云框架商务折扣信息。

接口约束

该接口可以使用客户AK/SK或者Token调用。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见策略授权参考。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    描述

    访问级别

    资源类型（*为必须）

    条件键

    别名

    billing:contract:view

    授予在费用中心查看线上合同、商务及商务折扣的权限。

    read

    -

    -

    -

URI

POST /v2/promotions/business/discount-info

表1 Header参数

参数

是否必选

描述

X-Language

否

参数解释：

语言。

约束限制：

不涉及

取值范围：

  • 中文：zh_CN
  • 英文：en_US

默认取值：

zh_CN。

请求消息

请求参数

参数

是否必选

参数类型

描述

quoting_item_type

是

String

参数解释：

报价项类型

约束限制：

不涉及

取值范围：

  • PRODUCT_ITEM 产品报价项
  • CATEGORY_ITEM 分类报价项

默认取值：

不涉及

cloud_service_types

否

List<String>

参数解释：

云服务编码列表，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表-ListServiceTypes接口获取。

约束限制：

  • 大小写不敏感。
  • 此参数不携带或携带值为空列表或携带值为null时，不作为筛选条件。

取值范围：

[0-100]

默认取值：

不涉及

charging_modes

否

List<String>

参数解释：

计费模式列表

约束限制：

  • 大小写不敏感。
  • 此参数不携带或携带值为空列表或携带值为null时，不作为筛选条件。

取值范围：

[0-20]

计费模式：

  • ONDEMAND：按需
  • ONETIME： 一次性
  • DAILY：包天
  • MONTHLY ：包月
  • 1_YEARLY： 包1年
  • 2_YEARLY ：包2年
  • 3_YEARLY ：包3年
  • 4_YEARLY： 包4年
  • 5_YEARLY： 包5年
  • 1_YEARLY_RI ：包1年预留实例
  • 3_YEARLY_RI ：包3年预留实例

默认取值：

不涉及

site_code

否

String

参数解释：

运营站点编码

约束限制：

  • 大小写不敏感。
  • 此参数不携带或携带值为null时，不作为筛选条件。

取值范围：

[1-64]

默认取值：

不涉及

offset

否

Integer

参数解释：

分页偏移量

约束限制：

不涉及

取值范围：

[0-2147483647]

默认取值：

0

limit

否

Integer

参数解释：

每页条数

约束限制：

不涉及

取值范围：

[1-1000]

默认取值：

20

请求示例

POST https://bss.myhuaweicloud.com/v2/promotions/business/discount-info HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "quoting_item_type": "PRODUCT_ITEM",
  "cloud_service_types": [],
  "charging_modes": [],
  "site_code": null,
  "offset": 0,
  "limit": 20
}

响应信息

响应参数

参数

参数类型

描述

error_code

String

参数解释：

状态码。

具体请参考状态码。只有失败才返回该字段。

取值范围：

最大长度：20

error_msg

String

参数解释：

错误描述信息。只有失败才返回该字段。

取值范围：

最大长度：1000

total_count

Integer

参数解释：

总条数

取值范围：

不涉及

commerce_id

String

参数解释：

商务ID

取值范围：

[0-64]

commerce_code

String

参数解释：

商务编号

取值范围：

[0-64]

effective_time

String

参数解释：

商务生效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]

expire_time

String

参数解释：

商务失效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]

product_quoting_items

List<ProductQuotingItem>

参数解释：

产品报价项列表，具体请参见表2。

quoting_item_type=PRODUCT_ITEM时返回，否则返回空列表。

取值范围：

[0-1000]

category_quoting_items

List<CategoryQuotingItem>

参数解释：

分类报价项列表，具体请参见表4。quoting_item_type=CATEGORY_ITEM时返回，否则返回空列表。

取值范围：

[0-1000]

category_quoting_item_steps

List<CategoryQuotingItemStep>

参数解释：

分类报价项阶梯列表，具体请参见表5。

quoting_item_type=CATEGORY_ITEM时返回，否则返回空列表。

取值范围：

[0-100]

accumulation_cycle_type

String

参数解释：

阶梯累计周期类型，category_quoting_item_steps有值返回时返回。

取值范围：

[0-32]

sites

List<SiteInfo>

参数解释：

运营站点列表，具体请参见表6。

取值范围：

不涉及
表2 ProductQuotingItem

参数

参数类型

描述

item_id

String

参数解释：

报价项ID

取值范围：

[0-64]

product_id

String

参数解释：

产品ID

取值范围：

[0-64]

product_spec_name

String

参数解释：

产品规格名称

取值范围：

[0-256]

cloud_service_type

String

参数解释：

云服务编码

取值范围：

[0-64]

cloud_service_type_name

String

参数解释：

云服务名称

取值范围：

[0-256]

site_code

String

参数解释：

归属运营站点编码

取值范围：

[0-64]

related_regions

List<RegionInfo>

参数解释：

产品关联的云服务区信息列表，具体参见表7。

取值范围：

不涉及

charge_event_code

String

参数解释：

计费事件编码

取值范围：

[0-128]

charging_mode

String

参数解释：

计费模式

取值范围：

  • ONDEMAND：按需
  • ONETIME： 一次性
  • DAILY：包天
  • MONTHLY ：包月
  • 1_YEARLY： 包1年
  • 2_YEARLY ：包2年
  • 3_YEARLY ：包3年
  • 4_YEARLY： 包4年
  • 5_YEARLY： 包5年
  • 1_YEARLY_RI ：包1年预留实例
  • 3_YEARLY_RI ：包3年预留实例

preferential_category

Integer

参数解释：

优惠分类

取值范围：

  • 0：普通优惠
  • 1：产品阶梯
  • 2：分时优惠

preferential_type

Integer

参数解释：

优惠方式

取值范围：

  • 0：产品折扣
  • 1：固定单价

sales_price

BigDecimal

参数解释：

固定单价，preferential_type=1固定单价时有值。

取值范围：

不涉及

discount_ratio

BigDecimal

参数解释：

折扣率，preferential_type=0产品折扣时有值。

取值范围：

[0-1]

pricing_basis

String

参数解释：

计费单位

取值范围：

[0-64]

effective_time

String

参数解释：

报价项生效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]

expire_time

String

参数解释：

报价项失效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]

product_quoting_item_steps

List<ProductQuotingItemStep>

参数解释：

产品报价项阶梯列表，产品阶梯或分时优惠时有值返回，否则返回空列表。具体请参见表3。

取值范围：

不涉及
表3 ProductQuotingItemStep

参数

参数类型

描述

step_id

String

参数解释：

阶梯ID

取值范围：

[0-64]

step_no

String

参数解释：

阶梯编号

取值范围：

[0-64]

step_start

BigDecimal

参数解释：

阶梯起始值

取值范围：

不涉及

start_measure_id

Integer

参数解释：

起始值度量单位

取值范围：

不涉及

step_end

BigDecimal

参数解释：

阶梯结束值

取值范围：

不涉及

end_measure_id

Integer

参数解释：

结束值度量单位

取值范围：

不涉及

preferential_type

Integer

参数解释：

优惠方式

取值范围：

  • 0：产品折扣
  • 1：固定单价

sales_price

BigDecimal

参数解释：

固定单价，preferential_type=1固定单价时有值。

取值范围：

不涉及

discount_ratio

BigDecimal

参数解释：

折扣率，preferential_type=0产品折扣时有值。

取值范围：

[0-1]

pricing_basis

String

参数解释：

计费单位

取值范围：

[0-64]
表4 CategoryQuotingItem

参数

参数类型

描述

item_id

String

参数解释：

报价项ID

取值范围：

[0-64]

cloud_service_type

String

参数解释：

云服务编码

取值范围：

[0-64]

cloud_service_type_name

String

参数解释：

云服务名称

取值范围：

[0-256]

commercial_resource_type

String

参数解释：

商务资源类型

取值范围：

[0-64]

resource_type_code

String

参数解释：

资源类型编码

取值范围：

[0-64]

resource_type_name

String

参数解释：

资源类型名称

取值范围：

[0-256]

sku_family_code

String

参数解释：

SKU族编码

取值范围：

[0-64]

sku_family_name

String

参数解释：

SKU族名称

取值范围：

[0-256]

site_code

String

参数解释：

归属运营站点编码

取值范围：

[0-64]

region_code

String

参数解释：

云服务区域编码

取值范围：

[0-64]

region_name

String

参数解释：

云服务区域名称

取值范围：

[0-256]

az_code

String

参数解释：

可用区AZ编码

取值范围：

[0-64]

az_name

String

参数解释：

可用区AZ名称

取值范围：

[0-256]

step_no

String

参数解释：

阶梯编号

取值范围：

[0-64]

charging_mode

String

参数解释：

计费模式

取值范围：

  • ONDEMAND：按需
  • ONETIME： 一次性
  • DAILY：包天
  • MONTHLY ：包月
  • 1_YEARLY： 包1年
  • 2_YEARLY ：包2年
  • 3_YEARLY ：包3年
  • 4_YEARLY： 包4年
  • 5_YEARLY： 包5年
  • 1_YEARLY_RI ：包1年预留实例
  • 3_YEARLY_RI ：包3年预留实例

discount_ratio

BigDecimal

参数解释：

折扣率

取值范围：

[0-1]

effective_time

String

参数解释：

报价项生效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]

expire_time

String

参数解释：

报价项失效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]
表5 CategoryQuotingItemStep

参数

参数类型

描述

step_id

String

参数解释：

阶梯ID

取值范围：

[0-64]

step_no

String

参数解释：

阶梯编号

取值范围：

[0-64]

step_start

BigDecimal

参数解释：

阶梯起始值

取值范围：

不涉及

start_measure_id

Integer

参数解释：

起始值度量单位

取值范围：

不涉及

step_end

BigDecimal

参数解释：

阶梯结束值

取值范围：

不涉及

end_measure_id

Integer

参数解释：

结束值度量单位

取值范围：

不涉及

effective_time

String

参数解释：

阶梯生效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]

expire_time

String

参数解释：

阶梯失效时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ

取值范围：

[0-32]

site_code

String

参数解释：

运营站点编码

取值范围：

[0-64]
表6 SiteInfo

参数

参数类型

描述

site_code

String

参数解释：

运营站点编码

取值范围：

[0-64]

site_name

String

参数解释：

运营站点名称

取值范围：

[0-256]

regions

List<RegionInfo>

参数解释：

云服务区信息列表，具体参见表7。

取值范围：

不涉及
表7 RegionInfo

参数

参数类型

描述

region_code

String

参数解释：

云服务区编码

取值范围：

[0-64]

region_name

String

参数解释：

云服务区名称

取值范围：

[0-256]

响应示例

{
    "total_count": 2,
    "commerce_id": "011***001",
    "commerce_code": "1HF***30J",
    "effective_time": "2026-08-13T09:27:01Z",
    "expire_time": "2026-09-30T15:59:59Z",
    "product_quoting_items": [
        {
            "item_id": "041***001",
            "product_id": "OFF***041",
            "product_spec_name": "sku***001",
            "cloud_service_type": "hws.service.type.ec2",
            "cloud_service_type_name": "弹性云服务器",
            "site_code": "HWC",
            "related_regions": [
                {
                    "region_code": "cn-north-1",
                    "region_name": "北京一"
                }
            ],
            "charge_event_code": "event***001",
            "charging_mode": "ONDEMAND",
            "preferential_category": 1,
            "preferential_type": null,
            "sales_price": null,
            "discount_ratio": null,
            "pricing_basis": "元/7天",
            "effective_time": "2026-08-13T09:27:01Z",
            "expire_time": "2026-09-30T15:59:59Z",
            "product_quoting_item_steps": [
                {
                    "step_id": "141***001",
                    "step_no": "1",
                    "step_start": 0.0,
                    "start_measure_id": 0,
                    "step_end": 1000.0,
                    "end_measure_id": 0,
                    "preferential_type": 1,
                    "sales_price": 99.0,
                    "discount_ratio": null,
                    "pricing_basis": "元/7天"
                },
                {
                    "step_id": "141***002",
                    "step_no": "2",
                    "step_start": 1000.0,
                    "start_measure_id": 0,
                    "step_end": 2000.0,
                    "end_measure_id": 0,
                    "preferential_type": 1,
                    "sales_price": 98.0,
                    "discount_ratio": null,
                    "pricing_basis": "元/7天"
                }
            ]
        }
    ],
    "category_quoting_items": [
        {
            "item_id": "031***_MONTHLY",
            "cloud_service_type": "hws.service.type.ec2",
            "cloud_service_type_name": "弹性云服务器",
            "commercial_resource_type": "hws.resource.type.vmOhter",
            "resource_type_code": "hws.resource.type.vm",
            "resource_type_name": "云主机",
            "sku_family_code": "family***001",
            "sku_family_name": "familyName***001",
            "site_code": "HWC",
            "region_code": "cn-north-1",
            "region_name": "北京一",
            "az_code": "AZ1",
            "az_name": "可用区1",
            "step_no": "1",
            "charging_mode": "MONTHLY",
            "discount_ratio": 0.942,
            "effective_time": "2026-08-13T09:22:43Z",
            "expire_time": "2026-09-30T15:59:59Z"
        }
    ],
    "category_quoting_item_steps": [
        {
            "step_id": "021***001",
            "step_no": "1",
            "step_start": 0.0,
            "start_measure_id": 1,
            "step_end": 1000.0,
            "end_measure_id": 1,
            "effective_time": "2026-08-13T09:27:01Z",
            "expire_time": "2026-09-30T15:59:59Z",
            "site_code": "HWC"
        },
        {
            "step_id": "021***002",
            "step_no": "2",
            "step_start": 1000.0,
            "start_measure_id": 1,
            "step_end": 2000.0,
            "end_measure_id": 1,
            "effective_time": "2026-08-13T09:27:01Z",
            "expire_time": "2026-09-30T15:59:59Z",
            "site_code": "HWC"
        }
    ],
    "accumulation_cycle_type": "Month",
    "sites": [
        {
            "site_code": "HWC",
            "site_name": "华为云",
            "regions": [
                {
                    "region_code": "cn-north-1",
                    "region_name": "北京一"
                }
            ]
        }
    ]
}

状态码

  • 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
  • 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

HTTP状态码

错误码

错误描述

403

CBC.0151

访问拒绝。

500

CBC.0999

其他错误。

400

CBC.0100

参数错误。
父主题： 管理优惠折扣

相关文档