1. Packages
  2. Packages
  3. Zscaler Private Access (ZPA)
  4. API Docs
  5. getTagNamespace
Viewing docs for Zscaler Private Access v1.0.4
published on Monday, Jun 29, 2026 by Zscaler
zpa logo
Viewing docs for Zscaler Private Access v1.0.4
published on Monday, Jun 29, 2026 by Zscaler

    Use the zpa_tag_namespace data source to get information about a tag namespace 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.getTagNamespace({
        name: "Example Namespace",
    });
    export const zpaTagNamespace = _this;
    
    import pulumi
    import pulumi_zpa as zpa
    
    this = zpa.get_tag_namespace(name="Example Namespace")
    pulumi.export("zpaTagNamespace", 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.GetTagNamespace(ctx, &zpa.LookupTagNamespaceArgs{
    			Name: pulumi.StringRef("Example Namespace"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("zpaTagNamespace", this)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Zpa = zscaler.PulumiPackage.Zpa;
    
    return await Deployment.RunAsync(() => 
    {
        var @this = Zpa.GetTagNamespace.Invoke(new()
        {
            Name = "Example Namespace",
        });
    
        return new Dictionary<string, object?>
        {
            ["zpaTagNamespace"] = @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.GetTagNamespaceArgs;
    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.getTagNamespace(GetTagNamespaceArgs.builder()
                .name("Example Namespace")
                .build());
    
            ctx.export("zpaTagNamespace", this_);
        }
    }
    
    variables:
      this:
        fn::invoke:
          function: zpa:getTagNamespace
          arguments:
            name: Example Namespace
    outputs:
      zpaTagNamespace: ${this}
    
    pulumi {
      required_providers {
        zpa = {
          source = "pulumi/zpa"
        }
      }
    }
    
    data "zpa_gettagnamespace" "this" {
      name = "Example Namespace"
    }
    
    output "zpaTagNamespace" {
      value = data.zpa_gettagnamespace.this
    }
    
    import * as pulumi from "@pulumi/pulumi";
    import * as zpa from "@bdzscaler/pulumi-zpa";
    
    const _this = zpa.getTagNamespace({
        id: "123456789",
    });
    
    import pulumi
    import pulumi_zpa as zpa
    
    this = zpa.get_tag_namespace(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.GetTagNamespace(ctx, &zpa.LookupTagNamespaceArgs{
    			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.GetTagNamespace.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.GetTagNamespaceArgs;
    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.getTagNamespace(GetTagNamespaceArgs.builder()
                .id("123456789")
                .build());
    
        }
    }
    
    variables:
      this:
        fn::invoke:
          function: zpa:getTagNamespace
          arguments:
            id: '123456789'
    
    pulumi {
      required_providers {
        zpa = {
          source = "pulumi/zpa"
        }
      }
    }
    
    data "zpa_gettagnamespace" "this" {
      id = "123456789"
    }
    

    Using getTagNamespace

    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 getTagNamespace(args: GetTagNamespaceArgs, opts?: InvokeOptions): Promise<GetTagNamespaceResult>
    function getTagNamespaceOutput(args: GetTagNamespaceOutputArgs, opts?: InvokeOptions): Output<GetTagNamespaceResult>
    def get_tag_namespace(id: Optional[str] = None,
                          microtenant_id: Optional[str] = None,
                          name: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetTagNamespaceResult
    def get_tag_namespace_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[GetTagNamespaceResult]
    func LookupTagNamespace(ctx *Context, args *LookupTagNamespaceArgs, opts ...InvokeOption) (*LookupTagNamespaceResult, error)
    func LookupTagNamespaceOutput(ctx *Context, args *LookupTagNamespaceOutputArgs, opts ...InvokeOption) LookupTagNamespaceResultOutput

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

    public static class GetTagNamespace 
    {
        public static Task<GetTagNamespaceResult> InvokeAsync(GetTagNamespaceArgs args, InvokeOptions? opts = null)
        public static Output<GetTagNamespaceResult> Invoke(GetTagNamespaceInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetTagNamespaceResult> getTagNamespace(GetTagNamespaceArgs args, InvokeOptions options)
    public static Output<GetTagNamespaceResult> getTagNamespace(GetTagNamespaceArgs args, InvokeOptions options)
    
    fn::invoke:
      function: zpa:index/getTagNamespace:getTagNamespace
      arguments:
        # arguments dictionary
    data "zpa_get_tag_namespace" "name" {
        # arguments
    }

    The following arguments are supported:

    Id string
    The ID of the tag namespace.
    MicrotenantId string

    The ID of the microtenant.

    NOTE: id and name are mutually exclusive but at least one must be provided.

    Name string
    The name of the tag namespace.
    Id string
    The ID of the tag namespace.
    MicrotenantId string

    The ID of the microtenant.

    NOTE: id and name are mutually exclusive but at least one must be provided.

    Name string
    The name of the tag namespace.
    id string
    The ID of the tag namespace.
    microtenant_id string

    The ID of the microtenant.

    NOTE: id and name are mutually exclusive but at least one must be provided.

    name string
    The name of the tag namespace.
    id String
    The ID of the tag namespace.
    microtenantId String

    The ID of the microtenant.

    NOTE: id and name are mutually exclusive but at least one must be provided.

    name String
    The name of the tag namespace.
    id string
    The ID of the tag namespace.
    microtenantId string

    The ID of the microtenant.

    NOTE: id and name are mutually exclusive but at least one must be provided.

    name string
    The name of the tag namespace.
    id str
    The ID of the tag namespace.
    microtenant_id str

    The ID of the microtenant.

    NOTE: id and name are mutually exclusive but at least one must be provided.

    name str
    The name of the tag namespace.
    id String
    The ID of the tag namespace.
    microtenantId String

    The ID of the microtenant.

    NOTE: id and name are mutually exclusive but at least one must be provided.

    name String
    The name of the tag namespace.

    getTagNamespace Result

    The following output properties are available:

    Description string
    The description of the tag namespace.
    Enabled bool
    Whether the tag namespace is enabled.
    MicrotenantName string
    The name of the microtenant.
    Origin string
    The origin of the tag namespace.
    Type string
    The type of the tag namespace.
    Id string
    MicrotenantId string
    The ID of the microtenant.
    Name string
    Description string
    The description of the tag namespace.
    Enabled bool
    Whether the tag namespace is enabled.
    MicrotenantName string
    The name of the microtenant.
    Origin string
    The origin of the tag namespace.
    Type string
    The type of the tag namespace.
    Id string
    MicrotenantId string
    The ID of the microtenant.
    Name string
    description string
    The description of the tag namespace.
    enabled bool
    Whether the tag namespace is enabled.
    microtenant_name string
    The name of the microtenant.
    origin string
    The origin of the tag namespace.
    type string
    The type of the tag namespace.
    id string
    microtenant_id string
    The ID of the microtenant.
    name string
    description String
    The description of the tag namespace.
    enabled Boolean
    Whether the tag namespace is enabled.
    microtenantName String
    The name of the microtenant.
    origin String
    The origin of the tag namespace.
    type String
    The type of the tag namespace.
    id String
    microtenantId String
    The ID of the microtenant.
    name String
    description string
    The description of the tag namespace.
    enabled boolean
    Whether the tag namespace is enabled.
    microtenantName string
    The name of the microtenant.
    origin string
    The origin of the tag namespace.
    type string
    The type of the tag namespace.
    id string
    microtenantId string
    The ID of the microtenant.
    name string
    description str
    The description of the tag namespace.
    enabled bool
    Whether the tag namespace is enabled.
    microtenant_name str
    The name of the microtenant.
    origin str
    The origin of the tag namespace.
    type str
    The type of the tag namespace.
    id str
    microtenant_id str
    The ID of the microtenant.
    name str
    description String
    The description of the tag namespace.
    enabled Boolean
    Whether the tag namespace is enabled.
    microtenantName String
    The name of the microtenant.
    origin String
    The origin of the tag namespace.
    type String
    The type of the tag namespace.
    id String
    microtenantId String
    The ID of the microtenant.
    name String

    Package Details

    Repository
    zpa zscaler/pulumi-zpa
    License
    MIT
    Notes
    This Pulumi package is based on the zpa Terraform Provider.
    zpa logo
    Viewing docs for Zscaler Private Access v1.0.4
    published on Monday, Jun 29, 2026 by Zscaler

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial