AWS::GlobalAccelerator::Listener - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::GlobalAccelerator::Listener

AWS::GlobalAccelerator::Listener 资源是 Global Accelerator 资源类型,其中包含有关如何创建侦听器以处理从客户端到加速器的入站连接的信息。连接到达您指定的端口、端口范围或端口范围列表上分配的静态 IP 地址。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::GlobalAccelerator::Listener", "Properties" : { "AcceleratorArn" : String, "ClientAffinity" : String, "PortRanges" : [ PortRange, ... ], "Protocol" : String } }

YAML

Type: AWS::GlobalAccelerator::Listener Properties: AcceleratorArn: String ClientAffinity: String PortRanges: - PortRange Protocol: String

属性

AcceleratorArn

您的加速器的 Amazon 资源名称 (ARN)。

必需:是

类型:字符串

最高255

Update requires: Replacement

ClientAffinity

客户端关联允许您将来自用户的所有请求定向到同一终端节点(如果您有状态应用程序),而不考虑客户端请求的端口和协议。客户端关联使您可以控制是否始终将每个客户端路由到相同的特定终端节点。

AWS Global Accelerator 使用一致流哈希算法为连接选择最佳终端节点。如果客户端关联为 NONE,则 Global Accelerator 使用“五元组”(5 元组)属性(源 IP 地址、源端口、目标 IP 地址、目标端口和协议)来选择哈希值,然后选择最佳终端节点。但是,使用此设置时,如果有人使用不同的端口连接到 Global Accelerator,他们的连接可能并不总是路由到同一终端节点,因为哈希值发生变化。

如果希望给定客户端始终路由到同一终端节点,请将客户端关联设置为 SOURCE_IP。当您使用 SOURCE_IP 设置时,Global Accelerator 使用“双元组”(2 元组)属性(源(客户端)IP 地址和目标 IP 地址)来选择哈希值。

默认值为 NONE

必需:否

类型:字符串

允许的值NONE | SOURCE_IP

Update requires: No interruption

PortRanges

从客户端到加速器的连接的端口范围列表。

必需:是

类型PortRange 的列表

最高10

Update requires: No interruption

Protocol

从客户端到加速器的连接的协议。

必需:是

类型:字符串

允许的值TCP | UDP

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回侦听器的 ARN,例如 arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

ListenerArn

侦听器的 ARN,例如 arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz

示例

添加侦听器

这些是指定侦听器的示例。

JSON

"Resources": { "Listener": { "Type": "AWS::GlobalAccelerator::Listener", "Properties": { "AcceleratorArn": { "Ref": "Accelerator" }, "Protocol": "TCP", "PortRanges": [ { "FromPort": 80, "ToPort": 80 } ] } } }

YAML

Listener: Type: AWS::GlobalAccelerator::Listener Properties: AcceleratorArn: Ref: Accelerator Protocol: TCP PortRanges: - FromPort: 80 ToPort: 80