zpa.getMicrotenant
Explore with Pulumi AI
The zpa_microtenant_controller data source to get information about a machine group created in the Zscaler Private Access cloud. This data source allows administrators to retrieve a specific microtenant ID, which can be passed to other supported resources via the microtenant_id attribute.
⚠️ WARNING:: This feature is in limited availability and requires additional license. To learn more, contact Zscaler Support or your local account team.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as zpa from "@pulumi/zpa";
const this = zpa.getMicrotenant({
    name: "Microtenant_A",
});
import pulumi
import pulumi_zpa as zpa
this = zpa.get_microtenant(name="Microtenant_A")
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.LookupMicrotenant(ctx, &zpa.LookupMicrotenantArgs{
			Name: pulumi.StringRef("Microtenant_A"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Zpa = Pulumi.Zpa;
return await Deployment.RunAsync(() => 
{
    var @this = Zpa.GetMicrotenant.Invoke(new()
    {
        Name = "Microtenant_A",
    });
});
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.GetMicrotenantArgs;
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 this = ZpaFunctions.getMicrotenant(GetMicrotenantArgs.builder()
            .name("Microtenant_A")
            .build());
    }
}
variables:
  this:
    fn::invoke:
      Function: zpa:getMicrotenant
      Arguments:
        name: Microtenant_A
Using getMicrotenant
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 getMicrotenant(args: GetMicrotenantArgs, opts?: InvokeOptions): Promise<GetMicrotenantResult>
function getMicrotenantOutput(args: GetMicrotenantOutputArgs, opts?: InvokeOptions): Output<GetMicrotenantResult>def get_microtenant(id: Optional[str] = None,
                    name: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetMicrotenantResult
def get_microtenant_output(id: Optional[pulumi.Input[str]] = None,
                    name: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetMicrotenantResult]func LookupMicrotenant(ctx *Context, args *LookupMicrotenantArgs, opts ...InvokeOption) (*LookupMicrotenantResult, error)
func LookupMicrotenantOutput(ctx *Context, args *LookupMicrotenantOutputArgs, opts ...InvokeOption) LookupMicrotenantResultOutput> Note: This function is named LookupMicrotenant in the Go SDK.
public static class GetMicrotenant 
{
    public static Task<GetMicrotenantResult> InvokeAsync(GetMicrotenantArgs args, InvokeOptions? opts = null)
    public static Output<GetMicrotenantResult> Invoke(GetMicrotenantInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetMicrotenantResult> getMicrotenant(GetMicrotenantArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: zpa:index/getMicrotenant:getMicrotenant
  arguments:
    # arguments dictionaryThe following arguments are supported:
getMicrotenant Result
The following output properties are available:
- Creation
Time string - Criteria
Attribute string - Criteria
Attribute List<string>Values  - Description string
 - Enabled bool
 - Modified
By string - Modified
Time string - Operator string
 - Priority string
 - Roles
List<Zscaler.
Zpa. Outputs. Get Microtenant Role>  - Users
List<Zscaler.
Zpa. Outputs. Get Microtenant User>  - Id string
 - Name string
 - (Required) Name of the microtenant controller.
 
- Creation
Time string - Criteria
Attribute string - Criteria
Attribute []stringValues  - Description string
 - Enabled bool
 - Modified
By string - Modified
Time string - Operator string
 - Priority string
 - Roles
[]Get
Microtenant Role  - Users
[]Get
Microtenant User  - Id string
 - Name string
 - (Required) Name of the microtenant controller.
 
- creation
Time String - criteria
Attribute String - criteria
Attribute List<String>Values  - description String
 - enabled Boolean
 - modified
By String - modified
Time String - operator String
 - priority String
 - roles
List<Get
Microtenant Role>  - users
List<Get
Microtenant User>  - id String
 - name String
 - (Required) Name of the microtenant controller.
 
- creation
Time string - criteria
Attribute string - criteria
Attribute string[]Values  - description string
 - enabled boolean
 - modified
By string - modified
Time string - operator string
 - priority string
 - roles
Get
Microtenant Role[]  - users
Get
Microtenant User[]  - id string
 - name string
 - (Required) Name of the microtenant controller.
 
- creation_
time str - criteria_
attribute str - criteria_
attribute_ Sequence[str]values  - description str
 - enabled bool
 - modified_
by str - modified_
time str - operator str
 - priority str
 - roles
Sequence[Get
Microtenant Role]  - users
Sequence[Get
Microtenant User]  - id str
 - name str
 - (Required) Name of the microtenant controller.
 
- creation
Time String - criteria
Attribute String - criteria
Attribute List<String>Values  - description String
 - enabled Boolean
 - modified
By String - modified
Time String - operator String
 - priority String
 - roles List<Property Map>
 - users List<Property Map>
 - id String
 - name String
 - (Required) Name of the microtenant controller.
 
Supporting Types
GetMicrotenantRole  
- Custom
Role bool - Id string
 - Name string
 - (Required) Name of the microtenant controller.
 
- Custom
Role bool - Id string
 - Name string
 - (Required) Name of the microtenant controller.
 
- custom
Role Boolean - id String
 - name String
 - (Required) Name of the microtenant controller.
 
- custom
Role boolean - id string
 - name string
 - (Required) Name of the microtenant controller.
 
- custom_
role bool - id str
 - name str
 - (Required) Name of the microtenant controller.
 
- custom
Role Boolean - id String
 - name String
 - (Required) Name of the microtenant controller.
 
GetMicrotenantUser  
- Comments string
 - Creation
Time string - Customer
Id string - Description string
 - Display
Name string - Email string
 - Enabled bool
 - Eula string
 - Force
Pwd boolChange  - Group
Ids string - Id string
 - Is
Enabled bool - Is
Locked bool - Language
Code string - Local
Login boolDisabled  - Microtenant
Id string - Microtenant
Name string - Modified
Time int - Modifiedby int
 - Name string
 - (Required) Name of the microtenant controller.
 
- Password string
 - Phone
Number bool - Pin
Session string - Role
Id bool - Timezone string
 - Tmp
Password string - Token
Id string - Two
Factor boolAuth Enabled  - Two
Factor stringAuth Type  - Username string
 
- Comments string
 - Creation
Time string - Customer
Id string - Description string
 - Display
Name string - Email string
 - Enabled bool
 - Eula string
 - Force
Pwd boolChange  - Group
Ids string - Id string
 - Is
Enabled bool - Is
Locked bool - Language
Code string - Local
Login boolDisabled  - Microtenant
Id string - Microtenant
Name string - Modified
Time int - Modifiedby int
 - Name string
 - (Required) Name of the microtenant controller.
 
- Password string
 - Phone
Number bool - Pin
Session string - Role
Id bool - Timezone string
 - Tmp
Password string - Token
Id string - Two
Factor boolAuth Enabled  - Two
Factor stringAuth Type  - Username string
 
- comments String
 - creation
Time String - customer
Id String - description String
 - display
Name String - email String
 - enabled Boolean
 - eula String
 - force
Pwd BooleanChange  - group
Ids String - id String
 - is
Enabled Boolean - is
Locked Boolean - language
Code String - local
Login BooleanDisabled  - microtenant
Id String - microtenant
Name String - modified
Time Integer - modifiedby Integer
 - name String
 - (Required) Name of the microtenant controller.
 
- password String
 - phone
Number Boolean - pin
Session String - role
Id Boolean - timezone String
 - tmp
Password String - token
Id String - two
Factor BooleanAuth Enabled  - two
Factor StringAuth Type  - username String
 
- comments string
 - creation
Time string - customer
Id string - description string
 - display
Name string - email string
 - enabled boolean
 - eula string
 - force
Pwd booleanChange  - group
Ids string - id string
 - is
Enabled boolean - is
Locked boolean - language
Code string - local
Login booleanDisabled  - microtenant
Id string - microtenant
Name string - modified
Time number - modifiedby number
 - name string
 - (Required) Name of the microtenant controller.
 
- password string
 - phone
Number boolean - pin
Session string - role
Id boolean - timezone string
 - tmp
Password string - token
Id string - two
Factor booleanAuth Enabled  - two
Factor stringAuth Type  - username string
 
- comments str
 - creation_
time str - customer_
id str - description str
 - display_
name str - email str
 - enabled bool
 - eula str
 - force_
pwd_ boolchange  - group_
ids str - id str
 - is_
enabled bool - is_
locked bool - language_
code str - local_
login_ booldisabled  - microtenant_
id str - microtenant_
name str - modified_
time int - modifiedby int
 - name str
 - (Required) Name of the microtenant controller.
 
- password str
 - phone_
number bool - pin_
session str - role_
id bool - timezone str
 - tmp_
password str - token_
id str - two_
factor_ boolauth_ enabled  - two_
factor_ strauth_ type  - username str
 
- comments String
 - creation
Time String - customer
Id String - description String
 - display
Name String - email String
 - enabled Boolean
 - eula String
 - force
Pwd BooleanChange  - group
Ids String - id String
 - is
Enabled Boolean - is
Locked Boolean - language
Code String - local
Login BooleanDisabled  - microtenant
Id String - microtenant
Name String - modified
Time Number - modifiedby Number
 - name String
 - (Required) Name of the microtenant controller.
 
- password String
 - phone
Number Boolean - pin
Session String - role
Id Boolean - timezone String
 - tmp
Password String - token
Id String - two
Factor BooleanAuth Enabled  - two
Factor StringAuth Type  - username String
 
Package Details
- Repository
 - zpa zscaler/pulumi-zpa
 - License
 - MIT
 - Notes
 - This Pulumi package is based on the 
zpaTerraform Provider.