DescribeDeductionStatistic - 查询抵扣详情 - 无影云电脑

获取指定条件下的资源抵扣和使用情况统计。

接口说明

请求说明

该接口支持 GET 和 POST 方法。
periods 参数为 JSON 数组格式，每个元素为一个 PeriodParam 对象，包含 periodUnit 和 baseTime 字段。
resourceTypes 参数为 JSON 数组格式，包含多个资源类型字符串。
startTime 和 endTime 参数为时间戳格式，表示查询的时间范围。
分页参数包括 nextToken、maxResults、pageNo 和 pageSize，用于控制返回结果的数量和分页。
当 resourceTypes 参数包含无效值或 periods 参数 JSON 解析失败时，会抛出 SalesClientException 异常。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ecd:DescribeDeductionStatistic	list	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
Periods	array<object>	否	时间周期列表，JSON 数组格式，元素为 `PeriodParam` 对象
	object	否
BaseTime	string	否	基准时间	2024-01-01
PeriodUnit	string	否	时间周期单位（参考 `PeriodUnit` 枚举）	Year
ResourceTypes	array	否	资源类型列表，JSON 数组格式
	string	否	资源类型列表。最多支持 50 组。说明如果您设置了`ResourceTypes`，则请求参数中单独设置的`Service`和`ResourceType`将不生效。	Desktop
StartTime	long	否	开始时间（时间戳）	2026-03-20T16:00:00Z
EndTime	long	否	结束时间（时间戳）	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>	抵扣数据详情
deductions	object	抵扣数据详情
ConsumeSecond	long	消费时长（秒）	7000
DeductionDate	string	抵扣日期	2024-01-01
ResourceType	string	资源类型	CloudDesktop
Usages	array<object>	使用量列表
usages	object
ConsumeSecond	long	消费时长（秒）	6000
Period	string	时间周期	2024-01-01
ResourceType	string	资源类型	CloudDesktop
AvailableCorePackages	array<object>	可用的核时包资源列表
availableCorePackages	object
Status	string	状态	Active
GroupResourceType	string	组资源类型	CoreHour
EndTime	string	结束时间	2024-12-31 23:59:59
CreateTime	string	创建时间	2024-01-01 00:00:00
StartTime	string	开始时间	2024-01-01 00:00:00
NoLx	boolean	是否无凌霄
ResourceType	string	组资源类型	CoreHour
GroupId	string	组 ID	g-xxxxx
NoLxSource	string	无凌霄来源	无凌霄来源示例值
ResourceId	string	资源 ID	res-xxxxx
ExpiredTime	string	过期时间	2024-12-31 23:59:59
UsedTime	long	已使用时长	40000
TotalTime	long	总时长	1000000
AliUid	long	阿里云 UID	1568857911493620

示例

正常返回示例

JSON格式

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

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2026-05-05	新增 OpenAPI	查看变更详情