All Products
Search

This Product

    Expenses and Costs:DescribeInstanceBill

    Document Center

    Expenses and Costs:DescribeInstanceBill

    Last Updated:Jun 10, 2026

    Mengkueri ringkasan konsumsi semua instance produk atau item yang dapat ditagih untuk sebuah akun dalam satu siklus penagihan.

    Deskripsi operasi

    • Data untuk bulan berjalan hanya bersifat referensi dan dapat disesuaikan selama bulan tersebut karena keterlambatan penagihan, pengembalian dana, penyesuaian, atau penghapusan untuk pembayaran yang terlambat. Tagihan final tersedia setelah pukul 12:00 pada hari ketiga bulan berikutnya.

    • Data tagihan untuk bulan berjalan tidak mencakup resource bayar sesuai pemakaian yang belum diselesaikan.

    • Anda dapat mengkueri data dari 18 bulan terakhir.

    • Data tagihan diperbarui dengan keterlambatan 24 jam dibandingkan dengan penggunaan aktual. Informasi terkait ID instance diperbarui dengan keterlambatan 48 jam. Ini termasuk konfigurasi instance, tipe instance, nickname instance, grup resource, alamat IP publik, alamat IP privat, dan zona.

    • Data tagihan tidak menyediakan biaya untuk masing-masing resource terlampir dari layanan seperti CDN, OSS, dan Internet Shared Bandwidth. Misalnya, biaya tidak disediakan untuk masing-masing nama domain, bucket, atau EIP. Untuk melihat biaya resource terlampir, buka halaman Split Bill.

    • Untuk produk Alibaba Cloud Communications, Anda hanya dapat mengkueri detail tagihan mulai Juni 2020. Untuk produk HiChina, termasuk Nama Domain dan merek dagang, Anda dapat mengkueri detail untuk tagihan mulai November 2020 dan seterusnya.

    • Setiap akun dapat melakukan hingga 10 kueri per detik. Jika terjadi error timeout, coba lagi.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    bssapi:DescribeInstanceBill

    get

    *All Resource

    *
    • bssapi:ProductCode
    • bssapi:ProductCode
    • bssapi:ProductType
    • bssapi:ProductType
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    BillingCycle

    string

    Yes

    Siklus penagihan dalam format YYYY-MM. Hanya siklus penagihan dalam 18 bulan terakhir yang didukung.

    2020-03
    ProductCode

    string

    No

    Kode produk.

    rds
    ProductType

    string

    No

    Tipe produk.

    rds
    SubscriptionType

    string

    No

    Tipe langganan. Nilai yang valid:

    • Subscription: langganan

    • PayAsYouGo: bayar sesuai pemakaian

    PayAsYouGo
    IsBillingItem

    boolean

    No

    Menentukan apakah akan menarik data berdasarkan dimensi item penagihan.

    • false (default): Data konsisten dengan halaman Instance Bill di bawah Expenses and Costs > Bills > Bill Details.

    • true: Data konsisten dengan halaman Billing Item Bill di bawah Expenses and Costs > Bills > Bill Details.

    false
    NextToken

    string

    No

    Token yang menentukan titik awal untuk membaca data. Biarkan parameter ini kosong untuk membaca halaman pertama hasil. Untuk membaca halaman berikutnya, atur parameter ini ke nilai NextToken yang dikembalikan pada respons sebelumnya. Nilai lain akan menyebabkan kesalahan.

    CAESEgoQCg4KCm
    MaxResults

    integer

    No

    Jumlah maksimum catatan data yang dikembalikan. Nilai default: 20. Nilai maksimum: 300.

    20
    IsHideZeroCharge

    boolean

    No

    Menentukan apakah akan mengecualikan tagihan di mana PretaxGrossAmount dan PretaxAmount keduanya bernilai 0.

    • false

    • true

    false
    BillingDate

    string

    No

    Tanggal tagihan. Parameter ini diperlukan hanya jika Granularity diatur ke DAILY. Formatnya adalah YYYY-MM-DD.

    Catatan

    Bulan BillingDate harus sesuai dengan bulan BillingCycle. Misalnya, jika BillingCycle adalah 2020-03, BillingDate harus dalam format 2020-03-DD. Jika bulan tidak cocok, kueri akan mengembalikan hasil berdasarkan pengaturan BillingCycle.

    2020-03-02
    Granularity

    string

    No

    Granularitas tagihan yang akan dikueri. Nilai yang valid:

    • MONTHLY: Bulanan. Ini sesuai dengan tagihan pada tab Bills by Billing Cycle di halaman Bill Details.

    • DAILY: Harian. Ini sesuai dengan tagihan pada tab Bills by Day di halaman Bill Details.

    Catatan

    Tentukan BillingDate jika Anda memilih DAILY.

    MONTHLY
    BillOwnerId

    integer

    No

    ID akun kepemilikan resource. Ini adalah akun yang sebenarnya menggunakan resource tersebut.

    122
    InstanceID

    string

    No

    ID instance.

    abc
    PipCode

    string

    No

    Kode produk. Ini sama dengan kode produk pada tagihan di User Center.

    rds

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Code

    string

    Kode status.

    Success
    Message

    string

    Pesan kesalahan.

    Successful!
    RequestId

    string

    ID permintaan.

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

    boolean

    Menunjukkan apakah permintaan berhasil.

    true
    Data

    object

    Data yang dikembalikan.

    NextToken

    string

    Token yang menandai posisi untuk kueri berikutnya. Nilai kosong menunjukkan bahwa semua data telah dibaca. Untuk melanjutkan kueri, atur parameter permintaan NextToken ke nilai ini pada panggilan berikutnya.

    CAESEgoQCg4KCm
    BillingCycle

    string

    Tanggal penagihan. Format: YYYY-MM.

    2020-03
    MaxResults

    integer

    Jumlah maksimum catatan yang dikembalikan per halaman.

    20
    AccountID

    string

    ID akun.

    122
    TotalCount

    integer

    Jumlah total catatan.

    20
    AccountName

    string

    Akun pengguna.

    test@test.aliyunid.com
    Items

    array<object>

    Detail tagihan.

    object

    BillingDate

    string

    The billing date is in YYYY-MM-DD format. This parameter has a value only when Granularity is set to DAILY.

    2020-03-20
    InstanceConfig

    string

    The detailed configuration of the instance.

    CPU：12
    InternetIP

    string

    The public IP address.

    34.xx.x.x

    Item

    string

    The bill type:

    • SubscriptionOrder: A prepaid order.

    • PayAsYouGoBill: A postpaid bill.

    • Refund: A refund.

    • Adjustment: An adjustment.

    PayAsYouGoBill
    Tag

    string

    The tag of the resource.

    key:testKey value:testValue; key:testKey1 value:testValues1
    InstanceID

    string

    The instance ID.

    i-dadada
    Currency

    string

    The currency. Valid values:

    • CNY

    • USD

    • JPY

    CNY
    BillAccountName

    string

    The name of the account associated with the bill.

    test@test.aliyunid.com
    DeductedByCashCoupons

    number

    代金券抵扣。

    0.1
    SubscriptionType

    string

    The subscription type. Valid values:

    • Subscription: Subscription.

    • PayAsYouGo: Pay-as-you-go.

    PayAsYouGo
    BizType

    string

    The service type.

    trusteeship
    InstanceSpec

    string

    The instance type.

    ecs.sn1ne.3xlarge

    DeductedByCoupons

    number

    The amount deducted by coupons.

    0.1
    BillingItem

    string

    The billing item. This property has a value only when IsBillingItem is true.

    带宽
    BillingItemCode

    string

    The billing item code.

    disk
    Region

    string

    The region.

    杭州
    OutstandingAmount

    number

    未结清金额。

    0.1
    CostUnit

    string

    The cost center.

    未分配

    ListPriceUnit

    string

    The unit of the list price. This parameter is valid only when isBillingItem is true.

    元
    ResourceGroup

    string

    The resource group.

    默认资源组

    PipCode

    string

    The product code. It is the same as the product code on the bill in the User Center.

    rds
    ServicePeriodUnit

    string

    The unit of the service period.

    秒
    PretaxAmount

    number

    The pretax amount.

    0.1
    CommodityCode

    string

    The product code. This is the same as the product detail code in the User Center.

    rds
    ProductName

    string

    The name of the product.

    云数据库RDS

    AdjustAmount

    number

    信用额度退款抵扣。

    0
    NickName

    string

    The nickname of the instance.

    test
    ProductDetail

    string

    The details of the product.

    云数据库RDS

    Usage

    string

    The usage.

    Catatan

    This parameter is valid only when isBillingItem is set to true. The usage data is the total usage from all bills in an epoch, not the actual purchased amount. For example, if you use 1 GB of storage and a bill is generated every hour, the hourly usage is 1 GB. The daily usage on the bill is 1 GB × 24 = 24 GB.

    100
    IntranetIP

    string

    The internal IP address.

    192.xx.xx.xx
    OwnerID

    string

    The Account ID of the resource owner in a multi-account payment scenario.

    123
    DeductedByPrepaidCard

    number

    储值卡抵扣。

    0.1
    UsageUnit

    string

    The usage unit. This parameter is valid only when isBillingItem is true.

    GB
    BillAccountID

    string

    The ID of the account to which the bill belongs.

    122
    PaymentAmount

    number

    现金支付（含信用额度退款抵扣）。

    0.1
    InvoiceDiscount

    number

    The discount amount.

    0.1
    DeductedByResourcePackage

    string

    The amount deducted by the resource plan. This parameter is valid only when isBillingItem is true.

    0.1
    ProductType

    string

    The product type.

    rds
    ServicePeriod

    string

    The service period.

    3600
    Zone

    string

    The zone.

    杭州1
    ListPrice

    string

    The list price. This is valid only when isBillingItem is true.

    100
    PretaxGrossAmount

    number

    The original amount.

    0.1
    CashAmount

    number

    现金支付（不包含信用额度退款抵扣）。

    0
    ProductCode

    string

    The product code.

    rds
    BillingType

    string

    The billing method.

    其它
    ItemName

    string

    The name of the project.

    iZ28bycvyb4Z
    AfterDiscountAmount

    number

    The amount after a discount is applied. This amount includes the payable amount after coupon deductions. The formula is: Discounted amount = List price - Discount amount.

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.