AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::ElasticLoadBalancingV2::Listener

AWS::ElasticLoadBalancingV2::Listener 资源将为 Elastic Load Balancing 应用程序或网络负载均衡器创建侦听器。该侦听器检查连接请求并将这些请求转发到一个或多个目标组。有关更多信息,请参阅 Elastic Load Balancing 用户指南中的入门

语法

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

JSON

{ "Type" : "AWS::ElasticLoadBalancingV2::Listener", "Properties" : { "Certificates" : [ Certificates, ... ], "DefaultActions" : [ DefaultActions, ... ], "LoadBalancerArn" : String, "Port" : Integer, "Protocol" : String, "SslPolicy" : String } }

YAML

Type: "AWS::ElasticLoadBalancingV2::Listener" Properties: Certificates: - Certificates DefaultActions: - DefaultActions LoadBalancerArn: String Port: Integer Protocol: String SslPolicy: String

属性

Certificates

侦听器的 SSL 服务器证书。利用证书,您可以加密负载均衡器与启动 HTTPS 会话的客户端之间的流量以及负载均衡器与您的目标之间的流量。

Required: Conditional。如果您为 Protocol 属性指定 HTTPS,请指定一个证书。

Type: Elastic Load Balancing Listener Certificates 列表

更新要求无需中断

DefaultActions

侦听器在处理传入请求时采取的默认操作。

Required: Yes

Type: Elastic Load Balancing Listener DefaultActions 列表

更新要求无需中断

LoadBalancerArn

要与侦听器关联的负载均衡器的 Amazon 资源名称 (ARN)。

Required: Yes

Type: String

更新要求替换

Port

侦听器侦听请求所用的端口。

有关有效值的信息,请参阅 Elastic Load Balancing API 参考版本 2015-12-01 中的 CreateListener 操作的 Port 参数。

Required: Yes

Type: Integer

更新要求无需中断

Protocol

客户端将请求发送到侦听器时必须使用的协议。

有关有效值的信息,请参阅 Elastic Load Balancing API 参考版本 2015-12-01 中的 CreateListener 操作的 Protocol 参数。

Required: Yes

Type: String

更新要求无需中断

SslPolicy

定义负载均衡器支持的密码和协议的安全策略。

Required: No

Type: String

更新要求无需中断

返回值

Ref

当向 Ref 内部函数提供此资源的逻辑 ID 时,Ref 将返回侦听器 ARN,例如 arn:aws:elasticloadbalancing:us-west-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/f2f7dc8efc522ab2

有关使用 Ref 功能的更多信息,请参阅参考

示例

下面的示例为 myLoadBalancer 资源创建侦听器。侦听器的默认操作是将请求转发到 myTargetGroup 目标组。

JSON

"Listener": { "Type": "AWS::ElasticLoadBalancingV2::Listener", "Properties": { "DefaultActions": [{ "Type": "forward", "TargetGroupArn": { "Ref": "myTargetGroup" } }], "LoadBalancerArn": { "Ref": "myLoadBalancer" }, "Port": "8000", "Protocol": "HTTP" } }

YAML

Listener: Type: AWS::ElasticLoadBalancingV2::Listener Properties: DefaultActions: - Type: forward TargetGroupArn: Ref: myTargetGroup LoadBalancerArn: Ref: myLoadBalancer Port: '8000' Protocol: HTTP

本页内容: