平台可捕获每个租户的桌面使用情况，以便服务提供程序可以访问计费摘要信息。

所有计费信息检索必须通过 REST API 来完成。不支持通过脚本检索计费信息。

注： 默认情况下，计费摘要报告将包含有关已禁用和已启用租户的信息，但有一个策略（“billing.summary.skip.disabled.tenants”）可以更改此功能，以便仅收集已启用租户的信息。要激活此选项，请将该策略值设置为“true”。

报告内容

对于与租户关联的每个数据中心，平台将捕获以下数据：

  • 每个桌面模型的配额。
  • 每个模型的正在使用的桌面数。
  • 每个协议的配额。
  • 每个协议正在使用的桌面数。

默认情况下，平台会在每天午夜 (UTC) 之后捕获这些信息，并清除 180 天之前的摘要信息。

无限制的配额使用值 -1 来表示。

记录布局说明

下表介绍了每列中返回的值。

列名称 示例值 描述
snapshot 201203220856 记录的日期和时间（格式：yyyyMMddhhmm）
org_id 1001 组织/租户的唯一 ID
org_name 租户 A 由 org_id 标识的租户的名称
datacenter_id 5925d361-4c1c-490e-9616-c5041d067b8e 用于标识数据中心位置的唯一 ID
status 已启用 租户的状态：已启用、已禁用、错误
type_id 1cb3f348-f987-4834-a33c-742ef30d356b 以下给定类型的唯一 ID：
  • “template”，对于模板配额
  • “desktop”，如果没有配额（全部为 0），也没有 in_use_count 数值。在这种情况下，quota 和 in_use_count 将设置为 -1，表示未找到租户的任何信息。
desktop_model_name Pro 对于 Template.Quota，此值为空
model_protocols 31 如果 type 为 PROTOCOL，则此列表示该协议的位掩码值。
  • RDP = 位 0
  • RGS = 位 1
  • HDX = 位 2
  • VNC = 位 3
  • NX = 位 4
  • PCoIP = 位 5

例如，位掩码 31 表示 RDP、RGS、HDX、VNC 和 NX 均可用，位掩码 1 表示仅 RDP 可用。如果 type 为 DESKTOPMODEL，则此列会被忽略并包含 0。

quota 17 错误值为 -1
in_use_count 17 当会话类型 = 置备的会话数时会正常显示数值；否则会显示 -1，表示在获取摘要时出现错误，或者系统无法与租户通信。仅当管理程序上存在虚拟机或在环境外部创建了虚拟机时，in_use_count 的数值才可高于配额。仅映射到已导入、回收和实用程序池的已导入或实用程序桌面模型配额才会出现这种情况。
date_updated 2012-03-22 08:56:30.784 上次修改此行的时间
type PROTOCOL 表示配额类型（DESKTOPMODEL、SESSION、PROTOCOL、TEMPLATE）

覆盖报告时间间隔

默认情况下，平台会在每天午夜 (UTC) 之后捕获计费摘要信息，并清除 180 天之前的摘要信息。要覆盖这些默认时间间隔，请按照下面的过程进行操作。

  1. 在服务中心内，选择租户 > 策略。
  2. 在“策略配置”页面上，设置以下策略：
    • billing.summary.collection.interval - 计费收集之间的时间间隔（以毫秒为单位）。默认值为 86400000 毫秒（24 小时）。
    • billing.summary.purge.interval 策略 - 在数据库中保留计费摘要记录的天数。默认值为 180 天。将从数据库中清除早于该时间间隔的记录。设置为 0 可在数据库中保留所有计费历史记录。