costs
orc costs get は、対象Workspaceのcredit費用を日次bucketで取得します。--group-by cost_type で費用種別ごとに分けられます。
--start-time は必須のRFC 3339日時で、その時刻を含みます。--end-time は含まない上限で、開始より後を指定します。範囲は最大90日です。終了を省略すると各requestの現在時刻を使うため、ページ送りでは終了を明示して範囲を固定します。
使い方
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化できます。
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。必須。
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。任意。
orc costs get --end-time <value>--bucket-width
Cost reports support daily buckets only. Defaults to 1d.; enum: 1d
型: string。任意。
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。任意。
orc costs get --group-by <value>使用例
種別ごとのJSONを取得します。
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 では、次のグローバルオプションを使用できます。
各オプションの詳細と使用例は、グローバルオプションを参照してください。