使用量とコスト

costs

orc costs get は、対象Workspaceのcredit費用を日次bucketで取得します。--group-by cost_type で費用種別ごとに分けられます。

--start-time は必須のRFC 3339日時で、その時刻を含みます。--end-time は含まない上限で、開始より後を指定します。範囲は最大90日です。終了を省略すると各requestの現在時刻を使うため、ページ送りでは終了を明示して範囲を固定します。

使い方

terminal
orc costs get --start-time 2026-09-01T00:00:00Z --end-time 2026-10-01T00:00:00Z

期間を固定して取得します。

集計とページ送り

group化を省略すると各bucket内の該当記録を集計します。保存された値がnullのgroup項目は結果から省略されます。--cursor は返された値を変更せず使い、範囲・filter・group条件を維持します。

サブコマンド

get

費用は日次 1d のみです。cost_type でgroup化できます。

terminal
orc costs get [options]

固有のオプション

--start-time

Inclusive lower bound for usage records, as an RFC 3339 timestamp. Required. The range from start_time to end_time cannot exceed 90 days.

型: string。必須。

terminal
orc costs get --start-time <value>
--end-time

Exclusive upper bound for usage records. Must be after start_time. Defaults to the time of each request; set it explicitly to keep a fixed range across pages.

型: string。任意。

terminal
orc costs get --end-time <value>
--bucket-width

Cost reports support daily buckets only. Defaults to 1d.; enum: 1d

型: string。任意。

terminal
orc costs get --bucket-width <value>
--group-by

Split each time bucket by cost_type. Omit to aggregate all matching records in each bucket. Use repeated HTTP query parameters. A grouping field is omitted from a result when its stored value is null.; csv of: cost_type

型: string。任意。

terminal
orc costs get --group-by <value>

使用例

種別ごとのJSONを取得します。

terminal
orc costs get --start-time 2026-09-01T00:00:00Z --end-time 2026-10-01T00:00:00Z --group-by cost_type --json

種別ごとのJSONを取得します。

必要な権限

認証し、対象Workspaceを選択して実行します。対象Workspaceへのアクセスが必要です。

グローバルオプション

orc costs では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。