account billable-usage command group

Note

This information applies to Databricks CLI versions 0.205 and above. The Databricks CLI is in Public Preview.

Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.

The account billable-usage command group within the Databricks CLI contains commands to download billable usage logs for the specified account and date range. This feature works with all account types.

databricks account billable-usage download

Return billable usage logs in CSV format for the specified account and date range.

Warning

This method might take multiple minutes to complete. Depending on the queried date range, the number of workspaces in the account, the size of the response and the internet speed of the caller, this API may hit a timeout after a few minutes. If you experience this, try to mitigate by calling the API with narrower date ranges.

databricks account billable-usage download START_MONTH END_MONTH [flags]

Arguments

START_MONTH

    Format: YYYY-MM. First month to return billable usage logs for. Billable usage logs are unavailable before March 2019 (2019-03).

END_MONTH

    Format: YYYY-MM. Last month to return billable usage logs for.

Options

--personal-data

    Specify whether to include personally identifiable information in the billable usage logs, for example the email addresses of cluster creators.

Global flags

Examples

The following example downloads billable usage logs for a date range:

databricks account billable-usage download 2024-01 2024-03

The following example downloads billable usage logs including personal data:

databricks account billable-usage download 2024-01 2024-03 --personal-data

The following example downloads billable usage logs for a single month:

databricks account billable-usage download 2024-03 2024-03

Global flags

--debug

  Whether to enable debug logging.

-h or --help

    Display help for the Databricks CLI or the related command group or the related command.

--log-file string

    A string representing the file to write output logs to. If this flag is not specified then the default is to write output logs to stderr.

--log-format format

    The log format type, text or json. The default value is text.

--log-level string

    A string representing the log format level. If not specified then the log format level is disabled.

-o, --output type

    The command output type, text or json. The default value is text.

-p, --profile string

    The name of the profile in the ~/.databrickscfg file to use to run the command. If this flag is not specified then if it exists, the profile named DEFAULT is used.

--progress-format format

    The format to display progress logs: default, append, inplace, or json

-t, --target string

    If applicable, the bundle target to use