Gunakan DescribeSplitItemBill untuk kueri split bills - Expenses and Costs - Alibaba Cloud - Expenses and Costs

Mengkueri Tagihan Pemisahan.

Deskripsi operasi

Split bill data for the current month is for reference only and cannot be used for reconciliation. The final bill for the current month is available for query after 12:00 (UTC+8) on the fourth day of the next month. The split bill data for the current month does not include unsettled pay-as-you-go data.
You can query split bill data from the past 12 months.
Split bill data is updated with a 48-hour delay from the actual resource consumption. For products that support split billing, such as CDN, OSS, and Internet Shared Bandwidth, the costs of individual billable items, such as domain names, buckets, and EIPs, are updated with a 72-hour delay.
Split bill data is available only after you enable the split bill feature on the Split Bill page in the console. The data becomes available 24 hours after you enable the feature.
A single user can perform a maximum of 10 queries per second (QPS). If a timeout error occurs, retry the request.

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 Tagihan. Format: YYYY-MM.	2020-03
ProductCode	string	No	Kode produk.	rds
ProductType	string	No	Tipe produk.	rds
SubscriptionType	string	No	Metode Tagihan. Nilai valid: Subscription: langganan. PayAsYouGo: bayar sesuai pemakaian. 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 pemanggilan API sebelumnya. Jika nilai ditentukan, kueri baru dimulai dari halaman berikutnya. Jika Anda mengosongkan parameter ini, kueri dimulai dari awal.	CAESEgoQCg4KCmd
MaxResults	integer	No	Jumlah maksimum entri yang akan dikembalikan. Nilai default: 20. Nilai maksimum: 300.	20
BillOwnerId	integer	No	ID akun pemilik sumber daya. Akun pemilik sumber daya adalah akun yang sebenarnya menggunakan sumber daya tersebut.	123
InstanceID	string	No	ID instans.	i-kjhdskjgshfdlkjfdh
SplitItemID	string	No	ID item Pemisahan.	i-kjhdskjgshfdlkjfdh
Granularity	string	No	Granularitas untuk mengkueri tagihan. Nilai valid: MONTHLY: mengkueri tagihan per bulan. Data konsisten dengan data pada tab Siklus Penagihan di halaman Tagihan Split di Pusat Pengguna. DAILY: mengkueri tagihan per hari. Data konsisten dengan data pada tab Per Hari di halaman Tagihan Split di Pusat Pengguna. Catatan Jika Anda menetapkan parameter ini ke DAILY, Anda harus menentukan parameter BillingDate.	Monthly
BillingDate	string	No	Tanggal Tagihan. Parameter ini hanya diperlukan ketika parameter Granularity ditetapkan 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	The tag filter.
TagValues	array	No	The tag values. A list of strings. TagValues.N can be 1 to 20, and 1 to 128 characters in length. If you specify the TagValues.N parameter, you must also specify TagFilter.N.TagKey. Otherwise, an InvalidParameter.TagValues error is reported. If you specify multiple tag values, bills that match any of the tag values are queried.	TestValue
	string	No	The tag value.	TestValue
TagKey	string	No	Specifies the tag key for filtering cost allocation or billing data. Valid range for N: 1 to 20 (you can define up to 20 tag filters). Length: 1 to 128 characters. Behavior: If you specify only TagKey (without TagValue), the system returns bills for all resources that have that tag key assigned (regardless of value). If you specify multiple TagKey+TagValue pairs, the system uses OR logic: bills are returned if any of the key-value pairs match. Billing data reflects the tags as they existed during the billing period. If a tag is removed or changed, past bills are not re-evaluated.	TestKey
IsHideZeroCharge	boolean	No	Apakah akan memfilter tagihan yang nilai PretaxGrossAmount dan PretaxAmount-nya sama dengan 0. Nilai 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	The status code.	Success
Message	string	The error message.	Successful!
RequestId	string	The ID of the request.	79EE7556-0CFD-44EB-9CD6-B3B526E3A85F
Success	boolean	Indicates whether the request was successful.	true
Data	object	The returned data.
NextToken	string	The token that is used to retrieve the next page of results. If this parameter is empty, all the results are returned. For the next query, pass the value of this parameter as the NextToken request parameter.	CAESEgoQCg4K
BillingCycle	string	The billing cycle. Format: YYYY-MM.	2020-03
MaxResults	integer	The maximum number of entries returned for the current request.	20
AccountID	string	The ID of the account.	185xxxx3489
TotalCount	integer	The total number of entries.	20
AccountName	string	The name of the account.	test@test.aliyunid.com
Items	array<object>	The details of the bill.
	object
SplitAccountID	string	The ID of the account to which the split item belongs.	12**122
BillAccountName	string	The name of the account to which the bill belongs.	test@test.aliyunid.com
SubscriptionType	string	The billing method. Valid values: Subscription: subscription. PayAsYouGo: pay-as-you-go.	PayAsYouGo
InstanceSpec	string	The instance type.	ecs.sn1ne.3xlarge
DeductedByCoupons	number	The amount deducted with coupons.	0
Region	string	The region.	杭州
OutstandingAmount	number	未结清金额。	0.1
PipCode	string	The code of the product. This code is consistent with the product code on the bill in User Center.	rds
CommodityCode	string	The code of the commodity. This code is consistent with the product detail code in User Center.	rds
NickName	string	The nickname of the instance.	nick
ProductDetail	string	The details of the product.	云数据库RDS
Usage	string	The usage.	100
IntranetIP	string	The private IP address.	192.xx.xx.xx
UsageUnit	string	The unit of the usage.	GB
SplitCommodityCode	string	The commodity code of the split item.	rds
BillAccountID	string	The ID of the account to which the bill belongs.	185xxxx3489
ProductType	string	The type of the product.	rds
DeductedByResourcePackage	string	The amount deducted with resource plans.	0
PaymentAmount	number	现金支付（含信用额度退款抵扣）。	0
SplitBillingCycle	string	The month of the split bill.	2021-06
ServicePeriod	string	The service duration.	20
SplitItemName	string	The name of the split item.	iZ28bycvyb4Z
ListPrice	string	The unit price.	0.12
Zone	string	The zone.	华北1
PretaxGrossAmount	number	The pretax gross amount.	0
CashAmount	number	现金支付（不包含信用额度退款抵扣）。	0
InstanceConfig	string	The instance configuration details.	CPU:12
BillingDate	string	The billing date. Format: YYYY-MM-DD. This parameter is not supported.	2020-01-20
InternetIP	string	The public IP address.	34.xx.x.x
Item	string	The type of the bill. Valid values: SubscriptionOrder: subscription order. PayAsYouGoBill: pay-as-you-go bill. Refund: refund. Adjustment: adjustment.	PayAsYouGoBill
SplitItemID	string	The ID of the split item.	i-28bycvyb4
InstanceID	string	The ID of the instance.	i-kjhdskjgshfdlkjfdh
Tag	string	The tag of the resource. If the tag of a resource is changed, the bill generated for the resource during the lifecycle of the tag contains the tag.	key:testKey value:testValue; key:testKey1 value:testValues1
Currency	string	The currency. Valid values: CNY USD JPY	CNY
DeductedByCashCoupons	number	代金券抵扣。	0
BizType	string	The business type.	trusteeship
BillingItem	string	The billable item.	带宽
BillingItemCode	string	The code of the billable item.	disk
CostUnit	string	The cost center.	未分配
ListPriceUnit	string	The unit of the unit price.	元/GB
ResourceGroup	string	The resource group.	默认资源组
PretaxAmount	number	The pretax amount.	0
ServicePeriodUnit	string	The unit of the service duration.	小时
SplitBillingDate	string	The day of the split bill.	2021-06-01
ProductName	string	The name of the product.	云数据库RDS
SplitProductDetail	string	The name of the split item's product detail.	云数据库
AdjustAmount	number	信用额度退款抵扣。	0
OwnerID	string	The ID of the account that owns the resource. This parameter is returned in multi-account payment scenarios.	169***013
DeductedByPrepaidCard	number	储值卡抵扣。	0
InvoiceDiscount	number	The discount.	0
SplitAccountName	string	The name of the account to which the split item belongs.	test**1122
BillingType	string	The billing method.	其它
ProductCode	string	The code of the product.	rds
ItemName	string	The name of the item.	iZ28bycvyb4Z
AfterDiscountAmount	number	The amount after a discount. This is the amount payable after a discount is applied. Formula: Amount after discount = List price - Discount.

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.