Viewing billing and usage information (ibmcloud billing)
Use the following commands from the IBM Cloud® Command Line Interface to retrieve resource usage and billing information.
ibmcloud billing account-usage
Show monthly usage of the current account (account admin only):
ibmcloud billing account-usage [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
Command options
- -d {YEAR-MONTH} (optional)
- Display data for the month that is specified by using the YYYY-MM format. If not specified, usage of the current month is shown.
- --output {FORMAT TYPE} (optional)
- Specify the output format. Accepted inputs are JSON and CSV.
- -q, --quiet (optional)
- Suppress verbose output.
Examples
Show current account's usage and cost report in 2024-06:
ibmcloud billing account-usage -d 2024-06
ibmcloud billing resource-group-usage
Show monthly usage for a resource group (account admin or resource group admin only):
ibmcloud billing resource-group-usage GROUP_NAME [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
Command options
- GROUP_NAME (required)
- Name of the resource group.
- -d {YEAR-MONTH} (optional)
- Display data for the month that is specified by using the YYYY-MM format. If not specified, usage of the current month is shown.
- --output {FORMAT} (optional)
- Specify the output format. Only JSON is supported.
- -q, --quiet (optional)
- Suppress verbose output.
ibmcloud billing resource-instances-usage
Show monthly resource instances usage under the current account:
ibmcloud billing resource-instances-usage [-o ORG] [-g RESOURCE_GROUP] [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
Command options
- -o {ORG_NAME} (optional)
- Filter instances by organization.
- -g {GROUP_NAME}
- Filter instance by resource group.
- -d {YEAR-MONTH} (optional)
- Display data for month that is specified by using the YYYY-MM format. If not specified, usage of the current month is shown.
- --output {FORMAT} (optional)
- Specify the output format. Accepted inputs are JSON and CSV.
- -q, --quiet (optional)
- Suppress verbose output.
ibmcloud billing enterprise-usage
Show enterprise usage reports:
ibmcloud billing enterprise-usage [--account-group ACCOUNT_GROUP_NAME | --account-group-id ACCOUNT_GROUP_ID | --account ACCOUNT_NAME | --account-id ACCOUNT_ID] [--month MONTH] [--children] [--output FORMAT] [-q, --quiet]
Command options
- --account {ACCOUNT_NAME} (optional)
- Name of target account.
- --account-id {ACCOUNT_ID} (optional)
- ID of target account.
- --account-group {ACCOUNT_GROUP_NAME} (optional)
- Name of target account group.
- --account-group-id {ACCOUNT_GROUP_ID} (optional)
- ID of target account group.
- --children (optional)
- Show children usage reports.
- --month {MONTH} (optional)
- Target month. Default to the current month.
- --output {FORMAT} (optional)
- Specify the output format. Only JSON is supported.
- -q, --quiet (optional)
- Suppress verbose output.