指定された条件に基づいて、リソースの控除および使用量の統計情報を取得します。
操作説明
リクエストの説明
この操作は GET および POST メソッドをサポートしています。
periodsパラメーターは JSON 配列フォーマットです。各要素はperiodUnitフィールドとbaseTimeフィールドを含むPeriodParamオブジェクトです。resourceTypesパラメーターは JSON 配列フォーマットで、複数のリソースタイプ文字列を含みます。startTimeおよびendTimeパラメーターはタイムスタンプフォーマットで、クエリの有効値を指定します。ページネーションパラメーターには
nextToken、maxResults、pageNo、pageSizeがあり、返される結果の数とページネーションをコントロールします。resourceTypesパラメーターに無効な値が含まれている場合、またはperiodsパラメーターの JSON 解析に失敗した場合、SalesClientException例外がスローされます。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
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 |
応答のスキーマ。 |
||
| 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"
}
]
}
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。