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 MONTH_DATE (optional)
- Display data for the month and date that is specified by using the YYYY-MM format. If not specified, usage of the current month is shown.
- --output FORMAT (optional)
- Specify output format. Accepted inputs are JSON and CSV.
- -q, --quiet (optional)
- Suppress verbose output.
Examples
Show current account's usage and cost report in 2016-06:
ibmcloud billing account-usage -d 2016-06
ibmcloud billing org-usage
Show monthly usage for an org (account admin or org billing manager only):
ibmcloud billing org-usage ORG_NAME [-d YYYY-MM] [--output FORMAT] [-q, --quiet]
Command options
- ORG_NAME (required)
- Name of the org.
- -d MONTH_DATE (optional)
- Display data for the month and date that is specified by using the YYYY-MM format. If not specified, usage of the current month is shown.
- --output FORMAT (optional)
- Specify output format. Only JSON is supported.
- -q, --quiet (optional)
- Suppress verbose output.
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 MONTH_DATE (optional)
- Display data for the month and date that is specified by using the YYYY-MM format. If not specified, usage of the current month is shown.
- --output FORMAT (optional)
- Specify 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 MONTH_DATE (optional)
- Display data for month and date that is specified by using the YYYY-MM format. If not specified, usage of the current month is shown.
- --output FORMAT (optional)
- Specify 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 current month.
- --output FORMAT (optional)
- Specify output format. Only JSON is supported.
- -q, --quiet (optional)
- Suppress verbose output.