getGroupSubgroups

GitLab v9.5.0, Nov 22 25

GitLab v9.5.0 published on Saturday, Nov 22, 2025 by Pulumi

Schema (JSON)

pulumi/pulumi-gitlab

GitLab v9.5.0 published on Saturday, Nov 22, 2025 by Pulumi

Schema (JSON)

pulumi/pulumi-gitlab

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as gitlab from "@pulumi/gitlab";

export = async () => {
    const subgroups = await gitlab.getGroupSubgroups({
        groupId: 123456,
    });
    return {
        subgroups: subgroups,
    };
}

import pulumi
import pulumi_gitlab as gitlab

subgroups = gitlab.get_group_subgroups(group_id=123456)
pulumi.export("subgroups", subgroups)

package main

import (
	"github.com/pulumi/pulumi-gitlab/sdk/v9/go/gitlab"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		subgroups, err := gitlab.GetGroupSubgroups(ctx, &gitlab.GetGroupSubgroupsArgs{
			GroupId: 123456,
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("subgroups", subgroups)
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using GitLab = Pulumi.GitLab;

return await Deployment.RunAsync(() => 
{
    var subgroups = GitLab.GetGroupSubgroups.Invoke(new()
    {
        GroupId = 123456,
    });

    return new Dictionary<string, object?>
    {
        ["subgroups"] = subgroups,
    };
});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gitlab.GitlabFunctions;
import com.pulumi.gitlab.inputs.GetGroupSubgroupsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var subgroups = GitlabFunctions.getGroupSubgroups(GetGroupSubgroupsArgs.builder()
            .groupId(123456)
            .build());

        ctx.export("subgroups", subgroups);
    }
}

variables:
  subgroups:
    fn::invoke:
      function: gitlab:getGroupSubgroups
      arguments:
        groupId: '123456'
outputs:
  subgroups: ${subgroups}

Using getGroupSubgroups

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getGroupSubgroups(args: GetGroupSubgroupsArgs, opts?: InvokeOptions): Promise<GetGroupSubgroupsResult>
function getGroupSubgroupsOutput(args: GetGroupSubgroupsOutputArgs, opts?: InvokeOptions): Output<GetGroupSubgroupsResult>

def get_group_subgroups(all_available: Optional[bool] = None,
                        group_id: Optional[int] = None,
                        min_access_level: Optional[str] = None,
                        order_by: Optional[str] = None,
                        owned: Optional[bool] = None,
                        search: Optional[str] = None,
                        skip_groups: Optional[Sequence[int]] = None,
                        sort: Optional[str] = None,
                        statistics: Optional[bool] = None,
                        with_custom_attributes: Optional[bool] = None,
                        opts: Optional[InvokeOptions] = None) -> GetGroupSubgroupsResult
def get_group_subgroups_output(all_available: Optional[pulumi.Input[bool]] = None,
                        group_id: Optional[pulumi.Input[int]] = None,
                        min_access_level: Optional[pulumi.Input[str]] = None,
                        order_by: Optional[pulumi.Input[str]] = None,
                        owned: Optional[pulumi.Input[bool]] = None,
                        search: Optional[pulumi.Input[str]] = None,
                        skip_groups: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]] = None,
                        sort: Optional[pulumi.Input[str]] = None,
                        statistics: Optional[pulumi.Input[bool]] = None,
                        with_custom_attributes: Optional[pulumi.Input[bool]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetGroupSubgroupsResult]

func GetGroupSubgroups(ctx *Context, args *GetGroupSubgroupsArgs, opts ...InvokeOption) (*GetGroupSubgroupsResult, error)
func GetGroupSubgroupsOutput(ctx *Context, args *GetGroupSubgroupsOutputArgs, opts ...InvokeOption) GetGroupSubgroupsResultOutput

> Note: This function is named GetGroupSubgroups in the Go SDK.

public static class GetGroupSubgroups 
{
    public static Task<GetGroupSubgroupsResult> InvokeAsync(GetGroupSubgroupsArgs args, InvokeOptions? opts = null)
    public static Output<GetGroupSubgroupsResult> Invoke(GetGroupSubgroupsInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetGroupSubgroupsResult> getGroupSubgroups(GetGroupSubgroupsArgs args, InvokeOptions options)
public static Output<GetGroupSubgroupsResult> getGroupSubgroups(GetGroupSubgroupsArgs args, InvokeOptions options)

fn::invoke:
  function: gitlab:index/getGroupSubgroups:getGroupSubgroups
  arguments:
    # arguments dictionary

The following arguments are supported:

GroupId int: The ID of the group.
AllAvailable bool: Show all the groups you have access to.
MinAccessLevel string: Limit to groups where current user has at least this access level.
OrderBy string: Order groups by name, path or id.
Owned bool: Limit to groups explicitly owned by the current user.
Search string: Return the list of authorized groups matching the search criteria.
SkipGroups List<int>: Skip the group IDs passed.
Sort string: Order groups in asc or desc order.
Statistics bool: Include group statistics (administrators only).
WithCustomAttributes bool: Include custom attributes in response (administrators only).

GroupId int: The ID of the group.
AllAvailable bool: Show all the groups you have access to.
MinAccessLevel string: Limit to groups where current user has at least this access level.
OrderBy string: Order groups by name, path or id.
Owned bool: Limit to groups explicitly owned by the current user.
Search string: Return the list of authorized groups matching the search criteria.
SkipGroups []int: Skip the group IDs passed.
Sort string: Order groups in asc or desc order.
Statistics bool: Include group statistics (administrators only).
WithCustomAttributes bool: Include custom attributes in response (administrators only).

groupId Integer: The ID of the group.
allAvailable Boolean: Show all the groups you have access to.
minAccessLevel String: Limit to groups where current user has at least this access level.
orderBy String: Order groups by name, path or id.
owned Boolean: Limit to groups explicitly owned by the current user.
search String: Return the list of authorized groups matching the search criteria.
skipGroups List<Integer>: Skip the group IDs passed.
sort String: Order groups in asc or desc order.
statistics Boolean: Include group statistics (administrators only).
withCustomAttributes Boolean: Include custom attributes in response (administrators only).

groupId number: The ID of the group.
allAvailable boolean: Show all the groups you have access to.
minAccessLevel string: Limit to groups where current user has at least this access level.
orderBy string: Order groups by name, path or id.
owned boolean: Limit to groups explicitly owned by the current user.
search string: Return the list of authorized groups matching the search criteria.
skipGroups number[]: Skip the group IDs passed.
sort string: Order groups in asc or desc order.
statistics boolean: Include group statistics (administrators only).
withCustomAttributes boolean: Include custom attributes in response (administrators only).

group_id int: The ID of the group.
all_available bool: Show all the groups you have access to.
min_access_level str: Limit to groups where current user has at least this access level.
order_by str: Order groups by name, path or id.
owned bool: Limit to groups explicitly owned by the current user.
search str: Return the list of authorized groups matching the search criteria.
skip_groups Sequence[int]: Skip the group IDs passed.
sort str: Order groups in asc or desc order.
statistics bool: Include group statistics (administrators only).
with_custom_attributes bool: Include custom attributes in response (administrators only).

groupId Number: The ID of the group.
allAvailable Boolean: Show all the groups you have access to.
minAccessLevel String: Limit to groups where current user has at least this access level.
orderBy String: Order groups by name, path or id.
owned Boolean: Limit to groups explicitly owned by the current user.
search String: Return the list of authorized groups matching the search criteria.
skipGroups List<Number>: Skip the group IDs passed.
sort String: Order groups in asc or desc order.
statistics Boolean: Include group statistics (administrators only).
withCustomAttributes Boolean: Include custom attributes in response (administrators only).

getGroupSubgroups Result

The following output properties are available:

AllAvailable bool: Show all the groups you have access to.
GroupId int: The ID of the group.
Id string: The ID of this datasource. In the format <group-id>.
MinAccessLevel string: Limit to groups where current user has at least this access level.
OrderBy string: Order groups by name, path or id.
Owned bool: Limit to groups explicitly owned by the current user.
Search string: Return the list of authorized groups matching the search criteria.
SkipGroups List<int>: Skip the group IDs passed.
Sort string: Order groups in asc or desc order.
Statistics bool: Include group statistics (administrators only).
Subgroups List<Pulumi.GitLab.Outputs.GetGroupSubgroupsSubgroup>: Subgroups of the parent group.
WithCustomAttributes bool: Include custom attributes in response (administrators only).

AllAvailable bool: Show all the groups you have access to.
GroupId int: The ID of the group.
Id string: The ID of this datasource. In the format <group-id>.
MinAccessLevel string: Limit to groups where current user has at least this access level.
OrderBy string: Order groups by name, path or id.
Owned bool: Limit to groups explicitly owned by the current user.
Search string: Return the list of authorized groups matching the search criteria.
SkipGroups []int: Skip the group IDs passed.
Sort string: Order groups in asc or desc order.
Statistics bool: Include group statistics (administrators only).
Subgroups []GetGroupSubgroupsSubgroup: Subgroups of the parent group.
WithCustomAttributes bool: Include custom attributes in response (administrators only).

allAvailable Boolean: Show all the groups you have access to.
groupId Integer: The ID of the group.
id String: The ID of this datasource. In the format <group-id>.
minAccessLevel String: Limit to groups where current user has at least this access level.
orderBy String: Order groups by name, path or id.
owned Boolean: Limit to groups explicitly owned by the current user.
search String: Return the list of authorized groups matching the search criteria.
skipGroups List<Integer>: Skip the group IDs passed.
sort String: Order groups in asc or desc order.
statistics Boolean: Include group statistics (administrators only).
subgroups List<GetGroupSubgroupsSubgroup>: Subgroups of the parent group.
withCustomAttributes Boolean: Include custom attributes in response (administrators only).

allAvailable boolean: Show all the groups you have access to.
groupId number: The ID of the group.
id string: The ID of this datasource. In the format <group-id>.
minAccessLevel string: Limit to groups where current user has at least this access level.
orderBy string: Order groups by name, path or id.
owned boolean: Limit to groups explicitly owned by the current user.
search string: Return the list of authorized groups matching the search criteria.
skipGroups number[]: Skip the group IDs passed.
sort string: Order groups in asc or desc order.
statistics boolean: Include group statistics (administrators only).
subgroups GetGroupSubgroupsSubgroup[]: Subgroups of the parent group.
withCustomAttributes boolean: Include custom attributes in response (administrators only).

all_available bool: Show all the groups you have access to.
group_id int: The ID of the group.
id str: The ID of this datasource. In the format <group-id>.
min_access_level str: Limit to groups where current user has at least this access level.
order_by str: Order groups by name, path or id.
owned bool: Limit to groups explicitly owned by the current user.
search str: Return the list of authorized groups matching the search criteria.
skip_groups Sequence[int]: Skip the group IDs passed.
sort str: Order groups in asc or desc order.
statistics bool: Include group statistics (administrators only).
subgroups Sequence[GetGroupSubgroupsSubgroup]: Subgroups of the parent group.
with_custom_attributes bool: Include custom attributes in response (administrators only).

allAvailable Boolean: Show all the groups you have access to.
groupId Number: The ID of the group.
id String: The ID of this datasource. In the format <group-id>.
minAccessLevel String: Limit to groups where current user has at least this access level.
orderBy String: Order groups by name, path or id.
owned Boolean: Limit to groups explicitly owned by the current user.
search String: Return the list of authorized groups matching the search criteria.
skipGroups List<Number>: Skip the group IDs passed.
sort String: Order groups in asc or desc order.
statistics Boolean: Include group statistics (administrators only).
subgroups List<Property Map>: Subgroups of the parent group.
withCustomAttributes Boolean: Include custom attributes in response (administrators only).

Supporting Types

GetGroupSubgroupsSubgroup

AllowedEmailDomainsList string: A list of email address domains to allow group access.
AutoDevopsEnabled bool: Default to Auto DevOps pipeline for all projects within this group.
AvatarUrl string: The URL of the avatar image.
CreatedAt string: Group created at date.
DefaultBranchProtection int: Whether developers and maintainers can push to the applicable default branch.
Description string: The description of the group.
EmailsEnabled bool: Enable email notifications.
FileTemplateProjectId int: The ID of the project that will be used for file templates.
FullName string: The full name of the group.
FullPath string: The full path of the group.
GroupId int: The ID of the group.
IpRestrictionRanges string: A list of IP addresses or subnet masks to restrict group access.
LfsEnabled bool: Is LFS enabled for projects in this group.
MentionsDisabled bool: Disable the capability of a group from getting mentioned.
Name string: The name of this group.
ParentId int: ID of the parent group.
Path string: The path of the group.
ProjectCreationLevel string: Determine if developers can create projects in the group. Valid values are: noone, owner, maintainer, developer, administrator
RequestAccessEnabled bool: Is request for access enabled to the group.
RequireTwoFactorAuthentication bool: Require all users in this group to setup Two-factor authentication.
ShareWithGroupLock bool: Prevent sharing a project with another group within this group.
SharedRunnersSetting string: Enable or disable shared runners for a group's subgroups and projects. Valid values are: enabled, disabled_and_overridable, disabled_and_unoverridable, disabled_with_override.
Statistics Dictionary<string, string>: Group statistics.
SubgroupCreationLevel string: Allowed to create subgroups. Valid values are: owner, maintainer.
TwoFactorGracePeriod int: Time before Two-factor authentication is enforced (in hours).
Visibility string: Limited by visibility public, internal, or private.
WebUrl string: Web URL of the group.
WikiAccessLevel string: The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are disabled, private, enabled.

AllowedEmailDomainsList string: A list of email address domains to allow group access.
AutoDevopsEnabled bool: Default to Auto DevOps pipeline for all projects within this group.
AvatarUrl string: The URL of the avatar image.
CreatedAt string: Group created at date.
DefaultBranchProtection int: Whether developers and maintainers can push to the applicable default branch.
Description string: The description of the group.
EmailsEnabled bool: Enable email notifications.
FileTemplateProjectId int: The ID of the project that will be used for file templates.
FullName string: The full name of the group.
FullPath string: The full path of the group.
GroupId int: The ID of the group.
IpRestrictionRanges string: A list of IP addresses or subnet masks to restrict group access.
LfsEnabled bool: Is LFS enabled for projects in this group.
MentionsDisabled bool: Disable the capability of a group from getting mentioned.
Name string: The name of this group.
ParentId int: ID of the parent group.
Path string: The path of the group.
ProjectCreationLevel string: Determine if developers can create projects in the group. Valid values are: noone, owner, maintainer, developer, administrator
RequestAccessEnabled bool: Is request for access enabled to the group.
RequireTwoFactorAuthentication bool: Require all users in this group to setup Two-factor authentication.
ShareWithGroupLock bool: Prevent sharing a project with another group within this group.
SharedRunnersSetting string: Enable or disable shared runners for a group's subgroups and projects. Valid values are: enabled, disabled_and_overridable, disabled_and_unoverridable, disabled_with_override.
Statistics map[string]string: Group statistics.
SubgroupCreationLevel string: Allowed to create subgroups. Valid values are: owner, maintainer.
TwoFactorGracePeriod int: Time before Two-factor authentication is enforced (in hours).
Visibility string: Limited by visibility public, internal, or private.
WebUrl string: Web URL of the group.
WikiAccessLevel string: The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are disabled, private, enabled.

allowedEmailDomainsList String: A list of email address domains to allow group access.
autoDevopsEnabled Boolean: Default to Auto DevOps pipeline for all projects within this group.
avatarUrl String: The URL of the avatar image.
createdAt String: Group created at date.
defaultBranchProtection Integer: Whether developers and maintainers can push to the applicable default branch.
description String: The description of the group.
emailsEnabled Boolean: Enable email notifications.
fileTemplateProjectId Integer: The ID of the project that will be used for file templates.
fullName String: The full name of the group.
fullPath String: The full path of the group.
groupId Integer: The ID of the group.
ipRestrictionRanges String: A list of IP addresses or subnet masks to restrict group access.
lfsEnabled Boolean: Is LFS enabled for projects in this group.
mentionsDisabled Boolean: Disable the capability of a group from getting mentioned.
name String: The name of this group.
parentId Integer: ID of the parent group.
path String: The path of the group.
projectCreationLevel String: Determine if developers can create projects in the group. Valid values are: noone, owner, maintainer, developer, administrator
requestAccessEnabled Boolean: Is request for access enabled to the group.
requireTwoFactorAuthentication Boolean: Require all users in this group to setup Two-factor authentication.
shareWithGroupLock Boolean: Prevent sharing a project with another group within this group.
sharedRunnersSetting String: Enable or disable shared runners for a group's subgroups and projects. Valid values are: enabled, disabled_and_overridable, disabled_and_unoverridable, disabled_with_override.
statistics Map<String,String>: Group statistics.
subgroupCreationLevel String: Allowed to create subgroups. Valid values are: owner, maintainer.
twoFactorGracePeriod Integer: Time before Two-factor authentication is enforced (in hours).
visibility String: Limited by visibility public, internal, or private.
webUrl String: Web URL of the group.
wikiAccessLevel String: The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are disabled, private, enabled.

allowedEmailDomainsList string: A list of email address domains to allow group access.
autoDevopsEnabled boolean: Default to Auto DevOps pipeline for all projects within this group.
avatarUrl string: The URL of the avatar image.
createdAt string: Group created at date.
defaultBranchProtection number: Whether developers and maintainers can push to the applicable default branch.
description string: The description of the group.
emailsEnabled boolean: Enable email notifications.
fileTemplateProjectId number: The ID of the project that will be used for file templates.
fullName string: The full name of the group.
fullPath string: The full path of the group.
groupId number: The ID of the group.
ipRestrictionRanges string: A list of IP addresses or subnet masks to restrict group access.
lfsEnabled boolean: Is LFS enabled for projects in this group.
mentionsDisabled boolean: Disable the capability of a group from getting mentioned.
name string: The name of this group.
parentId number: ID of the parent group.
path string: The path of the group.
projectCreationLevel string: Determine if developers can create projects in the group. Valid values are: noone, owner, maintainer, developer, administrator
requestAccessEnabled boolean: Is request for access enabled to the group.
requireTwoFactorAuthentication boolean: Require all users in this group to setup Two-factor authentication.
shareWithGroupLock boolean: Prevent sharing a project with another group within this group.
sharedRunnersSetting string: Enable or disable shared runners for a group's subgroups and projects. Valid values are: enabled, disabled_and_overridable, disabled_and_unoverridable, disabled_with_override.
statistics {[key: string]: string}: Group statistics.
subgroupCreationLevel string: Allowed to create subgroups. Valid values are: owner, maintainer.
twoFactorGracePeriod number: Time before Two-factor authentication is enforced (in hours).
visibility string: Limited by visibility public, internal, or private.
webUrl string: Web URL of the group.
wikiAccessLevel string: The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are disabled, private, enabled.

allowed_email_domains_list str: A list of email address domains to allow group access.
auto_devops_enabled bool: Default to Auto DevOps pipeline for all projects within this group.
avatar_url str: The URL of the avatar image.
created_at str: Group created at date.
default_branch_protection int: Whether developers and maintainers can push to the applicable default branch.
description str: The description of the group.
emails_enabled bool: Enable email notifications.
file_template_project_id int: The ID of the project that will be used for file templates.
full_name str: The full name of the group.
full_path str: The full path of the group.
group_id int: The ID of the group.
ip_restriction_ranges str: A list of IP addresses or subnet masks to restrict group access.
lfs_enabled bool: Is LFS enabled for projects in this group.
mentions_disabled bool: Disable the capability of a group from getting mentioned.
name str: The name of this group.
parent_id int: ID of the parent group.
path str: The path of the group.
project_creation_level str: Determine if developers can create projects in the group. Valid values are: noone, owner, maintainer, developer, administrator
request_access_enabled bool: Is request for access enabled to the group.
require_two_factor_authentication bool: Require all users in this group to setup Two-factor authentication.
share_with_group_lock bool: Prevent sharing a project with another group within this group.
shared_runners_setting str: Enable or disable shared runners for a group's subgroups and projects. Valid values are: enabled, disabled_and_overridable, disabled_and_unoverridable, disabled_with_override.
statistics Mapping[str, str]: Group statistics.
subgroup_creation_level str: Allowed to create subgroups. Valid values are: owner, maintainer.
two_factor_grace_period int: Time before Two-factor authentication is enforced (in hours).
visibility str: Limited by visibility public, internal, or private.
web_url str: Web URL of the group.
wiki_access_level str: The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are disabled, private, enabled.

allowedEmailDomainsList String: A list of email address domains to allow group access.
autoDevopsEnabled Boolean: Default to Auto DevOps pipeline for all projects within this group.
avatarUrl String: The URL of the avatar image.
createdAt String: Group created at date.
defaultBranchProtection Number: Whether developers and maintainers can push to the applicable default branch.
description String: The description of the group.
emailsEnabled Boolean: Enable email notifications.
fileTemplateProjectId Number: The ID of the project that will be used for file templates.
fullName String: The full name of the group.
fullPath String: The full path of the group.
groupId Number: The ID of the group.
ipRestrictionRanges String: A list of IP addresses or subnet masks to restrict group access.
lfsEnabled Boolean: Is LFS enabled for projects in this group.
mentionsDisabled Boolean: Disable the capability of a group from getting mentioned.
name String: The name of this group.
parentId Number: ID of the parent group.
path String: The path of the group.
projectCreationLevel String: Determine if developers can create projects in the group. Valid values are: noone, owner, maintainer, developer, administrator
requestAccessEnabled Boolean: Is request for access enabled to the group.
requireTwoFactorAuthentication Boolean: Require all users in this group to setup Two-factor authentication.
shareWithGroupLock Boolean: Prevent sharing a project with another group within this group.
sharedRunnersSetting String: Enable or disable shared runners for a group's subgroups and projects. Valid values are: enabled, disabled_and_overridable, disabled_and_unoverridable, disabled_with_override.
statistics Map<String>: Group statistics.
subgroupCreationLevel String: Allowed to create subgroups. Valid values are: owner, maintainer.
twoFactorGracePeriod Number: Time before Two-factor authentication is enforced (in hours).
visibility String: Limited by visibility public, internal, or private.
webUrl String: Web URL of the group.
wikiAccessLevel String: The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are disabled, private, enabled.

Package Details

Repository: GitLab pulumi/pulumi-gitlab
License: Apache-2.0
Notes: This Pulumi package is based on the gitlab Terraform Provider.

GitLab v9.5.0 published on Saturday, Nov 22, 2025 by Pulumi

Schema (JSON)

pulumi/pulumi-gitlab

gitlab.getGroupSubgroups

On this page

On this page

Example Usage

Using getGroupSubgroups

getGroupSubgroups Result

Supporting Types

GetGroupSubgroupsSubgroup

Package Details

On this page

On this page