DescribeInstanceBill - Expenses and Costs

Mengambil ringkasan konsumsi semua instans produk atau item yang dapat ditagih untuk suatu akun dalam satu siklus penagihan.

Deskripsi operasi

Data untuk bulan berjalan bersifat referensi dan dapat berubah selama bulan tersebut karena penagihan yang tertunda, pengembalian dana, penyesuaian, atau penghapusan piutang atas pembayaran tertunda. Tagihan akhir tersedia setelah pukul 12.00 pada hari ketiga bulan berikutnya.
Data tagihan untuk bulan berjalan tidak mencakup resource pay-as-you-go yang belum diselesaikan.
Anda dapat mengambil data hingga 18 bulan ke belakang.
Data tagihan diperbarui dengan keterlambatan 24 jam dari penggunaan aktual. Informasi terkait ID instans diperbarui dengan keterlambatan 48 jam, termasuk konfigurasi instans, tipe instans, nama panggilan instans, kelompok sumber daya, alamat IP publik, alamat IP pribadi, dan zona.
Data tagihan tidak menyediakan biaya untuk masing-masing resource yang dilampirkan 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 yang dilampirkan, buka halaman Split Bill.
Untuk produk Alibaba Cloud Communications, Anda hanya dapat mengambil detail tagihan mulai Juni 2020. Untuk produk HiChina, termasuk Domain Names dan merek dagang, Anda dapat mengambil detail tagihan mulai November 2020.
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: subscription PayAsYouGo: pay-as-you-go	PayAsYouGo
IsBillingItem	boolean	No	Menentukan apakah akan menarik data berdasarkan dimensi item penagihan. false (default): Data konsisten dengan halaman Instance Bill di bawah Biaya dan Pengeluaran > Tagihan > Detail Tagihan. true: Data konsisten dengan halaman Billing Item Bill di bawah Biaya dan Pengeluaran > Tagihan > Detail Tagihan.	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 dalam respons sebelumnya. Nilai lainnya akan menyebabkan error.	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 wajib hanya jika Granularity diatur ke DAILY. Formatnya adalah YYYY-MM-DD. Catatan Bulan pada BillingDate harus sesuai dengan bulan pada BillingCycle. Misalnya, jika BillingCycle adalah 2020-03, maka BillingDate harus dalam format 2020-03-DD. Jika bulannya tidak sesuai, kueri akan mengembalikan hasil berdasarkan pengaturan BillingCycle.	2020-03-02
Granularity	string	No	Granularitas tagihan yang akan ditanyakan. Nilai yang valid: MONTHLY: Bulanan. Ini sesuai dengan tagihan pada tab Bills by Billing Cycle di halaman Detail Tagihan. DAILY: Harian. Ini sesuai dengan tagihan pada tab Bills by Day di halaman Detail Tagihan. Catatan Tentukan BillingDate jika Anda memilih DAILY.	MONTHLY
BillOwnerId	integer	No	ID akun kepemilikan resource. Ini adalah akun yang benar-benar menggunakan resource tersebut.	122
InstanceID	string	No	ID instans.	abc
PipCode	string	No	Kode produk. Ini sama 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 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	Tanggal penagihan dalam format YYYY-MM-DD. Parameter ini memiliki nilai hanya jika Granularity diatur ke DAILY.	2020-03-20
InstanceConfig	string	Konfigurasi detail instans.	CPU：12
InternetIP	string	Alamat IP publik.	34.xx.x.x
Item	string	Tipe tagihan: SubscriptionOrder: Pesanan prabayar. PayAsYouGoBill: Tagihan pascabayar. Refund: Pengembalian dana. Adjustment: Penyesuaian.	PayAsYouGoBill
Tag	string	Tag resource.	key:testKey value:testValue; key:testKey1 value:testValues1
InstanceID	string	ID instans.	i-dadada
Currency	string	Mata uang. Nilai yang valid: CNY USD JPY	CNY
BillAccountName	string	Nama akun yang terkait dengan tagihan.	test@test.aliyunid.com
SubscriptionType	string	Tipe langganan. Nilai yang valid: Subscription: Subscription. PayAsYouGo: Pay-as-you-go.	PayAsYouGo
BizType	string	Tipe layanan.	trusteeship
InstanceSpec	string	Tipe instans.	ecs.sn1ne.3xlarge
DeductedByCoupons	number	Jumlah yang dipotong oleh kupon.	0.1
BillingItem	string	Item penagihan. Properti ini memiliki nilai hanya jika IsBillingItem bernilai true.	带宽
BillingItemCode	string	Kode item penagihan.	disk
Region	string	Wilayah.	杭州
CostUnit	string	Pusat biaya.	未分配
ListPriceUnit	string	Unit harga daftar. Parameter ini hanya berlaku jika isBillingItem bernilai true.	元
ResourceGroup	string	Kelompok sumber daya.	默认资源组
PipCode	string	Kode produk. Sama dengan kode produk pada tagihan di Pusat Pengguna.	rds
ServicePeriodUnit	string	Unit periode layanan.	秒
PretaxAmount	number	Jumlah sebelum pajak.	0.1
CommodityCode	string	Kode produk. Sama dengan kode detail produk di Pusat Pengguna.	rds
ProductName	string	Nama produk.	云数据库RDS
NickName	string	Nama panggilan instans.	test
ProductDetail	string	Detail produk.	云数据库RDS
Usage	string	Penggunaan. Catatan Parameter ini hanya berlaku jika isBillingItem diatur ke true. Data penggunaan adalah total penggunaan dari semua tagihan dalam satu epoch, bukan jumlah yang benar-benar dibeli. Misalnya, jika Anda menggunakan 1 GB penyimpanan dan tagihan dihasilkan setiap jam, penggunaan per jam adalah 1 GB. Penggunaan harian pada tagihan adalah 1 GB × 24 = 24 GB.	100
IntranetIP	string	Alamat IP internal.	192.xx.xx.xx
OwnerID	string	ID Akun pemilik resource dalam skenario pembayaran multi-akun.	123
UsageUnit	string	Unit penggunaan. Parameter ini hanya berlaku jika isBillingItem bernilai true.	GB
BillAccountID	string	ID akun tempat tagihan tersebut terdaftar.	122
InvoiceDiscount	number	Jumlah diskon.	0.1
DeductedByResourcePackage	string	Jumlah yang dipotong oleh paket sumber daya. Parameter ini hanya berlaku jika isBillingItem bernilai true.	0.1
ProductType	string	Tipe produk.	rds
ServicePeriod	string	Periode layanan.	3600
Zone	string	Zona.	杭州1
ListPrice	string	Harga daftar. Ini hanya berlaku jika isBillingItem bernilai true.	100
PretaxGrossAmount	number	Jumlah asli.	0.1
ProductCode	string	Kode produk.	rds
BillingType	string	Metode penagihan.	其它
ItemName	string	Nama proyek.	iZ28bycvyb4Z
AfterDiscountAmount	number	Jumlah setelah diskon diterapkan. Jumlah ini mencakup jumlah yang harus dibayar setelah potongan kupon. Rumusnya: Jumlah setelah diskon = Harga daftar - Jumlah diskon.

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.