文档首页/ CloudPond云服务/ API参考/ API/ 销售周期/ 查询可购买的销售周期 - ListSaleCycles
更新时间:2025-12-08 GMT+08:00

查询可购买的销售周期 - ListSaleCycles

功能介绍

查询可购买的销售周期

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    ies::listSaleCycles

    List

    -

    -

    • ies:system:listSaleCycles

    -

URI

GET /v2/{domain_id}/sale-cycles

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

String

path中租户的账号ID

表2 Query参数

参数

是否必选

参数类型

描述

zone_code

String

地区编码

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

sale_cycles

Array of SaleCycleOption objects

销售周期信息

表5 SaleCycleOption

参数

参数类型

描述

pay_mode

String

包周期付款类型

  • FULL: 全预付

  • HALF:半预付

  • PAID_BY_YEAR:按年付费

  • ZERO_PAID_BY_YEAR:零预付-按年

  • ZERO_PAID_BY_MONTH:零预付-按月

period_type

String

包周期类型

  • year:包年

period_num

Array of integers

销售周期取值

请求示例

查询可购买的销售周期

GET https://{ies_endpoint}/v2/{domain_id}/sale-cycles

响应示例

状态码:200

successful operation

{
  "sale_cycles" : [ {
    "pay_mode" : "FULL",
    "period_type" : "year",
    "period_num" : [ 1, 3 ]
  } ]
}

状态码

状态码

描述

200

successful operation

错误码

请参见错误码