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 |
Requests a description of a set of instances.
This call accepts only one resource-identifying parameter.
Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.
Synopsis
- data DescribeInstances = DescribeInstances' {}
- newDescribeInstances :: DescribeInstances
- describeInstances_instanceIds :: Lens' DescribeInstances (Maybe [Text])
- describeInstances_stackId :: Lens' DescribeInstances (Maybe Text)
- describeInstances_layerId :: Lens' DescribeInstances (Maybe Text)
- data DescribeInstancesResponse = DescribeInstancesResponse' {
- instances :: Maybe [Instance]
- httpStatus :: Int
- newDescribeInstancesResponse :: Int -> DescribeInstancesResponse
- describeInstancesResponse_instances :: Lens' DescribeInstancesResponse (Maybe [Instance])
- describeInstancesResponse_httpStatus :: Lens' DescribeInstancesResponse Int
Creating a Request
data DescribeInstances Source #
See: newDescribeInstances
smart constructor.
DescribeInstances' | |
|
Instances
newDescribeInstances :: DescribeInstances Source #
Create a value of DescribeInstances
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:instanceIds:DescribeInstances'
, describeInstances_instanceIds
- An array of instance IDs to be described. If you use this parameter,
DescribeInstances
returns a description of the specified instances.
Otherwise, it returns a description of every instance.
$sel:stackId:DescribeInstances'
, describeInstances_stackId
- A stack ID. If you use this parameter, DescribeInstances
returns
descriptions of the instances associated with the specified stack.
$sel:layerId:DescribeInstances'
, describeInstances_layerId
- A layer ID. If you use this parameter, DescribeInstances
returns
descriptions of the instances associated with the specified layer.
Request Lenses
describeInstances_instanceIds :: Lens' DescribeInstances (Maybe [Text]) Source #
An array of instance IDs to be described. If you use this parameter,
DescribeInstances
returns a description of the specified instances.
Otherwise, it returns a description of every instance.
describeInstances_stackId :: Lens' DescribeInstances (Maybe Text) Source #
A stack ID. If you use this parameter, DescribeInstances
returns
descriptions of the instances associated with the specified stack.
describeInstances_layerId :: Lens' DescribeInstances (Maybe Text) Source #
A layer ID. If you use this parameter, DescribeInstances
returns
descriptions of the instances associated with the specified layer.
Destructuring the Response
data DescribeInstancesResponse Source #
Contains the response to a DescribeInstances
request.
See: newDescribeInstancesResponse
smart constructor.
DescribeInstancesResponse' | |
|
Instances
newDescribeInstancesResponse Source #
Create a value of DescribeInstancesResponse
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:instances:DescribeInstancesResponse'
, describeInstancesResponse_instances
- An array of Instance
objects that describe the instances.
$sel:httpStatus:DescribeInstancesResponse'
, describeInstancesResponse_httpStatus
- The response's http status code.
Response Lenses
describeInstancesResponse_instances :: Lens' DescribeInstancesResponse (Maybe [Instance]) Source #
An array of Instance
objects that describe the instances.
describeInstancesResponse_httpStatus :: Lens' DescribeInstancesResponse Int Source #
The response's http status code.