Okta v4.9.2 published on Tuesday, Jun 25, 2024 by Pulumi
okta.user.getUser
Explore with Pulumi AI
Get a single users from Okta.
Using getUser
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 getUser(args: GetUserArgs, opts?: InvokeOptions): Promise<GetUserResult>
function getUserOutput(args: GetUserOutputArgs, opts?: InvokeOptions): Output<GetUserResult>def get_user(compound_search_operator: Optional[str] = None,
             delay_read_seconds: Optional[str] = None,
             searches: Optional[Sequence[GetUserSearch]] = None,
             skip_groups: Optional[bool] = None,
             skip_roles: Optional[bool] = None,
             user_id: Optional[str] = None,
             opts: Optional[InvokeOptions] = None) -> GetUserResult
def get_user_output(compound_search_operator: Optional[pulumi.Input[str]] = None,
             delay_read_seconds: Optional[pulumi.Input[str]] = None,
             searches: Optional[pulumi.Input[Sequence[pulumi.Input[GetUserSearchArgs]]]] = None,
             skip_groups: Optional[pulumi.Input[bool]] = None,
             skip_roles: Optional[pulumi.Input[bool]] = None,
             user_id: Optional[pulumi.Input[str]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetUserResult]func LookupUser(ctx *Context, args *LookupUserArgs, opts ...InvokeOption) (*LookupUserResult, error)
func LookupUserOutput(ctx *Context, args *LookupUserOutputArgs, opts ...InvokeOption) LookupUserResultOutput> Note: This function is named LookupUser in the Go SDK.
public static class GetUser 
{
    public static Task<GetUserResult> InvokeAsync(GetUserArgs args, InvokeOptions? opts = null)
    public static Output<GetUserResult> Invoke(GetUserInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetUserResult> getUser(GetUserArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: okta:user/getUser:getUser
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Compound
Search stringOperator  - Search operator used when joining multiple search clauses
 - Delay
Read stringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - Searches
List<Get
User 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
 - Skip
Groups bool - Do not populate user groups information (prevents additional API call)
 - Skip
Roles bool - Do not populate user roles information (prevents additional API call)
 - User
Id string - Retrieve a single user based on their id
 
- Compound
Search stringOperator  - Search operator used when joining multiple search clauses
 - Delay
Read stringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - Searches
[]Get
User 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
 - Skip
Groups bool - Do not populate user groups information (prevents additional API call)
 - Skip
Roles bool - Do not populate user roles information (prevents additional API call)
 - User
Id string - Retrieve a single user based on their id
 
- compound
Search StringOperator  - Search operator used when joining multiple search clauses
 - delay
Read StringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - searches
List<Get
User 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
 - skip
Groups Boolean - Do not populate user groups information (prevents additional API call)
 - skip
Roles Boolean - Do not populate user roles information (prevents additional API call)
 - user
Id String - Retrieve a single user based on their id
 
- compound
Search stringOperator  - Search operator used when joining multiple search clauses
 - delay
Read stringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - searches
Get
User 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
 - skip
Groups boolean - Do not populate user groups information (prevents additional API call)
 - skip
Roles boolean - Do not populate user roles information (prevents additional API call)
 - user
Id string - Retrieve a single user based on their id
 
- compound_
search_ stroperator  - Search operator used when joining multiple search clauses
 - delay_
read_ strseconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - searches
Sequence[Get
User 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
 - skip_
groups bool - Do not populate user groups information (prevents additional API call)
 - skip_
roles bool - Do not populate user roles information (prevents additional API call)
 - user_
id str - Retrieve a single user based on their id
 
- compound
Search StringOperator  - Search operator used when joining multiple search clauses
 - delay
Read StringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - 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
 - skip
Groups Boolean - Do not populate user groups information (prevents additional API call)
 - skip
Roles Boolean - Do not populate user roles information (prevents additional API call)
 - user
Id String - Retrieve a single user based on their id
 
getUser Result
The following output properties are available:
- 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
 - The provider-assigned unique ID for this managed resource.
 - 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 - Compound
Search stringOperator  - Search operator used when joining multiple search clauses
 - Delay
Read stringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - Searches
List<Get
User 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
 - Skip
Groups bool - Do not populate user groups information (prevents additional API call)
 - Skip
Roles bool - Do not populate user roles information (prevents additional API call)
 - User
Id string - Retrieve a single user based on their id
 
- 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
 - The provider-assigned unique ID for this managed resource.
 - 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 - Compound
Search stringOperator  - Search operator used when joining multiple search clauses
 - Delay
Read stringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - Searches
[]Get
User 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
 - Skip
Groups bool - Do not populate user groups information (prevents additional API call)
 - Skip
Roles bool - Do not populate user roles information (prevents additional API call)
 - User
Id string - Retrieve a single user based on their id
 
- 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
 - The provider-assigned unique ID for this managed resource.
 - 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 - compound
Search StringOperator  - Search operator used when joining multiple search clauses
 - delay
Read StringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - searches
List<Get
User 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
 - skip
Groups Boolean - Do not populate user groups information (prevents additional API call)
 - skip
Roles Boolean - Do not populate user roles information (prevents additional API call)
 - user
Id String - Retrieve a single user based on their id
 
- 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
 - The provider-assigned unique ID for this managed resource.
 - 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 - compound
Search stringOperator  - Search operator used when joining multiple search clauses
 - delay
Read stringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - searches
Get
User 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
 - skip
Groups boolean - Do not populate user groups information (prevents additional API call)
 - skip
Roles boolean - Do not populate user roles information (prevents additional API call)
 - user
Id string - Retrieve a single user based on their id
 
- 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
 - The provider-assigned unique ID for this managed resource.
 - 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 - compound_
search_ stroperator  - Search operator used when joining multiple search clauses
 - delay_
read_ strseconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - searches
Sequence[Get
User 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
 - skip_
groups bool - Do not populate user groups information (prevents additional API call)
 - skip_
roles bool - Do not populate user roles information (prevents additional API call)
 - user_
id str - Retrieve a single user based on their id
 
- 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
 - The provider-assigned unique ID for this managed resource.
 - 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 - compound
Search StringOperator  - Search operator used when joining multiple search clauses
 - delay
Read StringSeconds  - Force delay of the user read by N seconds. Useful when eventual consistency of user information needs to be allowed for.
 - 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
 - skip
Groups Boolean - Do not populate user groups information (prevents additional API call)
 - skip
Roles Boolean - Do not populate user roles information (prevents additional API call)
 - user
Id String - Retrieve a single user based on their id
 
Supporting Types
GetUserSearch  
- 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
 
Package Details
- Repository
 - Okta pulumi/pulumi-okta
 - License
 - Apache-2.0
 - Notes
 - This Pulumi package is based on the 
oktaTerraform Provider.