すべてのプロダクト
Search

このプロダクト

    :QueryAccountBill

    ドキュメントセンター

    :QueryAccountBill

    最終更新日:Oct 29, 2025

    課金サイクル内のアカウントの支出をクエリし、リソース所有者ごとにデータを集計します。

    操作説明

    • 当月のデータは参考用であり、請求の遅延、返金、請求調整、支払い遅延の償却などのイベントが発生する可能性があるため、照合には使用しないでください。当月の最終請求書は、翌月の 3 日の 12:00 以降に利用可能になります。

    • 過去 18 か月分のデータをクエリできます。

    • 請求データは 24 時間の遅延で更新されます。インスタンスの構成、インスタンスタイプ、ニックネーム、リソースグループ、パブリック IP アドレス、プライベート IP アドレス、ゾーンなどのインスタンス関連情報は、48 時間の遅延で更新されます。

    • 請求データには、CDN、OSS、Internet Shared Bandwidth などのプロダクトのドメイン名、バケット、EIP などのアタッチされたリソースの特定のコストは含まれません。アタッチされたリソースのデータを含む統計を表示するには、分割請求書をご参照ください。

    • Alibaba Cloud Communications プロダクトの場合、2020 年 6 月以降の詳細データをクエリできます。ドメイン名や商標などの HiChina プロダクトの場合、2020 年 11 月以降の詳細データをクエリできます。

    • 単一ユーザーのレート制限は 10 クエリ/秒です。タイムアウトが発生した場合は、リクエストをリトライしてください。

    今すぐお試しください

    この 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:QueryAccountBill

    get

    *All Resource

    *
    • bssapi:ProductCode
    • bssapi:ProductType
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    BillingCycle

    string

    必須

    請求日。フォーマット: YYYY-MM。

    2018-07
    PageNum

    integer

    任意

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

    1
    PageSize

    integer

    任意

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

    20
    IsGroupByProduct

    boolean

    任意

    結果をプロダクトコードで集計するかどうかを指定します。

    • true

    • false

    デフォルト値: false。

    false
    ProductCode

    string

    任意

    プロダクトコード。

    rds
    BillOwnerId

    integer

    任意

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

    122
    Granularity

    string

    任意

    請求書をクエリする粒度。有効な値:

    • MONTHLY: 月単位で請求書をクエリします。これは、ユーザーセンターの請求詳細ページの月次請求書と一致します。

    • DAILY: 日単位で請求書をクエリします。これは、ユーザーセンターの請求詳細ページの日次請求書と一致します。

    説明

    このパラメーターを DAILY に設定する場合は、BillingDate パラメーターも指定する必要があります。

    MONTHLY
    BillingDate

    string

    任意

    請求日。このパラメーターは、Granularity を DAILY に設定した場合にのみ必要です。フォーマット: YYYY-MM-DD。

    2021-06-01

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    状態コード。

    Success
    Message

    string

    エラーメッセージ。

    Successful!
    RequestId

    string

    リクエスト ID。

    3BFC23FE-A182-4D96-A1E4-7521B30B8E43
    Success

    boolean

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

    true
    Data

    object

    返されたデータ。

    PageNum

    integer

    ページ番号。

    1
    BillingCycle

    string

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

    2020-03
    AccountID

    string

    アカウント ID。

    1857xxxxx489
    PageSize

    integer

    1 ページに表示されるエントリ数。

    20
    TotalCount

    integer

    レコードの総数。

    1
    AccountName

    string

    アカウント名。

    test@test.aliyunid.com
    Items

    object

    Item

    array<object>

    請求の詳細。

    object

    PipCode

    string

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

    rds
    BillingDate

    string

    請求日。

    2021-03-01
    ProductName

    string

    プロダクト名。

    説明

    このパラメーターは、IsGroupByProduct が true に設定されている場合にのみ返されます。

    rds
    OwnerName

    string

    リソース所有者の AccountName。これは、複数アカウントでの支払いシナリオで使用されます。

    aligzncloudtest2
    Currency

    string

    通貨。有効な値:

    • CNY

    • USD

    • JPY

    CNY
    BillAccountName

    string

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

    test@test.aliyunid.com
    SubscriptionType

    string

    プロダクトのサブスクリプションタイプ。

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

    • PayAsYouGo: 従量課金

    説明

    このパラメーターは、IsGroupByProduct が true に設定されている場合にのみ返されます。

    PayAsYouGo
    BizType

    string

    ビジネスタイプ。

    trusteeship
    OwnerID

    string

    リソース所有者の AccountID。これは、複数アカウントでの支払いシナリオで使用されます。

    325434254
    DeductedByCoupons

    number

    クーポンで差し引かれた金額。

    0
    BillAccountID

    string

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

    1857xxxxx489
    InvoiceDiscount

    number

    割引額。

    0
    CostUnit

    string

    コストセンター。

    未分配
    PretaxGrossAmount

    number

    税引前総額。

    0
    ProductCode

    string

    プロダクトコード。

    説明

    このパラメーターは、IsGroupByProduct が true に設定されている場合にのみ返されます。

    rds

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "3BFC23FE-A182-4D96-A1E4-7521B30B8E43",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "BillingCycle": "2020-03",
    "AccountID": "1857xxxxx489",
    "PageSize": 20,
    "TotalCount": 1,
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "PipCode": "rds",
          "BillingDate": "2021-03-01",
          "ProductName": "rds",
          "OwnerName": "aligzncloudtest2",
          "Currency": "CNY",
          "BillAccountName": "test@test.aliyunid.com",
          "SubscriptionType": "PayAsYouGo",
          "BizType": "trusteeship",
          "OwnerID": "325434254",
          "DeductedByCoupons": 0,
          "BillAccountID": "1857xxxxx489",
          "InvoiceDiscount": 0,
          "CostUnit": "未分配",
          "PretaxGrossAmount": 0,
          "ProductCode": "rds"
        }
      ]
    }
  }
}

    エラーコード

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

    変更履歴

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