metalcloud-cli infrastructure utilization

Get resource utilization report for infrastructures

Synopsis

Get detailed utilization report for infrastructure resources within a specified time range. The report provides insights into resource usage patterns and capacity planning for infrastructures.

Required flags: —user-id ID of the user to include in the report —start-time Start time for the report (RFC3339 or date format) —end-time End time for the report (RFC3339 or date format)

Optional flags: —site-id Site IDs to include in the report (can be specified multiple times) —infrastructure-id Infrastructure IDs to include in the report (can be specified multiple times)

Examples:

Get utilization report for user 123 for the last 7 days

metalcloud-cli infrastructure utilization —user-id 123 —start-time 2025-08-01 —end-time 2025-08-08

Get utilization for specific sites and infrastructures

metalcloud-cli infrastructure utilization —user-id 123 —start-time 2025-08-01T00:00:00Z —end-time 2025-08-08T23:59:59Z —site-id 1 —site-id 2 —infrastructure-id 100 —infrastructure-id 101

Get utilization for all infrastructures of a user in specific sites

metalcloud-cli infrastructure utilization —user-id 123 —start-time 2025-08-01 —end-time 2025-08-08 —site-id 1 —site-id 3

metalcloud-cli infrastructure utilization [flags]

Options

      --end-time time            End time for the report.
  -h, --help                     help for utilization
      --infrastructure-id ints   Infrastructure IDs to include in the report.
      --site-id ints             Site IDs to include in the report.
      --start-time time          Start time for the report.
      --user-id int              ID of the user to include in the report.

Options inherited from parent commands

  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")