Belirli bir faturalandırma döngüsü içinde bir kullanıcının tüm ürün örneklerinin veya faturalandırılabilir öğelerinin tüketim özetini sorgular.
Operation description
Cari ayın sorgu sonuçları yalnızca referans amaçlıdır ve mutabakat için temel olarak kullanılamaz. Cari ayın nihai faturası, bir sonraki ayın 3. günü saat 12:00'den sonra görüntülenebilir veya dışa aktarılabilir. Ay boyunca, gecikmeli faturalandırma, iadeler, fatura düzeltmeleri ve vadesi geçmiş ödemelerin silinmesi dahil ancak bunlarla sınırlı olmamak üzere çeşitli senaryolar gerçekleşebilir.
Cari ayın fatura verileri, faturalandırılmamış veya birikmekte olan ödenmemiş kullandıkça öde verilerini içermez.
Son 18 aya ait veriler desteklenir.
Fatura verileri, gerçek tüketime kıyasla 24 saatlik bir gecikmeyle güncellenir. Örnek yapılandırması, örnek türü, örnek diğer adı, kaynak grubu, genel IP adresi, özel IP adresi ve bölge gibi örnek kimliğiyle ilgili bilgiler 48 saatlik bir gecikmeyle güncellenir.
Fatura verileri; CDN, OSS ve İnternet Paylaşılan Bant Genişliği gibi bölünmüş türdeki bulut hizmetleri için etki alanı adları, paketler ve EIP'ler gibi bireysel bölünmüş öğelerin belirli maliyetlerini sağlamaz. Bölünmüş öğeleri içeren verileri görüntülemek için bölünmüş fatura sayfasına gidin.
Bulut iletişim ürünleri için yalnızca Haziran 2020 ve sonrasına ait ayrıntı verileri desteklenir. Etki alanı adları ve ticari markalar dahil HiChina ürünleri için yalnızca Kasım 2020 ve sonrasına ait ayrıntı verileri desteklenir.
Hız sınırı, kullanıcı başına saniyede 10 istektir. Zaman aşımı oluşursa isteği yeniden deneyin.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
bssapi:DescribeInstanceBill |
get |
*All resources.
|
|
None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| BillingCycle |
string |
Yes |
YYYY-AA biçimindeki faturalandırma döngüsü. Yalnızca son 18 faturalandırma döngüsü desteklenir. |
2020-03 |
| ProductCode |
string |
No |
Ürün kodu. |
rds |
| ProductType |
string |
No |
Ürün türü. |
rds |
| SubscriptionType |
string |
No |
Abonelik türü. Geçerli değerler:
|
PayAsYouGo |
| IsBillingItem |
boolean |
No |
Verilerin faturalandırılabilir öğeye göre alınıp alınmayacağını belirtir. Geçerli değerler:
|
false |
| NextToken |
string |
No |
Mevcut çağrının verileri okumaya başladığı konum. Değer boş olmalı veya önceki yanıtta döndürülen NextToken değerine ayarlanmalıdır. Aksi takdirde bir hata oluşur. Boş bir değer, okumanın baştan başladığını gösterir. |
CAESEgoQCg4KCm |
| MaxResults |
integer |
No |
Mevcut çağrıda okunacak maksimum veri kaydı sayısı. Varsayılan değer: 20. Maksimum değer: 300. |
20 |
| IsHideZeroCharge |
boolean |
No |
Hem orijinal fiyatın (PretaxGrossAmount) hem de ödenecek tutarın (PretaxAmount) 0 olduğu kayıtların filtrelenip filtrelenmeyeceğini belirtir. Geçerli değerler:
|
false |
| BillingDate |
string |
No |
Faturalandırma tarihi. Bu parametre yalnızca Granularity değeri DAILY olarak ayarlandığında gereklidir. Biçim: YYYY-AA-GG. Not
BillingDate değeri, BillingCycle değeriyle aynı ayda olmalıdır. Örneğin, BillingCycle değeri 2020-03 olarak ayarlanmışsa, BillingDate değeri 2020-03-GG olarak ayarlanmalıdır. Aylar tutarsızsa, sorgu sonuçları BillingCycle tarafından belirtilen zamana göre döndürülür. |
2020-03-02 |
| Granularity |
string |
No |
Faturaların sorgulandığı ayrıntı düzeyi. Geçerli değerler:
Not
DAILY seçerseniz, BillingDate değerini belirtmeniz gerekir. |
MONTHLY |
| BillOwnerId |
integer |
No |
Kaynak sahipliği hesabının kimliği. Kaynak sahipliği hesabı, kaynağı fiilen kullanan hesaptır. |
122 |
| InstanceID |
string |
No |
Örnek kimliği. |
abc |
| PipCode |
string |
No |
Kullanıcı Merkezi faturalarındaki ürün koduyla tutarlı olan ürün kodu. |
rds |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| Code |
string |
Durum kodu. |
Success |
| Data |
object |
Döndürülen veriler. |
|
| AccountID |
string |
Hesap kimliği. |
122 |
| AccountName |
string |
Kullanıcı hesabı. |
test@test.aliyunid.com |
| BillingCycle |
string |
Faturalandırma tarihi. Biçim: YYYY-AA. |
2020-03 |
| Items |
array<object> |
Fatura ayrıntıları. |
|
|
object |
|||
| AfterDiscountAmount |
number |
Kupon kesintisinden sonraki ödenecek tutar dahil olmak üzere indirimden sonraki tutar. Hesaplama kuralı: İndirimden sonraki tutar = Liste fiyatı - İndirim tutarı. |
0 |
| BillAccountID |
string |
Faturanın ait olduğu hesabın kimliği. |
122 |
| BillAccountName |
string |
Faturanın ait olduğu hesabın adı. |
test@test.aliyunid.com |
| BillingDate |
string |
Faturalandırma tarihi. Bu parametre yalnızca Granularity değeri DAILY olarak ayarlandığında bir değere sahiptir. Biçim: YYYY-AA-GG. |
2020-03-20 |
| BillingItem |
string |
Faturalandırılabilir öğe. Bu parametre yalnızca IsBillingItem değeri true olarak ayarlandığında bir değere sahiptir. |
Bandwidth |
| BillingItemCode |
string |
Faturalandırılabilir öğe kodu. |
disk |
| BillingType |
string |
Faturalandırma yöntemi. |
Other |
| BizType |
string |
İş türü. |
trusteeship |
| CommodityCode |
string |
Kullanıcı Merkezi'ndeki ürün ayrıntı koduyla aynı olan emtia kodu. |
rds |
| CostUnit |
string |
Maliyet birimi. |
Unallocated |
| Currency |
string |
Para birimi. Geçerli değerler:
|
CNY |
| DeductedByCoupons |
number |
Kupon indirim tutarı. |
0.1 |
| DeductedByResourcePackage |
string |
Kaynak planlarıyla düşülen tutar. Bu parametre yalnızca isBillingItem değeri true olarak ayarlandığında geçerlidir. |
0.1 |
| InstanceConfig |
string |
Ayrıntılı örnek yapılandırması. |
CPU:12 |
| InstanceID |
string |
Örnek kimliği. |
i-dadada |
| InstanceSpec |
string |
Örnek teknik özellikleri. |
ecs.sn1ne.3xlarge |
| InternetIP |
string |
Genel IP adresi. |
34.xx.x.x |
| IntranetIP |
string |
Dahili IP adresi. |
192.xx.xx.xx |
| InvoiceDiscount |
number |
İndirim tutarı. |
0.1 |
| Item |
string |
Fatura türü. Geçerli değerler:
|
PayAsYouGoBill |
| ItemName |
string |
Öğe adı. |
iZ28bycvyb4Z |
| ListPrice |
string |
Birim fiyat. Bu parametre yalnızca isBillingItem değeri true olarak ayarlandığında geçerlidir. |
100 |
| ListPriceUnit |
string |
Birim fiyatın birimi. Bu parametre yalnızca isBillingItem değeri true olarak ayarlandığında geçerlidir. |
CNY |
| NickName |
string |
Örnek diğer adı. |
test |
| OwnerID |
string |
Çoklu hesap ödeme senaryolarında kaynak sahibinin hesap kimliği. |
123 |
| PipCode |
string |
Kullanıcı Merkezi faturalarındaki ürün koduyla tutarlı olan ürün kodu. |
rds |
| PretaxAmount |
number |
Ödenecek tutar. |
0.1 |
| PretaxGrossAmount |
number |
Orijinal tutar. |
0.1 |
| ProductCode |
string |
Ürün kodu. |
rds |
| ProductDetail |
string |
Ürün ayrıntısı. |
ApsaraDB RDS |
| ProductName |
string |
Ürün adı. |
ApsaraDB RDS |
| ProductType |
string |
Ürün türü. |
rds |
| Region |
string |
Bölge. |
Hangzhou |
| ResourceGroup |
string |
Kaynak grubu. |
Default resource group |
| ServicePeriod |
string |
Hizmet süresi. |
3600 |
| ServicePeriodUnit |
string |
Hizmet süresi birimi. |
Seconds |
| SubscriptionType |
string |
Abonelik türü. Geçerli değerler:
|
PayAsYouGo |
| Tag |
string |
Kaynak etiketi. |
key:testKey value:testValue; key:testKey1 value:testValues1 |
| Usage |
string |
Kullanım. Not
Bu parametre yalnızca isBillingItem değeri true olarak ayarlandığında geçerlidir. Kullanım verileri, fiilen satın alınan miktar değil, döngü içindeki tüm faturalardaki kullanım toplamıdır. Örneğin, 1 GB depolama alanı kullanılıyor ve saatlik olarak faturalandırılıyorsa, saatlik kullanım 1 GB'dir ve günlük birleştirilmiş fatura kullanımı 1 GB × 24 = 24 GB'dir. |
100 |
| UsageUnit |
string |
Kullanım birimi. Bu parametre yalnızca isBillingItem değeri true olarak ayarlandığında geçerlidir. |
GB |
| Zone |
string |
Bölge. |
Hangzhou Zone 1 |
| MaxResults |
integer |
Mevcut istek için döndürülen maksimum kayıt sayısı. |
20 |
| NextToken |
string |
Mevcut çağrının okumaya devam ettiği konumu belirten belirteç. Boş bir değer, tüm verilerin okunduğunu gösterir. Bir sonraki çağrı için bu değeri NextToken istek parametresine ayarlayın. |
CAESEgoQCg4KCm |
| TotalCount |
integer |
Toplam kayıt sayısı. |
20 |
| Message |
string |
Hata mesajı. |
Successful! |
| RequestId |
string |
İstek kimliği. |
79EE7556-0CFD-44EB-9CD6-B3B526E3A85F |
| Success |
boolean |
İsteğin başarılı olup olmadığını gösterir. |
true |
Examples
Success response
JSON format
{
"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": "Bandwidth",
"BillingItemCode": "disk",
"BillingType": "Other",
"BizType": "trusteeship",
"CommodityCode": "rds",
"CostUnit": "Unallocated",
"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": "CNY",
"NickName": "test",
"OwnerID": "123",
"PipCode": "rds",
"PretaxAmount": 0.1,
"PretaxGrossAmount": 0.1,
"ProductCode": "rds",
"ProductDetail": "ApsaraDB RDS",
"ProductName": "ApsaraDB RDS",
"ProductType": "rds",
"Region": "Hangzhou",
"ResourceGroup": "Default resource group",
"ServicePeriod": "3600",
"ServicePeriodUnit": "Second",
"SubscriptionType": "PayAsYouGo",
"Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
"Usage": "100",
"UsageUnit": "GB",
"Zone": "Hangzhou Zone 1"
}
],
"MaxResults": 20,
"NextToken": "CAESEgoQCg4KCm",
"TotalCount": 20
},
"Message": "Successful!",
"RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
"Success": true
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.