Skip to content

✨ feat(iaas): add consumption aggregate commands#200

Merged
jfbus merged 1 commit into
mainfrom
consumption_summaries
Jun 11, 2026
Merged

✨ feat(iaas): add consumption aggregate commands#200
jfbus merged 1 commit into
mainfrom
consumption_summaries

Conversation

@jfbus

@jfbus jfbus commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Description

This adds octl iaas consumption aggregate commands.

Type of Change

Please check the relevant option(s):

  • 🐛 Bug fix
  • ✨ New feature
  • 🧹 Code cleanup or refactor
  • 📝 Documentation update
  • 🔧 Build or CI-related change
  • 🔒 Security fix
  • Other (specify):

How Has This Been Tested?

Please describe the test strategy:

  • Manual testing
  • Unit tests
  • Integration tests
  • Not tested yet

Checklist

  • I have followed the Contributing Guidelines
  • I have added tests or explained why they are not needed
  • I have updated relevant documentation (README, examples, etc.)
  • My changes follow the Conventional Commits specification
  • My commits include appropriate Gitmoji

Additional Context

@github-actions

github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown

WARNING : Differences in reference doc 🤔

 docs/reference/octl_iaas_consumptionaccount.md     |  1 +
 .../octl_iaas_consumptionaccount_aggregate.md      | 38 +++++++++++++++++
 .../octl_iaas_consumptionaccount_aggregate_all.md  | 48 ++++++++++++++++++++++
 ...tl_iaas_consumptionaccount_aggregate_compute.md | 48 ++++++++++++++++++++++
 .../octl_iaas_consumptionaccount_aggregate_gpu.md  | 48 ++++++++++++++++++++++
 5 files changed, 183 insertions(+)
Detailed changes

docs/reference/octl_iaas_consumptionaccount.md

+* [octl iaas consumptionaccount aggregate](octl_iaas_consumptionaccount_aggregate.md)	 - aggregate commands

docs/reference/octl_iaas_consumptionaccount_aggregate.md

new file mode 100644
+## octl iaas consumptionaccount aggregate
+
+aggregate commands
+
+### Options
+
+```
+  -h, --help   help for aggregate
+```
+
+### Options inherited from parent commands
+
+```
+  -c, --columns string              columns to display - [+]<title>:<jq query for content>||<title>:<jq query for content>
+      --config string               Path of profile file (by default, ~/.osc/config.json)
+      --filter strings              comma separated list of filters for results - name:value,name:value, alias for jq filter 'select(.name | test("value"))'
+      --jq string                   jq filter
+      --no-upgrade                  do not check for new versions
+  -O, --out-file string             redirect output to file
+  -o, --output string               output format (raw, json, yaml, table, csv, none, base64, text)
+      --payload string              JSON content for query body
+      --profile string              Profile to use in profile file (by default, "default")
+      --single                      convert single entry lists to a single object
+      --template string             JSON template file for query body
+  -v, --verbose                     Verbose output
+      --waitfor string              jq expression to wait for - octl will query every waitfor-interval until the expression returns 1/true or a non empty result
+      --waitfor-interval duration   interval between two waitfor iterations (default 5s)
+      --waitfor-timeout duration    maximum duration of a wait (default 10m0s)
+  -y, --yes                         answer yes to all prompts
+```
+
+### SEE ALSO
+
+* [octl iaas consumptionaccount](octl_iaas_consumptionaccount.md)	 - consumptionaccount commands
+* [octl iaas consumptionaccount aggregate all](octl_iaas_consumptionaccount_aggregate_all.md)	 - Aggregate all costs using ReadConsumptionAccount
+* [octl iaas consumptionaccount aggregate compute](octl_iaas_consumptionaccount_aggregate_compute.md)	 - Aggregate all compute costs using ReadConsumptionAccount
+* [octl iaas consumptionaccount aggregate gpu](octl_iaas_consumptionaccount_aggregate_gpu.md)	 - Aggregate all GPU costs using ReadConsumptionAccount
+

docs/reference/octl_iaas_consumptionaccount_aggregate_all.md

new file mode 100644
+## octl iaas consumptionaccount aggregate all
+
+Aggregate all costs using ReadConsumptionAccount
+
+### Synopsis
+
+> *Aggregate all costs using ReadConsumptionAccount*
+
+Gets information about the consumption of your OUTSCALE account for each billable resource within the specified time period.
+
+```
+octl iaas consumptionaccount aggregate all [flags]
+```
+
+### Options
+
+```
+      --from-date osctime   The beginning of the time period, in ISO 8601 date format (for example, 2020-06-14).
+  -h, --help                help for all
+      --overall             If false, returns only the consumption of the specific account that sends this request.
+      --to-date osctime     The end of the time period, in ISO 8601 date format (for example, 2020-06-30).
+```
+
+### Options inherited from parent commands
+
+```
+  -c, --columns string              columns to display - [+]<title>:<jq query for content>||<title>:<jq query for content>
+      --config string               Path of profile file (by default, ~/.osc/config.json)
+      --filter strings              comma separated list of filters for results - name:value,name:value, alias for jq filter 'select(.name | test("value"))'
+      --jq string                   jq filter
+      --no-upgrade                  do not check for new versions
+  -O, --out-file string             redirect output to file
+  -o, --output string               output format (raw, json, yaml, table, csv, none, base64, text)
+      --payload string              JSON content for query body
+      --profile string              Profile to use in profile file (by default, "default")
+      --single                      convert single entry lists to a single object
+      --template string             JSON template file for query body
+  -v, --verbose                     Verbose output
+      --waitfor string              jq expression to wait for - octl will query every waitfor-interval until the expression returns 1/true or a non empty result
+      --waitfor-interval duration   interval between two waitfor iterations (default 5s)
+      --waitfor-timeout duration    maximum duration of a wait (default 10m0s)
+  -y, --yes                         answer yes to all prompts
+```
+
+### SEE ALSO
+
+* [octl iaas consumptionaccount aggregate](octl_iaas_consumptionaccount_aggregate.md)	 - aggregate commands
+

docs/reference/octl_iaas_consumptionaccount_aggregate_compute.md

new file mode 100644
+## octl iaas consumptionaccount aggregate compute
+
+Aggregate all compute costs using ReadConsumptionAccount
+
+### Synopsis
+
+> *Aggregate all compute costs using ReadConsumptionAccount*
+
+Gets information about the consumption of your OUTSCALE account for each billable resource within the specified time period.
+
+```
+octl iaas consumptionaccount aggregate compute [flags]
+```
+
+### Options
+
+```
+      --from-date osctime   The beginning of the time period, in ISO 8601 date format (for example, 2020-06-14).
+  -h, --help                help for compute
+      --overall             If false, returns only the consumption of the specific account that sends this request.
+      --to-date osctime     The end of the time period, in ISO 8601 date format (for example, 2020-06-30).
+```
+
+### Options inherited from parent commands
+
+```
+  -c, --columns string              columns to display - [+]<title>:<jq query for content>||<title>:<jq query for content>
+      --config string               Path of profile file (by default, ~/.osc/config.json)
+      --filter strings              comma separated list of filters for results - name:value,name:value, alias for jq filter 'select(.name | test("value"))'
+      --jq string                   jq filter
+      --no-upgrade                  do not check for new versions
+  -O, --out-file string             redirect output to file
+  -o, --output string               output format (raw, json, yaml, table, csv, none, base64, text)
+      --payload string              JSON content for query body
+      --profile string              Profile to use in profile file (by default, "default")
+      --single                      convert single entry lists to a single object
+      --template string             JSON template file for query body
+  -v, --verbose                     Verbose output
+      --waitfor string              jq expression to wait for - octl will query every waitfor-interval until the expression returns 1/true or a non empty result
+      --waitfor-interval duration   interval between two waitfor iterations (default 5s)
+      --waitfor-timeout duration    maximum duration of a wait (default 10m0s)
+  -y, --yes                         answer yes to all prompts
+```
+
+### SEE ALSO
+
+* [octl iaas consumptionaccount aggregate](octl_iaas_consumptionaccount_aggregate.md)	 - aggregate commands
+

docs/reference/octl_iaas_consumptionaccount_aggregate_gpu.md

new file mode 100644
+## octl iaas consumptionaccount aggregate gpu
+
+Aggregate all GPU costs using ReadConsumptionAccount
+
+### Synopsis
+
+> *Aggregate all GPU costs using ReadConsumptionAccount*
+
+Gets information about the consumption of your OUTSCALE account for each billable resource within the specified time period.
+
+```
+octl iaas consumptionaccount aggregate gpu [flags]
+```
+
+### Options
+
+```
+      --from-date osctime   The beginning of the time period, in ISO 8601 date format (for example, 2020-06-14).
+  -h, --help                help for gpu
+      --overall             If false, returns only the consumption of the specific account that sends this request.
+      --to-date osctime     The end of the time period, in ISO 8601 date format (for example, 2020-06-30).
+```
+
+### Options inherited from parent commands
+
+```
+  -c, --columns string              columns to display - [+]<title>:<jq query for content>||<title>:<jq query for content>
+      --config string               Path of profile file (by default, ~/.osc/config.json)
+      --filter strings              comma separated list of filters for results - name:value,name:value, alias for jq filter 'select(.name | test("value"))'
+      --jq string                   jq filter
+      --no-upgrade                  do not check for new versions
+  -O, --out-file string             redirect output to file
+  -o, --output string               output format (raw, json, yaml, table, csv, none, base64, text)
+      --payload string              JSON content for query body
+      --profile string              Profile to use in profile file (by default, "default")
+      --single                      convert single entry lists to a single object
+      --template string             JSON template file for query body
+  -v, --verbose                     Verbose output
+      --waitfor string              jq expression to wait for - octl will query every waitfor-interval until the expression returns 1/true or a non empty result
+      --waitfor-interval duration   interval between two waitfor iterations (default 5s)
+      --waitfor-timeout duration    maximum duration of a wait (default 10m0s)
+  -y, --yes                         answer yes to all prompts
+```
+
+### SEE ALSO
+
+* [octl iaas consumptionaccount aggregate](octl_iaas_consumptionaccount_aggregate.md)	 - aggregate commands
[...]

@jfbus jfbus force-pushed the consumption_summaries branch from e014fc5 to 8a1250a Compare June 3, 2026 12:55
@jfbus jfbus changed the title Consumption summaries ✨ feat(iaas): add consumption aggregate commands Jun 3, 2026
@github-actions

github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown

Binary size: 81.7MB => 81.7MB (change +4KB, +0.0%) 😉

@jfbus jfbus force-pushed the consumption_summaries branch from 8a1250a to 810de3f Compare June 3, 2026 14:25
@jfbus jfbus force-pushed the consumption_summaries branch from 810de3f to fa074dc Compare June 11, 2026 13:12
@jfbus jfbus marked this pull request as ready for review June 11, 2026 13:12
@jfbus jfbus requested a review from a team June 11, 2026 13:12
@jfbus jfbus requested a review from a team as a code owner June 11, 2026 13:12
@jfbus jfbus merged commit 4b05264 into main Jun 11, 2026
10 checks passed
@jfbus jfbus deleted the consumption_summaries branch June 11, 2026 17:11
@jfbus jfbus added the kind/feature New feature or request label Jun 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/feature New feature or request

Development

Successfully merging this pull request may close these issues.

2 participants