Skip to main content

group_releases

Gets or lists a group_releases resource.

Overview​

Namegroup_releases
TypeResource
Idgitlab.groups.group_releases

Fields​

The following fields are returned by SELECT queries:

GraphQL response envelope

NameDatatypeDescription
idstringGlobal ID of the release.
namestringName of the release.
tag_namestringName of the tag associated with the release.
authorobjectUserCore identity (id, username, name)
created_atstringTimestamp of when the release was created.
descriptionstringDescription (also known as "release notes") of the release.
historical_releasebooleanIndicates the release is a historical release.
released_atstringTimestamp of when the release was released.
tag_pathstringRelative web path to the tag associated with the release.
upcoming_releasebooleanIndicates the release is an upcoming release.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectfull_path, hostsortReleases 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.

NameDatatypeDescription
full_pathstringFull path of the group, for example gitlab-org
hoststringGitLab 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)
sortstringSort group releases by given criteria.

SELECT examples​

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 }}'
;