View a markdown version of this page

使用 查詢工作階段統計資料彙總資料 AWS CLI - 截止日期雲端

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 查詢工作階段統計資料彙總資料 AWS CLI

若要追蹤成本、分析資源用量,或識別哪些使用者耗用最多資源,您可以使用 AWS Command Line Interface (AWS CLI) 查詢 AWS 截止日期雲端 (截止日期雲端) 陣列的彙總工作階段統計資料。工作階段統計資料 API 提供成本、執行期和用量的資料,您可以依佇列、機群、執行個體類型或使用者等各種維度分組。

查詢工作階段統計資料是非同步程序。首先,您啟動彙總請求,然後使用彙總 ID 擷取結果。

啟動彙總請求

若要啟動彙總請求,請執行 start-sessions-statistics-aggregation命令。下列範例會依特定佇列的使用者 ID 將統計資料分組。將預留位置文字取代為您的資訊。

aws deadline start-sessions-statistics-aggregation \ --farm-id farm-id \ --resource-ids '{"queueIds":["queue-id"]}' \ --start-time 2025-11-24T10:00:00Z \ --end-time 2025-11-25T18:00:00Z \ --group-by '["USER_ID"]' \ --period HOURLY \ --statistics '["SUM"]' \ --timezone UTC-08:00 \ --region region-name

您可以依其他維度將統計資料分組,例如 QUEUE_IDINSTANCE_TYPE、、 FLEET_ID JOB_IDLICENSE_PRODUCT。如需所有可用參數的詳細資訊,請參閱《 AWS CLI 命令參考》中的 start-sessions-statistics-aggregation

回應包含彙總 ID:

{ "aggregationId": "92b35143f2d04641979bc9b777232f38" }

擷取結果

使用彙總 ID 執行 get-sessions-statistics-aggregation命令以擷取結果。將預留位置文字取代為您的資訊。

aws deadline get-sessions-statistics-aggregation \ --farm-id farm-id \ --aggregation-id aggregation-id \ --region region-name

下列範例顯示當您依使用者 ID 將統計資料分組時的回應。userId 欄位包含 UUID,您必須映射至使用者名稱以識別使用者:

{ "statistics": [ { "userId": "f9c1f3f0-1031-70dc-4d25-30d7225b04a0", "count": 1, "costInUsd": { "sum": 0.0 }, "runtimeInSeconds": { "sum": 53.773 }, "aggregationStartTime": "2025-11-24T22:00:00Z", "aggregationEndTime": "2025-11-24T23:00:00Z" } ], "status": "COMPLETED" }

若要尋找與 相關聯的使用者名稱userId,請參閱 在身分存放區中使用 userID 擷取使用者中繼資料和屬性

如需 API 的詳細資訊,請參閱截止日期雲端 API 參考