Deployments

GetUsageSummaryDeployCompute

Retrieves a summary of Pulumi Deployments compute usage (deployment minutes) for an organization. The response provides aggregated deployment minute consumption over the specified time period. Use the 'granularity' parameter to control time bucketing (e.g. 'daily' or 'hourly'), and either 'lookbackDays' (number of days from the current date) or 'lookbackStart' (a Unix timestamp) to define the reporting window. Returns 204 No Content if no usage data is available for the specified period.

get/api/orgs/{orgName}/deployments/summary

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/orgs/{orgName}/deployments/summary
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

Query parameters

granularity'yearly' | 'monthly' | 'weekly' | 'daily' | 'hourly' required

Time granularity for the summary. Hourly granularity is limited to a 2-day lookback.

lookbackDaysinteger

Number of days to look back from the current date. Must be positive; when granularity is 'hourly' the value must not exceed 2. Mutually exclusive with lookbackStart; exactly one must be provided.

lookbackStartinteger

Start of the lookback period as a Unix timestamp (seconds since epoch). Must be positive, in the past, and within the last year. Mutually exclusive with lookbackDays; exactly one must be provided.

Response

OK

tagKeysstring[]

The list of tag keys present in the breakdown entries. Only present when a tag breakdown is requested.

Changes

No recorded changes to this operation across all 1 revision of this API.