文档目录

计费管理

概览

ZStack Cloud提供准公有云计费方式体验,将各资源计费单价汇总为一份计费价目,绑定到项目/账户即可按量生成计费账单。目前支持计费的资源类型包括:处理器、内存、根云盘、数据云盘、GPU设备、公网IP(云主机IP)、公网IP(虚拟IP)、弹性裸金属实例

相关定义

  • 计费价目:一张包含不同资源计费单价的集合表,资源单价基于资源规格、资源使用时间而设置。
  • 账单:按计费价目在指定时间段统计的资源费用,计费精确至秒级。账单类型包括:项目账单、部门账单、账户账单。

功能优势

ZStack Cloud计费功能具有以下优势:
  • 通过计费价目形式,对一组资源的计费单价进行集中高效管理。
  • 计费价目包含多个资源的计费单价,且根云盘/数据云盘支持按磁盘性能单独设置计费单价。
  • 云平台支持创建多份计费价目,项目/账户可使用各自的计费价目进行计费。同一计费价目支持绑定多个项目/账户,无需重复创建。
  • 计费价目配置完成后,即可以账户为单位实时生成计费账单。
  • 计费价目配置完成后,即可以项目为单位实时生成计费账单。也可将项目加载到部门,以部门为单位统计账单。
  • 自定义定时输出账单明细,支持以资源为粒度查看计费详细情况。
  • 用户可根据实际情况,在全局设置中修改计费货币符号的值,更换货币单位显示符号。包括:人民币 CNY、美元 USD、欧元 EUR、英镑 GBP、澳元 AUD、港元 HKD、日元 JPY、瑞士法郎 CHF 、加拿大元 CAD、印尼卢比 IDR、马来西亚林吉特 MYR、泰铢 THB、新加坡元 SGD、阿联酋迪拉姆 AED、巴基斯坦卢比 PKR、沙特里亚尔 SAR。

计费规则

  • 若在全局设置中关闭计费功能开关,系统将停止对资源进行计费,关闭后不再生成新的账单。
  • 云主机已删除但未彻底删除,仅释放计算资源(处理器、内存)和IP资源,存储资源仍然占据。因此,处理器、内存、公网IP资源不再进行计费,但根云盘依然计费直至被彻底删除。
  • 云主机处于已停止状态,仅释放计算资源,依然占用存储资源和IP资源。因此,处理器和内存资源不再计费,但根云盘和公网IP将继续进行计费。
  • 弹性裸金属实例计费的本质为裸金属节点,若关机并释放裸金属节点,将对弹性裸金属实例停止计费。
  • 云盘已删除但未彻底删除,仍占据存储资源(数据云盘)。因此,数据云盘将继续计费直至被彻底删除。
  • 公网IP采用带宽计费方式,需对公网IP(虚拟IP)或公网IP(云主机IP)设置QoS才可按计费单价进行计费。
  • 未实例化的云盘不进行计费,一旦被实例化即刻开始计费。即使没有加载到云主机,依然进行计费。
  • 更改资源所有者操作:以更改时间为分割点,更改前的费用保留于旧账户/项目,更改后在新账户/项目进行计费。

清单

资源价格清单(ResourcePrice Inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 请参见资源结构 0.6
resourceName 资源名称
  • cpu
  • memory
  • rootVolume
  • dataVolume
0.6
resourceUnit 资源计费单元 0.6
timeUnit 计费时间单元 0.6
price 单位价格 0.6
dateInLong 长整型时间 0.6
tableuuid 价目表UUID 3.7.2
pciDeviceOfferings PCI设备列表 2.4
createDate 请参见资源结构 0.6
lastOpDate 请参见资源结构 0.6

示例

{
    "inventories": [],
    "success": true
}

计费价目清单(PriceTable Inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 请参见 资源属性 3.7.2
name 请参见 资源属性 3.7.2
description 请参见 资源属性 3.7.2
groupBy 以字段分组,相当于MySQL中的group by关键字。例如groupBy=type 3.7.2
createDate 请参见 资源属性 3.7.2
lastOpDate 请参见 资源属性 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
示例
{
  "inventories": [
    {
      "uuid": "3e78d076698438a6a68aa2eabdde8adf",
      "name": "price table",
      "createDate": "Nov 14, 2017 10:20:57 PM",
      "lastOpDate": "Nov 14, 2017 10:20:57 PM"
    }
  ]
}

账户/项目与计费价目关联关系清单(AccountPriceTableRef Inventory)

名字 描述 可选的 可选的参数值 起始支持版本
accountUuid 账户UUID 3.7.2
tableUuid 价目表UUID 3.7.2
groupBy 以字段分组,相当于MySQL中的group by关键字。例如groupBy=type 3.7.2
createDate 请参见 资源属性 3.7.2
lastOpDate 请参见 资源属性 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
示例
{
  "inventories": [
    {
      "accountUuid": "3dd9565ef61137c2a8615c26da6ddd4c",
      "tableUuid": "b0c83f78e0323aea8969e5b879ffbe5f",
      "createDate": "Nov 14, 2017 10:20:57 PM",
      "lastOpDate": "Nov 14, 2017 10:20:57 PM"
    }
  ]
}

操作(Operations)

创建资源价格(CreateResourcePrice)

管理员可以使用CreateResourcePrice创建资源价格。例如:
CreateResourcePrice resourceName=memory price=60 timeUnit=d resourceUnit=G

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
resourceName 资源名称
  • cpu
  • memory
  • rootvolume
  • datavolume
  • snapshot
  • gpu
  • pubIpVmNicBandwidthOut
  • pubIpVmNicBandwidthIn
  • pubIpVipBandwidthOut
  • pubIpVipBandwidthIn
0.6
resourceUnit 资源计费单元 0.6
timeUnit 计费时间单元 0.6
price 单位价格 0.6
accountUuid 账户uuid 0.6
dateInLong 长整型时间 0.6
tableUuid 价目表UUID 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 0.6
timeout
Note:
  • ZStack Cloud支持创建资源价格时指定PCI设备,SystemTags增加PCI设备选项。
    • 选项格式为:gpuOfferingUuid::UUID
    • 例如:gpuOfferingUuid::634b48a7bca139d9944a0f95b0c2dddf
  • ZStack Cloud支持创建资源价格时自定义资源计费类型,SystemTags增加priceUserConfig选项。
    • 选项格式为:priceUserConfig::xxx,XXX要求JSON字符串。

删除资源价格(DeleteResourcePrice)

管理员可以使用DeleteResourcePrice删除资源价格。例如:
DeleteResourcePrice uuid=7c9a496360c040819dbaa5abd9c074b8

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 资源uuid 0.6
deleteMode 请参见 删除资源(Delete Resources)
  • Permissive
  • Enforcing
0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 0.6
timeout

修改资源价格(UpdateResourcePrice)

用户可以使用UpdateResourcePrice修改资源价格。 例如:
UpdateResourcePrice uuid=bed31eb3ba76325ba6a1cef1a64c97a3 setEndDateInLongBaseOnCurrentTime=false

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 资源价格UUID 3.7.2
endDateInLong 资源价格生效截止时间 3.7.2
setEndDateInLongBaseOnCurrentTime 设置资源价格生效截止时间为当前时间 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

查询资源价格(QueryResourcePrice)

管理员可以使用QueryResourcePrice查询资源价格。例如:
QueryResourcePrice resourceName=datavolume

原生域查询(Primitive Fields of Query)

请参见资源价格清单(ResourcePrice Inventory)

计算账户花费(CalculateAccountSpending)

管理员可以使用CalculateAccountSpending计算账户花费。例如:
CalculateAccountSpending accountUuid=36c27e8ff05c4780bf6d2fa65700f22e

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
accountUuid 账户uuid 0.6
dateStart 起始日期 0.6
dateEnd 结束日期 0.6
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 0.6
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 0.6
timeout

查询账户账单(QueryAccountBilling)

管理员可以使用QueryAccountBilling查询账户账单。例如:
QueryAccountBilling accountUuid=2533823b9a764cd89f141f7bbcb78430

原生域查询(Primitive Fields of Query)

请参见账户账单清单(AccountBilling Inventory)

Note: QueryAccountBilling默认查询所有账单,如需按时间查询账单,请使用CalculateAccountSpending

创建计费价目(CreatePriceTable)

用户可以使用CreatePriceTable创建计费价目。 例如:
CreatePriceTable name=table_1 prices='[{"resourceName": "cpu","timeUnit": "s","price": 1.0}]'

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
name 价目表名称 3.7.2
description 价目表的详细描述 3.7.2
prices 3.7.2
resourceUuid 价目表UUID 3.7.2
tagUuids 标签UUID列表 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

删除计费价目(DeletePriceTable)

用户可以使用DeletePriceTable删除计费价目。 例如:
DeletePriceTable uuid=81bd5aa16d203ca39bc5e79e2bbc6de2

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 价目表UUID 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

修改计费价目(UpdatePriceTable)

用户可以使用UpdatePriceTable修改计费价目。 例如:
UpdatePriceTable name=table_1

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 价目表UUID 3.7.2
name 价目表名称 3.7.2
description 价目表描述 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

查询计费价目(QueryPriceTable)

管理员可以使用QueryPriceTable查询计费价目。例如:
QueryPriceTable uuid=86b5cece6d0f3534a0a995ab8e60289f

原生域查询(Primitive Fields of Query)

请参见计费价目清单(PriceTable Inventory)

为账户/项目指定计费价目(AttachPriceTableToAccount)

用户可以使用AttachPriceTableToAccount为账户/项目指定计费价目。 例如:
AttachPriceTableToAccount accountUuid=e32698fcb57d34d68bbf1c4963af95a0 tableUuid=f354e135276d3e77a46f47c5c0e47b1a

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
accountUuid 账户UUID 3.7.2
tableUuid 价目表UUID 3.7.2
tagUuids 标签UUID列表 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

取消账户/项目关联的计费价目(DetachPriceTableFromAccount)

用户可以使用DetachPriceTableFromAccount取消账户/项目关联的计费价目。 例如:
DetachPriceTableFromAccount accountUuid=c27d5d1d46ce3b548ec0755d0b354084 tableUuid=5b81c2a13b2f319ea97a4568575b0266

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
accountUuid 账户UUID 3.7.2
tableUuid 价目表UUID 3.7.2
tagUuids 标签UUID列表 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

修改账户/项目计费价目(ChangeAccountPriceTableBinding)

用户可以使用ChangeAccountPriceTableBinding修改账户/项目计费价目。 例如:
ChangeAccountPriceTableBinding accountUuid=ca0f8310310e351f8590e4d9f03106bc tableUuid=082289755ebe363daa52eb2aa10cbb01

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
accountUuid 账户UUID 3.7.2
tableUuid 价目表UUID 3.7.2
resourceUuid 3.7.2
tagUuids 标签UUID列表 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

获得项目/账户使用的计费价目(GetAccountPriceTableRef)

用户可以使用GetAccountPriceTableRef查询项目/账户使用的计费价目。 例如:
GetAccountPriceTableRef accountUuid=67fcb4c5fa0c36adba411d7258d4557e

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
tableUuid (可选) 价目表UUID 3.7.2
accountUuid (可选) 账户UUID 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

查询账户/项目与计费价目的关联关系(QueryAccountPriceTableRef)

管理员可以使用QueryAccountPriceTableRef查询账户/项目与计费价目的关联关系。例如:
QueryAccountPriceTableRef accountUuid=b86c9016b4f24953a9edefb53ca0678c

原生域查询(Primitive Fields of Query)

请参见账户/项目与计费价目关联关系清单(AccountPriceTableRef Inventory)

生成账单(GenerateAccountBilling)

用户可以使用GenerateAccountBilling生成账单。 例如:
GenerateAccountBilling accountUuid=54caddf06e1e3b7c995df5e99d8ca9d9

参数(Parameters)

名字 描述 可选的 可选的参数值 起始支持版本
accountUuid 账户UUID 3.7.2
userTags 用户标签,请参见 创建用户标签(CreateUserTag) 3.7.2
systemTags 系统标签,请参见 创建系统标签(CreateSystemTag) 3.7.2
timeout

标签(Tags)

  • 用户可以使用CreateUserTag resourceType=PriceVO创建资源价格的用户标签。 例如:
    CreateUserTag resourceType=PriceVO tag=Test1 resourceUuid=3214e0dcd01d4e2aa8407968e1c51d58
  • 用户可以使用CreateUserTag resourceType=PriceTableVO创建计费价目的用户标签。 例如:
    CreateUserTag resourceType=PriceTableVO tag=Test1 resourceUuid=12a087c058cc45d5bf80a605f17c0083
CLI命令使用手册 | 5.5.30 | ZStack Cloud · ZCF | ZStack 资源中心