分割請求を照会します。
操作説明
当月の分割請求データは参考値であり、照合には使用できません。当月の最終的な請求は、翌月 4 日の 12:00 (UTC + 08:00) 以降に照会できます。当月の分割請求データには、未決済の従量課金データは含まれていません。
過去 12 か月間の分割請求データを照会できます。
分割請求データは、実際のリソース消費から 48 時間の遅延で更新されます。 CDN、OSS、インターネット共有帯域幅など、分割請求をサポートするプロダクトの場合、ドメイン名、バケット、EIP などの個々の課金項目のコストは 72 時間の遅延で更新されます。
分割請求データは、コンソールの [分割請求] ページで分割請求機能を有効にした後にのみ使用できます。データは、機能を有効にしてから 24 時間後に使用可能になります。
1 人のユーザーは、最大 10 クエリ/秒 (QPS) を実行できます。タイムアウトエラーが発生した場合は、リクエストを再試行してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
bssapi:DescribeSplitItemBill |
get |
*All Resource
|
bssapi:ProductCode
bssapi:ProductType
|
なし |
リクエストパラメーター
|
パラメーター |
タイプ |
必須 / 任意 |
説明 |
例 |
| BillingCycle |
string |
必須 |
請求サイクル。形式: YYYY-MM。 |
2020-03 |
| ProductCode |
string |
任意 |
プロダクトのコード。 |
rds |
| ProductType |
string |
任意 |
プロダクトのタイプ。 |
rds |
| SubscriptionType |
string |
任意 |
課金方法。有効な値:
説明
このパラメータは、ProductCode パラメータと一緒に使用する必要があります。 |
PayAsYouGo |
| NextToken |
string |
任意 |
次のページの結果を取得するために使用されるトークン。最初のリクエストでは、このパラメータを指定する必要はありません。値は、前の API 呼び出しで返された NextToken 値です。値が指定されている場合、新しいクエリは次のページから開始されます。このパラメータを空のままにすると、クエリは最初から開始されます。 |
CAESEgoQCg4KCmd |
| MaxResults |
integer |
任意 |
返すエントリの最大数。デフォルト値: 20 。最大値: 300 。 |
20 |
| BillOwnerId |
integer |
任意 |
リソースを所有するアカウントの ID 。リソースを所有するアカウントは、実際にリソースを使用するアカウントです。 |
123 |
| InstanceID |
string |
任意 |
インスタンスの ID 。 |
i-kjhdskjgshfdlkjfdh |
| SplitItemID |
string |
任意 |
分割項目の ID 。 |
i-kjhdskjgshfdlkjfdh |
| Granularity |
string |
任意 |
請求を照会するための粒度。有効な値:
説明
このパラメータを DAILY に設定する場合は、BillingDate パラメータを指定する必要があります。 |
Monthly |
| BillingDate |
string |
任意 |
請求日。このパラメータは、Granularity パラメータが DAILY に設定されている場合にのみ必須です。形式: YYYY-MM-DD。 |
2020-03-02 |
| TagFilter |
array<object> |
任意 |
タグフィルター。TagValues パラメータには複数のタグ値を指定できます。複数のタグ値間の関係は OR です。 |
|
|
object |
任意 |
タグフィルター。 |
||
| TagValues |
array |
任意 |
タグ値。文字列のリスト。N の値は 1 から 20 までです。タグ値の長さは 1 ～ 128 文字です。
|
TestValue |
|
string |
任意 |
タグ値。 |
TestValue |
|
| TagKey |
string |
任意 |
タグキー。N の値は 1 から 20 までです。タグキーの長さは 1 ～ 128 文字です。
|
TestKey |
| IsHideZeroCharge |
boolean |
任意 |
PretaxGrossAmount と PretaxAmount の両方が 0 である請求を除外するかどうかを指定します。有効な値:
|
false |
| PipCode |
string |
任意 |
プロダクトのコード。このコードは、ユーザーセンターの請求書のプロダクトコードと一致します。 |
rds |
レスポンスパラメーター
|
パラメーター |
タイプ |
説明 |
例 |
|
object |
|||
| Code |
string |
状態コード。 |
Success |
| Message |
string |
エラーメッセージ。 |
Successful! |
| RequestId |
string |
リクエストの ID 。 |
79EE7556-0CFD-44EB-9CD6-B3B526E3A85F |
| Success |
boolean |
リクエストが成功したかどうかを示します。 |
true |
| Data |
object |
返されたデータ。 |
|
| NextToken |
string |
結果の次のページを取得するために使用されるトークン。このパラメータが空の場合、すべての結果が返されます。次のクエリでは、このパラメータの値を NextToken リクエストパラメータとして渡します。 |
CAESEgoQCg4K |
| BillingCycle |
string |
請求サイクル。形式: YYYY-MM。 |
2020-03 |
| MaxResults |
integer |
現在のリクエストで返されるエントリの最大数。 |
20 |
| AccountID |
string |
アカウントの ID 。 |
185xxxx3489 |
| TotalCount |
integer |
エントリの総数。 |
20 |
| AccountName |
string |
アカウントの名前。 |
test@test.aliyunid.com |
| Items |
array<object> |
請求の詳細。 |
|
|
object |
|||
| SplitAccountID |
string |
分割項目が属するアカウントの ID 。 |
12**122 |
| BillAccountName |
string |
請求が属するアカウントの名前。 |
test@test.aliyunid.com |
| SubscriptionType |
string |
課金方法。有効な値: Subscription: サブスクリプション。 PayAsYouGo: 従量課金。 |
PayAsYouGo |
| InstanceSpec |
string |
インスタンスタイプ。 |
ecs.sn1ne.3xlarge |
| DeductedByCoupons |
number |
クーポンで割引された金額。 |
0 |
| Region |
string |
リージョン。 |
China (Hangzhou) |
| OutstandingAmount |
number |
未払い金額。 |
0.1 |
| PipCode |
string |
プロダクトのコード。このコードは、ユーザーセンターの請求書のプロダクトコードと一致します。 |
rds |
| CommodityCode |
string |
商品のコード。このコードは、ユーザーセンターのプロダクト詳細コードと一致します。 |
rds |
| NickName |
string |
インスタンスのニックネーム。 |
nick |
| ProductDetail |
string |
プロダクトの詳細。 |
ApsaraDB RDS |
| Usage |
string |
使用量。 |
100 |
| IntranetIP |
string |
プライベート IP アドレス。 |
192.xx.xx.xx |
| UsageUnit |
string |
使用量の単位。 |
GB |
| SplitCommodityCode |
string |
分割項目の商品コード。 |
rds |
| BillAccountID |
string |
請求が属するアカウントの ID 。 |
185xxxx3489 |
| ProductType |
string |
プロダクトのタイプ。 |
rds |
| DeductedByResourcePackage |
string |
リソースプランで割引された金額。 |
0 |
| PaymentAmount |
number |
現金で支払われた金額。この金額には、クレジットの払い戻しから差し引かれた金額が含まれています。 |
0 |
| SplitBillingCycle |
string |
分割請求の月。 |
2021-06 |
| ServicePeriod |
string |
サービス期間。 |
20 |
| SplitItemName |
string |
分割項目の名前。 |
iZ28bycvyb4Z |
| ListPrice |
string |
単価。 |
0.12 |
| Zone |
string |
ゾーン。 |
Qingdao Zone B |
| PretaxGrossAmount |
number |
税引前総額。 |
0 |
| CashAmount |
number |
現金で支払われた金額。この金額には、クレジットの払い戻しから差し引かれた金額は含まれていません。 |
0 |
| InstanceConfig |
string |
インスタンスの構成詳細。 |
CPU:12 |
| BillingDate |
string |
請求日。形式: YYYY-MM-DD。このパラメータはサポートされていません。 |
2020-01-20 |
| InternetIP |
string |
パブリック IP アドレス。 |
34.xx.x.x |
| Item |
string |
請求のタイプ。有効な値: SubscriptionOrder: サブスクリプションオーダー。 PayAsYouGoBill: 従量課金請求。 Refund: 払い戻し。 Adjustment: 調整。 |
PayAsYouGoBill |
| SplitItemID |
string |
分割項目の ID 。 |
i-28bycvyb4 |
| InstanceID |
string |
インスタンスの ID 。 |
i-kjhdskjgshfdlkjfdh |
| Tag |
string |
リソースのタグ。リソースのタグが変更された場合、タグのライフサイクル中にリソースに対して生成された請求には、タグが含まれます。 |
key:testKey value:testValue; key:testKey1 value:testValues1 |
| Currency |
string |
通貨。有効な値: CNY。 USD。 JPY。 |
CNY |
| DeductedByCashCoupons |
number |
キャッシュクーポンで割引された金額。 |
0 |
| BizType |
string |
ビジネスの種類。 |
trusteeship |
| BillingItem |
string |
課金項目。 |
Bandwidth |
| BillingItemCode |
string |
課金項目のコード。 |
disk |
| CostUnit |
string |
コストセンター。 |
Not allocated |
| ListPriceUnit |
string |
単価の単位。 |
CNY/GB |
| ResourceGroup |
string |
リソースグループ。 |
Default resource group |
| PretaxAmount |
number |
税引前金額。 |
0 |
| ServicePeriodUnit |
string |
サービス期間の単位。 |
Hour |
| SplitBillingDate |
string |
分割請求の日。 |
2021-06-01 |
| ProductName |
string |
プロダクトの名前。 |
ApsaraDB RDS |
| SplitProductDetail |
string |
分割項目のプロダクト詳細の名前。 |
ApsaraDB RDS |
| AdjustAmount |
number |
クレジットの払い戻しから差し引かれた金額。 |
0 |
| OwnerID |
string |
リソースを所有するアカウントの ID 。このパラメータは、複数アカウントの支払いシナリオで返されます。 |
169***013 |
| DeductedByPrepaidCard |
number |
プリペイドカードで割引された金額。 |
0 |
| InvoiceDiscount |
number |
割引。 |
0 |
| SplitAccountName |
string |
分割項目が属するアカウントの名前。 |
test**1122 |
| BillingType |
string |
課金方法。 |
Other |
| ProductCode |
string |
プロダクトのコード。 |
rds |
| ItemName |
string |
項目の名前。 |
iZ28bycvyb4Z |
| AfterDiscountAmount |
number |
割引後の金額。これは、割引が適用された後の支払い金額です。式: 割引後の金額 = 定価 - 割引。 |
例
成功レスポンス
JSONJSON
{
"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": "China (Hangzhou)\n",
"OutstandingAmount": 0.1,
"PipCode": "rds",
"CommodityCode": "rds",
"NickName": "nick",
"ProductDetail": "ApsaraDB RDS\n",
"Usage": "100",
"IntranetIP": "192.xx.xx.xx",
"UsageUnit": "GB",
"SplitCommodityCode": "rds",
"BillAccountID": "185xxxx3489",
"ProductType": "rds",
"DeductedByResourcePackage": "0",
"PaymentAmount": 0,
"SplitBillingCycle": "2021-06",
"ServicePeriod": "20",
"SplitItemName": "iZ28bycvyb4Z",
"ListPrice": "0.12",
"Zone": "Qingdao Zone B\n",
"PretaxGrossAmount": 0,
"CashAmount": 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",
"DeductedByCashCoupons": 0,
"BizType": "trusteeship",
"BillingItem": "Bandwidth\n",
"BillingItemCode": "disk",
"CostUnit": "Not allocated\n",
"ListPriceUnit": "CNY/GB\n",
"ResourceGroup": "Default resource group\n",
"PretaxAmount": 0,
"ServicePeriodUnit": "Hour\n",
"SplitBillingDate": "2021-06-01",
"ProductName": "ApsaraDB RDS\n",
"SplitProductDetail": "ApsaraDB RDS\n",
"AdjustAmount": 0,
"OwnerID": "169***013",
"DeductedByPrepaidCard": 0,
"InvoiceDiscount": 0,
"SplitAccountName": "test**1122",
"BillingType": "Other\n",
"ProductCode": "rds",
"ItemName": "iZ28bycvyb4Z",
"AfterDiscountAmount": 0
}
]
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。