QueryBill - Expenses and Costs

Menanyakan tagihan penyelesaian untuk suatu akun dalam siklus penagihan tertentu.

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

bss:DescribeBillList

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
BillingCycle	string	Yes	Siklus penagihan. Formatnya adalah YYYY-MM.	2018-07
Type	string	No	Tipe. Nilai yang valid: SubscriptionOrder PayAsYouGoBill Refund Adjustment	SubscriptionOrder
ProductCode	string	No	Kode produk.	rds
ProductType	string	No	Tipe produk.	rds
SubscriptionType	string	No	Tipe langganan. Nilai yang valid: Subscription PayAsYouGo Catatan Parameter ini harus digunakan bersama parameter ProductCode.	Subscription
IsHideZeroCharge	boolean	No	Menentukan apakah akan mengecualikan tagihan dengan jumlah bruto sebelum pajak (PretaxGrossAmount) sebesar 0. Nilai default-nya adalah false. Ini memastikan kompatibilitas mundur. true: Ya. false: Tidak.	true
PageNum	integer	No	Nomor halaman. Nilai default-nya adalah 1.	1
PageSize	integer	No	Jumlah entri per halaman. Nilai default: 20. Nilai maksimum: 300.	20
BillOwnerId	integer	No	ID akun yang memiliki resource. Ini adalah akun yang benar-benar menggunakan resource tersebut.	123

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status.	Success
Message	string	Pesan error.	Successful!
RequestId	string	ID permintaan.	AE3F4057-DFC9-4B81-8858-F620651010C9
Success	boolean	Menunjukkan apakah permintaan berhasil.	true
Data	object	Data yang dikembalikan.
PageNum	integer	Nomor halaman.	1
BillingCycle	string	Siklus penagihan dalam format YYYY-MM.	2020-02
AccountID	string	ID akun.	185xxxxx489
PageSize	integer	Jumlah entri per halaman.	1
TotalCount	integer	Jumlah total catatan.	20
AccountName	string	Akun.	test@test.aliyunid.com
Items	object
Item	array<object>	Detail tagihan.
	object
Status	string	Status pembayaran. Nilai yang valid: PayFinish: Telah dibayar PayUnclear: Belum lunas PayUnsettle: Belum diselesaikan NoSettle: Bebas penyelesaian	PayFinish
RoundDownDiscount	string	Jumlah diskon akibat pembulatan.	0
Item	string	Tipe tagihan: SubscriptionOrder PayAsYouGoBill Refund Adjustment	SubscriptionOrder
Currency	string	Mata uang. CNY USD JPY	CNY
UsageStartTime	string	Waktu mulai tagihan.	2020-03-11 07:00:00
SubscriptionType	string	Tipe langganan. Nilai yang valid: Subscription PayAsYouGo	PayAsYouGo
UsageEndTime	string	Waktu akhir tagihan.	2020-03-11 08:00:00
DeductedByCoupons	number	Jumlah yang dipotong menggunakan kupon.	0
SubOrderId	string	ID detail pesanan yang sesuai dengan tagihan.	325345254353
OutstandingAmount	number	Jumlah yang belum dibayar.	0
AfterTaxAmount	number
PaymentTime	string	Waktu pesanan dibayar.	2020-03-11 08:00:00
PretaxAmountLocal	number
Tax	number
PipCode	string	Kode produk.	rds
PaymentTransactionID	string
PretaxAmount	number	Jumlah yang harus dibayar.	100
CommodityCode	string	Kode komoditas.	rds
ProductName	string	Nama produk.	云数据库RDS
RecordID	string	Nomor pesanan atau nomor tagihan.	2020xxxx5912
AdjustAmount	number	Jumlah yang dipotong dari pengembalian kredit.	0
ProductDetail	string	Detail produk.	关系型数据库RDS（包月）
PaymentCurrency	string
OwnerID	string	AccountID dari RAM user. Ini berlaku untuk skenario di mana akun manajemen membayar untuk akun anggota.	3532535235
ProductType	string	Tipe produk.	rds
InvoiceDiscount	number	Jumlah diskon.	0
PaymentAmount	number	Pembayaran tunai, termasuk potongan dari pengembalian kredit.	0
PretaxGrossAmount	number	Jumlah asli.	0
CashAmount	number	Pembayaran tunai, tidak termasuk potongan dari pengembalian kredit.	0
ProductCode	string	Kode produk.	rds

Contoh

Respons sukses

JSONformat

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "AE3F4057-DFC9-4B81-8858-F620651010C9",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "BillingCycle": "2020-02",
    "AccountID": "185xxxxx489",
    "PageSize": 1,
    "TotalCount": 20,
    "AccountName": "test@test.aliyunid.com",
    "Items": {
      "Item": [
        {
          "Status": "PayFinish",
          "RoundDownDiscount": "0",
          "Item": "SubscriptionOrder",
          "Currency": "CNY",
          "UsageStartTime": "2020-03-11 07:00:00",
          "SubscriptionType": "PayAsYouGo",
          "UsageEndTime": "2020-03-11 08:00:00",
          "DeductedByCoupons": 0,
          "SubOrderId": "325345254353",
          "OutstandingAmount": 0,
          "AfterTaxAmount": 0,
          "PaymentTime": "2020-03-11 08:00:00",
          "PretaxAmountLocal": 0,
          "Tax": 0,
          "PipCode": "rds",
          "PaymentTransactionID": "",
          "PretaxAmount": 100,
          "CommodityCode": "rds",
          "ProductName": "云数据库RDS",
          "RecordID": "2020xxxx5912",
          "AdjustAmount": 0,
          "ProductDetail": "关系型数据库RDS（包月）",
          "PaymentCurrency": "",
          "OwnerID": "3532535235",
          "ProductType": "rds",
          "InvoiceDiscount": 0,
          "PaymentAmount": 0,
          "PretaxGrossAmount": 0,
          "CashAmount": 0,
          "ProductCode": "rds"
        }
      ]
    }
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.