擷取指定條件下的資源抵扣和使用方式統計。
介面說明
請求說明
該介面支援 GET 和 POST 方法。
periods參數為 JSON 數組格式,每個元素為一個PeriodParam對象,包含periodUnit和baseTime欄位。resourceTypes參數為 JSON 數組格式,包含多個資源類型字串。startTime和endTime參數為時間戳記格式,表示查詢的時間範圍。分頁參數包括
nextToken、maxResults、pageNo和pageSize,用於控制返回結果的數量和分頁。當
resourceTypes參數包含無效值或periods參數 JSON 解析失敗時,會拋出SalesClientException異常。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST HTTP/1.1
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Periods |
array<object> |
否 |
時間周期列表,JSON 數組格式,元素為 |
|
|
object |
否 |
|||
| PeriodUnit |
string |
否 |
時間周期單位(參考 |
Year |
| BaseTime |
string |
否 |
基準時間 |
2024-01-01 |
| ResourceTypes |
array |
否 |
資源類型列表,JSON 數組格式 |
|
|
string |
否 |
資源類型列表。最多支援 50 組。 說明
如果您設定了 |
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"
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。