Skip to main content
Sign in Dashboard Get started
  1. Docs
  2. pulumi org usage get | CLI commands

pulumi org usage get | CLI commands

Generated for Pulumi CLI v3.243.0.

    [EXPERIMENTAL] Fetch the resources-under-management summary for an organization

    Synopsis

    [EXPERIMENTAL] Fetch the resources-under-management summary for an organization.

    Returns the Resources Under Management (RUM) and Resource Hours Under Management (RHUM) totals for the organization, bucketed by the requested granularity. Default output is a human-readable table; pass –output=json for the full response as a JSON envelope.

    Wraps the GetUsageSummaryResourceHours Pulumi Cloud REST endpoint.

    pulumi org usage get [flags]

    Examples

      # Summary for the default org, server-chosen granularity and window.
  pulumi org usage get

  # Daily summary for the last 30 days.
  pulumi org usage get --granularity daily --lookback-days 30

  # Hourly summary ending at a specific time (Unix seconds).
  pulumi org usage get --granularity hourly --lookback-start 1700000000

  # JSON output for scripting.
  pulumi org usage get --output json

    Options

          --granularity string   Time granularity for aggregation. One of: hourly, daily, monthly (default "daily")
  -h, --help                 help for get
      --lookback-days int    Number of days to look back from --lookback-start (or the current time) (default 30)
      --lookback-start int   Unix timestamp (seconds) marking the end of the lookback window
      --org string           Organization to fetch usage for (defaults to the current default org)
      --output string        Output format. Supported values are: default and json (default "default")

    Options inherited from parent commands

          --color string                 Colorize output. Choices are: always, never, raw, auto (default "auto")
  -C, --cwd string                   Run pulumi as if it had been started in another directory
      --disable-integrity-checking   Disable integrity checking of checkpoint files
  -e, --emoji                        Enable emojis in the output
  -Q, --fully-qualify-stack-names    Show fully-qualified stack names
      --logflow                      Flow log settings to child processes (like plugins)
      --logtostderr                  Log to stderr instead of to files
      --memprofilerate int           Enable more precise (and expensive) memory allocation profiles by setting runtime.MemProfileRate
      --non-interactive              Disable interactive mode for all commands
      --otel-traces string           Export OpenTelemetry traces to the specified endpoint. Use file:// for local JSON files, grpc:// for remote collectors
      --profiling string             Emit CPU and memory profiles and an execution trace to '[filename].[pid].{cpu,mem,trace}', respectively
      --tracing file:                Emit tracing to the specified endpoint. Use the file: scheme to write tracing data to a local file
  -v, --verbose int                  Enable verbose logging (e.g., v=3); anything >3 is very verbose

    SEE ALSO