Okta v4.11.0 published on Tuesday, Sep 17, 2024 by Pulumi
okta.user.getUsers
Explore with Pulumi AI
Get a list of users from Okta.
Using getUsers
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 getUsers(args: GetUsersArgs, opts?: InvokeOptions): Promise<GetUsersResult>
function getUsersOutput(args: GetUsersOutputArgs, opts?: InvokeOptions): Output<GetUsersResult>
def get_users(compound_search_operator: Optional[str] = None,
delay_read_seconds: Optional[str] = None,
group_id: Optional[str] = None,
include_groups: Optional[bool] = None,
include_roles: Optional[bool] = None,
searches: Optional[Sequence[GetUsersSearch]] = None,
opts: Optional[InvokeOptions] = None) -> GetUsersResult
def get_users_output(compound_search_operator: Optional[pulumi.Input[str]] = None,
delay_read_seconds: Optional[pulumi.Input[str]] = None,
group_id: Optional[pulumi.Input[str]] = None,
include_groups: Optional[pulumi.Input[bool]] = None,
include_roles: Optional[pulumi.Input[bool]] = None,
searches: Optional[pulumi.Input[Sequence[pulumi.Input[GetUsersSearchArgs]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetUsersResult]
func GetUsers(ctx *Context, args *GetUsersArgs, opts ...InvokeOption) (*GetUsersResult, error)
func GetUsersOutput(ctx *Context, args *GetUsersOutputArgs, opts ...InvokeOption) GetUsersResultOutput
> Note: This function is named GetUsers
in the Go SDK.
public static class GetUsers
{
public static Task<GetUsersResult> InvokeAsync(GetUsersArgs args, InvokeOptions? opts = null)
public static Output<GetUsersResult> Invoke(GetUsersInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetUsersResult> getUsers(GetUsersArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: okta:user/getUsers:getUsers
arguments:
# arguments dictionary
The following arguments are supported:
- Compound
Search stringOperator - Search operator used when joining multiple search clauses
- Delay
Read stringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- Group
Id string - Find users based on group membership using the id of the group.
- Include
Groups bool - Fetch group memberships for each user
- Include
Roles bool - Fetch user roles for each user
- Searches
List<Get
Users Search> - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- Compound
Search stringOperator - Search operator used when joining multiple search clauses
- Delay
Read stringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- Group
Id string - Find users based on group membership using the id of the group.
- Include
Groups bool - Fetch group memberships for each user
- Include
Roles bool - Fetch user roles for each user
- Searches
[]Get
Users Search - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- compound
Search StringOperator - Search operator used when joining multiple search clauses
- delay
Read StringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group
Id String - Find users based on group membership using the id of the group.
- include
Groups Boolean - Fetch group memberships for each user
- include
Roles Boolean - Fetch user roles for each user
- searches
List<Get
Users Search> - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- compound
Search stringOperator - Search operator used when joining multiple search clauses
- delay
Read stringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group
Id string - Find users based on group membership using the id of the group.
- include
Groups boolean - Fetch group memberships for each user
- include
Roles boolean - Fetch user roles for each user
- searches
Get
Users Search[] - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- compound_
search_ stroperator - Search operator used when joining multiple search clauses
- delay_
read_ strseconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group_
id str - Find users based on group membership using the id of the group.
- include_
groups bool - Fetch group memberships for each user
- include_
roles bool - Fetch user roles for each user
- searches
Sequence[Get
Users Search] - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- compound
Search StringOperator - Search operator used when joining multiple search clauses
- delay
Read StringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group
Id String - Find users based on group membership using the id of the group.
- include
Groups Boolean - Fetch group memberships for each user
- include
Roles Boolean - Fetch user roles for each user
- searches List<Property Map>
- Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
getUsers Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Users
List<Get
Users User> - collection of users retrieved from Okta.
- Compound
Search stringOperator - Search operator used when joining multiple search clauses
- Delay
Read stringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- Group
Id string - Find users based on group membership using the id of the group.
- Include
Groups bool - Fetch group memberships for each user
- Include
Roles bool - Fetch user roles for each user
- Searches
List<Get
Users Search> - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- Id string
- The provider-assigned unique ID for this managed resource.
- Users
[]Get
Users User - collection of users retrieved from Okta.
- Compound
Search stringOperator - Search operator used when joining multiple search clauses
- Delay
Read stringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- Group
Id string - Find users based on group membership using the id of the group.
- Include
Groups bool - Fetch group memberships for each user
- Include
Roles bool - Fetch user roles for each user
- Searches
[]Get
Users Search - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- id String
- The provider-assigned unique ID for this managed resource.
- users
List<Get
Users User> - collection of users retrieved from Okta.
- compound
Search StringOperator - Search operator used when joining multiple search clauses
- delay
Read StringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group
Id String - Find users based on group membership using the id of the group.
- include
Groups Boolean - Fetch group memberships for each user
- include
Roles Boolean - Fetch user roles for each user
- searches
List<Get
Users Search> - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- id string
- The provider-assigned unique ID for this managed resource.
- users
Get
Users User[] - collection of users retrieved from Okta.
- compound
Search stringOperator - Search operator used when joining multiple search clauses
- delay
Read stringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group
Id string - Find users based on group membership using the id of the group.
- include
Groups boolean - Fetch group memberships for each user
- include
Roles boolean - Fetch user roles for each user
- searches
Get
Users Search[] - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- id str
- The provider-assigned unique ID for this managed resource.
- users
Sequence[Get
Users User] - collection of users retrieved from Okta.
- compound_
search_ stroperator - Search operator used when joining multiple search clauses
- delay_
read_ strseconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group_
id str - Find users based on group membership using the id of the group.
- include_
groups bool - Fetch group memberships for each user
- include_
roles bool - Fetch user roles for each user
- searches
Sequence[Get
Users Search] - Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
- id String
- The provider-assigned unique ID for this managed resource.
- users List<Property Map>
- collection of users retrieved from Okta.
- compound
Search StringOperator - Search operator used when joining multiple search clauses
- delay
Read StringSeconds - Force delay of the users read by N seconds. Useful when eventual consistency of users information needs to be allowed for.
- group
Id String - Find users based on group membership using the id of the group.
- include
Groups Boolean - Fetch group memberships for each user
- include
Roles Boolean - Fetch user roles for each user
- searches List<Property Map>
- Filter to find user/users. Each filter will be concatenated with the compound search operator. Please be aware profile properties must match what is in Okta, which is likely camel case. Expression is a free form expression filter https://developer.okta.com/docs/reference/core-okta-api/#filter . The set name/value/comparison properties will be ignored if expression is present
Supporting Types
GetUsersSearch
- Comparison string
- Expression string
- A raw search expression string. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- Name string
- Property name to search for. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- Value string
- Comparison string
- Expression string
- A raw search expression string. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- Name string
- Property name to search for. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- Value string
- comparison String
- expression String
- A raw search expression string. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- name String
- Property name to search for. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- value String
- comparison string
- expression string
- A raw search expression string. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- name string
- Property name to search for. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- value string
- comparison str
- expression str
- A raw search expression string. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- name str
- Property name to search for. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- value str
- comparison String
- expression String
- A raw search expression string. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- name String
- Property name to search for. This requires the search feature be on. Please see Okta documentation on their filter API for users. https://developer.okta.com/docs/api/resources/users#list-users-with-search
- value String
GetUsersUser
- Admin
Roles List<string> - City string
- Cost
Center string - Country
Code string - Custom
Profile stringAttributes - Department string
- Display
Name string - Division string
- Email string
- Employee
Number string - First
Name string - Group
Memberships List<string> - Honorific
Prefix string - Honorific
Suffix string - Id string
- Last
Name string - Locale string
- Login string
- Manager string
- Manager
Id string - Middle
Name string - Mobile
Phone string - Nick
Name string - Organization string
- Postal
Address string - Preferred
Language string - Primary
Phone string - Profile
Url string - Roles List<string>
- Second
Email string - State string
- Status string
- Street
Address string - Timezone string
- Title string
- User
Type string - Zip
Code string
- Admin
Roles []string - City string
- Cost
Center string - Country
Code string - Custom
Profile stringAttributes - Department string
- Display
Name string - Division string
- Email string
- Employee
Number string - First
Name string - Group
Memberships []string - Honorific
Prefix string - Honorific
Suffix string - Id string
- Last
Name string - Locale string
- Login string
- Manager string
- Manager
Id string - Middle
Name string - Mobile
Phone string - Nick
Name string - Organization string
- Postal
Address string - Preferred
Language string - Primary
Phone string - Profile
Url string - Roles []string
- Second
Email string - State string
- Status string
- Street
Address string - Timezone string
- Title string
- User
Type string - Zip
Code string
- admin
Roles List<String> - city String
- cost
Center String - country
Code String - custom
Profile StringAttributes - department String
- display
Name String - division String
- email String
- employee
Number String - first
Name String - group
Memberships List<String> - honorific
Prefix String - honorific
Suffix String - id String
- last
Name String - locale String
- login String
- manager String
- manager
Id String - middle
Name String - mobile
Phone String - nick
Name String - organization String
- postal
Address String - preferred
Language String - primary
Phone String - profile
Url String - roles List<String>
- second
Email String - state String
- status String
- street
Address String - timezone String
- title String
- user
Type String - zip
Code String
- admin
Roles string[] - city string
- cost
Center string - country
Code string - custom
Profile stringAttributes - department string
- display
Name string - division string
- email string
- employee
Number string - first
Name string - group
Memberships string[] - honorific
Prefix string - honorific
Suffix string - id string
- last
Name string - locale string
- login string
- manager string
- manager
Id string - middle
Name string - mobile
Phone string - nick
Name string - organization string
- postal
Address string - preferred
Language string - primary
Phone string - profile
Url string - roles string[]
- second
Email string - state string
- status string
- street
Address string - timezone string
- title string
- user
Type string - zip
Code string
- admin_
roles Sequence[str] - city str
- cost_
center str - country_
code str - custom_
profile_ strattributes - department str
- display_
name str - division str
- email str
- employee_
number str - first_
name str - group_
memberships Sequence[str] - honorific_
prefix str - honorific_
suffix str - id str
- last_
name str - locale str
- login str
- manager str
- manager_
id str - middle_
name str - mobile_
phone str - nick_
name str - organization str
- postal_
address str - preferred_
language str - primary_
phone str - profile_
url str - roles Sequence[str]
- second_
email str - state str
- status str
- street_
address str - timezone str
- title str
- user_
type str - zip_
code str
- admin
Roles List<String> - city String
- cost
Center String - country
Code String - custom
Profile StringAttributes - department String
- display
Name String - division String
- email String
- employee
Number String - first
Name String - group
Memberships List<String> - honorific
Prefix String - honorific
Suffix String - id String
- last
Name String - locale String
- login String
- manager String
- manager
Id String - middle
Name String - mobile
Phone String - nick
Name String - organization String
- postal
Address String - preferred
Language String - primary
Phone String - profile
Url String - roles List<String>
- second
Email String - state String
- status String
- street
Address String - timezone String
- title String
- user
Type String - zip
Code String
Package Details
- Repository
- Okta pulumi/pulumi-okta
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
okta
Terraform Provider.