全部產品
Search
文件中心

Elastic Desktop Service:DescribeDeductionStatistic - 查詢抵扣詳情

更新時間:May 26, 2026

擷取指定條件下的資源抵扣和使用方式統計。

介面說明

請求說明

  • 該介面支援 GET 和 POST 方法。

  • periods 參數為 JSON 數組格式,每個元素為一個 PeriodParam 對象,包含 periodUnitbaseTime 欄位。

  • resourceTypes 參數為 JSON 數組格式,包含多個資源類型字串。

  • startTimeendTime 參數為時間戳記格式,表示查詢的時間範圍。

  • 分頁參數包括 nextTokenmaxResultspageNopageSize,用於控制返回結果的數量和分頁。

  • resourceTypes 參數包含無效值或 periods 參數 JSON 解析失敗時,會拋出 SalesClientException 異常。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

Periods

array<object>

時間周期列表,JSON 數組格式,元素為 PeriodParam 對象

object

PeriodUnit

string

時間周期單位(參考 PeriodUnit 枚舉)

Year

BaseTime

string

基準時間

2024-01-01

ResourceTypes

array

資源類型列表,JSON 數組格式

string

資源類型列表。最多支援 50 組。

說明

如果您設定了ResourceTypes,則請求參數中單獨設定的ServiceResourceType將不生效。

Desktop

StartTime

integer

開始時間(時間戳記)

2026-03-20T16:00:00Z

EndTime

integer

結束時間(時間戳記)

2025-06-06T02:14:00Z

InstanceIds

array

執行個體 ID 列表(JSON 數組)

string

執行個體 ID。

ak-7yz7llzomgh2g64gc

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID

A1B2C3D4-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Data

object

抵扣資料

Deductions

array<object>

抵扣資料詳情

object

抵扣資料詳情

DeductionDate

string

抵扣日期

2024-01-01

ConsumeSecond

integer

消費時間長度(秒)

7000

ResourceType

string

資源類型

CloudDesktop

Usages

array<object>

使用量列表

object

Period

string

時間周期

2024-01-01

ConsumeSecond

integer

消費時間長度(秒)

6000

ResourceType

string

資源類型

CloudDesktop

AvailableCorePackages

array<object>

可用的核時包資源清單

object

GroupId

string

組 ID

g-xxxxx

AliUid

integer

阿里雲 UID

1568857911493620

GroupResourceType

string

組資源類型

CoreHour

UsedTime

integer

已使用時間長度

40000

TotalTime

integer

總時間長度

1000000

ResourceType

string

組資源類型

CoreHour

StartTime

string

開始時間

2024-01-01 00:00:00

EndTime

string

結束時間

2024-12-31 23:59:59

Status

string

狀態

Active

ExpiredTime

string

到期時間

2024-12-31 23:59:59

CreateTime

string

建立時間

2024-01-01 00:00:00

NoLx

boolean

是否無淩霄

NoLxSource

string

無淩霄來源

無淩霄來源樣本值

ResourceId

string

資源 ID

res-xxxxx

樣本

正常返回樣本

JSON格式

{
  "RequestId": "A1B2C3D4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "Data": {
    "Deductions": [
      {
        "DeductionDate": "2024-01-01",
        "ConsumeSecond": 7000,
        "ResourceType": "CloudDesktop"
      }
    ],
    "Usages": [
      {
        "Period": "2024-01-01",
        "ConsumeSecond": 6000,
        "ResourceType": "CloudDesktop"
      }
    ],
    "AvailableCorePackages": [
      {
        "GroupId": "g-xxxxx",
        "AliUid": 1568857911493620,
        "GroupResourceType": "CoreHour",
        "UsedTime": 40000,
        "TotalTime": 1000000,
        "ResourceType": "CoreHour",
        "StartTime": "2024-01-01 00:00:00",
        "EndTime": "2024-12-31 23:59:59",
        "Status": "Active",
        "ExpiredTime": "2024-12-31 23:59:59",
        "CreateTime": "2024-01-01 00:00:00",
        "NoLx": true,
        "NoLxSource": "無淩霄來源樣本值",
        "ResourceId": "res-xxxxx"
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情