Class: Aws::GlobalAccelerator::Types::EndpointConfiguration

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-globalaccelerator/types.rb

Overview

A complex type for endpoints. A resource must be valid and active when you add it as an endpoint.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#attachment_arnString

The Amazon Resource Name (ARN) of the cross-account attachment that specifies the endpoints (resources) that can be added to accelerators and principals that have permission to add the endpoints.

Returns:

  • (String)


2016
2017
2018
2019
2020
2021
2022
2023
# File 'lib/aws-sdk-globalaccelerator/types.rb', line 2016

class EndpointConfiguration < Struct.new(
  :endpoint_id,
  :weight,
  :client_ip_preservation_enabled,
  :attachment_arn)
  SENSITIVE = []
  include Aws::Structure
end

#client_ip_preservation_enabledBoolean

Indicates whether client IP address preservation is enabled for an endpoint. The value is true or false. The default value is true for Application Load Balancer endpoints.

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, Amazon EC2 instances, and Network Load Balancers with security groups. IMPORTANT: You cannot use client IP address preservation with Network Load Balancers with TLS listeners.

For more information, see [ Preserve client IP addresses in Global Accelerator] in the *Global Accelerator Developer Guide*.

[1]: docs.aws.amazon.com/global-accelerator/latest/dg/preserve-client-ip-address.html

Returns:

  • (Boolean)


2016
2017
2018
2019
2020
2021
2022
2023
# File 'lib/aws-sdk-globalaccelerator/types.rb', line 2016

class EndpointConfiguration < Struct.new(
  :endpoint_id,
  :weight,
  :client_ip_preservation_enabled,
  :attachment_arn)
  SENSITIVE = []
  include Aws::Structure
end

#endpoint_idString

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. A resource must be valid and active when you add it as an endpoint.

For cross-account endpoints, this must be the ARN of the resource.

Returns:

  • (String)


2016
2017
2018
2019
2020
2021
2022
2023
# File 'lib/aws-sdk-globalaccelerator/types.rb', line 2016

class EndpointConfiguration < Struct.new(
  :endpoint_id,
  :weight,
  :client_ip_preservation_enabled,
  :attachment_arn)
  SENSITIVE = []
  include Aws::Structure
end

#weightInteger

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*.

[1]: docs.aws.amazon.com/global-accelerator/latest/dg/about-endpoints-endpoint-weights.html

Returns:

  • (Integer)


2016
2017
2018
2019
2020
2021
2022
2023
# File 'lib/aws-sdk-globalaccelerator/types.rb', line 2016

class EndpointConfiguration < Struct.new(
  :endpoint_id,
  :weight,
  :client_ip_preservation_enabled,
  :attachment_arn)
  SENSITIVE = []
  include Aws::Structure
end