project_pipeline_counts
Gets or lists a project_pipeline_counts resource.
Overview​
| Name | project_pipeline_counts |
| Type | Resource |
| Id | gitlab.ci.project_pipeline_counts |
Fields​
The following fields are returned by SELECT queries:
- get
GraphQL response envelope
| Name | Datatype | Description |
|---|---|---|
all_ | integer | Total number of pipelines for the project. |
finished | integer | Number of pipelines with scope FINISHED for the project |
pending | integer | Number of pipelines with scope PENDING for the project |
running | integer | Number of pipelines with scope RUNNING for the project |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | full_path, host | ref, sha, source | Pipeline counts of the project. Generated from the GitLab GraphQL schema field Project.pipelineCounts (PipelineCounts). |
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 |
|---|---|---|
full_path | string | Full path of the project, for example gitlab-org/gitlab |
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) |
ref | string | Filter pipelines by the ref they are run for. |
sha | string | Filter pipelines by the SHA of the commit they are run for. |
source | string | Filter pipelines by their source. |
SELECT examples​
- get
Pipeline counts of the project. Generated from the GitLab GraphQL schema field Project.pipelineCounts (PipelineCounts).
SELECT
all_,
finished,
pending,
running
FROM gitlab.ci.project_pipeline_counts
WHERE full_path = '{{ full_path }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
AND ref = '{{ ref }}'
AND sha = '{{ sha }}'
AND source = '{{ source }}'
;