平台會擷取每個租用戶的桌面使用量，讓服務提供者可以存取計費摘要資訊。

一律必須透過 REST API 來擷取計費資訊。不支援透過指令碼來擷取計費資訊。

備註： 依預設，「計費摘要報告」將包含已停用和已啟用的租用戶的相關資訊，但有一個原則 (「billing.summary.skip.disabled.tenants」) 可修改此功能，以僅收集已啟用的租用戶的資訊。若要啟用此選項，請將原則值設定為「true」。

報告內容

針對與租用戶相關聯的每個資料中心，平台會擷取下列資料：

  • 針對每個桌面模式的配額。
  • 針對每個模式使用中的桌面。
  • 針對每個通訊協定的配額。
  • 針對每個通訊協定使用中的桌面。

依預設，平台會在每日午夜 (UTC) 過後擷取此資訊，並清除 180 天以前的舊摘要。

無限制的配額以值 -1 表示。

記錄配置的說明

下表說明每個資料行中傳回的值。

資料行名稱 範例值 說明
snapshot 201203220856 記錄的日期和時間 (格式：yyyyMMddhhmm)
org_id 1001 組織/租用戶的唯一識別碼
org_name 租用戶 A 依 org_id 識別的租用戶名稱
datacenter_id 5925d361-4c1c-490e-9616-c5041d067b8e 識別資料中心位置的唯一識別碼
status 已啟用 租用戶的狀態：已啟用、已停用、錯誤
type_id 1cb3f348-f987-4834-a33c-742ef30d356b 特定類型的唯一識別碼：
  • 「template」代表 Template 配額
  • 如果沒有配額 (全部為 0) 且沒有 in_use_count 數字，則為「desktop」。在此情況下，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 Type 為 Session 時，值為已佈建的工作階段數目；否則，-1 表示取得摘要時發生錯誤，或系統無法與租用戶通訊。僅當虛擬機器上存在於 Hypervisor 上或在環境外建立時，in_use_count 才會高於 quota。僅在已匯入或公用程式集區模式配額對應至已匯入、回收或或公用程式集區時，才會發生這種情況。
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 policies - 在資料庫中保留計費摘要記錄的天數。預設值為 180 天。超過間隔的記錄會從資料庫中清除。設定為 0 會將所有計費歷程記錄保留在資料庫中。