Copyright | (c) 2013-2018 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 |
Language | Haskell2010 |
Lists the current handshakes that are associated with the account of the requesting user.
Handshakes that are ACCEPTED, DECLINED, or CANCELED appear in the results of this API for only 30 days after changing to that state. After that they are deleted and no longer accessible.
This operation can be called from any account in the organization.
This operation returns paginated results.
- listHandshakesForAccount :: ListHandshakesForAccount
- data ListHandshakesForAccount
- lhfaNextToken :: Lens' ListHandshakesForAccount (Maybe Text)
- lhfaFilter :: Lens' ListHandshakesForAccount (Maybe HandshakeFilter)
- lhfaMaxResults :: Lens' ListHandshakesForAccount (Maybe Natural)
- listHandshakesForAccountResponse :: Int -> ListHandshakesForAccountResponse
- data ListHandshakesForAccountResponse
- lhfarsHandshakes :: Lens' ListHandshakesForAccountResponse [Handshake]
- lhfarsNextToken :: Lens' ListHandshakesForAccountResponse (Maybe Text)
- lhfarsResponseStatus :: Lens' ListHandshakesForAccountResponse Int
Creating a Request
listHandshakesForAccount :: ListHandshakesForAccount Source #
Creates a value of ListHandshakesForAccount
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lhfaNextToken
- Use this parameter if you receive aNextToken
response in a previous request that indicates that there is more output available. Set it to the value of the previous call'sNextToken
response to indicate where the output should continue from.lhfaFilter
- Filters the handshakes that you want included in the response. The default is all types. Use theActionType
element to limit the output to only a specified type, such asINVITE
,ENABLE-FULL-CONTROL
, orAPPROVE-FULL-CONTROL
. Alternatively, for theENABLE-FULL-CONTROL
handshake that generates a separate child handshake for each member account, you can specifyParentHandshakeId
to see only the handshakes that were generated by that parent request.lhfaMaxResults
- (Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, theNextToken
response element is present and has a value (is not null). Include that value as theNextToken
request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should checkNextToken
after every operation to ensure that you receive all of the results.
data ListHandshakesForAccount Source #
See: listHandshakesForAccount
smart constructor.
Request Lenses
lhfaNextToken :: Lens' ListHandshakesForAccount (Maybe Text) Source #
Use this parameter if you receive a NextToken
response in a previous request that indicates that there is more output available. Set it to the value of the previous call's NextToken
response to indicate where the output should continue from.
lhfaFilter :: Lens' ListHandshakesForAccount (Maybe HandshakeFilter) Source #
Filters the handshakes that you want included in the response. The default is all types. Use the ActionType
element to limit the output to only a specified type, such as INVITE
, ENABLE-FULL-CONTROL
, or APPROVE-FULL-CONTROL
. Alternatively, for the ENABLE-FULL-CONTROL
handshake that generates a separate child handshake for each member account, you can specify ParentHandshakeId
to see only the handshakes that were generated by that parent request.
lhfaMaxResults :: Lens' ListHandshakesForAccount (Maybe Natural) Source #
(Optional) Use this to limit the number of results you want included in the response. If you do not include this parameter, it defaults to a value that is specific to the operation. If additional items exist beyond the maximum you specify, the NextToken
response element is present and has a value (is not null). Include that value as the NextToken
request parameter in the next call to the operation to get the next part of the results. Note that Organizations might return fewer results than the maximum even when there are more results available. You should check NextToken
after every operation to ensure that you receive all of the results.
Destructuring the Response
listHandshakesForAccountResponse Source #
Creates a value of ListHandshakesForAccountResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lhfarsHandshakes
- A list ofHandshake
objects with details about each of the handshakes that is associated with the specified account.lhfarsNextToken
- If present, this value indicates that there is more output available than is included in the current response. Use this value in theNextToken
request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until theNextToken
response element comes back asnull
.lhfarsResponseStatus
- -- | The response status code.
data ListHandshakesForAccountResponse Source #
See: listHandshakesForAccountResponse
smart constructor.
Response Lenses
lhfarsHandshakes :: Lens' ListHandshakesForAccountResponse [Handshake] Source #
A list of Handshake
objects with details about each of the handshakes that is associated with the specified account.
lhfarsNextToken :: Lens' ListHandshakesForAccountResponse (Maybe Text) Source #
If present, this value indicates that there is more output available than is included in the current response. Use this value in the NextToken
request parameter in a subsequent call to the operation to get the next part of the output. You should repeat this until the NextToken
response element comes back as null
.
lhfarsResponseStatus :: Lens' ListHandshakesForAccountResponse Int Source #
- - | The response status code.