QuerySavingsPlansDeductLog - 节省计划抵扣明细查询

更新时间:

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

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bssapi:QuerySavingsPlansDeductLog

get

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

InstanceType

string

查询类型:

  • spn 节省计划实例

  • product 抵扣云产品实例

spn

PageSize

integer

每页数量

20

Locale

string

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

ZH

PageNum

integer

查询页数

1

InstanceId

string

实例 ID

spn-XXXXXXX

StartTime

string

查询开始时间

2022-01-01 00:00:00

EndTime

string

查询结束时间

2022-01-05 00:00:00

返回参数

名称

类型

描述

示例值

object

返回值

Code

string

错误码

PARAM_ERROR

Message

string

错误信息

请校验入参正确性

RequestId

string

请求 ID

61293E7A-3406-4447-8620-EC88B0AA66AD

Success

boolean

是否成功

true

Data

object

返回元素

PageNum

integer

查询页数

1

PageSize

integer

每页个数

20

TotalCount

integer

总个数

20

Items

array<object>

抵扣明细列表

object

抵扣明细数据

EndTime

string

结束时间

2020-12-01 01:00:00

StartTime

string

开始时间

2020-12-01 00:00:00

SavingsType

string

节省计划类型:

  • universal 通用型

  • ecs 计算型

ecs

UserId

integer

用户 ID

1906589291020438

DiscountRate

string

当前抵扣使用的折扣率

0.069

BillModule

string

抵扣计费项

云服务器配置

InstanceId

string

节省计划实例 ID

spn-xxxxxxx

DeductInstanceId

string

被抵扣云产品实例 ID

i-XXXXXXXXX

DeductCommodity

string

抵扣商品

云服务器ECS-按量付费

DeductRate

string

抵扣率

1.0

DeductFee

string

抵扣费用,单位:元

0.52

OwnerId

integer

所有者 ID。

1906589291020438

BillingCycle

string

账期

202312

Region

string

被抵扣实例地域

cn-shanghai-eu13-a01

InstanceSpec

string

被抵扣实例规格

ecs.g7.xlarge

InstanceTypeFamily

string

被抵扣实例规格族

ecs.g7

BillingOfficialPrice

string

被抵扣账单的官网价,单位:元

375.35

DeductedOfficialPrice

string

被抵扣部分官网价,单位:元

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

错误码

错误信息

描述

400 InvalidOwner The specified owner does not belong to caller.
400 InvalidParameter The specified request contains invalid parameters.
400 MissingParameter The specified request lacks essential parameters.
400 NotApplicable The specified API is not applicable for the user.
400 NotAuthorized The user is not authorized for the specified API.
500 InternalError An error occurred in the internal server. 系统异常,请重试

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

变更历史

更多信息,参考变更详情