group_releases
Gets or lists a group_releases resource.
Overview​
| Name | group_releases |
| Type | Resource |
| Id | gitlab.groups.group_releases |
Fields​
The following fields are returned by SELECT queries:
- list
GraphQL response envelope
| Name | Datatype | Description |
|---|---|---|
id | string | Global ID of the release. |
name | string | Name of the release. |
tag_name | string | Name of the tag associated with the release. |
author | object | UserCore identity (id, username, name) |
created_at | string | Timestamp of when the release was created. |
description | string | Description (also known as "release notes") of the release. |
historical_release | boolean | Indicates the release is a historical release. |
released_at | string | Timestamp of when the release was released. |
tag_path | string | Relative web path to the tag associated with the release. |
upcoming_release | boolean | Indicates the release is an upcoming release. |
Methods​
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | full_path, host | sort | Releases belonging to projects in the group. Generated from the GitLab GraphQL schema field Group.releases (connection of Release 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 |
|---|---|---|
full_path | string | Full path of the group, for example gitlab-org |
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) |
sort | string | Sort group releases by given criteria. |
SELECT examples​
- list
Releases belonging to projects in the group. Generated from the GitLab GraphQL schema field Group.releases (connection of Release nodes).
SELECT
id,
name,
tag_name,
author,
created_at,
description,
historical_release,
released_at,
tag_path,
upcoming_release
FROM gitlab.groups.group_releases
WHERE full_path = '{{ full_path }}' -- required
AND host = '{{ host }}' -- required (defaults to gitlab.com; or set GITLAB_HOST)
AND sort = '{{ sort }}'
;