DescribeSplitItemBill - Expenses and Costs

Menampilkan tagihan terpisah.

Deskripsi operasi

Data tagihan terpisah untuk bulan berjalan hanya bersifat referensi dan tidak dapat digunakan untuk rekonsiliasi. Tagihan akhir untuk bulan berjalan tersedia setelah pukul 12.00 (UTC+8) pada hari keempat bulan berikutnya. Data ini tidak mencakup biaya bayar sesuai penggunaan yang belum diselesaikan.
Anda dapat mengakses data tagihan terpisah hingga 12 bulan terakhir.
Data tagihan terpisah diperbarui dengan keterlambatan 48 jam dari konsumsi resource aktual. Untuk produk yang mendukung penagihan terpisah, seperti CDN, OSS, dan Internet Shared Bandwidth, biaya item yang dapat ditagih masing-masing—seperti nama domain, bucket, dan EIP—diperbarui dengan keterlambatan 72 jam.
Data tagihan terpisah hanya tersedia setelah Anda mengaktifkan fitur split bill di halaman Split Bill di Konsol. Data akan tersedia dalam waktu 24 jam setelah aktivasi fitur tersebut.
Satu pengguna dapat melakukan maksimal 10 permintaan per detik (QPS). Jika terjadi error timeout, ulangi permintaan tersebut.

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:DescribeSplitItemBill

get

*All Resource

*

bssapi:ProductCode
bssapi:ProductType

None

Parameter permintaan

Parameter	Type	Required	Description	Example
BillingCycle	string	Yes	Siklus penagihan. Format: YYYY-MM.	2020-03
ProductCode	string	No	Kode produk.	rds
ProductType	string	No	Tipe produk.	rds
SubscriptionType	string	No	Metode penagihan. Nilai yang valid: Subscription: subscription. PayAsYouGo: pay-as-you-go. Catatan Parameter ini harus digunakan bersama parameter ProductCode.	PayAsYouGo
NextToken	string	No	Token yang digunakan untuk mengambil halaman hasil berikutnya. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Nilainya adalah nilai NextToken yang dikembalikan dalam panggilan API sebelumnya. Jika nilai ditentukan, kueri baru dimulai dari halaman berikutnya. Jika Anda membiarkan parameter ini kosong, kueri dimulai dari awal.	CAESEgoQCg4KCmd
MaxResults	integer	No	Jumlah maksimum entri yang dikembalikan. Nilai default: 20. Nilai maksimum: 300.	20
BillOwnerId	integer	No	ID akun yang memiliki resource. Akun yang memiliki resource adalah akun yang benar-benar menggunakan resource tersebut.	123
InstanceID	string	No	ID instans.	i-kjhdskjgshfdlkjfdh
SplitItemID	string	No	ID item terpisah.	i-kjhdskjgshfdlkjfdh
Granularity	string	No	Granularitas untuk menanyakan tagihan. Nilai yang valid: MONTHLY: menanyakan tagihan per bulan. Datanya konsisten dengan data pada tab Siklus Penagihan di halaman Split Bill di Pusat Pengguna. DAILY: menanyakan tagihan per hari. Datanya konsisten dengan data pada tab Per Hari di halaman Split Bill di Pusat Pengguna. Catatan Jika Anda mengatur parameter ini ke DAILY, Anda harus menentukan parameter BillingDate.	Monthly
BillingDate	string	No	Tanggal penagihan. Parameter ini hanya diperlukan ketika parameter Granularity diatur ke DAILY. Format: YYYY-MM-DD.	2020-03-02
TagFilter	array<object>	No	Filter tag. Anda dapat menentukan beberapa nilai tag untuk parameter TagValues. Hubungan antara beberapa nilai tag adalah OR.
	object	No	Filter tag.
TagValues	array	No	Nilai tag. Daftar string. TagValues.N dapat berisi 1 hingga 20 karakter, dan panjangnya 1 hingga 128 karakter. Jika Anda menentukan parameter TagValues.N, Anda juga harus menentukan TagFilter.N.TagKey. Jika tidak, error InvalidParameter.TagValues akan dilaporkan. Jika Anda menentukan beberapa nilai tag, tagihan yang sesuai dengan salah satu nilai tag tersebut akan ditanyakan.	TestValue
	string	No	Nilai tag.	TestValue
TagKey	string	No	Menentukan kunci tag untuk memfilter alokasi biaya atau data penagihan. Rentang valid untuk N: 1 hingga 20 (Anda dapat menentukan hingga 20 filter tag). Panjang: 1 hingga 128 karakter. Perilaku: Jika Anda hanya menentukan TagKey (tanpa TagValue), sistem akan mengembalikan tagihan untuk semua resource yang memiliki kunci tag tersebut (terlepas dari nilainya). Jika Anda menentukan beberapa pasangan TagKey+TagValue, sistem menggunakan logika OR: tagihan dikembalikan jika salah satu pasangan kunci-nilai cocok. Data penagihan mencerminkan tag yang ada selama periode penagihan. Jika tag dihapus atau diubah, tagihan sebelumnya tidak dievaluasi ulang.	TestKey
IsHideZeroCharge	boolean	No	Menentukan apakah akan menyaring tagihan yang nilai PretaxGrossAmount dan PretaxAmount-nya sama-sama 0. Nilai yang valid: false true	false
PipCode	string	No	Kode produk. Kode ini konsisten dengan kode produk pada tagihan di Pusat Pengguna.	rds

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status.	Success
Message	string	Pesan error.	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 digunakan untuk mengambil halaman hasil berikutnya. Jika parameter ini kosong, semua hasil telah dikembalikan. Untuk kueri berikutnya, gunakan nilai parameter ini sebagai parameter permintaan NextToken.	CAESEgoQCg4K
BillingCycle	string	Siklus penagihan. Format: YYYY-MM.	2020-03
MaxResults	integer	Jumlah maksimum entri yang dikembalikan untuk permintaan saat ini.	20
AccountID	string	ID akun.	185xxxx3489
TotalCount	integer	Jumlah total entri.	20
AccountName	string	Nama akun.	test@test.aliyunid.com
Items	array<object>	Detail tagihan.
	object
SplitAccountID	string	ID akun tempat item terpisah tersebut berada.	12**122
BillAccountName	string	Nama akun tempat tagihan tersebut berada.	test@test.aliyunid.com
SubscriptionType	string	Metode penagihan. Nilai yang valid: Subscription: subscription. PayAsYouGo: pay-as-you-go.	PayAsYouGo
InstanceSpec	string	Tipe instans.	ecs.sn1ne.3xlarge
DeductedByCoupons	number	Jumlah yang dikurangkan dengan kupon.	0
Region	string	Wilayah.	杭州
PipCode	string	Kode produk. Kode ini konsisten dengan kode produk pada tagihan di Pusat Pengguna.	rds
CommodityCode	string	Kode komoditas. Kode ini konsisten dengan kode detail produk di Pusat Pengguna.	rds
NickName	string	Nama panggilan instans.	nick
ProductDetail	string	Detail produk.	云数据库RDS
Usage	string	Penggunaan.	100
IntranetIP	string	Alamat IP pribadi.	192.xx.xx.xx
UsageUnit	string	Unit penggunaan.	GB
SplitCommodityCode	string	Kode komoditas item terpisah.	rds
BillAccountID	string	ID akun tempat tagihan tersebut berada.	185xxxx3489
ProductType	string	Tipe produk.	rds
DeductedByResourcePackage	string	Jumlah yang dikurangkan dengan paket sumber daya.	0
SplitBillingCycle	string	Bulan tagihan terpisah.	2021-06
ServicePeriod	string	Durasi layanan.	20
SplitItemName	string	Nama item terpisah.	iZ28bycvyb4Z
ListPrice	string	Harga satuan.	0.12
Zone	string	Zona.	华北1
PretaxGrossAmount	number	Jumlah bruto sebelum pajak.	0
InstanceConfig	string	Detail konfigurasi instans.	CPU:12
BillingDate	string	Tanggal penagihan. Format: YYYY-MM-DD. Parameter ini tidak didukung.	2020-01-20
InternetIP	string	Alamat IP publik.	34.xx.x.x
Item	string	Tipe tagihan. Nilai yang valid: SubscriptionOrder: pesanan subscription. PayAsYouGoBill: tagihan pay-as-you-go. Refund: pengembalian dana. Adjustment: penyesuaian.	PayAsYouGoBill
SplitItemID	string	ID item terpisah.	i-28bycvyb4
InstanceID	string	ID instans.	i-kjhdskjgshfdlkjfdh
Tag	string	Tag resource. Jika tag resource diubah, tagihan yang dihasilkan untuk resource tersebut selama siklus hidup tag tersebut akan mencakup tag tersebut.	key:testKey value:testValue; key:testKey1 value:testValues1
Currency	string	Mata uang. Nilai yang valid: CNY USD JPY	CNY
BizType	string	Tipe bisnis.	trusteeship
BillingItem	string	Item yang dapat ditagih.	带宽
BillingItemCode	string	Kode item yang dapat ditagih.	disk
CostUnit	string	Pusat biaya.	未分配
ListPriceUnit	string	Unit harga satuan.	元/GB
ResourceGroup	string	Kelompok sumber daya.	默认资源组
PretaxAmount	number	Jumlah sebelum pajak.	0
ServicePeriodUnit	string	Unit durasi layanan.	小时
SplitBillingDate	string	Hari tagihan terpisah.	2021-06-01
ProductName	string	Nama produk.	云数据库RDS
SplitProductDetail	string	Nama detail produk item terpisah.	云数据库
OwnerID	string	ID akun yang memiliki resource. Parameter ini dikembalikan dalam skenario pembayaran multi-akun.	169***013
InvoiceDiscount	number	Diskon.	0
SplitAccountName	string	Nama akun tempat item terpisah tersebut berada.	test**1122
BillingType	string	Metode penagihan.	其它
ProductCode	string	Kode produk.	rds
ItemName	string	Nama item.	iZ28bycvyb4Z
AfterDiscountAmount	number	Jumlah setelah diskon. Ini adalah jumlah yang harus dibayar setelah diskon diterapkan. Rumus: Jumlah setelah diskon = Harga daftar - Diskon.

Contoh

Respons sukses

JSONformat

{
  "Code": "Success",
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true,
  "Data": {
    "NextToken": "CAESEgoQCg4K",
    "BillingCycle": "2020-03",
    "MaxResults": 20,
    "AccountID": "185xxxx3489",
    "TotalCount": 20,
    "AccountName": "test@test.aliyunid.com",
    "Items": [
      {
        "SplitAccountID": "12**122",
        "BillAccountName": "test@test.aliyunid.com",
        "SubscriptionType": "PayAsYouGo",
        "InstanceSpec": "ecs.sn1ne.3xlarge",
        "DeductedByCoupons": 0,
        "Region": "杭州",
        "PipCode": "rds",
        "CommodityCode": "rds",
        "NickName": "nick",
        "ProductDetail": "云数据库RDS",
        "Usage": "100",
        "IntranetIP": "192.xx.xx.xx",
        "UsageUnit": "GB",
        "SplitCommodityCode": "rds",
        "BillAccountID": "185xxxx3489",
        "ProductType": "rds",
        "DeductedByResourcePackage": "0",
        "SplitBillingCycle": "2021-06",
        "ServicePeriod": "20",
        "SplitItemName": "iZ28bycvyb4Z",
        "ListPrice": "0.12",
        "Zone": "华北1",
        "PretaxGrossAmount": 0,
        "InstanceConfig": "CPU:12",
        "BillingDate": "2020-01-20",
        "InternetIP": "34.xx.x.x",
        "Item": "PayAsYouGoBill",
        "SplitItemID": "i-28bycvyb4",
        "InstanceID": "i-kjhdskjgshfdlkjfdh",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Currency": "CNY",
        "BizType": "trusteeship",
        "BillingItem": "带宽",
        "BillingItemCode": "disk",
        "CostUnit": "未分配",
        "ListPriceUnit": "元/GB",
        "ResourceGroup": "默认资源组",
        "PretaxAmount": 0,
        "ServicePeriodUnit": "小时",
        "SplitBillingDate": "2021-06-01",
        "ProductName": "云数据库RDS",
        "SplitProductDetail": "云数据库",
        "OwnerID": "169***013",
        "InvoiceDiscount": 0,
        "SplitAccountName": "test**1122",
        "BillingType": "其它",
        "ProductCode": "rds",
        "ItemName": "iZ28bycvyb4Z",
        "AfterDiscountAmount": 0
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.