org.gitlab4j.api

Class GroupApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.GroupApi

All Implemented Interfaces:

Constants

public class GroupApi
extends AbstractApi

This class implements the client side API for the GitLab groups calls.

Nested Class Summary

Nested classes/interfaces inherited from interface org.gitlab4j.api.Constants

Constants.ActionType, Constants.ApplicationScope, Constants.ArchiveFormat, Constants.CommitBuildState, Constants.Encoding, Constants.EpicOrderBy, Constants.GroupOrderBy, Constants.ImpersonationState, Constants.IssueOrderBy, Constants.IssueScope, Constants.IssueState, Constants.JobScope, Constants.LineType, Constants.MergeRequestOrderBy, Constants.MergeRequestScope, Constants.MergeRequestState, Constants.MilestoneState, Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectOrderBy, Constants.SortOrder, Constants.StateEvent, Constants.TargetType, Constants.TokenType

Field Summary

Fields inherited from interface org.gitlab4j.api.Constants

NEXT_PAGE_HEADER, PAGE_HEADER, PAGE_PARAM, PER_PAGE, PER_PAGE_PARAM, PREV_PAGE_HEADER, TOTAL_HEADER, TOTAL_PAGES_HEADER

Constructor Summary

Constructors

Constructor and Description
GroupApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
Group	addGroup(Group group)
Group	addGroup(String name, String path) Creates a new project group.
Group	addGroup(String name, String path, String description, Boolean membershipLock, Boolean shareWithGroupLock, Visibility visibility, Boolean lfsEnabled, Boolean requestAccessEnabled, Integer parentId, Integer sharedRunnersMinutesLimit) Deprecated. Will be removed in version 5.0, replaced by addGroup(String, String, String, Visibility, Boolean, Boolean, Integer)
Group	addGroup(String name, String path, String description, Visibility visibility, Boolean lfsEnabled, Boolean requestAccessEnabled, Integer parentId) Creates a new project group.
void	addLdapGroupLink(Object groupIdOrPath, String cn, AccessLevel groupAccess, String provider) Adds an LDAP group link.
void	addLdapGroupLink(Object groupIdOrPath, String cn, Integer groupAccess, String provider) Adds an LDAP group link.
Member	addMember(Object groupIdOrPath, Integer userId, AccessLevel accessLevel) Adds a user to the list of group members.
Member	addMember(Object groupIdOrPath, Integer userId, AccessLevel accessLevel, Date expiresAt) Adds a user to the list of group members.
Member	addMember(Object groupIdOrPath, Integer userId, Integer accessLevel) Adds a user to the list of group members.
Member	addMember(Object groupIdOrPath, Integer userId, Integer accessLevel, Date expiresAt) Adds a user to the list of group members.
Variable	createVariable(Object groupIdOrPath, String key, String value, Boolean isProtected) Create a new group variable.
void	deleteGroup(Object groupIdOrPath) Removes group with all projects inside.
void	deleteLdapGroupLink(Object groupIdOrPath, String cn) Deletes an LDAP group link.
void	deleteLdapGroupLink(Object groupIdOrPath, String cn, String provider) Deletes an LDAP group link for a specific LDAP provider.
void	deleteVariable(Object groupIdOrPath, String key) Deletes a group variable.
Group	getGroup(Object groupIdOrPath) Get all details of a group.
List<Group>	getGroups() Get a list of groups.
List<Group>	getGroups(GroupFilter filter) Get a list of visible groups for the authenticated user using the provided filter.
Pager<Group>	getGroups(GroupFilter filter, int itemsPerPage) Get a Pager of visible groups for the authenticated user using the provided filter.
Pager<Group>	getGroups(int itemsPerPage) Get a Pager of groups.
List<Group>	getGroups(int page, int perPage) Get a list of groups (As user: my groups, as admin: all groups) and in the specified page range.
List<Group>	getGroups(String search) Get all groups that match your string in their name or path.
Pager<Group>	getGroups(String search, int itemsPerPage) Get all groups that match your string in their name or path.
List<Group>	getGroups(String search, int page, int perPage) Get all groups that match your string in their name or path.
Stream<Group>	getGroupsStream() Get a Stream of groups.
Stream<Group>	getGroupsStream(GroupFilter filter) Get a Stream of visible groups for the authenticated user using the provided filter.
Stream<Group>	getGroupsStream(String search) Get all groups that match your string in their name or path as a Stream.
Member	getMember(Object groupIdOrPath, int userId) Get a group member viewable by the authenticated user.
List<Member>	getMembers(Object groupIdOrPath) Get a list of group members viewable by the authenticated user.
Pager<Member>	getMembers(Object groupIdOrPath, int itemsPerPage) Get a Pager of group members viewable by the authenticated user.
List<Member>	getMembers(Object groupIdOrPath, int page, int perPage) Get a list of group members viewable by the authenticated user in the specified page range.
Stream<Member>	getMembersStream(Object groupIdOrPath) Get a Stream of group members viewable by the authenticated user.
Optional<Group>	getOptionalGroup(Object groupIdOrPath) Get all details of a group as an Optional instance.
Optional<Member>	getOptionalMember(Object groupIdOrPath, int userId) Get a group member viewable by the authenticated user as an Optional instance.
Optional<Variable>	getOptionalVariable(Object groupIdOrPath, String key) Get the details of a group variable as an Optional instance.
List<Project>	getProjects(Object groupIdOrPath) Get a list of projects belonging to the specified group ID.
List<Project>	getProjects(Object groupIdOrPath, GroupProjectsFilter filter) Get a list of projects belonging to the specified group ID and filter.
Pager<Project>	getProjects(Object groupIdOrPath, GroupProjectsFilter filter, int itemsPerPage) Get a Pager of projects belonging to the specified group ID and filter.
Pager<Project>	getProjects(Object groupIdOrPath, int itemsPerPage) Get a Pager of projects belonging to the specified group ID.
List<Project>	getProjects(Object groupIdOrPath, int page, int perPage) Get a list of projects belonging to the specified group ID in the specified page range.
Stream<Project>	getProjectsStream(Object groupIdOrPath) Get a Stream of projects belonging to the specified group ID.
Stream<Project>	getProjectsStream(Object groupIdOrPath, GroupProjectsFilter filter) Get a Stream of projects belonging to the specified group ID and filter.
List<Group>	getSubGroups(Object groupIdOrPath) Get a list of visible direct subgroups in this group.
Pager<Group>	getSubGroups(Object groupIdOrPath, int itemsPerPage) Get a Pager of visible direct subgroups in this group.
List<Group>	getSubGroups(Object groupIdOrPath, List<Integer> skipGroups, Boolean allAvailable, String search, Constants.GroupOrderBy orderBy, Constants.SortOrder sortOrder, Boolean statistics, Boolean owned) Get a list of visible direct subgroups in this group.
Pager<Group>	getSubGroups(Object groupIdOrPath, List<Integer> skipGroups, Boolean allAvailable, String search, Constants.GroupOrderBy orderBy, Constants.SortOrder sortOrder, Boolean statistics, Boolean owned, int itemsPerPage) Get a Pager of visible direct subgroups in this group.
List<Group>	getSubGroups(Object groupIdOrPath, List<Integer> skipGroups, Boolean allAvailable, String search, Constants.GroupOrderBy orderBy, Constants.SortOrder sortOrder, Boolean statistics, Boolean owned, int page, int perPage) Get a list of visible direct subgroups in this group.
Stream<Group>	getSubGroupsStream(Object groupIdOrPath) Get a Stream of visible direct subgroups in this group.
Stream<Group>	getSubGroupsStream(Object groupIdOrPath, List<Integer> skipGroups, Boolean allAvailable, String search, Constants.GroupOrderBy orderBy, Constants.SortOrder sortOrder, Boolean statistics, Boolean owned) Get a Stream of visible direct subgroups in this group.
Variable	getVariable(Object groupIdOrPath, String key) Get the details of a group variable.
List<Variable>	getVariables(Object groupIdOrPath) Get list of a group’s variables.
Pager<Variable>	getVariables(Object groupIdOrPath, int itemsPerPage) Get a Pager of variables belonging to the specified group.
List<Variable>	getVariables(Object groupIdOrPath, int page, int perPage) Get a list of variables for the specified group in the specified page range.
Stream<Variable>	getVariablesStream(Object groupIdOrPath) Get a Stream of variables belonging to the specified group.
void	ldapSync(Object groupIdOrPath) Syncs the group with its linked LDAP group.
void	removeMember(Object groupIdOrPath, Integer userId) Removes member from the group.
Project	transferProject(Object groupIdOrPath, Object projectIdOrPath) Transfer a project to the Group namespace.
Group	updateGroup(Group group) Updates a project group.
Group	updateGroup(Object groupIdOrPath, String name, String path, String description, Boolean membershipLock, Boolean shareWithGroupLock, Visibility visibility, Boolean lfsEnabled, Boolean requestAccessEnabled, Integer parentId, Integer sharedRunnersMinutesLimit) Deprecated. Will be removed in version 5.0, replaced by updateGroup(Object, String, String, String, Visibility, Boolean, Boolean, Integer)
Group	updateGroup(Object groupIdOrPath, String name, String path, String description, Visibility visibility, Boolean lfsEnabled, Boolean requestAccessEnabled, Integer parentId) Updates a project group.
Member	updateMember(Object groupIdOrPath, Integer userId, AccessLevel accessLevel) Updates a member of a group.
Member	updateMember(Object groupIdOrPath, Integer userId, AccessLevel accessLevel, Date expiresAt) Updates a member of a group.
Member	updateMember(Object groupIdOrPath, Integer userId, Integer accessLevel) Updates a member of a group.
Member	updateMember(Object groupIdOrPath, Integer userId, Integer accessLevel, Date expiresAt) Updates a member of a group.
Variable	updateVariable(Object groupIdOrPath, String key, String value, Boolean isProtected) Update a group variable.

Methods inherited from class org.gitlab4j.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getDefaultPerPageParam, getGroupIdOrPath, getPageQueryParams, getPageQueryParams, getPerPageQueryParam, getProjectIdOrPath, getUserIdOrUsername, getWithAccepts, handle, head, isApiVersion, post, post, post, post, post, put, put, putUpload, putUpload, putWithFormData, upload, upload, upload, urlEncode, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GroupApi

public GroupApi(GitLabApi gitLabApi)

Method Detail

getGroups

public List<Group> getGroups()
                      throws GitLabApiException

Get a list of groups. (As user: my groups, as admin: all groups)

GitLab Endpoint: GET /groups

Returns:

the list of groups viewable by the authenticated user

Throws:

GitLabApiException - if any exception occurs

getGroups

public List<Group> getGroups(int page,
                             int perPage)
                      throws GitLabApiException

Get a list of groups (As user: my groups, as admin: all groups) and in the specified page range.

GitLab Endpoint: GET /groups

Parameters:

page - the page to get

perPage - the number of Group instances per page

Returns:

the list of groups viewable by the authenticated userin the specified page range

Throws:

GitLabApiException - if any exception occurs

getGroups

public Pager<Group> getGroups(int itemsPerPage)
                       throws GitLabApiException

Get a Pager of groups. (As user: my groups, as admin: all groups)

GitLab Endpoint: GET /groups

Parameters:

itemsPerPage - the number of Group instances that will be fetched per page

Returns:

the list of groups viewable by the authenticated user

Throws:

GitLabApiException - if any exception occurs

getGroupsStream

public Stream<Group> getGroupsStream()
                              throws GitLabApiException

Get a Stream of groups. (As user: my groups, as admin: all groups)

GitLab Endpoint: GET /groups

Returns:

a Stream of groups viewable by the authenticated user

Throws:

GitLabApiException - if any exception occurs

getGroups

public List<Group> getGroups(String search)
                      throws GitLabApiException

Get all groups that match your string in their name or path.

Parameters:

search - the group name or path search criteria

Returns:

a List containing matching Group instances

Throws:

GitLabApiException - if any exception occurs

getGroups

public List<Group> getGroups(String search,
                             int page,
                             int perPage)
                      throws GitLabApiException

Get all groups that match your string in their name or path.

Parameters:

search - the group name or path search criteria

page - the page to get

perPage - the number of Group instances per page

Returns:

a List containing matching Group instances

Throws:

GitLabApiException - if any exception occurs

getGroups

public Pager<Group> getGroups(String search,
                              int itemsPerPage)
                       throws GitLabApiException

Get all groups that match your string in their name or path.

Parameters:

search - the group name or path search criteria

itemsPerPage - the number of Group instances that will be fetched per page

Returns:

a Pager containing matching Group instances

Throws:

GitLabApiException - if any exception occurs

getGroupsStream

public Stream<Group> getGroupsStream(String search)
                              throws GitLabApiException

Get all groups that match your string in their name or path as a Stream.

Parameters:

search - the group name or path search criteria

Returns:

a Stream containing matching Group instances

Throws:

GitLabApiException - if any exception occurs

getGroups

public List<Group> getGroups(GroupFilter filter)
                      throws GitLabApiException

Get a list of visible groups for the authenticated user using the provided filter.

GitLab Endpoint: GET /groups

Parameters:

filter - the GroupFilter to match against

Returns:

a List<Group> of the matching groups

Throws:

GitLabApiException - if any exception occurs

getGroups

public Pager<Group> getGroups(GroupFilter filter,
                              int itemsPerPage)
                       throws GitLabApiException

Get a Pager of visible groups for the authenticated user using the provided filter.

GitLab Endpoint: GET /groups

Parameters:

filter - the GroupFilter to match against

itemsPerPage - the number of Group instances that will be fetched per page

Returns:

a Pager containing matching Group instances

Throws:

GitLabApiException - if any exception occurs

getGroupsStream

public Stream<Group> getGroupsStream(GroupFilter filter)
                              throws GitLabApiException

Get a Stream of visible groups for the authenticated user using the provided filter.

GitLab Endpoint: GET /groups

Parameters:

filter - the GroupFilter to match against

Returns:

a Stream<Group> of the matching groups

Throws:

GitLabApiException - if any exception occurs

getSubGroups

public List<Group> getSubGroups(Object groupIdOrPath)
                         throws GitLabApiException

Get a list of visible direct subgroups in this group.

GitLab Endpoint: GET /groups/:id/subgroups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

Returns:

a List<Group> containing the group's sub-groups

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab 10.3.0

getSubGroups

public Pager<Group> getSubGroups(Object groupIdOrPath,
                                 int itemsPerPage)
                          throws GitLabApiException

Get a Pager of visible direct subgroups in this group.

GitLab Endpoint: GET /groups/:id/subgroups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

itemsPerPage - the number of Group instances that will be fetched per page

Returns:

a Pager containing matching Group instances

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab 10.3.0

getSubGroupsStream

public Stream<Group> getSubGroupsStream(Object groupIdOrPath)
                                 throws GitLabApiException

Get a Stream of visible direct subgroups in this group.

GitLab Endpoint: GET /groups/:id/subgroups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

Returns:

a Stream<Group> containing the group's sub-groups

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab 10.3.0

getSubGroups

public List<Group> getSubGroups(Object groupIdOrPath,
                                List<Integer> skipGroups,
                                Boolean allAvailable,
                                String search,
                                Constants.GroupOrderBy orderBy,
                                Constants.SortOrder sortOrder,
                                Boolean statistics,
                                Boolean owned)
                         throws GitLabApiException

Get a list of visible direct subgroups in this group.

GitLab Endpoint: GET /groups/:id/subgroups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

skipGroups - skip the group IDs passed

allAvailable - show all the groups you have access to (defaults to false for authenticated users)

search - return the list of authorized groups matching the search criteria

orderBy - order groups by NAME or PATH. Default is NAME

sortOrder - order groups in ASC or DESC order. Default is ASC

statistics - include group statistics (admins only)

owned - limit to groups owned by the current user

Returns:

a List<Group> of the matching subgroups

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab 10.3.0

getSubGroups

public List<Group> getSubGroups(Object groupIdOrPath,
                                List<Integer> skipGroups,
                                Boolean allAvailable,
                                String search,
                                Constants.GroupOrderBy orderBy,
                                Constants.SortOrder sortOrder,
                                Boolean statistics,
                                Boolean owned,
                                int page,
                                int perPage)
                         throws GitLabApiException

Get a list of visible direct subgroups in this group.

GitLab Endpoint: GET /groups/:id/subgroups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

skipGroups - skip the group IDs passed

allAvailable - show all the groups you have access to (defaults to false for authenticated users)

search - return the list of authorized groups matching the search criteria

orderBy - order groups by NAME or PATH. Default is NAME

sortOrder - order groups in ASC or DESC order. Default is ASC

statistics - include group statistics (admins only)

owned - limit to groups owned by the current user

page - the page to get

perPage - the number of Group instances per page

Returns:

a List<Group> of the matching subgroups

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab 10.3.0

getSubGroups

public Pager<Group> getSubGroups(Object groupIdOrPath,
                                 List<Integer> skipGroups,
                                 Boolean allAvailable,
                                 String search,
                                 Constants.GroupOrderBy orderBy,
                                 Constants.SortOrder sortOrder,
                                 Boolean statistics,
                                 Boolean owned,
                                 int itemsPerPage)
                          throws GitLabApiException

Get a Pager of visible direct subgroups in this group.

GitLab Endpoint: GET /groups/:id/subgroups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

skipGroups - skip the group IDs passed

allAvailable - show all the groups you have access to (defaults to false for authenticated users)

search - return the list of authorized groups matching the search criteria

orderBy - order groups by NAME or PATH. Default is NAME

sortOrder - order groups in ASC or DESC order. Default is ASC

statistics - include group statistics (admins only)

owned - limit to groups owned by the current user

itemsPerPage - the number of Group instances that will be fetched per page

Returns:

a Pager containing matching Group instances

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab 10.3.0

getSubGroupsStream

public Stream<Group> getSubGroupsStream(Object groupIdOrPath,
                                        List<Integer> skipGroups,
                                        Boolean allAvailable,
                                        String search,
                                        Constants.GroupOrderBy orderBy,
                                        Constants.SortOrder sortOrder,
                                        Boolean statistics,
                                        Boolean owned)
                                 throws GitLabApiException

Get a Stream of visible direct subgroups in this group.

GitLab Endpoint: GET /groups/:id/subgroups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

skipGroups - skip the group IDs passed

allAvailable - show all the groups you have access to (defaults to false for authenticated users)

search - return the list of authorized groups matching the search criteria

orderBy - order groups by NAME or PATH. Default is NAME

sortOrder - order groups in ASC or DESC order. Default is ASC

statistics - include group statistics (admins only)

owned - limit to groups owned by the current user

Returns:

a Stream<Group> of the matching subgroups

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab 10.3.0

getProjects

public List<Project> getProjects(Object groupIdOrPath,
                                 GroupProjectsFilter filter)
                          throws GitLabApiException

Get a list of projects belonging to the specified group ID and filter.

GitLab Endpoint: GET /groups/:id/projects

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

filter - the GroupProjectsFilter instance holding the filter values for the query

Returns:

a List containing Project instances that belong to the group and match the provided filter

Throws:

GitLabApiException - if any exception occurs

getProjects

public Pager<Project> getProjects(Object groupIdOrPath,
                                  GroupProjectsFilter filter,
                                  int itemsPerPage)
                           throws GitLabApiException

Get a Pager of projects belonging to the specified group ID and filter.

GitLab Endpoint: GET /groups/:id/projects

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

filter - the GroupProjectsFilter instance holding the filter values for the query

itemsPerPage - the number of Project instances that will be fetched per page

Returns:

a Pager containing Project instances that belong to the group and match the provided filter

Throws:

GitLabApiException - if any exception occurs

getProjectsStream

public Stream<Project> getProjectsStream(Object groupIdOrPath,
                                         GroupProjectsFilter filter)
                                  throws GitLabApiException

Get a Stream of projects belonging to the specified group ID and filter.

GitLab Endpoint: GET /groups/:id/projects

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

filter - the GroupProjectsFilter instance holding the filter values for the query

Returns:

a Stream containing Project instances that belong to the group and match the provided filter

Throws:

GitLabApiException - if any exception occurs

getProjects

public List<Project> getProjects(Object groupIdOrPath)
                          throws GitLabApiException

Get a list of projects belonging to the specified group ID.

GitLab Endpoint: GET /groups/:id/projects

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

a list of projects belonging to the specified group ID

Throws:

GitLabApiException - if any exception occurs

getProjects

public List<Project> getProjects(Object groupIdOrPath,
                                 int page,
                                 int perPage)
                          throws GitLabApiException

Get a list of projects belonging to the specified group ID in the specified page range.

GitLab Endpoint: GET /groups/:id/projects

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

page - the page to get

perPage - the number of Project instances per page

Returns:

a list of projects belonging to the specified group ID in the specified page range

Throws:

GitLabApiException - if any exception occurs

getProjects

public Pager<Project> getProjects(Object groupIdOrPath,
                                  int itemsPerPage)
                           throws GitLabApiException

Get a Pager of projects belonging to the specified group ID.

GitLab Endpoint: GET /groups/:id/projects

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

itemsPerPage - the number of Project instances that will be fetched per page

Returns:

a Pager of projects belonging to the specified group ID

Throws:

GitLabApiException - if any exception occurs

getProjectsStream

public Stream<Project> getProjectsStream(Object groupIdOrPath)
                                  throws GitLabApiException

Get a Stream of projects belonging to the specified group ID.

GitLab Endpoint: GET /groups/:id/projects

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

a Stream of projects belonging to the specified group ID

Throws:

GitLabApiException - if any exception occurs

getGroup

public Group getGroup(Object groupIdOrPath)
               throws GitLabApiException

Get all details of a group.

GitLab Endpoint: GET /groups/:id

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

the Group instance for the specified group path

Throws:

GitLabApiException - if any exception occurs

getOptionalGroup

public Optional<Group> getOptionalGroup(Object groupIdOrPath)

Get all details of a group as an Optional instance.

GitLab Endpoint: GET /groups/:id

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

the Group for the specified group path as an Optional instance

addGroup

public Group addGroup(String name,
                      String path)
               throws GitLabApiException

Creates a new project group. Available only for users who can create groups.

GitLab Endpoint: POST /groups

Parameters:

name - the name of the group to add

path - the path for the group

Returns:

the created Group instance

Throws:

GitLabApiException - if any exception occurs

addGroup

public Group addGroup(Group group)
               throws GitLabApiException

Throws:

GitLabApiException

addGroup

public Group addGroup(String name,
                      String path,
                      String description,
                      Visibility visibility,
                      Boolean lfsEnabled,
                      Boolean requestAccessEnabled,
                      Integer parentId)
               throws GitLabApiException

Creates a new project group. Available only for users who can create groups.

GitLab Endpoint: POST /groups

Parameters:

name - the name of the group to add

path - the path for the group

description - (optional) - The group's description

visibility - (optional) - The group's visibility. Can be private, internal, or public.

lfsEnabled - (optional) - Enable/disable Large File Storage (LFS) for the projects in this group

requestAccessEnabled - (optional) - Allow users to request member access

parentId - (optional) - The parent group id for creating nested group

Returns:

the created Group instance

Throws:

GitLabApiException - if any exception occurs

updateGroup

public Group updateGroup(Group group)
                  throws GitLabApiException

Updates a project group. Available only for users who can create groups.

GitLab Endpoint: PUT /groups

Parameters:

group - to update

Returns:

updated group instance

Throws:

GitLabApiException - at any exception

updateGroup

public Group updateGroup(Object groupIdOrPath,
                         String name,
                         String path,
                         String description,
                         Visibility visibility,
                         Boolean lfsEnabled,
                         Boolean requestAccessEnabled,
                         Integer parentId)
                  throws GitLabApiException

Updates a project group. Available only for users who can create groups.

GitLab Endpoint: PUT /groups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

name - the name of the group to add

path - the path for the group

description - (optional) - The group's description

visibility - (optional) - The group's visibility. Can be private, internal, or public.

lfsEnabled - (optional) - Enable/disable Large File Storage (LFS) for the projects in this group

requestAccessEnabled - (optional) - Allow users to request member access

parentId - (optional) - The parent group id for creating nested group

Returns:

the updated Group instance

Throws:

GitLabApiException - if any exception occurs

addGroup

public Group addGroup(String name,
                      String path,
                      String description,
                      Boolean membershipLock,
                      Boolean shareWithGroupLock,
                      Visibility visibility,
                      Boolean lfsEnabled,
                      Boolean requestAccessEnabled,
                      Integer parentId,
                      Integer sharedRunnersMinutesLimit)
               throws GitLabApiException

Deprecated. Will be removed in version 5.0, replaced by addGroup(String, String, String, Visibility, Boolean, Boolean, Integer)

Creates a new project group. Available only for users who can create groups.

GitLab Endpoint: POST /groups

Parameters:

name - the name of the group to add

path - the path for the group

description - (optional) - The group's description

membershipLock - (optional, boolean) - Prevent adding new members to project membership within this group

shareWithGroupLock - (optional, boolean) - Prevent sharing a project with another group within this group

visibility - (optional) - The group's visibility. Can be private, internal, or public.

lfsEnabled - (optional) - Enable/disable Large File Storage (LFS) for the projects in this group

requestAccessEnabled - (optional) - Allow users to request member access.

parentId - (optional) - The parent group id for creating nested group.

sharedRunnersMinutesLimit - (optional) - (admin-only) Pipeline minutes quota for this group

Returns:

the created Group instance

Throws:

GitLabApiException - if any exception occurs

updateGroup

public Group updateGroup(Object groupIdOrPath,
                         String name,
                         String path,
                         String description,
                         Boolean membershipLock,
                         Boolean shareWithGroupLock,
                         Visibility visibility,
                         Boolean lfsEnabled,
                         Boolean requestAccessEnabled,
                         Integer parentId,
                         Integer sharedRunnersMinutesLimit)
                  throws GitLabApiException

Deprecated. Will be removed in version 5.0, replaced by updateGroup(Object, String, String, String, Visibility, Boolean, Boolean, Integer)

Updates a project group. Available only for users who can create groups.

GitLab Endpoint: PUT /groups

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

name - the name of the group to add

path - the path for the group

description - (optional) - The group's description

membershipLock - (optional, boolean) - Prevent adding new members to project membership within this group

shareWithGroupLock - (optional, boolean) - Prevent sharing a project with another group within this group

visibility - (optional) - The group's visibility. Can be private, internal, or public.

lfsEnabled - (optional) - Enable/disable Large File Storage (LFS) for the projects in this group

requestAccessEnabled - (optional) - Allow users to request member access

parentId - (optional) - The parent group id for creating nested group

sharedRunnersMinutesLimit - (optional) - (admin-only) Pipeline minutes quota for this group

Returns:

the updated Group instance

Throws:

GitLabApiException - if any exception occurs

deleteGroup

public void deleteGroup(Object groupIdOrPath)
                 throws GitLabApiException

Removes group with all projects inside.

GitLab Endpoint: DELETE /groups/:id

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Throws:

GitLabApiException - if any exception occurs

getMembers

public List<Member> getMembers(Object groupIdOrPath)
                        throws GitLabApiException

Get a list of group members viewable by the authenticated user.

GitLab Endpoint: GET /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

a list of group members viewable by the authenticated user

Throws:

GitLabApiException - if any exception occurs

getMembers

public List<Member> getMembers(Object groupIdOrPath,
                               int page,
                               int perPage)
                        throws GitLabApiException

Get a list of group members viewable by the authenticated user in the specified page range.

GitLab Endpoint: GET /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

page - the page to get

perPage - the number of Member instances per page

Returns:

a list of group members viewable by the authenticated user in the specified page range

Throws:

GitLabApiException - if any exception occurs

getMembers

public Pager<Member> getMembers(Object groupIdOrPath,
                                int itemsPerPage)
                         throws GitLabApiException

Get a Pager of group members viewable by the authenticated user.

GitLab Endpoint: GET /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

itemsPerPage - the number of Member instances that will be fetched per page

Returns:

a list of group members viewable by the authenticated user

Throws:

GitLabApiException - if any exception occurs

getMembersStream

public Stream<Member> getMembersStream(Object groupIdOrPath)
                                throws GitLabApiException

Get a Stream of group members viewable by the authenticated user.

GitLab Endpoint: GET /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

a Stream of group members viewable by the authenticated user

Throws:

GitLabApiException - if any exception occurs

getMember

public Member getMember(Object groupIdOrPath,
                        int userId)
                 throws GitLabApiException

Get a group member viewable by the authenticated user.

GitLab Endpoint: GET /groups/:id/members/:id

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

userId - the member ID of the member to get

Returns:

a member viewable by the authenticated user

Throws:

GitLabApiException - if any exception occurs

getOptionalMember

public Optional<Member> getOptionalMember(Object groupIdOrPath,
                                          int userId)

Get a group member viewable by the authenticated user as an Optional instance.

GitLab Endpoint: GET /groups/:id/members/:id

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

userId - the member ID of the member to get

Returns:

a member viewable by the authenticated user as an Optional instance

addMember

public Member addMember(Object groupIdOrPath,
                        Integer userId,
                        Integer accessLevel)
                 throws GitLabApiException

Adds a user to the list of group members.

GitLab Endpoint: POST /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

userId - the user ID of the member to add, required

accessLevel - the access level for the new member, required

Returns:

a Member instance for the added user

Throws:

GitLabApiException - if any exception occurs

addMember

public Member addMember(Object groupIdOrPath,
                        Integer userId,
                        AccessLevel accessLevel)
                 throws GitLabApiException

Adds a user to the list of group members.

GitLab Endpoint: POST /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

userId - the user ID of the member to add, required

accessLevel - the access level for the new member, required

Returns:

a Member instance for the added user

Throws:

GitLabApiException - if any exception occurs

addMember

public Member addMember(Object groupIdOrPath,
                        Integer userId,
                        AccessLevel accessLevel,
                        Date expiresAt)
                 throws GitLabApiException

Adds a user to the list of group members.

GitLab Endpoint: POST /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

userId - the user ID of the member to add, required

accessLevel - the access level for the new member, required

expiresAt - the date the membership in the group will expire, optional

Returns:

a Member instance for the added user

Throws:

GitLabApiException - if any exception occurs

addMember

public Member addMember(Object groupIdOrPath,
                        Integer userId,
                        Integer accessLevel,
                        Date expiresAt)
                 throws GitLabApiException

Adds a user to the list of group members.

GitLab Endpoint: POST /groups/:id/members

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

userId - the user ID of the member to add, required

accessLevel - the access level for the new member, required

expiresAt - the date the membership in the group will expire, optional

Returns:

a Member instance for the added user

Throws:

GitLabApiException - if any exception occurs

updateMember

public Member updateMember(Object groupIdOrPath,
                           Integer userId,
                           Integer accessLevel)
                    throws GitLabApiException

Updates a member of a group.

GitLab Endpoint: PUT /groups/:groupId/members/:userId

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

userId - the user ID of the member to update, required

accessLevel - the new access level for the member, required

Returns:

the updated member

Throws:

GitLabApiException - if any exception occurs

updateMember

public Member updateMember(Object groupIdOrPath,
                           Integer userId,
                           AccessLevel accessLevel)
                    throws GitLabApiException

Updates a member of a group.

GitLab Endpoint: PUT /groups/:groupId/members/:userId

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

userId - the user ID of the member to update, required

accessLevel - the new access level for the member, required

Returns:

the updated member

Throws:

GitLabApiException - if any exception occurs

updateMember

public Member updateMember(Object groupIdOrPath,
                           Integer userId,
                           AccessLevel accessLevel,
                           Date expiresAt)
                    throws GitLabApiException

Updates a member of a group.

GitLab Endpoint: PUT /groups/:groupId/members/:userId

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

userId - the user ID of the member to update, required

accessLevel - the new access level for the member, required

expiresAt - the date the membership in the group will expire, optional

Returns:

the updated member

Throws:

GitLabApiException - if any exception occurs

updateMember

public Member updateMember(Object groupIdOrPath,
                           Integer userId,
                           Integer accessLevel,
                           Date expiresAt)
                    throws GitLabApiException

Updates a member of a group.

GitLab Endpoint: PUT /groups/:groupId/members/:userId

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

userId - the user ID of the member to update, required

accessLevel - the new access level for the member, required

expiresAt - the date the membership in the group will expire, optional

Returns:

the updated member

Throws:

GitLabApiException - if any exception occurs

removeMember

public void removeMember(Object groupIdOrPath,
                         Integer userId)
                  throws GitLabApiException

Removes member from the group.

GitLab Endpoint: DELETE /groups/:id/members/:user_id

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

userId - the user ID of the member to remove

Throws:

GitLabApiException - if any exception occurs

ldapSync

public void ldapSync(Object groupIdOrPath)
              throws GitLabApiException

Syncs the group with its linked LDAP group. Only available to group owners and administrators.

GitLab Endpoint: POST /groups/:id/ldap_sync

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Throws:

GitLabApiException - if any exception occurs

addLdapGroupLink

public void addLdapGroupLink(Object groupIdOrPath,
                             String cn,
                             AccessLevel groupAccess,
                             String provider)
                      throws GitLabApiException

Adds an LDAP group link.

GitLab Endpoint: POST /groups/:id/ldap_group_links

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

cn - the CN of a LDAP group

groupAccess - the minimum access level for members of the LDAP group

provider - the LDAP provider for the LDAP group

Throws:

GitLabApiException - if any exception occurs

addLdapGroupLink

public void addLdapGroupLink(Object groupIdOrPath,
                             String cn,
                             Integer groupAccess,
                             String provider)
                      throws GitLabApiException

Adds an LDAP group link.

GitLab Endpoint: POST /groups/:id/ldap_group_links

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

cn - the CN of a LDAP group

groupAccess - the minimum access level for members of the LDAP group

provider - the LDAP provider for the LDAP group

Throws:

GitLabApiException - if any exception occurs

deleteLdapGroupLink

public void deleteLdapGroupLink(Object groupIdOrPath,
                                String cn)
                         throws GitLabApiException

Deletes an LDAP group link.

GitLab Endpoint: DELETE /groups/:id/ldap_group_links/:cn

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

cn - the CN of the LDAP group link to delete

Throws:

GitLabApiException - if any exception occurs

deleteLdapGroupLink

public void deleteLdapGroupLink(Object groupIdOrPath,
                                String cn,
                                String provider)
                         throws GitLabApiException

Deletes an LDAP group link for a specific LDAP provider.

GitLab Endpoint: DELETE /groups/:id/ldap_group_links/:provider/:cn

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

cn - the CN of the LDAP group link to delete

provider - the name of the LDAP provider

Throws:

GitLabApiException - if any exception occurs

getVariables

public List<Variable> getVariables(Object groupIdOrPath)
                            throws GitLabApiException

Get list of a group’s variables.

GitLab Endpoint: GET /groups/:id/variables

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

a list of variables belonging to the specified group

Throws:

GitLabApiException - if any exception occurs

getVariables

public List<Variable> getVariables(Object groupIdOrPath,
                                   int page,
                                   int perPage)
                            throws GitLabApiException

Get a list of variables for the specified group in the specified page range.

GitLab Endpoint: GET /groups/:id/variables

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

page - the page to get

perPage - the number of Variable instances per page

Returns:

a list of variables belonging to the specified group in the specified page range

Throws:

GitLabApiException - if any exception occurs

getVariables

public Pager<Variable> getVariables(Object groupIdOrPath,
                                    int itemsPerPage)
                             throws GitLabApiException

Get a Pager of variables belonging to the specified group.

GitLab Endpoint: GET /groups/:id/variables

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

itemsPerPage - the number of Variable instances that will be fetched per page

Returns:

a Pager of variables belonging to the specified group

Throws:

GitLabApiException - if any exception occurs

getVariablesStream

public Stream<Variable> getVariablesStream(Object groupIdOrPath)
                                    throws GitLabApiException

Get a Stream of variables belonging to the specified group.

GitLab Endpoint: GET /groups/:id/variables

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

Returns:

a Stream of variables belonging to the specified group

Throws:

GitLabApiException - if any exception occurs

getVariable

public Variable getVariable(Object groupIdOrPath,
                            String key)
                     throws GitLabApiException

Get the details of a group variable.

GitLab Endpoint: GET /groups/:id/variables/:key

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

key - the key of an existing variable, required

Returns:

the Variable instance for the specified group variable

Throws:

GitLabApiException - if any exception occurs

getOptionalVariable

public Optional<Variable> getOptionalVariable(Object groupIdOrPath,
                                              String key)

Get the details of a group variable as an Optional instance.

GitLab Endpoint: GET /groups/:id/variables/:key

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path

key - the key of an existing variable, required

Returns:

the Variable for the specified group variable as an Optional instance

createVariable

public Variable createVariable(Object groupIdOrPath,
                               String key,
                               String value,
                               Boolean isProtected)
                        throws GitLabApiException

Create a new group variable.

GitLab Endpoint: POST /groups/:id/variables

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

key - the key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed, required

value - the value for the variable, required

isProtected - whether the variable is protected, optional

Returns:

a Variable instance with the newly created variable

Throws:

GitLabApiException - if any exception occurs during execution

updateVariable

public Variable updateVariable(Object groupIdOrPath,
                               String key,
                               String value,
                               Boolean isProtected)
                        throws GitLabApiException

Update a group variable.

GitLab Endpoint: PUT /groups/:id/variables/:key

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

key - the key of an existing variable, required

value - the value for the variable, required

isProtected - whether the variable is protected, optional

Returns:

a Variable instance with the updated variable

Throws:

GitLabApiException - if any exception occurs during execution

deleteVariable

public void deleteVariable(Object groupIdOrPath,
                           String key)
                    throws GitLabApiException

Deletes a group variable.

GitLab Endpoint: DELETE /groups/:id/variables/:key

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

key - the key of an existing variable, required

Throws:

GitLabApiException - if any exception occurs

transferProject

public Project transferProject(Object groupIdOrPath,
                               Object projectIdOrPath)
                        throws GitLabApiException

Transfer a project to the Group namespace. Available only for admin users.

GitLab Endpoint: POST /groups/:id/projects/:project_id

Parameters:

groupIdOrPath - the group ID, path of the group, or a Group instance holding the group ID or path, required

projectIdOrPath - the project in the form of an Integer(ID), String(path), or Project instance, required

Returns:

the transfered Project instance

Throws:

GitLabApiException - if any exception occurs during execution