计费管理
概览
ZStack Cloud提供准公有云计费方式体验,将各资源计费单价汇总为一份计费价目,绑定到项目/账户即可按量生成计费账单。目前支持计费的资源类型包括:处理器、内存、根云盘、数据云盘、GPU设备、公网IP(云主机IP)、公网IP(虚拟IP)、弹性裸金属实例。
相关定义
- 计费价目:一张包含不同资源计费单价的集合表,资源单价基于资源规格、资源使用时间而设置。
- 账单:按计费价目在指定时间段统计的资源费用,计费精确至秒级。账单类型包括:项目账单、部门账单、账户账单。
功能优势
ZStack Cloud计费功能具有以下优势:
- 通过计费价目形式,对一组资源的计费单价进行集中高效管理。
- 计费价目包含多个资源的计费单价,且根云盘/数据云盘支持按磁盘性能单独设置计费单价。
- 云平台支持创建多份计费价目,项目/账户可使用各自的计费价目进行计费。同一计费价目支持绑定多个项目/账户,无需重复创建。
- 计费价目配置完成后,即可以账户为单位实时生成计费账单。
- 计费价目配置完成后,即可以项目为单位实时生成计费账单。也可将项目加载到部门,以部门为单位统计账单。
- 自定义定时输出账单明细,支持以资源为粒度查看计费详细情况。
- 用户可根据实际情况,在全局设置中修改计费货币符号的值,更换计费和账单的货币单位。可选货币单位包括:人民币 CNY、美元 USD、欧元 EUR、英镑 GBP、澳元 AUD、港元 HKD、日元 JPY、瑞士法郎 CHF、加拿大元 CAD、印尼卢比 IDR、波兰兹罗提 PLN 等。账单金额将根据所选货币显示对应货币符号,例如 PLN 显示为 zł。
计费规则
- 若在全局设置中关闭计费功能开关,系统将停止对资源进行计费,关闭后不再生成新的账单。
- 云主机已删除但未彻底删除,仅释放计算资源(处理器、内存)和IP资源,存储资源仍然占据。因此,处理器、内存、公网IP资源不再进行计费,但根云盘依然计费直至被彻底删除。
- 云主机处于已停止状态,仅释放计算资源,依然占用存储资源和IP资源。因此,处理器和内存资源不再计费,但根云盘和公网IP将继续进行计费。
- 弹性裸金属实例计费的本质为裸金属节点,若关机并释放裸金属节点,将对弹性裸金属实例停止计费。
- 云盘已删除但未彻底删除,仍占据存储资源(数据云盘)。因此,数据云盘将继续计费直至被彻底删除。
- 公网IP采用带宽计费方式,需对公网IP(虚拟IP)或公网IP(云主机IP)设置QoS才可按计费单价进行计费。
- 未实例化的云盘不进行计费,一旦被实例化即刻开始计费。即使没有加载到云主机,依然进行计费。
- 更改资源所有者操作:以更改时间为分割点,更改前的费用保留于旧账户/项目,更改后在新账户/项目进行计费。
清单
资源价格清单(ResourcePrice Inventory)
示例
{
"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 | 资源名称 |
|
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) | 是 |
|
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)
计算账户花费(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)
为账户/项目指定计费价目(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)
生成账单(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
