1. Packages
  2. Azure Native
  3. API Docs
  4. management
  5. getManagementGroup
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.13.0 published on Wednesday, Jan 28, 2026 by Pulumi
azure-native logo
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.13.0 published on Wednesday, Jan 28, 2026 by Pulumi

    Get the details of the management group.

    Uses Azure REST API version 2023-04-01.

    Other available API versions: 2021-04-01, 2024-02-01-preview. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native management [ApiVersion]. See the version guide for details.

    Using getManagementGroup

    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 getManagementGroup(args: GetManagementGroupArgs, opts?: InvokeOptions): Promise<GetManagementGroupResult>
    function getManagementGroupOutput(args: GetManagementGroupOutputArgs, opts?: InvokeOptions): Output<GetManagementGroupResult>
    def get_management_group(expand: Optional[str] = None,
                             filter: Optional[str] = None,
                             group_id: Optional[str] = None,
                             recurse: Optional[bool] = None,
                             opts: Optional[InvokeOptions] = None) -> GetManagementGroupResult
    def get_management_group_output(expand: Optional[pulumi.Input[str]] = None,
                             filter: Optional[pulumi.Input[str]] = None,
                             group_id: Optional[pulumi.Input[str]] = None,
                             recurse: Optional[pulumi.Input[bool]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetManagementGroupResult]
    func LookupManagementGroup(ctx *Context, args *LookupManagementGroupArgs, opts ...InvokeOption) (*LookupManagementGroupResult, error)
    func LookupManagementGroupOutput(ctx *Context, args *LookupManagementGroupOutputArgs, opts ...InvokeOption) LookupManagementGroupResultOutput

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

    public static class GetManagementGroup 
    {
        public static Task<GetManagementGroupResult> InvokeAsync(GetManagementGroupArgs args, InvokeOptions? opts = null)
        public static Output<GetManagementGroupResult> Invoke(GetManagementGroupInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetManagementGroupResult> getManagementGroup(GetManagementGroupArgs args, InvokeOptions options)
    public static Output<GetManagementGroupResult> getManagementGroup(GetManagementGroupArgs args, InvokeOptions options)
    
    fn::invoke:
      function: azure-native:management:getManagementGroup
      arguments:
        # arguments dictionary

    The following arguments are supported:

    GroupId string
    Management Group ID.
    Expand string
    The $expand=children query string parameter allows clients to request inclusion of children in the response payload. $expand=path includes the path from the root group to the current group. $expand=ancestors includes the ancestor Ids of the current group.
    Filter string
    A filter which allows the exclusion of subscriptions from results (i.e. '$filter=children.childType ne Subscription')
    Recurse bool
    The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that $expand=children must be passed up if $recurse is set to true.
    GroupId string
    Management Group ID.
    Expand string
    The $expand=children query string parameter allows clients to request inclusion of children in the response payload. $expand=path includes the path from the root group to the current group. $expand=ancestors includes the ancestor Ids of the current group.
    Filter string
    A filter which allows the exclusion of subscriptions from results (i.e. '$filter=children.childType ne Subscription')
    Recurse bool
    The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that $expand=children must be passed up if $recurse is set to true.
    groupId String
    Management Group ID.
    expand String
    The $expand=children query string parameter allows clients to request inclusion of children in the response payload. $expand=path includes the path from the root group to the current group. $expand=ancestors includes the ancestor Ids of the current group.
    filter String
    A filter which allows the exclusion of subscriptions from results (i.e. '$filter=children.childType ne Subscription')
    recurse Boolean
    The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that $expand=children must be passed up if $recurse is set to true.
    groupId string
    Management Group ID.
    expand string
    The $expand=children query string parameter allows clients to request inclusion of children in the response payload. $expand=path includes the path from the root group to the current group. $expand=ancestors includes the ancestor Ids of the current group.
    filter string
    A filter which allows the exclusion of subscriptions from results (i.e. '$filter=children.childType ne Subscription')
    recurse boolean
    The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that $expand=children must be passed up if $recurse is set to true.
    group_id str
    Management Group ID.
    expand str
    The $expand=children query string parameter allows clients to request inclusion of children in the response payload. $expand=path includes the path from the root group to the current group. $expand=ancestors includes the ancestor Ids of the current group.
    filter str
    A filter which allows the exclusion of subscriptions from results (i.e. '$filter=children.childType ne Subscription')
    recurse bool
    The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that $expand=children must be passed up if $recurse is set to true.
    groupId String
    Management Group ID.
    expand String
    The $expand=children query string parameter allows clients to request inclusion of children in the response payload. $expand=path includes the path from the root group to the current group. $expand=ancestors includes the ancestor Ids of the current group.
    filter String
    A filter which allows the exclusion of subscriptions from results (i.e. '$filter=children.childType ne Subscription')
    recurse Boolean
    The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that $expand=children must be passed up if $recurse is set to true.

    getManagementGroup Result

    The following output properties are available:

    AzureApiVersion string
    The Azure API version of the resource.
    Id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    Name string
    The name of the resource
    SystemData Pulumi.AzureNative.Management.Outputs.SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    Children List<Pulumi.AzureNative.Management.Outputs.ManagementGroupChildInfoResponse>
    The list of children.
    Details Pulumi.AzureNative.Management.Outputs.ManagementGroupDetailsResponse
    The details of a management group.
    DisplayName string
    The friendly name of the management group.
    TenantId string
    The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000
    AzureApiVersion string
    The Azure API version of the resource.
    Id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    Name string
    The name of the resource
    SystemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    Children []ManagementGroupChildInfoResponse
    The list of children.
    Details ManagementGroupDetailsResponse
    The details of a management group.
    DisplayName string
    The friendly name of the management group.
    TenantId string
    The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000
    azureApiVersion String
    The Azure API version of the resource.
    id String
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    name String
    The name of the resource
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    children List<ManagementGroupChildInfoResponse>
    The list of children.
    details ManagementGroupDetailsResponse
    The details of a management group.
    displayName String
    The friendly name of the management group.
    tenantId String
    The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000
    azureApiVersion string
    The Azure API version of the resource.
    id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    name string
    The name of the resource
    systemData SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    children ManagementGroupChildInfoResponse[]
    The list of children.
    details ManagementGroupDetailsResponse
    The details of a management group.
    displayName string
    The friendly name of the management group.
    tenantId string
    The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000
    azure_api_version str
    The Azure API version of the resource.
    id str
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    name str
    The name of the resource
    system_data SystemDataResponse
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type str
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    children Sequence[ManagementGroupChildInfoResponse]
    The list of children.
    details ManagementGroupDetailsResponse
    The details of a management group.
    display_name str
    The friendly name of the management group.
    tenant_id str
    The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000
    azureApiVersion String
    The Azure API version of the resource.
    id String
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    name String
    The name of the resource
    systemData Property Map
    Azure Resource Manager metadata containing createdBy and modifiedBy information.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    children List<Property Map>
    The list of children.
    details Property Map
    The details of a management group.
    displayName String
    The friendly name of the management group.
    tenantId String
    The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000

    Supporting Types

    ManagementGroupChildInfoResponse

    Children List<Pulumi.AzureNative.Management.Inputs.ManagementGroupChildInfoResponse>
    The list of children.
    DisplayName string
    The friendly name of the child resource.
    Id string
    The fully qualified ID for the child resource (management group or subscription). For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    Name string
    The name of the child entity.
    Type string
    The fully qualified resource type which includes provider namespace (e.g. Microsoft.Management/managementGroups)
    Children []ManagementGroupChildInfoResponse
    The list of children.
    DisplayName string
    The friendly name of the child resource.
    Id string
    The fully qualified ID for the child resource (management group or subscription). For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    Name string
    The name of the child entity.
    Type string
    The fully qualified resource type which includes provider namespace (e.g. Microsoft.Management/managementGroups)
    children List<ManagementGroupChildInfoResponse>
    The list of children.
    displayName String
    The friendly name of the child resource.
    id String
    The fully qualified ID for the child resource (management group or subscription). For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name String
    The name of the child entity.
    type String
    The fully qualified resource type which includes provider namespace (e.g. Microsoft.Management/managementGroups)
    children ManagementGroupChildInfoResponse[]
    The list of children.
    displayName string
    The friendly name of the child resource.
    id string
    The fully qualified ID for the child resource (management group or subscription). For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name string
    The name of the child entity.
    type string
    The fully qualified resource type which includes provider namespace (e.g. Microsoft.Management/managementGroups)
    children Sequence[ManagementGroupChildInfoResponse]
    The list of children.
    display_name str
    The friendly name of the child resource.
    id str
    The fully qualified ID for the child resource (management group or subscription). For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name str
    The name of the child entity.
    type str
    The fully qualified resource type which includes provider namespace (e.g. Microsoft.Management/managementGroups)
    children List<Property Map>
    The list of children.
    displayName String
    The friendly name of the child resource.
    id String
    The fully qualified ID for the child resource (management group or subscription). For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name String
    The name of the child entity.
    type String
    The fully qualified resource type which includes provider namespace (e.g. Microsoft.Management/managementGroups)

    ManagementGroupDetailsResponse

    ManagementGroupAncestors List<string>
    The ancestors of the management group.
    ManagementGroupAncestorsChain List<Pulumi.AzureNative.Management.Inputs.ManagementGroupPathElementResponse>
    The ancestors of the management group displayed in reversed order, from immediate parent to the root.
    Parent Pulumi.AzureNative.Management.Inputs.ParentGroupInfoResponse
    (Optional) The ID of the parent management group.
    Path List<Pulumi.AzureNative.Management.Inputs.ManagementGroupPathElementResponse>
    The path from the root to the current group.
    UpdatedBy string
    The identity of the principal or process that updated the object.
    UpdatedTime string
    The date and time when this object was last updated.
    Version int
    The version number of the object.
    ManagementGroupAncestors []string
    The ancestors of the management group.
    ManagementGroupAncestorsChain []ManagementGroupPathElementResponse
    The ancestors of the management group displayed in reversed order, from immediate parent to the root.
    Parent ParentGroupInfoResponse
    (Optional) The ID of the parent management group.
    Path []ManagementGroupPathElementResponse
    The path from the root to the current group.
    UpdatedBy string
    The identity of the principal or process that updated the object.
    UpdatedTime string
    The date and time when this object was last updated.
    Version int
    The version number of the object.
    managementGroupAncestors List<String>
    The ancestors of the management group.
    managementGroupAncestorsChain List<ManagementGroupPathElementResponse>
    The ancestors of the management group displayed in reversed order, from immediate parent to the root.
    parent ParentGroupInfoResponse
    (Optional) The ID of the parent management group.
    path List<ManagementGroupPathElementResponse>
    The path from the root to the current group.
    updatedBy String
    The identity of the principal or process that updated the object.
    updatedTime String
    The date and time when this object was last updated.
    version Integer
    The version number of the object.
    managementGroupAncestors string[]
    The ancestors of the management group.
    managementGroupAncestorsChain ManagementGroupPathElementResponse[]
    The ancestors of the management group displayed in reversed order, from immediate parent to the root.
    parent ParentGroupInfoResponse
    (Optional) The ID of the parent management group.
    path ManagementGroupPathElementResponse[]
    The path from the root to the current group.
    updatedBy string
    The identity of the principal or process that updated the object.
    updatedTime string
    The date and time when this object was last updated.
    version number
    The version number of the object.
    management_group_ancestors Sequence[str]
    The ancestors of the management group.
    management_group_ancestors_chain Sequence[ManagementGroupPathElementResponse]
    The ancestors of the management group displayed in reversed order, from immediate parent to the root.
    parent ParentGroupInfoResponse
    (Optional) The ID of the parent management group.
    path Sequence[ManagementGroupPathElementResponse]
    The path from the root to the current group.
    updated_by str
    The identity of the principal or process that updated the object.
    updated_time str
    The date and time when this object was last updated.
    version int
    The version number of the object.
    managementGroupAncestors List<String>
    The ancestors of the management group.
    managementGroupAncestorsChain List<Property Map>
    The ancestors of the management group displayed in reversed order, from immediate parent to the root.
    parent Property Map
    (Optional) The ID of the parent management group.
    path List<Property Map>
    The path from the root to the current group.
    updatedBy String
    The identity of the principal or process that updated the object.
    updatedTime String
    The date and time when this object was last updated.
    version Number
    The version number of the object.

    ManagementGroupPathElementResponse

    DisplayName string
    The friendly name of the group.
    Name string
    The name of the group.
    DisplayName string
    The friendly name of the group.
    Name string
    The name of the group.
    displayName String
    The friendly name of the group.
    name String
    The name of the group.
    displayName string
    The friendly name of the group.
    name string
    The name of the group.
    display_name str
    The friendly name of the group.
    name str
    The name of the group.
    displayName String
    The friendly name of the group.
    name String
    The name of the group.

    ParentGroupInfoResponse

    DisplayName string
    The friendly name of the parent management group.
    Id string
    The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    Name string
    The name of the parent management group
    DisplayName string
    The friendly name of the parent management group.
    Id string
    The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    Name string
    The name of the parent management group
    displayName String
    The friendly name of the parent management group.
    id String
    The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name String
    The name of the parent management group
    displayName string
    The friendly name of the parent management group.
    id string
    The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name string
    The name of the parent management group
    display_name str
    The friendly name of the parent management group.
    id str
    The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name str
    The name of the parent management group
    displayName String
    The friendly name of the parent management group.
    id String
    The fully qualified ID for the parent management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
    name String
    The name of the parent management group

    SystemDataResponse

    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    CreatedAt string
    The timestamp of resource creation (UTC).
    CreatedBy string
    The identity that created the resource.
    CreatedByType string
    The type of identity that created the resource.
    LastModifiedAt string
    The timestamp of resource last modification (UTC)
    LastModifiedBy string
    The identity that last modified the resource.
    LastModifiedByType string
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.
    createdAt string
    The timestamp of resource creation (UTC).
    createdBy string
    The identity that created the resource.
    createdByType string
    The type of identity that created the resource.
    lastModifiedAt string
    The timestamp of resource last modification (UTC)
    lastModifiedBy string
    The identity that last modified the resource.
    lastModifiedByType string
    The type of identity that last modified the resource.
    created_at str
    The timestamp of resource creation (UTC).
    created_by str
    The identity that created the resource.
    created_by_type str
    The type of identity that created the resource.
    last_modified_at str
    The timestamp of resource last modification (UTC)
    last_modified_by str
    The identity that last modified the resource.
    last_modified_by_type str
    The type of identity that last modified the resource.
    createdAt String
    The timestamp of resource creation (UTC).
    createdBy String
    The identity that created the resource.
    createdByType String
    The type of identity that created the resource.
    lastModifiedAt String
    The timestamp of resource last modification (UTC)
    lastModifiedBy String
    The identity that last modified the resource.
    lastModifiedByType String
    The type of identity that last modified the resource.

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
    Azure Native v3.13.0 published on Wednesday, Jan 28, 2026 by Pulumi
      Meet Neo: Your AI Platform Teammate