すべてのプロダクト
Search

このプロダクト

    :DescribeInstanceBill

    ドキュメントセンター

    :DescribeInstanceBill

    最終更新日:Sep 17, 2026

    特定の課金サイクル内における、ユーザーのすべてのプロダクトインスタンスまたは課金項目の消費のまとめを照会します。

    操作説明

    • 当月のクエリ結果はリファレンス用であり、照合には使用できません。当月の確定請求書は、翌月 3 日の 12:00 以降に表示またはエクスポートできます。月中には、課金の遅延、返金、請求書の調整、支払い遅延の償却など、さまざまなシナリオが発生する可能性があります。

    • 当月の請求書データには、未決済 (未請求または集計中) の従量課金データは含まれません。

    • 過去 18 か月間のデータがサポートされています。

    • 請求書データは、実際の消費コストに対して 24 時間の遅延をもって更新されます。インスタンス ID 関連情報 (インスタンス構成、インスタンスタイプ、インスタンスのニックネーム、リソースグループ、パブリック IP アドレス、非公開 IP アドレス、ゾーン) は 48 時間の遅延をもって更新されます。

    • 請求書データでは、アタッチされたリソースタイプのクラウドサービス (CDN、OSS、インターネット共有帯域幅など) に対する個々のアタッチされたリソース (ドメイン名、バケット、EIP など) の具体的なコストは提供されません。アタッチされたリソースを含むデータを取得するには、分割請求書を使用します。

    • Cloud Communications プロダクトの場合、2020 年 6 月以降の詳細データのみを照会できます。Wanwang プロダクト (ドメイン名および商標を含む) の場合、2020 年 11 月以降の詳細データのみを照会できます。

    • 単一ユーザーのレート制限は 1 秒あたり 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    bssapi:DescribeInstanceBill

    get

    *すべてのリソース。

    *
    • bssapi:ProductCode
    • bssapi:ProductCode
    • bssapi:ProductType
    • bssapi:ProductType
    		 なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    BillingCycle

    string

    必須

    YYYY-MM フォーマットの課金サイクル。過去 18 か月以内の課金サイクルのみがサポートされています。

    2020-03
    ProductCode

    string

    任意

    プロダクトコード。

    rds
    ProductType

    string

    任意

    プロダクトタイプ。

    rds
    SubscriptionType

    string

    任意

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

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

    • PayAsYouGo: 従量課金。

    PayAsYouGo
    IsBillingItem

    boolean

    任意

    課金項目ごとのデータを照会するかどうかを指定します。

    • false (デフォルト): データは、[費用とコスト] > [請求書] > [請求書の詳細] のインスタンスの請求書と一致します。

    • true: データは、[費用とコスト] > [請求書] > [請求書の詳細] の課金項目の請求書と一致します。

    false
    NextToken

    string

    任意

    現在の呼び出しでデータの読み取りを開始する位置を示すトークン。このパラメーターの値は空、または前の呼び出しで返された NextToken 値である必要があります。それ以外の場合はエラーが返されます。空の値は、先頭から読み取ることを示します。

    CAESEgoQCg4KCm
    MaxResults

    integer

    任意

    現在のリクエストで読み取りを行うデータレコードの最大値。デフォルト値: 20。最大値: 300。

    20
    IsHideZeroCharge

    boolean

    任意

    元の価格 (PretaxGrossAmount) と支払金額 (PretaxAmount) の両方が 0 であるレコードをフィルターで除外するかどうかを指定します。有効な値:

    • false。

    • true。

    false
    BillingDate

    string

    任意

    課金日。このパラメーターは、Granularity が DAILY にセットされている場合にのみ必須です。フォーマット: YYYY-MM-DD。

    説明

    BillingDate パラメーター値の月は、BillingCycle パラメーター値と一致している必要があります。たとえば、BillingCycle が 2020-03 にセットされている場合、BillingDate は 2020-03-DD にセットする必要があります。月が一致していない場合、クエリ結果は BillingCycle で指定された時間に基づいて返されます。

    2020-03-02
    Granularity

    string

    任意

    請求書クエリの粒度。有効な値:

    • MONTHLY: 月次。データは、[費用とコスト] > [請求書] > [請求書の詳細] の課金サイクルの請求書と一致します。

    • DAILY: 日次。データは、[費用とコスト] > [請求書] > [請求書の詳細] の日次の請求書と一致します。

    説明

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

    MONTHLY
    BillOwnerId

    integer

    任意

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

    122
    InstanceID

    string

    任意

    インスタンスの ID。

    abc
    PipCode

    string

    任意

    プロダクトコード。ユーザーセンターの請求書に記載されているプロダクトコードと一致します。

    rds

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    状態コード。

    Success
    Data

    object

    返されるデータ。

    AccountID

    string

    アカウントの ID。

    122
    AccountName

    string

    ユーザー名。

    test@test.aliyunid.com
    BillingCycle

    string

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

    2020-03
    Items

    array<object>

    請求書の詳細。

    object

    AfterDiscountAmount

    number

    割引後の金額。この金額には、クーポン控除後の支払金額が含まれます。計算ルール: 割引後金額 = リスト価格 - 割引金額。

    BillAccountID

    string

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

    122
    BillAccountName

    string

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

    test@test.aliyunid.com
    BillingDate

    string

    課金日。このパラメーターは、Granularity が DAILY に設定されている場合にのみ値を持ちます。フォーマット: YYYY-MM-DD。

    2020-03-20
    BillingItem

    string

    課金項目。このパラメーターは、IsBillingItem が true に設定されている場合にのみ値を持ちます。

    Bandwidth
    BillingItemCode

    string

    課金項目のコード。

    disk
    BillingType

    string

    課金方法。

    Other
    BizType

    string

    ビジネスタイプ。

    trusteeship
    CommodityCode

    string

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

    rds
    CostUnit

    string

    コストセンター。

    Unallocated
    Currency

    string

    通貨。有効な値:

    • CNY

    • USD

    • JPY

    CNY
    DeductedByCoupons

    number

    クーポンを使用して控除された金額。

    0.1
    DeductedByResourcePackage

    string

    リソースプランを使用して控除された金額。このパラメーターは、isBillingItem が true に設定されている場合にのみ有効です。

    0.1
    InstanceConfig

    string

    インスタンスの詳細な構成。

    CPU：12
    InstanceID

    string

    インスタンスの ID。

    i-dadada
    InstanceSpec

    string

    インスタンスタイプ。

    ecs.sn1ne.3xlarge
    InternetIP

    string

    パブリック IP アドレス。

    34.xx.x.x

    IntranetIP

    string

    内部 IP アドレス。

    192.xx.xx.xx
    InvoiceDiscount

    number

    割引金額。

    0.1
    Item

    string

    請求書タイプ。有効な値:

    • SubscriptionOrder: サブスクリプション注文。

    • PayAsYouGoBill: 従量課金請求書。

    • Refund: 返金。

    • Adjustment: 調整。

    PayAsYouGoBill
    ItemName

    string

    項目名。

    iZ28bycvyb4Z
    ListPrice

    string

    リスト価格。このパラメーターは、isBillingItem が true に設定されている場合にのみ有効です。

    100
    ListPriceUnit

    string

    リスト価格の単位。このパラメーターは、isBillingItem が true に設定されている場合にのみ有効です。

    CNY
    NickName

    string

    インスタンスのニックネーム。

    test
    OwnerID

    string

    リソース所有者のアカウントの ID。このパラメーターは、マルチアカウント支払いシナリオで使用されます。

    123
    PipCode

    string

    プロダクトコード。ユーザーセンターの請求書に記載されているプロダクトコードと同じです。

    rds
    PretaxAmount

    number

    支払金額。

    0.1
    PretaxGrossAmount

    number

    元の金額。

    0.1
    ProductCode

    string

    プロダクトコード。

    rds
    ProductDetail

    string

    プロダクトの詳細。

    ApsaraDB RDS
    ProductName

    string

    プロダクト名。

    ApsaraDB RDS
    ProductType

    string

    プロダクトタイプ。

    rds
    Region

    string

    リージョン。

    Hangzhou
    ResourceGroup

    string

    リソースグループ。

    デフォルトリソースグループ
    ServicePeriod

    string

    サービスの持続時間。

    3600
    ServicePeriodUnit

    string

    サービスの持続時間の単位。

    Second
    SubscriptionType

    string

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

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

    • PayAsYouGo: 従量課金。

    PayAsYouGo
    Tag

    string

    リソースタグ。

    キー:testKey 値:testValue; キー:testKey1 値:testValues1
    Usage

    string

    使用量。

    説明

    このパラメーターは、isBillingItem が true に設定されている場合にのみ有効です。使用量データは、実際の購入量ではなく、期間内のすべての請求書にわたる合計使用量です。たとえば、1 GB のストレージが使用され、1 時間ごとに課金される場合、1 時間あたりの使用量は 1 GB であり、日次集計請求書の使用量は 1 GB × 24 = 24 GB になります。

    100
    UsageUnit

    string

    使用量の単位。このパラメーターは、isBillingItem が true に設定されている場合にのみ有効です。

    GB
    Zone

    string

    ゾーン。

    Hangzhou Zone 1
    MaxResults

    integer

    現在のリクエストに対して返されるレコードの最大値。

    20
    NextToken

    string

    現在の呼び出しでデータの読み取りを開始する位置。空の値は、すべてのデータが読み取られたことを示します。次の呼び出しでは、NextToken リクエストパラメーターにこの値を設定します。

    CAESEgoQCg4KCm
    TotalCount

    integer

    レコードの総数。

    20
    Message

    string

    エラーメッセージ。

    Successful!
    RequestId

    string

    リクエストの ID。

    79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
    Success

    boolean

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

    true

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "Success",
  "Data": {
    "AccountID": "122",
    "AccountName": "test@test.aliyunid.com",
    "BillingCycle": "2020-03",
    "Items": [
      {
        "AfterDiscountAmount": 0,
        "BillAccountID": "122",
        "BillAccountName": "test@test.aliyunid.com",
        "BillingDate": "2020-03-20",
        "BillingItem": "带宽",
        "BillingItemCode": "disk",
        "BillingType": "其它",
        "BizType": "trusteeship",
        "CommodityCode": "rds",
        "CostUnit": "未分配\t",
        "Currency": "CNY",
        "DeductedByCoupons": 0.1,
        "DeductedByResourcePackage": "0.1",
        "InstanceConfig": "CPU：12",
        "InstanceID": "i-dadada",
        "InstanceSpec": "ecs.sn1ne.3xlarge\t",
        "InternetIP": "34.xx.x.x\t",
        "IntranetIP": "192.xx.xx.xx",
        "InvoiceDiscount": 0.1,
        "Item": "PayAsYouGoBill",
        "ItemName": "iZ28bycvyb4Z",
        "ListPrice": "100",
        "ListPriceUnit": "元",
        "NickName": "test",
        "OwnerID": "123",
        "PipCode": "rds",
        "PretaxAmount": 0.1,
        "PretaxGrossAmount": 0.1,
        "ProductCode": "rds",
        "ProductDetail": "云数据库RDS\t",
        "ProductName": "云数据库RDS\t",
        "ProductType": "rds",
        "Region": "杭州",
        "ResourceGroup": "默认资源组\t",
        "ServicePeriod": "3600",
        "ServicePeriodUnit": "秒",
        "SubscriptionType": "PayAsYouGo",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Usage": "100",
        "UsageUnit": "GB",
        "Zone": "杭州1"
      }
    ],
    "MaxResults": 20,
    "NextToken": "CAESEgoQCg4KCm",
    "TotalCount": 20
  },
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true
}

    エラーコード

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

    変更履歴

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