すべてのプロダクト
Search
ドキュメントセンター

:QueryBill

最終更新日:Oct 14, 2025

指定された課金サイクルにおけるアカウントの決済請求書を照会します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

bss:DescribeBillList

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

BillingCycle

string

必須

課金サイクル。フォーマットは YYYY-MM です。

2018-07

Type

string

任意

タイプ。有効な値:

  • SubscriptionOrder

  • PayAsYouGoBill

  • Refund

  • Adjustment

SubscriptionOrder

ProductCode

string

任意

プロダクトコード。

rds

ProductType

string

任意

プロダクトタイプ。

rds

SubscriptionType

string

任意

サブスクリプションタイプ。有効な値:

  • Subscription

  • PayAsYouGo

説明

このパラメーターは ProductCode パラメーターと一緒に使用する必要があります。

Subscription

IsHideZeroCharge

boolean

任意

税引前総額 (PretaxGrossAmount) が 0 の請求書を除外するかどうかを指定します。デフォルト値は false です。これにより、下位互換性が確保されます。

  • true: はい。

  • false: いいえ。

true

PageNum

integer

任意

ページ番号。デフォルト値は 1 です。

1

PageSize

integer

任意

ページあたりのエントリ数。デフォルト値: 20。最大値: 300。

20

BillOwnerId

integer

任意

リソースを所有するアカウントの ID。これは、実際にリソースを使用するアカウントです。

123

レスポンスフィールド

フィールド

説明

object

Code

string

状態コード。

Success

Message

string

エラーメッセージ。

Successful!

RequestId

string

リクエスト ID。

AE3F4057-DFC9-4B81-8858-F620651010C9

Success

boolean

リクエストが成功したかどうかを示します。

true

Data

object

返されたデータ。

PageNum

integer

ページ番号。

1

BillingCycle

string

YYYY-MM 形式の課金サイクル。

2020-02

AccountID

string

アカウント ID。

185xxxxx489

PageSize

integer

ページあたりのエントリ数。

1

TotalCount

integer

レコードの総数。

20

AccountName

string

アカウント。

test@test.aliyunid.com

Items

object

Item

array<object>

請求書の詳細。

object

Status

string

支払いステータス。有効な値:

  • PayFinish: 支払い済み

  • PayUnclear: 未払い

  • PayUnsettle: 未決済

  • NoSettle: 決済不要

PayFinish

RoundDownDiscount

string

丸めによる割引額。

0

Item

string

請求書タイプ:

  • SubscriptionOrder

  • PayAsYouGoBill

  • Refund

  • Adjustment

SubscriptionOrder

Currency

string

通貨。

  • CNY

  • USD

  • JPY

CNY

UsageStartTime

string

請求書の開始時刻。

2020-03-11 07:00:00

SubscriptionType

string

サブスクリプションタイプ。有効な値:

  • Subscription

  • PayAsYouGo

PayAsYouGo

DeductedByCashCoupons

number

現金クーポンを使用して差し引かれた金額。

0

UsageEndTime

string

請求書の終了時刻。

2020-03-11 08:00:00

DeductedByCoupons

number

クーポンを使用して差し引かれた金額。

0

SubOrderId

string

請求書に対応する注文詳細の ID。

325345254353

OutstandingAmount

number

未払い額。

0

PaymentTime

string

注文が支払われた時刻。

2020-03-11 08:00:00

PipCode

string

プロダクトコード。

rds

PretaxAmount

number

支払うべき金額。

100

CommodityCode

string

商品コード。

rds

ProductName

string

プロダクト名。

云数据库RDS

RecordID

string

注文番号または請求書番号。

2020xxxx5912

AdjustAmount

number

クレジットの返金から差し引かれた金額。

0

ProductDetail

string

プロダクトの詳細。

关系型数据库RDS(包月)

OwnerID

string

RAM ユーザーの AccountID。これは、管理アカウントがメンバーアカウントの支払いを行うシナリオに適用されます。

3532535235

DeductedByPrepaidCard

number

プリペイドカードを使用して差し引かれた金額。

0

ProductType

string

プロダクトタイプ。

rds

InvoiceDiscount

number

割引額。

0

PaymentAmount

number

クレジットの返金からの控除を含む現金支払い。

0

PretaxGrossAmount

number

元の金額。

0

CashAmount

number

クレジットの返金からの控除を除く現金支払い。

0

ProductCode

string

プロダクトコード。

rds

成功レスポンス

JSONJSON

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "AE3F4057-DFC9-4B81-8858-F620651010C9",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "BillingCycle": "2020-02",
    "AccountID": "185xxxxx489",
    "PageSize": 1,
    "TotalCount": 20,
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "Status": "PayFinish",
          "RoundDownDiscount": "0",
          "Item": "SubscriptionOrder",
          "Currency": "CNY",
          "UsageStartTime": "2020-03-11 07:00:00",
          "SubscriptionType": "PayAsYouGo",
          "DeductedByCashCoupons": 0,
          "UsageEndTime": "2020-03-11 08:00:00",
          "DeductedByCoupons": 0,
          "SubOrderId": "325345254353",
          "OutstandingAmount": 0,
          "PaymentTime": "2020-03-11 08:00:00",
          "PipCode": "rds",
          "PretaxAmount": 100,
          "CommodityCode": "rds",
          "ProductName": "云数据库RDS",
          "RecordID": "2020xxxx5912",
          "AdjustAmount": 0,
          "ProductDetail": "关系型数据库RDS(包月)",
          "OwnerID": "3532535235",
          "DeductedByPrepaidCard": 0,
          "ProductType": "rds",
          "InvoiceDiscount": 0,
          "PaymentAmount": 0,
          "PretaxGrossAmount": 0,
          "CashAmount": 0,
          "ProductCode": "rds"
        }
      ]
    }
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。