Tüm Ürünler
Search
Belge Merkezi

:DescribeInstanceBill

Son Güncelleme:Oct 10, 2026

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

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

bssapi:DescribeInstanceBill

get

*All resources.

*

  • bssapi:ProductCode
  • bssapi:ProductCode
  • bssapi:ProductType
  • bssapi:ProductType
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:

  • Subscription: abonelik.

  • PayAsYouGo: kullandıkça öde.

PayAsYouGo

IsBillingItem

boolean

No

Verilerin faturalandırılabilir öğeye göre alınıp alınmayacağını belirtir. Geçerli değerler:

  • false (varsayılan): Veriler, Giderler ve Maliyetler > Faturalar > Fatura Ayrıntıları > Örnek Faturaları bölümündeki örnek faturalarıyla tutarlıdır.

  • true: Veriler, Giderler ve Maliyetler > Faturalar > Fatura Ayrıntıları > Faturalandırılabilir Öğe Faturaları bölümündeki faturalandırılabilir öğe faturalarıyla tutarlıdır.

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

  • true

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:

  • MONTHLY: aylık. Veriler, Giderler ve Maliyetler > Faturalar > Fatura Ayrıntıları > Aylık Faturalar bölümündeki aylık faturalarla tutarlıdır.

  • DAILY: günlük. Veriler, Giderler ve Maliyetler > Faturalar > Fatura Ayrıntıları > Günlük Faturalar bölümündeki günlük faturalarla tutarlıdır.

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

  • USD

  • JPY

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:

  • SubscriptionOrder: abonelik siparişi

  • PayAsYouGoBill: kullandıkça öde faturası

  • Refund: iade

  • Adjustment: düzeltme

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:

  • Subscription: abonelik

  • PayAsYouGo: kullandıkça öde

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.