指定された条件に基づいて、リソースの控除と使用量に関する統計を取得します。
操作説明
リクエスト
この API は GET および POST メソッドに対応しています。
periodsパラメーターはPeriodParamオブジェクトの JSON 配列です。各オブジェクトにはperiodUnitフィールドとbaseTimeフィールドが含まれます。resourceTypesパラメーターは、リソースタイプの文字列の JSON 配列です。startTimeおよびendTimeパラメーターは、クエリの時間範囲を指定するタイムスタンプです。nextToken、maxResults、pageNo、およびpageSizeパラメーターで、ページネーションと返される結果数を制御します。resourceTypesパラメーターに無効な値が含まれている場合、またはperiodsパラメーターの JSON 解析に失敗した場合、この API はSalesClientException例外をスローします。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
POST HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Periods |
array<object> |
任意 |
|
|
|
object |
任意 |
|||
| PeriodUnit |
string |
任意 |
期間単位。有効な値については、 |
Year |
| BaseTime |
string |
任意 |
基準時間。 |
2024-01-01 |
| ResourceTypes |
array |
任意 |
JSON 配列で指定する、リソースタイプのリスト。 |
|
|
string |
任意 |
リソースタイプのリスト。最大 50 個のリソースタイプを指定できます。 説明
|
Desktop |
|
| StartTime |
integer |
任意 |
UNIX タイムスタンプで指定する開始時刻。 |
2026-03-20T16:00:00Z |
| EndTime |
integer |
任意 |
UNIX タイムスタンプで指定する終了時刻。 |
2025-06-06T02:14:00Z |
| InstanceIds |
array |
任意 |
JSON 配列で指定する、インスタンス ID のリスト。 |
|
|
string |
任意 |
インスタンス ID。 |
ak-7yz7llzomgh2g64gc |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスデータ。 |
||
| 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 |
Alibaba Cloud アカウント ID。 |
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 |
リソースが No-Lx リソースであるかどうかを示します。 |
|
| NoLxSource |
string |
No-Lx リソースのソース。 |
无凌霄来源示例值 |
| ResourceId |
string |
リソース ID。 |
res-xxxxx |
例
成功レスポンス
JSONJSON
{
"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": false,
"NoLxSource": "无凌霄来源示例值",
"ResourceId": "res-xxxxx"
}
]
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。