全部产品
Search
文档中心

阿里云交易和账单管理API:QuerySavingsPlansDeductLog - 节省计划抵扣明细查询

更新时间:Mar 01, 2024

查询节省计划抵扣的明细数据

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
bssapi:QuerySavingsPlansDeductLogRead
  • 全部资源
    *

请求参数

名称类型必填描述示例值
InstanceTypestring

查询类型:

  • spn 节省计划实例

  • product 抵扣云产品实例

spn
PageSizeinteger

每页数量

20
Localestring

多语言选项,默认返回中文 ZH 中文 EN 英文

ZH
PageNuminteger

查询页数

1
InstanceIdstring

实例 ID

spn-XXXXXXX
StartTimestring

查询开始时间

2022-01-01 00:00:00
EndTimestring

查询结束时间

2022-01-05 00:00:00

返回参数

名称类型描述示例值
object

返回值

Codestring

错误码

PARAM_ERROR
Messagestring

错误信息

请校验入参正确性
RequestIdstring

请求 ID

61293E7A-3406-4447-8620-EC88B0AA66AD
Successboolean

是否成功

true
Dataobject

返回元素

PageNuminteger

查询页数

1
PageSizeinteger

每页个数

20
TotalCountinteger

总个数

20
Itemsobject []

抵扣明细列表

EndTimestring

结束时间

2020-12-01 01:00:00
StartTimestring

开始时间

2020-12-01 00:00:00
SavingsTypestring

节省计划类型:

  • universal 通用型
  • ecs 计算型
ecs
UserIdlong

用户 ID

1906589291020438
DiscountRatestring

当前抵扣使用的折扣率

0.069
BillModulestring

抵扣计费项

云服务器配置
InstanceIdstring

节省计划实例 ID

spn-xxxxxxx
DeductInstanceIdstring

被抵扣云产品实例 ID

i-XXXXXXXXX
DeductCommoditystring

抵扣商品

云服务器ECS-按量付费
DeductRatestring

抵扣率

1.0
DeductFeestring

抵扣费用

0.52
OwnerIdlong

所有者 ID。

1906589291020438
BillingCyclestring

账期

202312
Regionstring

被抵扣实例地域

cn-shanghai-eu13-a01
InstanceSpecstring

被抵扣实例规格

ecs.g7.xlarge
InstanceTypeFamilystring

被抵扣实例规格族

ecs.g7
BillingOfficialPricestring

被抵扣账单的官网价

375.35
DeductedOfficialPricestring

被抵扣部分官网价

375.37

示例

正常返回示例

JSON格式

{
  "Code": "PARAM_ERROR",
  "Message": "请校验入参正确性",
  "RequestId": "61293E7A-3406-4447-8620-EC88B0AA66AD",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "PageSize": 20,
    "TotalCount": 20,
    "Items": [
      {
        "EndTime": "2020-12-01 01:00:00",
        "StartTime": "2020-12-01 00:00:00",
        "SavingsType": "ecs",
        "UserId": 1906589291020438,
        "DiscountRate": "0.069",
        "BillModule": "云服务器配置",
        "InstanceId": "spn-xxxxxxx",
        "DeductInstanceId": "i-XXXXXXXXX",
        "DeductCommodity": "云服务器ECS-按量付费",
        "DeductRate": "1.0",
        "DeductFee": "0.52",
        "OwnerId": 1906589291020438,
        "BillingCycle": "202312",
        "Region": "cn-shanghai-eu13-a01",
        "InstanceSpec": "ecs.g7.xlarge",
        "InstanceTypeFamily": "ecs.g7",
        "BillingOfficialPrice": "375.35",
        "DeductedOfficialPrice": "375.37"
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidOwnerThe specified owner does not belong to caller.指定的所有者不属于调用方。
400InvalidParameterThe specified request contains invalid parameters.请求中包含无效参数。
400MissingParameterThe specified request lacks essential parameters.该请求缺少必要参数。
400NotApplicableThe specified API is not applicable for the user.此API不适用于调用方。
400NotApplicableYou are not authorized to call the API operation. Please check whether the caller site matches the API domain regionId.用户不可调用该API。请检查调用用户站点和API域名的地域信息是否匹配。
400NotAuthorizedThe user is not authorized for the specified API.此API未对该调用者进行授权。
400NotAuthorizedYou are not authorized to call the API operation. Please check whether RAM user has the permission or check whether ownerId and callerId have been given the appropriate permission.用户没有调用该API的权限。如果是RAM调用,请检查是否授予相应权限。否则请检查ownerId和callerId的权限归属是否正确。
500InternalErrorAn error occurred in the internal server.-

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

变更历史

变更时间变更内容概要操作
2023-12-07OpenAPI 描述信息更新、OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:500
出参OpenAPI 返回结构发生变更
2022-06-28OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:500
出参OpenAPI 返回结构发生变更