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

日次使用量を照会する (V2)

指定した期間における、指定した組織の日次使用量を照会します。現在のユーザーは組織オーナーまたは請求管理者である必要があります。

POST/v2/usage/query
接続エンドポイント

https://api.cloud.zilliz.com

NaN
shell
export BASE_URL="https://api.cloud.zilliz.com"
パラメータ
Authorizationstringheader必要

認証トークンは、適切な権限を持つ API key である必要があります。

値の例： Bearer {{TOKEN}}
リクエスト・ボディapplication/json
startstring

照会期間の開始時刻です。形式は YYYY-MM-DD です。

endstring

照会期間の終了時刻です。形式は YYYY-MM-DD です。

bash
export TOKEN="YOUR_API_KEY"

curl --request POST \
--url "${BASE_URL}/v2/usage/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "start": "2024-01-01T00:00:00Z",
    "end": "2024-02-0100:00:00Z"
}'
レスポンス200 OK - application/json

指定した期間における、指定した組織の日次使用量の詳細を返します。

指定した期間における組織の日次使用量の詳細を返します。

codeinteger

レスポンスコード。

dataobject
resultsarray
[]resultsobject
intervalStartstring

照会する期間の開始時刻です。形式は YYYY-MM-DDTHH:mm:ssZ です。

intervalEndstring

照会する期間の終了時刻です。形式は YYYY-MM-DDTHH:mm:ssZ です。

totalnumber

指定した期間内の使用量の合計金額です。

currencystring

合計金額に適用される通貨です。

itemsarray

指定した期間内の使用量の内訳です。

[]itemsobject
costTypestring

コストの種類です。

propertiesobject

現在のコスト項目の詳細です。

projectIdstring

このコスト項目を生成するクラスターが属するプロジェクトの ID です。

regionIdstring

このコスト項目を生成するクラスターが属するリージョンの ID です。

cuTypestring

このコスト項目を生成するクラスターの compute unit (CU) の種類です。

planstring

このコスト項目を生成するクラスターのサブスクリプションプランです。

clusterIdstring

このコスト項目を生成するクラスターの ID です。

quantitynumber

コスト項目に対応する使用済みリソースの量です。

unitstring

コスト項目に対応する使用済みリソース量の単位です。

listPriceobject

コスト項目に対応する使用済みリソースの定価です。

unitPricenumber

使用済みリソースの単価です。

priceobject

コスト項目に対応する使用済みリソースの実際の価格です。

unitPricenumber

使用済みリソースの単価です。

amountnumber

コスト項目に記録された実際のコストです。単位はセントです。

currentPageinteger

照会結果の現在のページ番号です。

値の範囲： ≥ 1
pageSizeinteger

照会結果の 1 ページあたりの項目数です。

値の範囲： ≥ 1≤ 100
totalinteger

照会結果の項目総数です。

エラーメッセージを返します。

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。

Ctrl I