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

zia.getAdminUsers

Explore with Pulumi AI

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

Use the zia_admin_users data source to get information about an admin user account created in the Zscaler Internet Access cloud or via the API. This data source can then be associated with a ZIA administrator role.

Example Usage

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

const johnDoe = zia.getAdminUsers({
    loginName: "john.doe@example.com",
});
Copy
import pulumi
import pulumi_zia as zia

john_doe = zia.get_admin_users(login_name="john.doe@example.com")
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.LookupAdminUsers(ctx, &zia.LookupAdminUsersArgs{
			LoginName: pulumi.StringRef("john.doe@example.com"),
		}, 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 johnDoe = Zia.GetAdminUsers.Invoke(new()
    {
        LoginName = "john.doe@example.com",
    });

});
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.GetAdminUsersArgs;
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 johnDoe = ZiaFunctions.getAdminUsers(GetAdminUsersArgs.builder()
            .loginName("john.doe@example.com")
            .build());

    }
}
Copy
variables:
  johnDoe:
    fn::invoke:
      Function: zia:getAdminUsers
      Arguments:
        loginName: john.doe@example.com
Copy
import * as pulumi from "@pulumi/pulumi";
import * as zia from "@pulumi/zia";

const johnDoe = zia.getAdminUsers({
    username: "John Doe",
});
Copy
import pulumi
import pulumi_zia as zia

john_doe = zia.get_admin_users(username="John Doe")
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.LookupAdminUsers(ctx, &zia.LookupAdminUsersArgs{
			Username: pulumi.StringRef("John Doe"),
		}, 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 johnDoe = Zia.GetAdminUsers.Invoke(new()
    {
        Username = "John Doe",
    });

});
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.GetAdminUsersArgs;
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 johnDoe = ZiaFunctions.getAdminUsers(GetAdminUsersArgs.builder()
            .username("John Doe")
            .build());

    }
}
Copy
variables:
  johnDoe:
    fn::invoke:
      Function: zia:getAdminUsers
      Arguments:
        username: John Doe
Copy

Using getAdminUsers

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 getAdminUsers(args: GetAdminUsersArgs, opts?: InvokeOptions): Promise<GetAdminUsersResult>
function getAdminUsersOutput(args: GetAdminUsersOutputArgs, opts?: InvokeOptions): Output<GetAdminUsersResult>
Copy
def get_admin_users(id: Optional[int] = None,
                    login_name: Optional[str] = None,
                    username: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetAdminUsersResult
def get_admin_users_output(id: Optional[pulumi.Input[int]] = None,
                    login_name: Optional[pulumi.Input[str]] = None,
                    username: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetAdminUsersResult]
Copy
func LookupAdminUsers(ctx *Context, args *LookupAdminUsersArgs, opts ...InvokeOption) (*LookupAdminUsersResult, error)
func LookupAdminUsersOutput(ctx *Context, args *LookupAdminUsersOutputArgs, opts ...InvokeOption) LookupAdminUsersResultOutput
Copy

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

public static class GetAdminUsers 
{
    public static Task<GetAdminUsersResult> InvokeAsync(GetAdminUsersArgs args, InvokeOptions? opts = null)
    public static Output<GetAdminUsersResult> Invoke(GetAdminUsersInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetAdminUsersResult> getAdminUsers(GetAdminUsersArgs args, InvokeOptions options)
public static Output<GetAdminUsersResult> getAdminUsers(GetAdminUsersArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: zia:index/getAdminUsers:getAdminUsers
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Id int
The ID of the admin user to be exported.
LoginName string
The email address of the admin user to be exported.
Username string
The username of the admin user to be exported.
Id int
The ID of the admin user to be exported.
LoginName string
The email address of the admin user to be exported.
Username string
The username of the admin user to be exported.
id Integer
The ID of the admin user to be exported.
loginName String
The email address of the admin user to be exported.
username String
The username of the admin user to be exported.
id number
The ID of the admin user to be exported.
loginName string
The email address of the admin user to be exported.
username string
The username of the admin user to be exported.
id int
The ID of the admin user to be exported.
login_name str
The email address of the admin user to be exported.
username str
The username of the admin user to be exported.
id Number
The ID of the admin user to be exported.
loginName String
The email address of the admin user to be exported.
username String
The username of the admin user to be exported.

getAdminUsers Result

The following output properties are available:

AdminScopes List<zscaler.PulumiPackage.Zia.Outputs.GetAdminUsersAdminScope>
(Set of Object) The admin's scope. Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
Comments string
(String) Additional information about the admin or auditor.
Disabled bool
(Boolean) Indicates whether or not the admin account is disabled.
Email string
(String) Admin or auditor's email address.
ExecMobileAppTokens List<zscaler.PulumiPackage.Zia.Outputs.GetAdminUsersExecMobileAppToken>
(List of Object)
Id int
(Number) Identifier that uniquely identifies an entity
IsAuditor bool
(Boolean) Indicates whether the user is an auditor. This attribute is subject to change.
IsExecMobileAppEnabled bool
(Boolean) Indicates whether or not Executive Insights App access is enabled for the admin.
IsNonEditable bool
(Boolean) Indicates whether or not the admin can be edited or deleted.
IsPasswordExpired bool
(Boolean) Indicates whether or not an admin's password has expired.
IsPasswordLoginAllowed bool
(Boolean) The default is true when SAML Authentication is disabled. When SAML Authentication is enabled, this can be set to false in order to force the admin to login via SSO only.
IsProductUpdateCommEnabled bool
(Boolean) Communication setting for Product Update.
IsSecurityReportCommEnabled bool
(Boolean) Communication for Security Report is enabled.
IsServiceUpdateCommEnabled bool
(Boolean) Communication setting for Service Update.
LoginName string
PwdLastModifiedTime int
Roles List<zscaler.PulumiPackage.Zia.Outputs.GetAdminUsersRole>
(Set of Object) Role of the admin. This is not required for an auditor.
Username string
AdminScopes []GetAdminUsersAdminScope
(Set of Object) The admin's scope. Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
Comments string
(String) Additional information about the admin or auditor.
Disabled bool
(Boolean) Indicates whether or not the admin account is disabled.
Email string
(String) Admin or auditor's email address.
ExecMobileAppTokens []GetAdminUsersExecMobileAppToken
(List of Object)
Id int
(Number) Identifier that uniquely identifies an entity
IsAuditor bool
(Boolean) Indicates whether the user is an auditor. This attribute is subject to change.
IsExecMobileAppEnabled bool
(Boolean) Indicates whether or not Executive Insights App access is enabled for the admin.
IsNonEditable bool
(Boolean) Indicates whether or not the admin can be edited or deleted.
IsPasswordExpired bool
(Boolean) Indicates whether or not an admin's password has expired.
IsPasswordLoginAllowed bool
(Boolean) The default is true when SAML Authentication is disabled. When SAML Authentication is enabled, this can be set to false in order to force the admin to login via SSO only.
IsProductUpdateCommEnabled bool
(Boolean) Communication setting for Product Update.
IsSecurityReportCommEnabled bool
(Boolean) Communication for Security Report is enabled.
IsServiceUpdateCommEnabled bool
(Boolean) Communication setting for Service Update.
LoginName string
PwdLastModifiedTime int
Roles []GetAdminUsersRole
(Set of Object) Role of the admin. This is not required for an auditor.
Username string
adminScopes List<GetAdminUsersAdminScope>
(Set of Object) The admin's scope. Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
comments String
(String) Additional information about the admin or auditor.
disabled Boolean
(Boolean) Indicates whether or not the admin account is disabled.
email String
(String) Admin or auditor's email address.
execMobileAppTokens List<GetAdminUsersExecMobileAppToken>
(List of Object)
id Integer
(Number) Identifier that uniquely identifies an entity
isAuditor Boolean
(Boolean) Indicates whether the user is an auditor. This attribute is subject to change.
isExecMobileAppEnabled Boolean
(Boolean) Indicates whether or not Executive Insights App access is enabled for the admin.
isNonEditable Boolean
(Boolean) Indicates whether or not the admin can be edited or deleted.
isPasswordExpired Boolean
(Boolean) Indicates whether or not an admin's password has expired.
isPasswordLoginAllowed Boolean
(Boolean) The default is true when SAML Authentication is disabled. When SAML Authentication is enabled, this can be set to false in order to force the admin to login via SSO only.
isProductUpdateCommEnabled Boolean
(Boolean) Communication setting for Product Update.
isSecurityReportCommEnabled Boolean
(Boolean) Communication for Security Report is enabled.
isServiceUpdateCommEnabled Boolean
(Boolean) Communication setting for Service Update.
loginName String
pwdLastModifiedTime Integer
roles List<GetAdminUsersRole>
(Set of Object) Role of the admin. This is not required for an auditor.
username String
adminScopes GetAdminUsersAdminScope[]
(Set of Object) The admin's scope. Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
comments string
(String) Additional information about the admin or auditor.
disabled boolean
(Boolean) Indicates whether or not the admin account is disabled.
email string
(String) Admin or auditor's email address.
execMobileAppTokens GetAdminUsersExecMobileAppToken[]
(List of Object)
id number
(Number) Identifier that uniquely identifies an entity
isAuditor boolean
(Boolean) Indicates whether the user is an auditor. This attribute is subject to change.
isExecMobileAppEnabled boolean
(Boolean) Indicates whether or not Executive Insights App access is enabled for the admin.
isNonEditable boolean
(Boolean) Indicates whether or not the admin can be edited or deleted.
isPasswordExpired boolean
(Boolean) Indicates whether or not an admin's password has expired.
isPasswordLoginAllowed boolean
(Boolean) The default is true when SAML Authentication is disabled. When SAML Authentication is enabled, this can be set to false in order to force the admin to login via SSO only.
isProductUpdateCommEnabled boolean
(Boolean) Communication setting for Product Update.
isSecurityReportCommEnabled boolean
(Boolean) Communication for Security Report is enabled.
isServiceUpdateCommEnabled boolean
(Boolean) Communication setting for Service Update.
loginName string
pwdLastModifiedTime number
roles GetAdminUsersRole[]
(Set of Object) Role of the admin. This is not required for an auditor.
username string
admin_scopes Sequence[GetAdminUsersAdminScope]
(Set of Object) The admin's scope. Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
comments str
(String) Additional information about the admin or auditor.
disabled bool
(Boolean) Indicates whether or not the admin account is disabled.
email str
(String) Admin or auditor's email address.
exec_mobile_app_tokens Sequence[GetAdminUsersExecMobileAppToken]
(List of Object)
id int
(Number) Identifier that uniquely identifies an entity
is_auditor bool
(Boolean) Indicates whether the user is an auditor. This attribute is subject to change.
is_exec_mobile_app_enabled bool
(Boolean) Indicates whether or not Executive Insights App access is enabled for the admin.
is_non_editable bool
(Boolean) Indicates whether or not the admin can be edited or deleted.
is_password_expired bool
(Boolean) Indicates whether or not an admin's password has expired.
is_password_login_allowed bool
(Boolean) The default is true when SAML Authentication is disabled. When SAML Authentication is enabled, this can be set to false in order to force the admin to login via SSO only.
is_product_update_comm_enabled bool
(Boolean) Communication setting for Product Update.
is_security_report_comm_enabled bool
(Boolean) Communication for Security Report is enabled.
is_service_update_comm_enabled bool
(Boolean) Communication setting for Service Update.
login_name str
pwd_last_modified_time int
roles Sequence[GetAdminUsersRole]
(Set of Object) Role of the admin. This is not required for an auditor.
username str
adminScopes List<Property Map>
(Set of Object) The admin's scope. Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
comments String
(String) Additional information about the admin or auditor.
disabled Boolean
(Boolean) Indicates whether or not the admin account is disabled.
email String
(String) Admin or auditor's email address.
execMobileAppTokens List<Property Map>
(List of Object)
id Number
(Number) Identifier that uniquely identifies an entity
isAuditor Boolean
(Boolean) Indicates whether the user is an auditor. This attribute is subject to change.
isExecMobileAppEnabled Boolean
(Boolean) Indicates whether or not Executive Insights App access is enabled for the admin.
isNonEditable Boolean
(Boolean) Indicates whether or not the admin can be edited or deleted.
isPasswordExpired Boolean
(Boolean) Indicates whether or not an admin's password has expired.
isPasswordLoginAllowed Boolean
(Boolean) The default is true when SAML Authentication is disabled. When SAML Authentication is enabled, this can be set to false in order to force the admin to login via SSO only.
isProductUpdateCommEnabled Boolean
(Boolean) Communication setting for Product Update.
isSecurityReportCommEnabled Boolean
(Boolean) Communication for Security Report is enabled.
isServiceUpdateCommEnabled Boolean
(Boolean) Communication setting for Service Update.
loginName String
pwdLastModifiedTime Number
roles List<Property Map>
(Set of Object) Role of the admin. This is not required for an auditor.
username String

Supporting Types

GetAdminUsersAdminScope

ScopeEntities This property is required. List<zscaler.PulumiPackage.Zia.Inputs.GetAdminUsersAdminScopeScopeEntity>
(String) Based on the admin scope type, the entities can be the ID/name pair of departments, locations, or location groups.
ScopeGroupMemberEntities This property is required. List<zscaler.PulumiPackage.Zia.Inputs.GetAdminUsersAdminScopeScopeGroupMemberEntity>
(Number) Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
Type This property is required. string
(String) The admin scope type. The attribute name is subject to change.
ScopeEntities This property is required. []GetAdminUsersAdminScopeScopeEntity
(String) Based on the admin scope type, the entities can be the ID/name pair of departments, locations, or location groups.
ScopeGroupMemberEntities This property is required. []GetAdminUsersAdminScopeScopeGroupMemberEntity
(Number) Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
Type This property is required. string
(String) The admin scope type. The attribute name is subject to change.
scopeEntities This property is required. List<GetAdminUsersAdminScopeScopeEntity>
(String) Based on the admin scope type, the entities can be the ID/name pair of departments, locations, or location groups.
scopeGroupMemberEntities This property is required. List<GetAdminUsersAdminScopeScopeGroupMemberEntity>
(Number) Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
type This property is required. String
(String) The admin scope type. The attribute name is subject to change.
scopeEntities This property is required. GetAdminUsersAdminScopeScopeEntity[]
(String) Based on the admin scope type, the entities can be the ID/name pair of departments, locations, or location groups.
scopeGroupMemberEntities This property is required. GetAdminUsersAdminScopeScopeGroupMemberEntity[]
(Number) Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
type This property is required. string
(String) The admin scope type. The attribute name is subject to change.
scope_entities This property is required. Sequence[GetAdminUsersAdminScopeScopeEntity]
(String) Based on the admin scope type, the entities can be the ID/name pair of departments, locations, or location groups.
scope_group_member_entities This property is required. Sequence[GetAdminUsersAdminScopeScopeGroupMemberEntity]
(Number) Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
type This property is required. str
(String) The admin scope type. The attribute name is subject to change.
scopeEntities This property is required. List<Property Map>
(String) Based on the admin scope type, the entities can be the ID/name pair of departments, locations, or location groups.
scopeGroupMemberEntities This property is required. List<Property Map>
(Number) Only applicable for the LOCATION_GROUP admin scope type, in which case this attribute gives the list of ID/name pairs of locations within the location group.
type This property is required. String
(String) The admin scope type. The attribute name is subject to change.

GetAdminUsersAdminScopeScopeEntity

Extensions This property is required. Dictionary<string, string>
Id This property is required. int
The ID of the admin user to be exported.
Name This property is required. string
(String)
Extensions This property is required. map[string]string
Id This property is required. int
The ID of the admin user to be exported.
Name This property is required. string
(String)
extensions This property is required. Map<String,String>
id This property is required. Integer
The ID of the admin user to be exported.
name This property is required. String
(String)
extensions This property is required. {[key: string]: string}
id This property is required. number
The ID of the admin user to be exported.
name This property is required. string
(String)
extensions This property is required. Mapping[str, str]
id This property is required. int
The ID of the admin user to be exported.
name This property is required. str
(String)
extensions This property is required. Map<String>
id This property is required. Number
The ID of the admin user to be exported.
name This property is required. String
(String)

GetAdminUsersAdminScopeScopeGroupMemberEntity

Extensions This property is required. Dictionary<string, string>
Id This property is required. int
The ID of the admin user to be exported.
Name This property is required. string
(String)
Extensions This property is required. map[string]string
Id This property is required. int
The ID of the admin user to be exported.
Name This property is required. string
(String)
extensions This property is required. Map<String,String>
id This property is required. Integer
The ID of the admin user to be exported.
name This property is required. String
(String)
extensions This property is required. {[key: string]: string}
id This property is required. number
The ID of the admin user to be exported.
name This property is required. string
(String)
extensions This property is required. Mapping[str, str]
id This property is required. int
The ID of the admin user to be exported.
name This property is required. str
(String)
extensions This property is required. Map<String>
id This property is required. Number
The ID of the admin user to be exported.
name This property is required. String
(String)

GetAdminUsersExecMobileAppToken

Cloud This property is required. string
(String)
CreateTime This property is required. int
(Number)
DeviceId This property is required. string
(String)
DeviceName This property is required. string
(String)
Name This property is required. string
(String)
OrgId This property is required. int
(Number)
Token This property is required. string
(String)
TokenExpiry This property is required. int
(Number)
TokenId This property is required. string
(String)
Cloud This property is required. string
(String)
CreateTime This property is required. int
(Number)
DeviceId This property is required. string
(String)
DeviceName This property is required. string
(String)
Name This property is required. string
(String)
OrgId This property is required. int
(Number)
Token This property is required. string
(String)
TokenExpiry This property is required. int
(Number)
TokenId This property is required. string
(String)
cloud This property is required. String
(String)
createTime This property is required. Integer
(Number)
deviceId This property is required. String
(String)
deviceName This property is required. String
(String)
name This property is required. String
(String)
orgId This property is required. Integer
(Number)
token This property is required. String
(String)
tokenExpiry This property is required. Integer
(Number)
tokenId This property is required. String
(String)
cloud This property is required. string
(String)
createTime This property is required. number
(Number)
deviceId This property is required. string
(String)
deviceName This property is required. string
(String)
name This property is required. string
(String)
orgId This property is required. number
(Number)
token This property is required. string
(String)
tokenExpiry This property is required. number
(Number)
tokenId This property is required. string
(String)
cloud This property is required. str
(String)
create_time This property is required. int
(Number)
device_id This property is required. str
(String)
device_name This property is required. str
(String)
name This property is required. str
(String)
org_id This property is required. int
(Number)
token This property is required. str
(String)
token_expiry This property is required. int
(Number)
token_id This property is required. str
(String)
cloud This property is required. String
(String)
createTime This property is required. Number
(Number)
deviceId This property is required. String
(String)
deviceName This property is required. String
(String)
name This property is required. String
(String)
orgId This property is required. Number
(Number)
token This property is required. String
(String)
tokenExpiry This property is required. Number
(Number)
tokenId This property is required. String
(String)

GetAdminUsersRole

Extensions This property is required. Dictionary<string, string>
Id This property is required. int
The ID of the admin user to be exported.
Name This property is required. string
(String)
Extensions This property is required. map[string]string
Id This property is required. int
The ID of the admin user to be exported.
Name This property is required. string
(String)
extensions This property is required. Map<String,String>
id This property is required. Integer
The ID of the admin user to be exported.
name This property is required. String
(String)
extensions This property is required. {[key: string]: string}
id This property is required. number
The ID of the admin user to be exported.
name This property is required. string
(String)
extensions This property is required. Mapping[str, str]
id This property is required. int
The ID of the admin user to be exported.
name This property is required. str
(String)
extensions This property is required. Map<String>
id This property is required. Number
The ID of the admin user to be exported.
name This property is required. String
(String)

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