published on Monday, Jun 29, 2026 by Zscaler
published on Monday, Jun 29, 2026 by Zscaler
Use the zpa_tag_group data source to get information about a tag group in Zscaler Private Access (ZPA).
NOTE: This an Early Access feature.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as zpa from "@bdzscaler/pulumi-zpa";
const _this = zpa.getTagGroup({
name: "Example Tag Group",
});
export const zpaTagGroup = _this;
import pulumi
import pulumi_zpa as zpa
this = zpa.get_tag_group(name="Example Tag Group")
pulumi.export("zpaTagGroup", this)
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/zscaler/pulumi-zpa/sdk/go/zpa"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
this, err := zpa.GetTagGroup(ctx, &zpa.LookupTagGroupArgs{
Name: pulumi.StringRef("Example Tag Group"),
}, nil)
if err != nil {
return err
}
ctx.Export("zpaTagGroup", this)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Zpa = zscaler.PulumiPackage.Zpa;
return await Deployment.RunAsync(() =>
{
var @this = Zpa.GetTagGroup.Invoke(new()
{
Name = "Example Tag Group",
});
return new Dictionary<string, object?>
{
["zpaTagGroup"] = @this,
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.zpa.ZpaFunctions;
import com.pulumi.zpa.inputs.GetTagGroupArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 this = ZpaFunctions.getTagGroup(GetTagGroupArgs.builder()
.name("Example Tag Group")
.build());
ctx.export("zpaTagGroup", this_);
}
}
variables:
this:
fn::invoke:
function: zpa:getTagGroup
arguments:
name: Example Tag Group
outputs:
zpaTagGroup: ${this}
pulumi {
required_providers {
zpa = {
source = "pulumi/zpa"
}
}
}
data "zpa_gettaggroup" "this" {
name = "Example Tag Group"
}
output "zpaTagGroup" {
value = data.zpa_gettaggroup.this
}
import * as pulumi from "@pulumi/pulumi";
import * as zpa from "@bdzscaler/pulumi-zpa";
const _this = zpa.getTagGroup({
id: "123456789",
});
import pulumi
import pulumi_zpa as zpa
this = zpa.get_tag_group(id="123456789")
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/zscaler/pulumi-zpa/sdk/go/zpa"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := zpa.GetTagGroup(ctx, &zpa.LookupTagGroupArgs{
Id: pulumi.StringRef("123456789"),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Zpa = zscaler.PulumiPackage.Zpa;
return await Deployment.RunAsync(() =>
{
var @this = Zpa.GetTagGroup.Invoke(new()
{
Id = "123456789",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.zpa.ZpaFunctions;
import com.pulumi.zpa.inputs.GetTagGroupArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 this = ZpaFunctions.getTagGroup(GetTagGroupArgs.builder()
.id("123456789")
.build());
}
}
variables:
this:
fn::invoke:
function: zpa:getTagGroup
arguments:
id: '123456789'
pulumi {
required_providers {
zpa = {
source = "pulumi/zpa"
}
}
}
data "zpa_gettaggroup" "this" {
id = "123456789"
}
Using getTagGroup
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 getTagGroup(args: GetTagGroupArgs, opts?: InvokeOptions): Promise<GetTagGroupResult>
function getTagGroupOutput(args: GetTagGroupOutputArgs, opts?: InvokeOptions): Output<GetTagGroupResult>def get_tag_group(id: Optional[str] = None,
microtenant_id: Optional[str] = None,
name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetTagGroupResult
def get_tag_group_output(id: pulumi.Input[Optional[str]] = None,
microtenant_id: pulumi.Input[Optional[str]] = None,
name: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetTagGroupResult]func LookupTagGroup(ctx *Context, args *LookupTagGroupArgs, opts ...InvokeOption) (*LookupTagGroupResult, error)
func LookupTagGroupOutput(ctx *Context, args *LookupTagGroupOutputArgs, opts ...InvokeOption) LookupTagGroupResultOutput> Note: This function is named LookupTagGroup in the Go SDK.
public static class GetTagGroup
{
public static Task<GetTagGroupResult> InvokeAsync(GetTagGroupArgs args, InvokeOptions? opts = null)
public static Output<GetTagGroupResult> Invoke(GetTagGroupInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetTagGroupResult> getTagGroup(GetTagGroupArgs args, InvokeOptions options)
public static Output<GetTagGroupResult> getTagGroup(GetTagGroupArgs args, InvokeOptions options)
fn::invoke:
function: zpa:index/getTagGroup:getTagGroup
arguments:
# arguments dictionarydata "zpa_get_tag_group" "name" {
# arguments
}The following arguments are supported:
- Id string
- The ID of the tag group.
- Microtenant
Id string The ID of the microtenant.
NOTE:
idandnameare mutually exclusive but at least one must be provided.- Name string
- The name of the tag group.
- Id string
- The ID of the tag group.
- Microtenant
Id string The ID of the microtenant.
NOTE:
idandnameare mutually exclusive but at least one must be provided.- Name string
- The name of the tag group.
- id string
- The ID of the tag group.
- microtenant_
id string The ID of the microtenant.
NOTE:
idandnameare mutually exclusive but at least one must be provided.- name string
- The name of the tag group.
- id String
- The ID of the tag group.
- microtenant
Id String The ID of the microtenant.
NOTE:
idandnameare mutually exclusive but at least one must be provided.- name String
- The name of the tag group.
- id string
- The ID of the tag group.
- microtenant
Id string The ID of the microtenant.
NOTE:
idandnameare mutually exclusive but at least one must be provided.- name string
- The name of the tag group.
- id str
- The ID of the tag group.
- microtenant_
id str The ID of the microtenant.
NOTE:
idandnameare mutually exclusive but at least one must be provided.- name str
- The name of the tag group.
- id String
- The ID of the tag group.
- microtenant
Id String The ID of the microtenant.
NOTE:
idandnameare mutually exclusive but at least one must be provided.- name String
- The name of the tag group.
getTagGroup Result
The following output properties are available:
- Description string
- The description of the tag group.
- Microtenant
Name string - The name of the microtenant.
-
List<zscaler.
Pulumi Package. Zpa. Outputs. Get Tag Group Tag> - A list of tags in this tag group. Each element contains:
- Id string
- The ID of the tag value.
- Microtenant
Id string - The ID of the microtenant.
- Name string
- The name of the tag value.
- Description string
- The description of the tag group.
- Microtenant
Name string - The name of the microtenant.
-
[]Get
Tag Group Tag - A list of tags in this tag group. Each element contains:
- Id string
- The ID of the tag value.
- Microtenant
Id string - The ID of the microtenant.
- Name string
- The name of the tag value.
- description string
- The description of the tag group.
- microtenant_
name string - The name of the microtenant.
- list(object)
- A list of tags in this tag group. Each element contains:
- id string
- The ID of the tag value.
- microtenant_
id string - The ID of the microtenant.
- name string
- The name of the tag value.
- description String
- The description of the tag group.
- microtenant
Name String - The name of the microtenant.
-
List<Get
Tag Group Tag> - A list of tags in this tag group. Each element contains:
- id String
- The ID of the tag value.
- microtenant
Id String - The ID of the microtenant.
- name String
- The name of the tag value.
- description string
- The description of the tag group.
- microtenant
Name string - The name of the microtenant.
-
Get
Tag Group Tag[] - A list of tags in this tag group. Each element contains:
- id string
- The ID of the tag value.
- microtenant
Id string - The ID of the microtenant.
- name string
- The name of the tag value.
- description str
- The description of the tag group.
- microtenant_
name str - The name of the microtenant.
-
Sequence[Get
Tag Group Tag] - A list of tags in this tag group. Each element contains:
- id str
- The ID of the tag value.
- microtenant_
id str - The ID of the microtenant.
- name str
- The name of the tag value.
- description String
- The description of the tag group.
- microtenant
Name String - The name of the microtenant.
- List<Property Map>
- A list of tags in this tag group. Each element contains:
- id String
- The ID of the tag value.
- microtenant
Id String - The ID of the microtenant.
- name String
- The name of the tag value.
Supporting Types
GetTagGroupTag
- Namespaces
List<zscaler.
Pulumi Package. Zpa. Inputs. Get Tag Group Tag Namespace> - A list containing the tag namespace details:
- Origin string
- The origin of the tag.
- Tag
Keys List<zscaler.Pulumi Package. Zpa. Inputs. Get Tag Group Tag Tag Key> - A list containing the tag key details:
- Tag
Values List<zscaler.Pulumi Package. Zpa. Inputs. Get Tag Group Tag Tag Value> - A list containing the tag value details:
- Namespaces
[]Get
Tag Group Tag Namespace - A list containing the tag namespace details:
- Origin string
- The origin of the tag.
- Tag
Keys []GetTag Group Tag Tag Key - A list containing the tag key details:
- Tag
Values []GetTag Group Tag Tag Value - A list containing the tag value details:
- namespaces list(object)
- A list containing the tag namespace details:
- origin string
- The origin of the tag.
- tag_
keys list(object) - A list containing the tag key details:
- tag_
values list(object) - A list containing the tag value details:
- namespaces
List<Get
Tag Group Tag Namespace> - A list containing the tag namespace details:
- origin String
- The origin of the tag.
- tag
Keys List<GetTag Group Tag Tag Key> - A list containing the tag key details:
- tag
Values List<GetTag Group Tag Tag Value> - A list containing the tag value details:
- namespaces
Get
Tag Group Tag Namespace[] - A list containing the tag namespace details:
- origin string
- The origin of the tag.
- tag
Keys GetTag Group Tag Tag Key[] - A list containing the tag key details:
- tag
Values GetTag Group Tag Tag Value[] - A list containing the tag value details:
- namespaces
Sequence[Get
Tag Group Tag Namespace] - A list containing the tag namespace details:
- origin str
- The origin of the tag.
- tag_
keys Sequence[GetTag Group Tag Tag Key] - A list containing the tag key details:
- tag_
values Sequence[GetTag Group Tag Tag Value] - A list containing the tag value details:
- namespaces List<Property Map>
- A list containing the tag namespace details:
- origin String
- The origin of the tag.
- tag
Keys List<Property Map> - A list containing the tag key details:
- tag
Values List<Property Map> - A list containing the tag value details:
GetTagGroupTagNamespace
GetTagGroupTagTagKey
GetTagGroupTagTagValue
Package Details
- Repository
- zpa zscaler/pulumi-zpa
- License
- MIT
- Notes
- This Pulumi package is based on the
zpaTerraform Provider.
published on Monday, Jun 29, 2026 by Zscaler