メインコンテンツまでスキップ

組織のCCU使用量をクエリする

組織内または指定されたアカウント内の各クラスターのCCU使用量をクエリします。

注意

この操作には、組織のルートアカウントメンバーの application key と、請求の表示および管理権限が必要です。

リクエスト​

基本情報
HTTP URLhttps://cloud-api.celerdata.com/api/1.0/org/cluster/usage
HTTP メソッドPOST
頻度600/分

ヘッダーパラメータ​

パラメータ例必須タイプ説明
AuthorizationBearer OGQ5MDA4MZGTNJMWNS0ZY2Y2LWFJNZYTOTBINMZIYTGZZDUYはいStringCelerData Cloud BYOC API にアクセスするためのアクセストークン。形式: Bearer <access_token>。

アクセストークンを取得する を参照してください。

クエリパラメータ​

パラメータ例必須タイプ説明
account_ids["acc_01","acc_02"]いいえArrayCCU使用量をクエリしたいアカウントのID。
start_date20230701はいStringクエリする期間の開始日。形式: yyyyMMdd。
end_date20230731はいStringクエリする期間の終了日。形式: yyyyMMdd。
start_date は end_date 以下でなければならず、start_date から end_date を引いた結果は0から31の範囲でなければなりません。
show_daily_detailtrueいいえBooleanシステムがクラスターの日次使用量を返すかどうか。 有効な値: true および false(デフォルト)。

例:

{
    // 組織のCCU使用量を2025-06-01 00:00:00 UTCから2025-06-30 23:59:59 UTCまでクエリし、クラスターの日次使用量を取得します。
    "start_date": "20250601",
    "end_date": "20250630",
    "show_daily_detail": true
}

レスポンス​

サンプルレスポンス​

{
    "code": 20000,
    "data": {
        "total_usage": "3.253717",
        "accounts": [
            {
                "account_id": "lbyx05t5a",
                "account_name": "123",
                "account_email": "test@celerdata.com",
                "total_usage": "2.240385",
                "clusters": [
                    {
                        "cluster_id": "e19feed8-f29b-48a3-bd52-db391a912121",
                        "cluster_name": "test_elastic_tutorial",
                        "total_usage": "2.240385",
                        "daily_usages": [
                            {
                                "usage": "2.240385",
                                "date": 20250310,
                                "time_stamp": 1741564800
                            }
                        ]
                    }
                ]
            },
            {
                "account_id": "0qhbudg4w",
                "account_name": "456",
                "account_email": "test2@celerdata.com",
                "total_usage": "1.013332",
                "clusters": [
                    {
                        "cluster_id": "fea50468-c18b-446e-b05d-a66fce1094f2",
                        "cluster_name": "test002",
                        "total_usage": "1.013332",
                        "daily_usages": [
                            {
                                "usage": "1.013332",
                                "date": 20250331,
                                "time_stamp": 1743379200
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

レスポンス要素​

パラメータ例タイプ説明
code20000Integerエラーコード。エラーコードが 20000 の場合、リクエストは成功しました。それ以外のエラーコードが返された場合、リクエストは失敗しました。
data-ObjectAPI呼び出しの結果。data オブジェクトは一部のAPIアクションでは返されない場合があります。以下の要素で構成されています:
  • total_usage
  • usage_details
data.total_usage3.253717String選択された期間における組織または指定されたアカウントの総CCU使用量。
data.accounts-Array組織の総使用量が 0 でない場合のアカウントごとのCCU使用量の詳細。以下の要素で構成されています:
  • account_id
  • account_name
  • account_email
  • total_usage
  • clusters
data.accounts.account_idlbyx0bt7aStringアカウントのID。
data.accounts.account_nameacc_01Stringアカウントの名前。
data.accounts.account_emailx1@xxx.comStringアカウントのメールアドレス。
data.accounts.total_usage5.064104String選択された期間におけるアカウントのCCU使用量。
data.accounts.clusters-Arrayアカウントの総使用量が 0 でない場合のクラスターごとのCCU使用量の詳細。以下の要素で構成されています:
  • cluster_id
  • cluster_name
  • total_usage
  • daily_usages
data.accounts.clusters.cluster_id9d4b52ce-c272-48fb-9bdf-7c55ed7925abStringクラスターのID。
data.accounts.clusters.cluster_namecluster_01Stringクラスターの名前。
data.accounts.clusters.total_usage1.013332String選択された期間におけるクラスターのCCU使用量。
data.accounts.clusters.daily_usages1.013332Arrayクラスターの日次CCU使用量の詳細。以下の要素で構成されています:
  • usage
  • date
  • time_stamp
data.accounts.clusters.daily_usages.usage1.013332String特定の日におけるクラスターのCCU使用量。
data.accounts.clusters.daily_usages.date20250601String記録されたクラスターCCU使用量の日付。
data.accounts.clusters.daily_usages.time_stamp1743379200Integer日付の0:00:00に対応するタイムスタンプ（秒単位）。
messageparam start_date is invalidStringエラーメッセージ。この要素は code が 20000 でない場合にのみ返されます。
注意
リクエストが成功したか失敗したかを message の返り値に基づいて判断しないでください。