すべてのプロダクト
Search
ドキュメントセンター

:DescribeSplitItemBill

最終更新日:Sep 17, 2026

分割請求書を照会します。

操作説明

  • 当月の分割請求書データはリファレンス用であり、照合には使用できません。当月の確定請求書は、翌月 4 日の 12:00 以降に利用可能になります。当月の分割請求書データには、未決済 (未請求または集計中) の従量課金データは含まれません。

  • 分割請求書データは、直近 12 か月分が利用可能です。

  • 分割請求書データは、実際のコスト消費から 48 時間遅れて更新されます。コスト配分をサポートするクラウドサービス (CDN、OSS、インターネット共有帯域幅など) のアタッチされたリソースについては、個々のアタッチされたリソース (ドメイン名、バケット、EIP など) のコストが 72 時間遅れて更新されます。

  • 分割請求書データは、ユーザーセンターの金融の 分割請求書 ページで機能を有効化した後にのみ利用可能になります。データは有効化から 24 時間後に利用可能になります。

  • 単一ユーザーのレート制限は 1 秒あたり 10 クエリです。タイムアウトが発生した場合は、リクエストをリトライしてください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

bssapi:DescribeSplitItemBill

get

*すべてのリソース。

*

  • bssapi:ProductCode
  • bssapi:ProductType
なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

BillingCycle

string

必須

YYYY-MM フォーマットの課金サイクル。

2020-03

ProductCode

string

任意

プロダクトのコード。

rds

ProductType

string

任意

プロダクトのタイプ。

rds

SubscriptionType

string

任意

サブスクリプションタイプ。有効な値:

  • Subscription: 前払い。

  • PayAsYouGo: 従量課金。

説明

このパラメーターは、ProductCode パラメーターと組み合わせて使用する必要があります。

PayAsYouGo

NextToken

string

任意

現在の呼び出しでデータの読み取りを開始する位置を指定するトークン。値は空、または前の呼び出しで返された NextToken 値である必要があります。それ以外の場合は、エラーが返されます。空の値は、データが先頭から読み取られることを示します。

CAESEgoQCg4KCmd

MaxResults

integer

任意

現在のリクエストで読み取りを行うデータレコードの最大数。デフォルト値: 20。最大値: 300。

20

BillOwnerId

integer

任意

リソース所有権アカウントの ID。リソース所有権アカウントは、リソースを実際に使用するアカウントです。

123

InstanceID

string

任意

インスタンス ID。

i-kjhdskjgshfdlkjfdh

SplitItemID

string

任意

アタッチされたリソースの ID。

i-kjhdskjgshfdlkjfdh

Granularity

string

任意

請求書クエリの粒度。有効な値:

  • MONTHLY: 月次。ユーザーセンターの [分割請求書] ページの課金サイクル請求書と一致します。

  • DAILY: 日次。ユーザーセンターの [分割請求書] ページの日次請求書と一致します。

説明

このパラメーターを DAILY に設定する場合は、BillingDate を指定する必要があります。

Monthly

BillingDate

string

任意

課金日。このパラメーターは、Granularity が DAILY に設定されている場合にのみ必須です。フォーマット: YYYY-MM-DD。

2020-03-02

TagFilter

array<object>

任意

タグフィルター条件。TagValues クエリ条件の複数のグループがサポートされています。TagValues 条件の複数のグループ間の関係は OR です。

object

任意

タグフィルター条件。

TagKey

string

任意

TagFilter.N は、指定されたタグに一致する請求書を検索するために使用されます。キーと値のペアで構成されます。タグキー長の有効な値: 1 ~ 128。N の有効な値: 1 ~ 20。

  • TagFilter.N.TagKey のみが指定されている場合、そのタグキーに関連付けられているすべての請求書が返されます。

  • 複数のタグのキーと値のペアが指定されている場合、いずれかのタグのキーと値のペアに一致する請求書が返されます。

  • リソースのタグが変更された場合、タグが存在していた期間の請求書のみをクエリできます。

TestKey

TagValues

array

任意

TagValues.N は、指定されたタグ値に一致する請求書を検索するために使用されます。文字列のリストで構成されます。タグ値の長さの有効な値: 1 ~ 128。N の有効な値: 1 ~ 20。

  • TagValues.N を指定する場合は、TagFilter.N.TagKey も指定する必要があります。指定しない場合、InvalidParameter.TagValues エラーが返されます。

  • 複数のタグ値が指定されている場合、いずれかのタグ値に一致する請求書が返されます。

TestValue

string

任意

タグ値。

TestValue

IsHideZeroCharge

boolean

任意

元の価格 (PretaxGrossAmount) と支払金額 (PretaxAmount) の両方が 0 である請求書をフィルターで除外するかどうかを指定します。有効な値:

  • false。

  • true。

false

PipCode

string

任意

プロダクトコード。ユーザーセンターの請求書に記載されているプロダクトコードと一致します。

rds

レスポンスフィールド

フィールド

型

説明

例

object

Code

string

状態コード。

Success

Data

object

返されるデータ。

AccountID

string

アカウント ID。

185xxxx3489

AccountName

string

ユーザー名。

test@test.aliyunid.com

BillingCycle

string

YYYY-MM フォーマットの課金サイクル。

2020-03

Items

array<object>

請求書の詳細。

object

AfterDiscountAmount

number

割引後の金額。この値には、クーポン控除後の支払金額が含まれます。計算ルール: 割引後金額 = リスト価格 - 割引金額。

BillAccountID

string

請求書が属するアカウントの ID。

185xxxx3489

BillAccountName

string

請求書が属するアカウントの名前。

test@test.aliyunid.com

BillingDate

string

YYYY-MM-DD フォーマットの課金日。サポートされていません。

2020-01-20

BillingItem

string

請求書の課金項目。

Bandwidth

BillingItemCode

string

請求書の課金項目のコード。

disk

BillingType

string

課金方法。

Other

BizType

string

ビジネスタイプ。

trusteeship

CommodityCode

string

商品コード。ユーザーセンターのプロダクト詳細コードと同じです。

rds

CostUnit

string

コストセンター。

Unallocated

Currency

string

通貨。有効な値: CNY。 USD。 JPY。

CNY

DeductedByCoupons

number

クーポンを使用して控除された金額。

0

DeductedByResourcePackage

string

リソースプランを使用して控除された金額。

0

InstanceConfig

string

インスタンスの詳細な構成。

CPU:12

InstanceID

string

インスタンス ID。

i-kjhdskjgshfdlkjfdh

InstanceSpec

string

インスタンスタイプ。

ecs.sn1ne.3xlarge

InternetIP

string

パブリック IP アドレス。

34.xx.x.x

IntranetIP

string

内部 IP アドレス。

192.xx.xx.xx

InvoiceDiscount

number

割引金額。

0

Item

string

請求書タイプ。有効な値:

  • SubscriptionOrder: サブスクリプション注文。

  • PayAsYouGoBill: 従量課金請求書。

  • Refund: 返金。

  • Adjustment: 調整。

PayAsYouGoBill

ItemName

string

項目名。

iZ28bycvyb4Z

ListPrice

string

リスト価格。

0.12

ListPriceUnit

string

リスト価格の単位。

USD/GB

NickName

string

インスタンスのニックネーム。

nick

OwnerID

string

リソース所有者のアカウント ID。このパラメーターは、マルチアカウント支払いシナリオで使用されます。

169***013

PipCode

string

プロダクトコード。ユーザーセンターの請求書に記載されているプロダクトコードと同じです。

rds

PretaxAmount

number

支払金額。

0

PretaxGrossAmount

number

元の金額。

0

ProductCode

string

プロダクトのコード。

rds

ProductDetail

string

プロダクトの詳細。

ApsaraDB RDS

ProductName

string

プロダクト名。

ApsaraDB RDS

ProductType

string

プロダクトのタイプ。

rds

Region

string

リージョン。

Hangzhou

ResourceGroup

string

リソースグループ。

デフォルトリソースグループ

ServicePeriod

string

サービスの持続時間。

20

ServicePeriodUnit

string

サービスの持続時間の単位。

Hour

SplitAccountID

string

アタッチされたリソースが属するアカウントの ID。

12**122

SplitAccountName

string

アタッチされたリソースが属するアカウントの名前。

test**1122

SplitBillingCycle

string

コスト配分された分割請求書の課金サイクル。

2021-06

SplitBillingDate

string

コスト配分された分割請求書の課金日。

2021-06-01

SplitCommodityCode

string

アタッチされたリソースの商品コード。

rds

SplitItemID

string

アタッチされたリソースの ID。

i-28bycvyb4

SplitItemName

string

アタッチされたリソースの名前。

iZ28bycvyb4Z

SplitProductDetail

string

アタッチされたリソースのプロダクト詳細名。

ApsaraDB

SubscriptionType

string

サブスクリプションタイプ。有効な値:

  • Subscription: サブスクリプション。

  • PayAsYouGo: 従量課金。

PayAsYouGo

Tag

string

リソースタグ。リソースのタグが変更された場合、残りの期間に生成される請求書やレートには新しいタグが付けられます。

キー:testKey 値:testValue; キー:testKey1 値:testValues1

Usage

string

使用量。

100

UsageUnit

string

使用量の単位。

GB

Zone

string

ゾーン。

China North 1

MaxResults

integer

このリクエストで返されるレコードの最大値。

20

NextToken

string

現在の呼び出しで読み取りを開始する位置。空の値は、すべてのデータが読み取られたことを示します。次の呼び出しでは、NextToken リクエストパラメーターにこの値を設定します。

CAESEgoQCg4K

TotalCount

integer

レコードの総数。

20

Message

string

エラーメッセージ。

成功しました!

RequestId

string

リクエスト ID。

79EE7556-0CFD-44EB-9CD6-B3B526E3A85F

Success

boolean

リクエストが成功したかどうかを示します。

true

例

成功レスポンス

JSONJSON

{
  "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": "带宽",
        "BillingItemCode": "disk",
        "BillingType": "其它",
        "BizType": "trusteeship",
        "CommodityCode": "rds",
        "CostUnit": "未分配",
        "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": "元/GB",
        "NickName": "nick",
        "OwnerID": "169***013",
        "PipCode": "rds",
        "PretaxAmount": 0,
        "PretaxGrossAmount": 0,
        "ProductCode": "rds",
        "ProductDetail": "云数据库RDS",
        "ProductName": "云数据库RDS",
        "ProductType": "rds",
        "Region": "杭州",
        "ResourceGroup": "默认资源组",
        "ServicePeriod": "20",
        "ServicePeriodUnit": "小时",
        "SplitAccountID": "12**122",
        "SplitAccountName": "test**1122",
        "SplitBillingCycle": "2021-06",
        "SplitBillingDate": "2021-06-01",
        "SplitCommodityCode": "rds",
        "SplitItemID": "i-28bycvyb4",
        "SplitItemName": "iZ28bycvyb4Z",
        "SplitProductDetail": "云数据库",
        "SubscriptionType": "PayAsYouGo",
        "Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
        "Usage": "100",
        "UsageUnit": "GB",
        "Zone": "华北1"
      }
    ],
    "MaxResults": 20,
    "NextToken": "CAESEgoQCg4K",
    "TotalCount": 20
  },
  "Message": "Successful!",
  "RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Success": true
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。