Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Amazonka.GlobalAccelerator.Types.EndpointDescription
Description
Synopsis
- data EndpointDescription = EndpointDescription' {}
- newEndpointDescription :: EndpointDescription
- endpointDescription_clientIPPreservationEnabled :: Lens' EndpointDescription (Maybe Bool)
- endpointDescription_endpointId :: Lens' EndpointDescription (Maybe Text)
- endpointDescription_healthReason :: Lens' EndpointDescription (Maybe Text)
- endpointDescription_healthState :: Lens' EndpointDescription (Maybe HealthState)
- endpointDescription_weight :: Lens' EndpointDescription (Maybe Natural)
Documentation
data EndpointDescription Source #
A complex type for an endpoint. Each endpoint group can include one or more endpoints, such as load balancers.
See: newEndpointDescription
smart constructor.
Constructors
EndpointDescription' | |
Fields
|
Instances
newEndpointDescription :: EndpointDescription Source #
Create a value of EndpointDescription
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:clientIPPreservationEnabled:EndpointDescription'
, endpointDescription_clientIPPreservationEnabled
- Indicates whether client IP address preservation is enabled for an
endpoint. The value is true or false. The default value is true for new
accelerators.
If the value is set to true, the client's IP address is preserved in
the X-Forwarded-For
request header as traffic travels to applications
on the endpoint fronted by the accelerator.
Client IP address preservation is supported, in specific Amazon Web Services Regions, for endpoints that are Application Load Balancers and Amazon EC2 instances.
For more information, see Preserve client IP addresses in Global Accelerator in the Global Accelerator Developer Guide.
$sel:endpointId:EndpointDescription'
, endpointDescription_endpointId
- An ID for the endpoint. If the endpoint is a Network Load Balancer or
Application Load Balancer, this is the Amazon Resource Name (ARN) of the
resource. If the endpoint is an Elastic IP address, this is the Elastic
IP address allocation ID. For Amazon EC2 instances, this is the EC2
instance ID.
An Application Load Balancer can be either internal or internet-facing.
$sel:healthReason:EndpointDescription'
, endpointDescription_healthReason
- Returns a null result.
$sel:healthState:EndpointDescription'
, endpointDescription_healthState
- The health status of the endpoint.
$sel:weight:EndpointDescription'
, endpointDescription_weight
- The weight associated with the endpoint. When you add weights to
endpoints, you configure Global Accelerator to route traffic based on
proportions that you specify. For example, you might specify endpoint
weights of 4, 5, 5, and 6 (sum=20). The result is that 4/20 of your
traffic, on average, is routed to the first endpoint, 5/20 is routed
both to the second and third endpoints, and 6/20 is routed to the last
endpoint. For more information, see
Endpoint weights
in the Global Accelerator Developer Guide.
endpointDescription_clientIPPreservationEnabled :: Lens' EndpointDescription (Maybe Bool) Source #
Indicates whether client IP address preservation is enabled for an endpoint. The value is true or false. The default value is true for new accelerators.
If the value is set to true, the client's IP address is preserved in
the X-Forwarded-For
request header as traffic travels to applications
on the endpoint fronted by the accelerator.
Client IP address preservation is supported, in specific Amazon Web Services Regions, for endpoints that are Application Load Balancers and Amazon EC2 instances.
For more information, see Preserve client IP addresses in Global Accelerator in the Global Accelerator Developer Guide.
endpointDescription_endpointId :: Lens' EndpointDescription (Maybe Text) Source #
An ID for the endpoint. If the endpoint is a Network Load Balancer or Application Load Balancer, this is the Amazon Resource Name (ARN) of the resource. If the endpoint is an Elastic IP address, this is the Elastic IP address allocation ID. For Amazon EC2 instances, this is the EC2 instance ID.
An Application Load Balancer can be either internal or internet-facing.
endpointDescription_healthReason :: Lens' EndpointDescription (Maybe Text) Source #
Returns a null result.
endpointDescription_healthState :: Lens' EndpointDescription (Maybe HealthState) Source #
The health status of the endpoint.
endpointDescription_weight :: Lens' EndpointDescription (Maybe Natural) Source #
The weight associated with the endpoint. When you add weights to endpoints, you configure Global Accelerator to route traffic based on proportions that you specify. For example, you might specify endpoint weights of 4, 5, 5, and 6 (sum=20). The result is that 4/20 of your traffic, on average, is routed to the first endpoint, 5/20 is routed both to the second and third endpoints, and 6/20 is routed to the last endpoint. For more information, see Endpoint weights in the Global Accelerator Developer Guide.