Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.AlexaBusiness.SearchUsers

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Searches users and lists the ones that meet a set of filter and sort criteria.

This operation returns paginated results.

Synopsis

data SearchUsers = SearchUsers' {
- filters :: Maybe [Filter]
- sortCriteria :: Maybe [Sort]
- nextToken :: Maybe Text
- maxResults :: Maybe Natural
}
newSearchUsers :: SearchUsers
searchUsers_filters :: Lens' SearchUsers (Maybe [Filter])
searchUsers_sortCriteria :: Lens' SearchUsers (Maybe [Sort])
searchUsers_nextToken :: Lens' SearchUsers (Maybe Text)
searchUsers_maxResults :: Lens' SearchUsers (Maybe Natural)
data SearchUsersResponse = SearchUsersResponse' {
- users :: Maybe [UserData]
- nextToken :: Maybe Text
- totalCount :: Maybe Int
- httpStatus :: Int
}
newSearchUsersResponse :: Int -> SearchUsersResponse
searchUsersResponse_users :: Lens' SearchUsersResponse (Maybe [UserData])
searchUsersResponse_nextToken :: Lens' SearchUsersResponse (Maybe Text)
searchUsersResponse_totalCount :: Lens' SearchUsersResponse (Maybe Int)
searchUsersResponse_httpStatus :: Lens' SearchUsersResponse Int

Creating a Request

data SearchUsers Source #

See: newSearchUsers smart constructor.

Constructors

SearchUsers'

Fields

filters :: Maybe [Filter]
The filters to use for listing a specific set of users. Required. Supported filter keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.
sortCriteria :: Maybe [Sort]
The sort order to use in listing the filtered set of users. Required. Supported sort keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.
nextToken :: Maybe Text
An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults. Required.
maxResults :: Maybe Natural
The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. Required.

Instances

Instances details

Eq SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods (==) :: SearchUsers -> SearchUsers -> Bool # (/=) :: SearchUsers -> SearchUsers -> Bool #
Read SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods readsPrec :: Int -> ReadS SearchUsers # readList :: ReadS [SearchUsers] # readPrec :: ReadPrec SearchUsers # readListPrec :: ReadPrec [SearchUsers] #
Show SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods showsPrec :: Int -> SearchUsers -> ShowS # show :: SearchUsers -> String # showList :: [SearchUsers] -> ShowS #
Generic SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Associated Types type Rep SearchUsers :: Type -> Type # Methods from :: SearchUsers -> Rep SearchUsers x # to :: Rep SearchUsers x -> SearchUsers #
NFData SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods rnf :: SearchUsers -> () #
Hashable SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods hashWithSalt :: Int -> SearchUsers -> Int # hash :: SearchUsers -> Int #
ToJSON SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods toJSON :: SearchUsers -> Value # toEncoding :: SearchUsers -> Encoding # toJSONList :: [SearchUsers] -> Value # toEncodingList :: [SearchUsers] -> Encoding #
AWSPager SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods page :: SearchUsers -> AWSResponse SearchUsers -> Maybe SearchUsers #
AWSRequest SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Associated Types type AWSResponse SearchUsers # Methods request :: SearchUsers -> Request SearchUsers # response :: MonadResource m => Logger -> Service -> Proxy SearchUsers -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse SearchUsers))) #
ToHeaders SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods toHeaders :: SearchUsers -> [Header] #
ToPath SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods toPath :: SearchUsers -> ByteString #
ToQuery SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods toQuery :: SearchUsers -> QueryString #
type Rep SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers type Rep SearchUsers = D1 ('MetaData "SearchUsers" "Amazonka.AlexaBusiness.SearchUsers" "libZSservicesZSamazonka-alexa-businessZSamazonka-alexa-business" 'False) (C1 ('MetaCons "SearchUsers'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter])) :: S1 ('MetaSel ('Just "sortCriteria") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Sort]))) :: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)))))
type AWSResponse SearchUsers Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers type AWSResponse SearchUsers = SearchUsersResponse

newSearchUsers :: SearchUsers Source #

Create a value of SearchUsers with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:filters:SearchUsers', searchUsers_filters - The filters to use for listing a specific set of users. Required. Supported filter keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

$sel:sortCriteria:SearchUsers', searchUsers_sortCriteria - The sort order to use in listing the filtered set of users. Required. Supported sort keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

$sel:nextToken:SearchUsers', searchUsers_nextToken - An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults. Required.

$sel:maxResults:SearchUsers', searchUsers_maxResults - The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. Required.

Request Lenses

searchUsers_filters :: Lens' SearchUsers (Maybe [Filter]) Source #

The filters to use for listing a specific set of users. Required. Supported filter keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

searchUsers_sortCriteria :: Lens' SearchUsers (Maybe [Sort]) Source #

The sort order to use in listing the filtered set of users. Required. Supported sort keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

searchUsers_nextToken :: Lens' SearchUsers (Maybe Text) Source #

An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults. Required.

searchUsers_maxResults :: Lens' SearchUsers (Maybe Natural) Source #

The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. Required.

Destructuring the Response

data SearchUsersResponse Source #

See: newSearchUsersResponse smart constructor.

Constructors

SearchUsersResponse'
Fields users :: Maybe [UserData] The users that meet the specified set of filter criteria, in sort order. nextToken :: Maybe Text The token returned to indicate that there is more data available. totalCount :: Maybe Int The total number of users returned. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq SearchUsersResponse Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods (==) :: SearchUsersResponse -> SearchUsersResponse -> Bool # (/=) :: SearchUsersResponse -> SearchUsersResponse -> Bool #
Read SearchUsersResponse Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods readsPrec :: Int -> ReadS SearchUsersResponse # readList :: ReadS [SearchUsersResponse] # readPrec :: ReadPrec SearchUsersResponse # readListPrec :: ReadPrec [SearchUsersResponse] #
Show SearchUsersResponse Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods showsPrec :: Int -> SearchUsersResponse -> ShowS # show :: SearchUsersResponse -> String # showList :: [SearchUsersResponse] -> ShowS #
Generic SearchUsersResponse Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Associated Types type Rep SearchUsersResponse :: Type -> Type # Methods from :: SearchUsersResponse -> Rep SearchUsersResponse x # to :: Rep SearchUsersResponse x -> SearchUsersResponse #
NFData SearchUsersResponse Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers Methods rnf :: SearchUsersResponse -> () #
type Rep SearchUsersResponse Source #
Instance details Defined in Amazonka.AlexaBusiness.SearchUsers type Rep SearchUsersResponse = D1 ('MetaData "SearchUsersResponse" "Amazonka.AlexaBusiness.SearchUsers" "libZSservicesZSamazonka-alexa-businessZSamazonka-alexa-business" 'False) (C1 ('MetaCons "SearchUsersResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "users") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [UserData])) :: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "totalCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newSearchUsersResponse Source #

Arguments

:: Int	`$sel:httpStatus:SearchUsersResponse'`
-> SearchUsersResponse

Create a value of SearchUsersResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:users:SearchUsersResponse', searchUsersResponse_users - The users that meet the specified set of filter criteria, in sort order.

$sel:nextToken:SearchUsers', searchUsersResponse_nextToken - The token returned to indicate that there is more data available.

$sel:totalCount:SearchUsersResponse', searchUsersResponse_totalCount - The total number of users returned.

$sel:httpStatus:SearchUsersResponse', searchUsersResponse_httpStatus - The response's http status code.

Response Lenses

searchUsersResponse_users :: Lens' SearchUsersResponse (Maybe [UserData]) Source #

The users that meet the specified set of filter criteria, in sort order.

searchUsersResponse_nextToken :: Lens' SearchUsersResponse (Maybe Text) Source #

The token returned to indicate that there is more data available.

searchUsersResponse_totalCount :: Lens' SearchUsersResponse (Maybe Int) Source #

The total number of users returned.

searchUsersResponse_httpStatus :: Lens' SearchUsersResponse Int Source #

The response's http status code.