ci_minutes_usage
Gets or lists a ci_minutes_usage resource.
Overview​
| Name | ci_minutes_usage |
| Type | Resource |
| Id | gitlab.ci.ci_minutes_usage |
Fields​
The following fields are returned by SELECT queries:
- list
GraphQL response envelope
| Name | Datatype | Description |
|---|---|---|
minutes | integer | Total number of compute minutes used by all projects in the namespace. |
month | string | Month related to the usage data. |
month_iso8601 | string | Month related to the usage data in ISO 8601 date format. |
shared_runners_duration | integer | Total duration (in seconds) of shared runners use by the namespace for the month. |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | host | date, namespace_id | Compute usage data for a namespace. Generated from the GitLab GraphQL schema field Query.ciMinutesUsage (connection of CiMinutesNamespaceMonthlyUsage nodes). |
Parameters​
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
host | string | GitLab host, with an optional port (default gitlab.com). Resolved from the GITLAB_HOST environment variable when it is set (x-stackQL-envVar); a WHERE host value always takes precedence. Self-managed instances: the provider is generated from the gitlab.com schema, so older instances may reject fields they do not serve. (default: gitlab.com, x-stackQL-envVar: GITLAB_HOST) |
date | string | Date for which to retrieve the usage data, should be the first day of a month. |
namespace_id | string | Global ID of the Namespace for the monthly compute usage. |
SELECT examples​
- list
Compute usage data for a namespace. Generated from the GitLab GraphQL schema field Query.ciMinutesUsage (connection of CiMinutesNamespaceMonthlyUsage nodes).
SELECT
minutes,
month,
month_iso8601,
shared_runners_duration
FROM gitlab.ci.ci_minutes_usage
WHERE host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
AND date = '{{ date }}'
AND namespace_id = '{{ namespace_id }}'
;