All Products
Search

This Product

    Expenses and Costs:DescribeInstanceBill

    Document Center

    Expenses and Costs:DescribeInstanceBill

    Last Updated:Sep 17, 2026

    Mengkueri ringkasan konsumsi semua instans produk atau item yang dapat ditagih untuk pengguna dalam siklus penagihan tertentu.

    Deskripsi operasi

    • Hasil kueri untuk bulan berjalan hanya untuk referensi dan tidak dapat digunakan untuk rekonsiliasi. Tagihan final untuk bulan berjalan tersedia untuk dilihat atau diekspor setelah pengatur waktu 12:00 pada tanggal 3 bulan berikutnya. Selama bulan berjalan, beberapa skenario dapat terjadi, termasuk namun tidak terbatas pada penagihan tertunda, pengembalian dana, penyesuaian tagihan, dan penghapusan pembayaran tertunda.

    • Data tagihan untuk bulan berjalan tidak mencakup data pay-as-you-go yang belum diselesaikan (belum ditagih atau masih terakumulasi).

    • Data 18 bulan terakhir didukung.

    • Data tagihan diperbarui dengan penundaan 24 jam relatif terhadap konsumsi biaya aktual. Informasi terkait ID instans (konfigurasi instans, tipe instans, nama panggilan instans, kelompok sumber daya, alamat IP publik, alamat IP privat, dan zona) diperbarui dengan penundaan 48 jam.

    • Data tagihan tidak menyediakan biaya spesifik dari masing-masing resource yang dilampirkan (seperti nama domain, bucket, dan EIP) untuk layanan cloud tipe resource yang dilampirkan (seperti CDN, OSS, dan Internet Shared Bandwidth). Untuk mendapatkan data yang mencakup resource yang dilampirkan, gunakan tagihan pemisahan.

    • Untuk produk Cloud Communications, hanya data detail dari Juni 2020 dan seterusnya yang dapat dikueri. Untuk produk Wanwang (termasuk nama domain dan merek dagang), hanya data detail dari November 2020 dan seterusnya yang dapat dikueri.

    • Batas laju untuk satu pengguna adalah 10 kueri per detik. Jika terjadi timeout, ulangi permintaan.

    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

    *Semua sumber daya.

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

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    BillingCycle

    string

    Yes

    Siklus Tagihan dalam format YYYY-MM. Hanya siklus Tagihan 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 valid:

    • Subscription: Langganan.

    • PayAsYouGo: Pay-as-you-go.

    PayAsYouGo
    IsBillingItem

    boolean

    No

    Apakah akan mengkueri data berdasarkan item yang dapat ditagih.

    • false (default): Data konsisten dengan tagihan instans di Biaya dan Biaya > Tagihan > Detail Tagihan.

    • true: Data konsisten dengan tagihan item yang dapat ditagih di Biaya dan Biaya > Tagihan > Detail Tagihan.

    false
    NextToken

    string

    No

    Token yang menunjukkan posisi dari mana pemanggilan saat ini mulai membaca data. Nilai parameter ini harus kosong atau nilai NextToken yang dikembalikan dalam pemanggilan sebelumnya. Jika tidak, error akan dikembalikan. Nilai kosong menunjukkan pembacaan dari awal.

    CAESEgoQCg4KCm
    MaxResults

    integer

    No

    Jumlah maksimum rekaman data yang akan dibaca dalam permintaan saat ini. Nilai default: 20. Nilai maksimum: 300.

    20
    IsHideZeroCharge

    boolean

    No

    Apakah akan memfilter rekaman di mana harga asli (PretaxGrossAmount) dan jumlah yang harus dibayar (PretaxAmount) keduanya 0. Nilai valid:

    • false.

    • true.

    false
    BillingDate

    string

    No

    Tanggal Tagihan. Parameter ini hanya diperlukan ketika Granularity diatur ke DAILY. Format: YYYY-MM-DD.

    Catatan

    Bulan dalam nilai parameter BillingDate harus konsisten dengan nilai parameter BillingCycle. Misalnya, jika BillingCycle diatur ke 2020-03, BillingDate harus diatur ke 2020-03-DD. Jika bulan tidak konsisten, hasil kueri dikembalikan berdasarkan pengatur waktu yang ditentukan oleh BillingCycle.

    2020-03-02
    Granularity

    string

    No

    Granularitas kueri tagihan. Nilai valid:

    • MONTHLY: Bulanan. Data konsisten dengan tagihan siklus penagihan di Biaya dan Biaya > Tagihan > Detail Tagihan.

    • DAILY: Harian. Data konsisten dengan tagihan harian di Biaya dan Biaya > Tagihan > Detail Tagihan.

    Catatan

    Jika Anda mengatur parameter ini ke DAILY, Anda juga harus menentukan BillingDate.

    MONTHLY
    BillOwnerId

    integer

    No

    ID akun kepemilikan Sumber daya. Akun kepemilikan Sumber daya adalah akun yang sebenarnya menggunakan Sumber daya.

    122
    InstanceID

    string

    No

    ID instans.

    abc
    PipCode

    string

    No

    Kode produk, yang konsisten dengan kode produk di tagihan Pusat Pengguna.

    rds

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Code

    string

    Kode status.

    Success
    Data

    object

    Data yang dikembalikan.

    AccountID

    string

    ID akun.

    122
    AccountName

    string

    Nama pengguna.

    test@test.aliyunid.com
    BillingCycle

    string

    Tanggal Tagihan dalam format YYYY-MM.

    2020-03
    Items

    array<object>

    Detail tagihan.

    object

    AfterDiscountAmount

    number

    Jumlah setelah diskon. Jumlah ini mencakup jumlah yang harus dibayar setelah pengurangan kupon. Aturan perhitungan: Jumlah setelah diskon = Harga daftar - Jumlah diskon.

    BillAccountID

    string

    ID akun tempat tagihan berada.

    122
    BillAccountName

    string

    Nama akun tempat tagihan berada.

    test@test.aliyunid.com
    BillingDate

    string

    Tanggal Tagihan. Parameter ini memiliki nilai hanya ketika Granularity diatur ke DAILY. Format: YYYY-MM-DD.

    2020-03-20
    BillingItem

    string

    Item Tagihan. Parameter ini memiliki nilai hanya ketika IsBillingItem diatur ke true.

    Bandwidth
    BillingItemCode

    string

    Kode item Tagihan.

    disk
    BillingType

    string

    Metode Tagihan.

    Other
    BizType

    string

    Tipe bisnis.

    trusteeship
    CommodityCode

    string

    Kode komoditas, yang sama dengan kode detail produk di Pusat Pengguna.

    rds
    CostUnit

    string

    Pusat biaya.

    Unallocated
    Currency

    string

    Mata uang. Nilai valid:

    • CNY

    • USD

    • JPY

    CNY
    DeductedByCoupons

    number

    Jumlah yang dikurangkan menggunakan kupon.

    0.1
    DeductedByResourcePackage

    string

    Jumlah yang dikurangkan menggunakan paket Sumber daya. Parameter ini hanya valid ketika isBillingItem diatur ke true.

    0.1
    InstanceConfig

    string

    Konfigurasi detail instans.

    CPU：12
    InstanceID

    string

    ID instans.

    i-dadada
    InstanceSpec

    string

    Tipe instans.

    ecs.sn1ne.3xlarge
    InternetIP

    string

    Alamat IP publik.

    34.xx.x.x

    IntranetIP

    string

    Alamat IP internal.

    192.xx.xx.xx
    InvoiceDiscount

    number

    Jumlah diskon.

    0.1
    Item

    string

    Tipe tagihan. Nilai valid:

    • SubscriptionOrder: Pesanan langganan.

    • PayAsYouGoBill: Tagihan pay-as-you-go.

    • Refund: Pengembalian dana.

    • Adjustment: Penyesuaian.

    PayAsYouGoBill
    ItemName

    string

    Nama item.

    iZ28bycvyb4Z
    ListPrice

    string

    Harga satuan. Parameter ini hanya valid ketika isBillingItem diatur ke true.

    100
    ListPriceUnit

    string

    Unit harga satuan. Parameter ini hanya valid ketika isBillingItem diatur ke true.

    CNY
    NickName

    string

    Nama panggilan instans.

    test
    OwnerID

    string

    ID akun pemilik Sumber daya. Parameter ini digunakan dalam skenario pembayaran multi-akun.

    123
    PipCode

    string

    Kode produk, yang sama dengan kode produk pada tagihan di Pusat Pengguna.

    rds
    PretaxAmount

    number

    Jumlah yang harus dibayar.

    0.1
    PretaxGrossAmount

    number

    Jumlah asli.

    0.1
    ProductCode

    string

    Kode produk.

    rds
    ProductDetail

    string

    Detail produk.

    ApsaraDB RDS
    ProductName

    string

    Nama produk.

    ApsaraDB RDS
    ProductType

    string

    Tipe produk.

    rds
    Region

    string

    Wilayah.

    Hangzhou
    ResourceGroup

    string

    Kelompok sumber daya.

    Kelompok sumber daya default
    ServicePeriod

    string

    Durasi layanan.

    3600
    ServicePeriodUnit

    string

    Unit durasi layanan.

    Second
    SubscriptionType

    string

    Tipe langganan. Nilai valid:

    • Subscription: Langganan.

    • PayAsYouGo: Pay-as-you-go.

    PayAsYouGo
    Tag

    string

    Tag Sumber daya.

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

    string

    Penggunaan.

    Catatan

    Parameter ini hanya valid ketika isBillingItem diatur ke true. Data penggunaan adalah total penggunaan di seluruh tagihan dalam periode tersebut, bukan jumlah pembelian aktual. Misalnya, jika 1 GB penyimpanan digunakan dan ditagih per jam, penggunaan per jam adalah 1 GB, dan penggunaan tagihan teragregasi harian adalah 1 GB × 24 = 24 GB.

    100
    UsageUnit

    string

    Unit penggunaan. Parameter ini hanya valid ketika isBillingItem diatur ke true.

    GB
    Zone

    string

    Zona.

    Zona 1 Hangzhou
    MaxResults

    integer

    Jumlah maksimum rekaman yang dikembalikan untuk permintaan saat ini.

    20
    NextToken

    string

    Posisi dari mana pemanggilan saat ini mulai membaca data. Nilai kosong menunjukkan bahwa semua data telah dibaca. Untuk pemanggilan berikutnya, atur parameter permintaan NextToken ke nilai ini.

    CAESEgoQCg4KCm
    TotalCount

    integer

    Jumlah total rekaman.

    20
    Message

    string

    Paket error.

    Berhasil!
    RequestId

    string

    ID permintaan.

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

    boolean

    Apakah permintaan berhasil.

    true

    Contoh

    Respons sukses

    JSONformat

    {
  "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
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.