ListServiceInstanceBill - 查询服务实例账单_计算巢服务(Compute Nest)-阿里云帮助中心

调用ListServiceInstanceBill查询服务实例账单

调试

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

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
computenestsupplier:ListServiceInstanceBill	get	ServiceInstance `acs:computenestsupplier:{#regionId}:{#accountId}:serviceinstance/{#ServiceInstanceId}`	无	无

请求参数

名称	类型	必填	描述	示例值
MaxResults	integer	否	分页查询时每页行数。其中最大值为 100 行，默认值为 20 行。	20
NextToken	string	否	是否拥有下一次查询的令牌（Token）。取值：如果 NextToken 为空表示没有下一次查询。如果 NextToken 有返回值，该取值表示下一次查询开始的令牌。	AAAAAfu+XtuBE55iRLHEYYuojI4=
ServiceInstanceId	string	否	服务实例 ID。您可以通过调用ListServiceInstances - 查询服务实例列表获取服务实例 ID。	si-0d0d7bc9accc4e2e8a8f
BillingCycle	string	是	账期，YYYY-MM。	2025-03
Granularity	string	否	查询账单的颗粒度。取值如下： MONTHLY：月。与费用中心-费用账单-账单明细-账期账单一致。 DAILY：日。与费用中心-费用账单-账单明细-按天账单一致。说明选择 DAILY 需指定 BillingDate。	MONTHLY
BillingDate	string	否	账单日期，仅当 Granularity 为 DAILY 时必填，格式为 YYYY-MM-DD。	2024-12-05
ServiceId	string	否	服务 ID	service-6121296da4f44e469519
ServiceVersion	string	否	服务版本。	1

返回参数

名称	类型	描述	示例值
	object
NextToken	string	下一个查询开始 token。	AAAAAfu+XtuBE55iRLHEYYuojI4=
RequestId	string	请求 ID。	7B68C6D1-0C22-53F7-997C-F95D109C31AA
TotalCount	long	结果总数。	65
MaxResults	integer	分页查询时，每页显示的行数。每页最大 100 行，默认为 20 行。	20
Item	array<object>	检查项名称。
Item	object	子任务 ITEM 详情
SplitBillingCycle	string	分账月。	2021-06
BillingDate	string	账单日期，格式 YYYY-MM-DD。	2024-12-05
SubscriptionType	string	订阅类型： Subscription：预付费。 PayAsYouGo：后付费。	Subscription
ProductName	string	产品名称。	oss
BillingItemCode	string	计费项代码。	disk
ProductCode	string	产品代码。	oss
ProductDetail	string	产品明细。	sls
InstanceID	string	实例 ID。	rm-wz9k051l23j3o3xa9
DeductedByResourcePackage	string	资源包抵扣。	0
ListPriceUnit	string	单价单位。	元/GB
Usage	string	资源用量	1
ListPrice	string	单价。	0.12
UsageUnit	string	用量单位	GB
PretaxGrossAmount	string	原始金额。	0
InvoiceDiscount	string	优惠金额。	0
PretaxAmount	string	应付金额。	0
ServiceInstanceId	string	服务实例 ID。	si-bc5d6ac7022647d3a3bd
BillingCycle	string	账期，格式：YYYY-MM。	2024-12
BillingItem	string	计费项。	带宽
Currency	string	货币单位。	CNY

示例

正常返回示例

JSON格式

{
  "NextToken": "AAAAAfu+XtuBE55iRLHEYYuojI4=",
  "RequestId": "7B68C6D1-0C22-53F7-997C-F95D109C31AA",
  "TotalCount": 65,
  "MaxResults": 20,
  "Item": [
    {
      "SplitBillingCycle": "2021-06\n",
      "BillingDate": "2024-12-05",
      "SubscriptionType": "Subscription",
      "ProductName": "oss",
      "BillingItemCode": "disk",
      "ProductCode": "oss",
      "ProductDetail": "sls",
      "InstanceID": "rm-wz9k051l23j3o3xa9",
      "DeductedByResourcePackage": 0,
      "ListPriceUnit": "元/GB\n",
      "Usage": 1,
      "ListPrice": 0.12,
      "UsageUnit": "GB",
      "PretaxGrossAmount": 0,
      "InvoiceDiscount": 0,
      "PretaxAmount": 0,
      "ServiceInstanceId": "si-bc5d6ac7022647d3a3bd",
      "BillingCycle": "2024-12",
      "BillingItem": "带宽\n",
      "Currency": "CNY"
    }
  ]
}

错误码

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