Tüm Ürünler
Search
Belge Merkezi

:DescribeSplitItemBill

Son Güncelleme:Oct 10, 2026

Bölünmüş faturaları sorgular.

Operation description

  • Cari ayın bölünmüş fatura 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 4. günü saat 12:00'den sonra sorgulanabilir. Cari aya ait bölünmüş fatura verileri, ödenmemiş kullandıkça öde verilerini (faturalandırılmamış veya biriktirilmekte olan) içermez.

  • Bölünmüş fatura verileri son 12 ay için kullanılabilir.

  • Bölünmüş fatura verileri, gerçek harcamalara kıyasla 48 saatlik bir gecikmeyle güncellenir. Bölünmüş bulut hizmetleri (CDN, OSS ve İnternet Paylaşımlı Bant Genişliği gibi) için, eklenen her kaynağa (alan adları, paketler ve EIP'ler gibi) ait belirli harcamalar 72 saatlik bir gecikmeyle güncellenir.

  • Bölünmüş fatura verileri, yalnızca konsoldaki Bölünmüş Fatura sayfasında bu özelliği etkinleştirdikten sonra kullanılabilir. Veriler, özelliği etkinleştirdikten 24 saat sonra kullanılabilir hale gelir.

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

get

*All resources.

*

  • bssapi:ProductCode
  • bssapi:ProductType
None

Request parameters

Parameter

Type

Required

Description

Example

BillingCycle

string

Yes

Faturalandırma döngüsü. Biçim: YYYY-AA.

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.

Not

Bu parametre, ProductCode parametresiyle birlikte kullanılmalıdır.

PayAsYouGo

NextToken

string

No

Geçerli çağrının verileri okumaya başlayacağı konumu belirten belirteç. Değer boş olmalı veya önceki yanıtta döndürülen NextToken değeri olmalıdır. Aksi takdirde bir hata oluşur. Boş bir değer, okuma işleminin baştan başladığını gösterir.

CAESEgoQCg4KCmd

MaxResults

integer

No

Geçerli çağrıda döndürülecek maksimum giriş sayısı. Varsayılan değer: 20. Maksimum değer: 300.

20

BillOwnerId

integer

No

Kaynak sahipliği hesabının kimliği. Kaynak sahipliği hesabı, kaynağı fiilen kullanan hesaptır.

123

InstanceID

string

No

Örnek kimliği.

i-kjhdskjgshfdlkjfdh

SplitItemID

string

No

Eklenen kaynağın kimliği.

i-kjhdskjgshfdlkjfdh

Granularity

string

No

Faturaların sorgulandığı ayrıntı düzeyi. Geçerli değerler:

  • MONTHLY: aylık. Bu değer, Kullanıcı Merkezindeki Bölünmüş Fatura sayfasındaki aylık faturalara karşılık gelir.

  • DAILY: günlük. Bu değer, Kullanıcı Merkezindeki Bölünmüş Fatura sayfasındaki günlük faturalara karşılık gelir.

Not

Bu parametreyi DAILY olarak ayarlarsanız, BillingDate parametresini belirtmeniz gerekir.

Monthly

BillingDate

string

No

Faturalandırma tarihi. Bu parametre yalnızca Granularity değeri DAILY olarak ayarlandığında gereklidir. Biçim: YYYY-AA-GG.

2020-03-02

TagFilter

array<object>

No

Etiket filtreleme koşulları. Birden fazla TagValues sorgu koşulu kümesi desteklenir. Birden fazla TagValues koşulu kümesi arasındaki mantıksal ilişki OR şeklindedir.

object

No

Etiket filtreleme koşulları.

TagKey

string

No

TagFilter.N, belirtilen etiketlerle eşleşen faturaları sorgulamak için kullanılır. Bir anahtar-değer çiftinden oluşur. Etiket anahtarı 1 ila 128 karakter uzunluğunda olmalıdır. N için geçerli değerler: 1 ila 20.

  • Yalnızca TagFilter.N.TagKey değerini belirtirseniz, etiket anahtarıyla ilişkili tüm faturalar döndürülür.

  • Birden fazla etiket anahtar-değer çifti belirtirseniz, etiket anahtar-değer çiftlerinden herhangi biriyle eşleşen faturalar döndürülür.

  • Bir kaynaktaki etiketler değişirse, yalnızca etiketlerin kaynağa ekli olduğu dönemde oluşturulan faturaları sorgulayabilirsiniz.

TestKey

TagValues

array

No

TagValues.N, belirtilen etiket değerleriyle eşleşen faturaları sorgulamak için kullanılır. Bir dize listesinden oluşur. Etiket değeri 1 ila 128 karakter uzunluğunda olmalıdır. N için geçerli değerler: 1 ila 20.

  • TagValues.N değerini belirtirseniz, TagFilter.N.TagKey değerini de belirtmeniz gerekir. Aksi takdirde, InvalidParameter.TagValues hatası bildirilir.

  • Birden fazla etiket değeri belirtirseniz, etiket değerlerinden herhangi biriyle eşleşen faturalar döndürülür.

TestValue

string

No

Etiket değeri.

TestValue

IsHideZeroCharge

boolean

No

Hem orijinal fiyatın (PretaxGrossAmount) hem de ödenecek tutarın (PretaxAmount) 0 olduğu faturaların filtrelenip filtrelenmeyeceğini belirtir. Geçerli değerler:

  • false: Faturaları filtrelemez.

  • true: Faturaları filtreler.

false

PipCode

string

No

Ürün kodu. Bu değer, Kullanıcı Merkezindeki faturalarda yer alan ürün koduyla aynıdır.

rds

Response elements

Element

Type

Description

Example

object

Code

string

Durum kodu.

Success

Data

object

Yanıt verileri.

AccountID

string

Hesap kimliği.

185xxxx3489

AccountName

string

Kullanıcı hesabı.

test@test.aliyunid.com

BillingCycle

string

Faturalandırma döngüsü. Biçim: YYYY-AA.

2020-03

Items

array<object>

Fatura ayrıntıları.

object

AfterDiscountAmount

number

Kupon düşüldükten sonraki ödenecek tutarı içeren indirim sonrası tutar. Hesaplama kuralı: İndirim sonrası tutar = Liste fiyatı - İndirim tutarı.

0

BillAccountID

string

Faturanın ait olduğu hesabın kimliği.

185xxxx3489

BillAccountName

string

Faturanın ait olduğu hesabın adı.

test@test.aliyunid.com

BillingDate

string

YYYY-MM-DD biçimindeki faturalandırma tarihi. Bu parametre desteklenmez.

2020-01-20

BillingItem

string

Faturalandırma kalemi.

Bandwidth

BillingItemCode

string

Faturalandırma kalemi kodu.

disk

BillingType

string

Faturalandırma yöntemi.

Other

BizType

string

İş türü.

trusteeship

CommodityCode

string

Kullanıcı Merkezindeki ürün ayrıntı koduyla aynı olan ürün kodu.

rds

CostUnit

string

Maliyet birimi.

Unallocated

Currency

string

Para birimi. Geçerli değerler:\n- CNY\n- USD\n- JPY.

CNY

DeductedByCoupons

number

Kupon indirim tutarı.

0

DeductedByResourcePackage

string

Kaynak planlarıyla düşülen tutar.

0

InstanceConfig

string

Ayrıntılı örnek yapılandırması.

CPU:12

InstanceID

string

Örnek kimliği.

i-kjhdskjgshfdlkjfdh

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

Item

string

Fatura türü. Geçerli değerler:\n- SubscriptionOrder: Abonelik siparişi.\n- PayAsYouGoBill: Kullandıkça öde faturası.\n- Refund: İade.\n- Adjustment: Düzeltme.

PayAsYouGoBill

ItemName

string

Kalem adı.

iZ28bycvyb4Z

ListPrice

string

Birim fiyat.

0.12

ListPriceUnit

string

Birim fiyatın birimi.

CNY/GB

NickName

string

Örnek takma adı.

nick

OwnerID

string

Çoklu hesap ödeme senaryolarında kaynak sahibinin hesap kimliği.

169***013

PipCode

string

Kullanıcı Merkezindeki fatura ürün koduyla aynı olan ürün kodu.

rds

PretaxAmount

number

Ödenecek tutar.

0

PretaxGrossAmount

number

Orijinal tutar.

0

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.

20

ServicePeriodUnit

string

Hizmet süresinin birimi.

Hour

SplitAccountID

string

Ekli kaynağın hesap kimliği.

12**122

SplitAccountName

string

Ekli kaynağın hesap adı.

test**1122

SplitBillingCycle

string

Bölünmüş fatura ayı.

2021-06

SplitBillingDate

string

Bölünmüş fatura tarihi.

2021-06-01

SplitCommodityCode

string

Ekli kaynağın ürün kodu.

rds

SplitItemID

string

Eklenen kaynağın kimliği.

i-28bycvyb4

SplitItemName

string

Ekli kaynağın adı.

iZ28bycvyb4Z

SplitProductDetail

string

Ekli kaynağın ürün ayrıntı adı.

ApsaraDB

SubscriptionType

string

Abonelik türü. Geçerli değerler:\n- Subscription: Abonelik.\n- PayAsYouGo: Kullandıkça öde.

PayAsYouGo

Tag

string

Kaynak etiketi. Bir kaynaktaki etiket değiştirilirse, geçerlilik süresi boyunca oluşturulan faturalar bu etiketi içerecektir.

key:testKey value:testValue; key:testKey1 value:testValues1

Usage

string

Kullanım.

100

UsageUnit

string

Kullanım birimi.

GB

Zone

string

Bölge.

China North 1

MaxResults

integer

Mevcut istek için döndürülen maksimum giriş sayısı.

20

NextToken

string

Mevcut çağrının okumayı durdurduğu konumu belirten belirteç. Boş bir değer, tüm verilerin okunduğunu gösterir. Bu değeri bir sonraki çağrıda NextToken istek parametresi olarak ayarlayın.

CAESEgoQCg4K

TotalCount

integer

Toplam giriş 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": "185xxxx3489",
    "AccountName": "test@test.aliyunid.com",
    "BillingCycle": "2020-03",
    "Items": [
      {
        "AfterDiscountAmount": 0,
        "BillAccountID": "185xxxx3489",
        "BillAccountName": "test@test.aliyunid.com",
        "BillingDate": "2020-01-20",
        "BillingItem": "Bandwidth",
        "BillingItemCode": "disk",
        "BillingType": "Other",
        "BizType": "trusteeship",
        "CommodityCode": "rds",
        "CostUnit": "Unallocated",
        "Currency": "CNY",
        "DeductedByCoupons": 0,
        "DeductedByResourcePackage": "0",
        "InstanceConfig": "CPU:12",
        "InstanceID": "i-kjhdskjgshfdlkjfdh",
        "InstanceSpec": "ecs.sn1ne.3xlarge",
        "InternetIP": "34.xx.x.x",
        "IntranetIP": "192.xx.xx.xx",
        "InvoiceDiscount": 0,
        "Item": "PayAsYouGoBill",
        "ItemName": "iZ28bycvyb4Z",
        "ListPrice": "0.12",
        "ListPriceUnit": "USD/GB",
        "NickName": "nick",
        "OwnerID": "169***013",
        "PipCode": "rds",
        "PretaxAmount": 0,
        "PretaxGrossAmount": 0,
        "ProductCode": "rds",
        "ProductDetail": "ApsaraDB RDS",
        "ProductName": "ApsaraDB RDS",
        "ProductType": "rds",
        "Region": "Hangzhou",
        "ResourceGroup": "Default resource group",
        "ServicePeriod": "20",
        "ServicePeriodUnit": "Hour",
        "SplitAccountID": "12**122",
        "SplitAccountName": "test**1122",
        "SplitBillingCycle": "2021-06",
        "SplitBillingDate": "2021-06-01",
        "SplitCommodityCode": "rds",
        "SplitItemID": "i-28bycvyb4",
        "SplitItemName": "iZ28bycvyb4Z",
        "SplitProductDetail": "ApsaraDB",
        "SubscriptionType": "PayAsYouGo",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Usage": "100",
        "UsageUnit": "GB",
        "Zone": "China North 1"
      }
    ],
    "MaxResults": 20,
    "NextToken": "CAESEgoQCg4K",
    "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.