1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. getUserManagement
Zscaler Internet Access v0.0.7 published on Tuesday, Jul 30, 2024 by Zscaler

zia.getUserManagement

Explore with Pulumi AI

Zscaler Internet Access v0.0.7 published on Tuesday, Jul 30, 2024 by Zscaler

Use the zia_user_management data source to get information about a user account that may have been created in the Zscaler Internet Access portal or via API. This data source can then be associated with a ZIA cloud firewall filtering rule, and URL filtering rules.

Example Usage

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

const adamAshcroft = zia.getUserManagement({
    name: "Adam Ashcroft",
});
Copy
import pulumi
import pulumi_zia as zia

adam_ashcroft = zia.get_user_management(name="Adam Ashcroft")
Copy
package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/zscaler/pulumi-zia/sdk/go/zia"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := zia.LookupUserManagement(ctx, &zia.LookupUserManagementArgs{
			Name: pulumi.StringRef("Adam Ashcroft"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Zia = Pulumi.Zia;

return await Deployment.RunAsync(() => 
{
    var adamAshcroft = Zia.GetUserManagement.Invoke(new()
    {
        Name = "Adam Ashcroft",
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.zia.ZiaFunctions;
import com.pulumi.zia.inputs.GetUserManagementArgs;
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 adamAshcroft = ZiaFunctions.getUserManagement(GetUserManagementArgs.builder()
            .name("Adam Ashcroft")
            .build());

    }
}
Copy
variables:
  adamAshcroft:
    fn::invoke:
      Function: zia:getUserManagement
      Arguments:
        name: Adam Ashcroft
Copy

Using getUserManagement

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 getUserManagement(args: GetUserManagementArgs, opts?: InvokeOptions): Promise<GetUserManagementResult>
function getUserManagementOutput(args: GetUserManagementOutputArgs, opts?: InvokeOptions): Output<GetUserManagementResult>
Copy
def get_user_management(auth_methods: Optional[Sequence[str]] = None,
                        id: Optional[int] = None,
                        name: Optional[str] = None,
                        opts: Optional[InvokeOptions] = None) -> GetUserManagementResult
def get_user_management_output(auth_methods: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                        id: Optional[pulumi.Input[int]] = None,
                        name: Optional[pulumi.Input[str]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetUserManagementResult]
Copy
func LookupUserManagement(ctx *Context, args *LookupUserManagementArgs, opts ...InvokeOption) (*LookupUserManagementResult, error)
func LookupUserManagementOutput(ctx *Context, args *LookupUserManagementOutputArgs, opts ...InvokeOption) LookupUserManagementResultOutput
Copy

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

public static class GetUserManagement 
{
    public static Task<GetUserManagementResult> InvokeAsync(GetUserManagementArgs args, InvokeOptions? opts = null)
    public static Output<GetUserManagementResult> Invoke(GetUserManagementInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetUserManagementResult> getUserManagement(GetUserManagementArgs args, InvokeOptions options)
public static Output<GetUserManagementResult> getUserManagement(GetUserManagementArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: zia:index/getUserManagement:getUserManagement
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

AuthMethods List<string>
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
Id int
The ID of the time window resource.
Name string
User name. This appears when choosing users for policies.
AuthMethods []string
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
Id int
The ID of the time window resource.
Name string
User name. This appears when choosing users for policies.
authMethods List<String>
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id Integer
The ID of the time window resource.
name String
User name. This appears when choosing users for policies.
authMethods string[]
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id number
The ID of the time window resource.
name string
User name. This appears when choosing users for policies.
auth_methods Sequence[str]
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id int
The ID of the time window resource.
name str
User name. This appears when choosing users for policies.
authMethods List<String>
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id Number
The ID of the time window resource.
name String
User name. This appears when choosing users for policies.

getUserManagement Result

The following output properties are available:

AdminUser bool
(String) True if this user is an Admin user. readOnly: true default: false
Comments string
(String) Additional information about the group
Departments List<zscaler.PulumiPackage.Zia.Outputs.GetUserManagementDepartment>
(String) Department a user belongs to
Email string
(Required) User email consists of a user name and domain name. It does not have to be a valid email address, but it must be unique and its domain must belong to the organization
Groups List<zscaler.PulumiPackage.Zia.Outputs.GetUserManagementGroup>
(String) List of Groups a user belongs to. Groups are used in policies.
IsAuditor string
TempAuthEmail string
(String) Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
Type string
(String) User type. Provided only if this user is not an end user. The supported types are:

  • SUPERADMIN
  • ADMIN
  • AUDITOR
  • GUEST
  • REPORT_USER
  • UNAUTH_TRAFFIC_DEFAULT
AuthMethods List<string>
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
Id int
(Number) Unique identfier for the group
Name string
(String) Group name
AdminUser bool
(String) True if this user is an Admin user. readOnly: true default: false
Comments string
(String) Additional information about the group
Departments []GetUserManagementDepartment
(String) Department a user belongs to
Email string
(Required) User email consists of a user name and domain name. It does not have to be a valid email address, but it must be unique and its domain must belong to the organization
Groups []GetUserManagementGroup
(String) List of Groups a user belongs to. Groups are used in policies.
IsAuditor string
TempAuthEmail string
(String) Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
Type string
(String) User type. Provided only if this user is not an end user. The supported types are:

  • SUPERADMIN
  • ADMIN
  • AUDITOR
  • GUEST
  • REPORT_USER
  • UNAUTH_TRAFFIC_DEFAULT
AuthMethods []string
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
Id int
(Number) Unique identfier for the group
Name string
(String) Group name
adminUser Boolean
(String) True if this user is an Admin user. readOnly: true default: false
comments String
(String) Additional information about the group
departments List<GetUserManagementDepartment>
(String) Department a user belongs to
email String
(Required) User email consists of a user name and domain name. It does not have to be a valid email address, but it must be unique and its domain must belong to the organization
groups List<GetUserManagementGroup>
(String) List of Groups a user belongs to. Groups are used in policies.
isAuditor String
tempAuthEmail String
(String) Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
type String
(String) User type. Provided only if this user is not an end user. The supported types are:

  • SUPERADMIN
  • ADMIN
  • AUDITOR
  • GUEST
  • REPORT_USER
  • UNAUTH_TRAFFIC_DEFAULT
authMethods List<String>
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id Integer
(Number) Unique identfier for the group
name String
(String) Group name
adminUser boolean
(String) True if this user is an Admin user. readOnly: true default: false
comments string
(String) Additional information about the group
departments GetUserManagementDepartment[]
(String) Department a user belongs to
email string
(Required) User email consists of a user name and domain name. It does not have to be a valid email address, but it must be unique and its domain must belong to the organization
groups GetUserManagementGroup[]
(String) List of Groups a user belongs to. Groups are used in policies.
isAuditor string
tempAuthEmail string
(String) Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
type string
(String) User type. Provided only if this user is not an end user. The supported types are:

  • SUPERADMIN
  • ADMIN
  • AUDITOR
  • GUEST
  • REPORT_USER
  • UNAUTH_TRAFFIC_DEFAULT
authMethods string[]
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id number
(Number) Unique identfier for the group
name string
(String) Group name
admin_user bool
(String) True if this user is an Admin user. readOnly: true default: false
comments str
(String) Additional information about the group
departments Sequence[GetUserManagementDepartment]
(String) Department a user belongs to
email str
(Required) User email consists of a user name and domain name. It does not have to be a valid email address, but it must be unique and its domain must belong to the organization
groups Sequence[GetUserManagementGroup]
(String) List of Groups a user belongs to. Groups are used in policies.
is_auditor str
temp_auth_email str
(String) Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
type str
(String) User type. Provided only if this user is not an end user. The supported types are:

  • SUPERADMIN
  • ADMIN
  • AUDITOR
  • GUEST
  • REPORT_USER
  • UNAUTH_TRAFFIC_DEFAULT
auth_methods Sequence[str]
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id int
(Number) Unique identfier for the group
name str
(String) Group name
adminUser Boolean
(String) True if this user is an Admin user. readOnly: true default: false
comments String
(String) Additional information about the group
departments List<Property Map>
(String) Department a user belongs to
email String
(Required) User email consists of a user name and domain name. It does not have to be a valid email address, but it must be unique and its domain must belong to the organization
groups List<Property Map>
(String) List of Groups a user belongs to. Groups are used in policies.
isAuditor String
tempAuthEmail String
(String) Temporary Authentication Email. If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
type String
(String) User type. Provided only if this user is not an end user. The supported types are:

  • SUPERADMIN
  • ADMIN
  • AUDITOR
  • GUEST
  • REPORT_USER
  • UNAUTH_TRAFFIC_DEFAULT
authMethods List<String>
(String) Type of authentication method to be enabled. Supported values are: BASIC and DIGEST
id Number
(Number) Unique identfier for the group
name String
(String) Group name

Supporting Types

GetUserManagementDepartment

Comments This property is required. string
(String) Additional information about the group
Deleted This property is required. bool
(Boolean) default: false
Id This property is required. int
The ID of the time window resource.
IdpId This property is required. int
(Number) Unique identfier for the identity provider (IdP)
Name This property is required. string
User name. This appears when choosing users for policies.
Comments This property is required. string
(String) Additional information about the group
Deleted This property is required. bool
(Boolean) default: false
Id This property is required. int
The ID of the time window resource.
IdpId This property is required. int
(Number) Unique identfier for the identity provider (IdP)
Name This property is required. string
User name. This appears when choosing users for policies.
comments This property is required. String
(String) Additional information about the group
deleted This property is required. Boolean
(Boolean) default: false
id This property is required. Integer
The ID of the time window resource.
idpId This property is required. Integer
(Number) Unique identfier for the identity provider (IdP)
name This property is required. String
User name. This appears when choosing users for policies.
comments This property is required. string
(String) Additional information about the group
deleted This property is required. boolean
(Boolean) default: false
id This property is required. number
The ID of the time window resource.
idpId This property is required. number
(Number) Unique identfier for the identity provider (IdP)
name This property is required. string
User name. This appears when choosing users for policies.
comments This property is required. str
(String) Additional information about the group
deleted This property is required. bool
(Boolean) default: false
id This property is required. int
The ID of the time window resource.
idp_id This property is required. int
(Number) Unique identfier for the identity provider (IdP)
name This property is required. str
User name. This appears when choosing users for policies.
comments This property is required. String
(String) Additional information about the group
deleted This property is required. Boolean
(Boolean) default: false
id This property is required. Number
The ID of the time window resource.
idpId This property is required. Number
(Number) Unique identfier for the identity provider (IdP)
name This property is required. String
User name. This appears when choosing users for policies.

GetUserManagementGroup

Comments This property is required. string
(String) Additional information about the group
Id This property is required. int
The ID of the time window resource.
IdpId This property is required. int
(Number) Unique identfier for the identity provider (IdP)
Name This property is required. string
User name. This appears when choosing users for policies.
Comments This property is required. string
(String) Additional information about the group
Id This property is required. int
The ID of the time window resource.
IdpId This property is required. int
(Number) Unique identfier for the identity provider (IdP)
Name This property is required. string
User name. This appears when choosing users for policies.
comments This property is required. String
(String) Additional information about the group
id This property is required. Integer
The ID of the time window resource.
idpId This property is required. Integer
(Number) Unique identfier for the identity provider (IdP)
name This property is required. String
User name. This appears when choosing users for policies.
comments This property is required. string
(String) Additional information about the group
id This property is required. number
The ID of the time window resource.
idpId This property is required. number
(Number) Unique identfier for the identity provider (IdP)
name This property is required. string
User name. This appears when choosing users for policies.
comments This property is required. str
(String) Additional information about the group
id This property is required. int
The ID of the time window resource.
idp_id This property is required. int
(Number) Unique identfier for the identity provider (IdP)
name This property is required. str
User name. This appears when choosing users for policies.
comments This property is required. String
(String) Additional information about the group
id This property is required. Number
The ID of the time window resource.
idpId This property is required. Number
(Number) Unique identfier for the identity provider (IdP)
name This property is required. String
User name. This appears when choosing users for policies.

Package Details

Repository
zia zscaler/pulumi-zia
License
MIT
Notes
This Pulumi package is based on the zia Terraform Provider.
Zscaler Internet Access v0.0.7 published on Tuesday, Jul 30, 2024 by Zscaler