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 |
Gets a list of names for one or more on-premises instances.
Unless otherwise specified, both registered and deregistered on-premises instance names are listed. To list only registered or deregistered on-premises instance names, use the registration status parameter.
This operation returns paginated results.
Synopsis
- data ListOnPremisesInstances = ListOnPremisesInstances' {}
- newListOnPremisesInstances :: ListOnPremisesInstances
- listOnPremisesInstances_tagFilters :: Lens' ListOnPremisesInstances (Maybe [TagFilter])
- listOnPremisesInstances_nextToken :: Lens' ListOnPremisesInstances (Maybe Text)
- listOnPremisesInstances_registrationStatus :: Lens' ListOnPremisesInstances (Maybe RegistrationStatus)
- data ListOnPremisesInstancesResponse = ListOnPremisesInstancesResponse' {
- nextToken :: Maybe Text
- instanceNames :: Maybe [Text]
- httpStatus :: Int
- newListOnPremisesInstancesResponse :: Int -> ListOnPremisesInstancesResponse
- listOnPremisesInstancesResponse_nextToken :: Lens' ListOnPremisesInstancesResponse (Maybe Text)
- listOnPremisesInstancesResponse_instanceNames :: Lens' ListOnPremisesInstancesResponse (Maybe [Text])
- listOnPremisesInstancesResponse_httpStatus :: Lens' ListOnPremisesInstancesResponse Int
Creating a Request
data ListOnPremisesInstances Source #
Represents the input of a ListOnPremisesInstances
operation.
See: newListOnPremisesInstances
smart constructor.
ListOnPremisesInstances' | |
|
Instances
newListOnPremisesInstances :: ListOnPremisesInstances Source #
Create a value of ListOnPremisesInstances
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:tagFilters:ListOnPremisesInstances'
, listOnPremisesInstances_tagFilters
- The on-premises instance tags that are used to restrict the on-premises
instance names returned.
$sel:nextToken:ListOnPremisesInstances'
, listOnPremisesInstances_nextToken
- An identifier returned from the previous list on-premises instances
call. It can be used to return the next set of on-premises instances in
the list.
$sel:registrationStatus:ListOnPremisesInstances'
, listOnPremisesInstances_registrationStatus
- The registration status of the on-premises instances:
Deregistered
: Include deregistered on-premises instances in the resulting list.Registered
: Include registered on-premises instances in the resulting list.
Request Lenses
listOnPremisesInstances_tagFilters :: Lens' ListOnPremisesInstances (Maybe [TagFilter]) Source #
The on-premises instance tags that are used to restrict the on-premises instance names returned.
listOnPremisesInstances_nextToken :: Lens' ListOnPremisesInstances (Maybe Text) Source #
An identifier returned from the previous list on-premises instances call. It can be used to return the next set of on-premises instances in the list.
listOnPremisesInstances_registrationStatus :: Lens' ListOnPremisesInstances (Maybe RegistrationStatus) Source #
The registration status of the on-premises instances:
Deregistered
: Include deregistered on-premises instances in the resulting list.Registered
: Include registered on-premises instances in the resulting list.
Destructuring the Response
data ListOnPremisesInstancesResponse Source #
Represents the output of the list on-premises instances operation.
See: newListOnPremisesInstancesResponse
smart constructor.
ListOnPremisesInstancesResponse' | |
|
Instances
newListOnPremisesInstancesResponse Source #
Create a value of ListOnPremisesInstancesResponse
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:nextToken:ListOnPremisesInstances'
, listOnPremisesInstancesResponse_nextToken
- If a large amount of information is returned, an identifier is also
returned. It can be used in a subsequent list on-premises instances call
to return the next set of on-premises instances in the list.
$sel:instanceNames:ListOnPremisesInstancesResponse'
, listOnPremisesInstancesResponse_instanceNames
- The list of matching on-premises instance names.
$sel:httpStatus:ListOnPremisesInstancesResponse'
, listOnPremisesInstancesResponse_httpStatus
- The response's http status code.
Response Lenses
listOnPremisesInstancesResponse_nextToken :: Lens' ListOnPremisesInstancesResponse (Maybe Text) Source #
If a large amount of information is returned, an identifier is also returned. It can be used in a subsequent list on-premises instances call to return the next set of on-premises instances in the list.
listOnPremisesInstancesResponse_instanceNames :: Lens' ListOnPremisesInstancesResponse (Maybe [Text]) Source #
The list of matching on-premises instance names.
listOnPremisesInstancesResponse_httpStatus :: Lens' ListOnPremisesInstancesResponse Int Source #
The response's http status code.