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

:QueryBillOverview

最終更新日: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

*

  • bssapi:ProductCode
  • bssapi:ProductType
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

BillingCycle

string

必須

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

2018-07

ProductCode

string

任意

プロダクトコード。

rds

ProductType

string

任意

プロダクトタイプ。

rds

SubscriptionType

string

任意

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

  • Subscription: サブスクリプション。

  • PayAsYouGo: 従量課金。

Subscription

BillOwnerId

integer

任意

リソースを使用するアカウントの ID。

1234

レスポンスフィールド

フィールド

説明

object

Code

string

状態コード。

Success

Message

string

エラーメッセージ。

Successful!

RequestId

string

リクエスト ID。

BCB1E1BC-05BF-4217-80EE-BF09A29407BA

Success

boolean

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

true

Data

object

返されたデータ。

BillingCycle

string

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

2020-03

AccountID

string

アカウント ID。

185766xxxx

AccountName

string

アカウント名。

test@test.aliyunid.com

Items

object

Item

array<object>

請求の詳細。

object

RoundDownDiscount

string

切り捨てられた割引額。

0

Item

string

請求タイプ。有効な値:

  • SubscriptionOrder: サブスクリプション請求

  • PayAsYouGoBill: 従量課金請求

  • Refund: 返金

  • Adjustment: 調整

PayAsYouGoBill

Currency

string

通貨。有効な値:

  • CNY

  • USD

  • JPY

CNY

SubscriptionType

string

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

  • Subscription: サブスクリプション。

  • PayAsYouGo: 従量課金。

Subscription

DeductedByCashCoupons

number

現金クーポンによって差し引かれた金額。

0

BillAccountName

string

請求が属するアカウントの名前。

test@test.aliyunid.com

BizType

string

ビジネスタイプ。

trusteeship

DeductedByCoupons

number

クーポンによって差し引かれた金額。

0

OutstandingAmount

number

未決済額またはクレジットで決済された額。これは、一般ユーザの支払い遅延、またはクレジットベースのユーザーが消費したクレジットである可能性があります。

0

PipCode

string

プロダクトコード。これは、ユーザーセンターの請求書のプロダクトコードと同じです。

rds

PretaxAmount

number

税引前金額。

100

ProductName

string

プロダクト名。

Nat网关

CommodityCode

string

商品コード。これは、ユーザーセンターのプロダクト詳細コードと同じです。

rds

AdjustAmount

number

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

0

ProductDetail

string

プロダクトの詳細。

NAT Gateway (Pay-As-You-Go)

OwnerID

string

請求オーナーの ID。

1222

DeductedByPrepaidCard

number

プリペイドカードによって差し引かれた金額。

0

ProductType

string

プロダクトタイプ。

rds

InvoiceDiscount

number

割引額。

0

PaymentAmount

number

現金で支払われた金額。これには、クレジット返金から差し引かれた金額が含まれます。

100

BillAccountID

string

請求が属するアカウントの ID。

185766xxxx

PretaxGrossAmount

number

元の金額。

100

CashAmount

number

現金で支払われた金額。これには、クレジット返金から差し引かれた金額は含まれません。

0

ProductCode

string

プロダクトコード。

rds

成功レスポンス

JSONJSON

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "BCB1E1BC-05BF-4217-80EE-BF09A29407BA",
  "Success": true,
  "Data": {
    "BillingCycle": "2020-03",
    "AccountID": "185766xxxx",
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "RoundDownDiscount": "0",
          "Item": "PayAsYouGoBill",
          "Currency": "CNY",
          "SubscriptionType": "Subscription",
          "DeductedByCashCoupons": 0,
          "BillAccountName": "test@test.aliyunid.com",
          "BizType": "trusteeship",
          "DeductedByCoupons": 0,
          "OutstandingAmount": 0,
          "PipCode": "rds",
          "PretaxAmount": 100,
          "ProductName": "Nat网关",
          "CommodityCode": "rds",
          "AdjustAmount": 0,
          "ProductDetail": "NAT Gateway (Pay-As-You-Go)",
          "OwnerID": "1222",
          "DeductedByPrepaidCard": 0,
          "ProductType": "rds",
          "InvoiceDiscount": 0,
          "PaymentAmount": 100,
          "BillAccountID": "185766xxxx",
          "PretaxGrossAmount": 100,
          "CashAmount": 0,
          "ProductCode": "rds"
        }
      ]
    }
  }
}

エラーコード

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

変更履歴

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