ALIYUN::SLB::Listener用于创建负载均衡监听（Listener）。

语法

{
  "Type": "ALIYUN::SLB::Listener",
  "Properties": {
    "AclStatus": String,
    "Protocol": String,
    "AclId": String,
    "ServerCertificateId": String,
    "HealthCheck": Map,
    "RequestTimeout": Integer,
    "IdleTimeout": Integer,
    "ListenerPort": Integer,
    "Bandwidth": Integer,
    "AclType": String,
    "BackendServerPort": Integer,
    "Scheduler": String,
    "LoadBalancerId": String,
    "CACertificateId": String,
    "Persistence": Map,
    "VServerGroupId": String
  }
}

属性

属性名称 类型 必须 允许更新 描述 约束
AclStatus String 否 否 是否开启访问控制功能。 取值范围：on、off（默认值）。
AclId String 否 否 监听绑定的访问策略组ID。当AclStatus参数的值为on时，该参数为必选参数。 无。
AclType String 否 否 访问控制类型。
  • white：仅转发来自所选访问控制策略组中设置的IP地址或地址段的请求。白名单适用于应用只允许特定IP访问的场景。设置白名单存在一定业务风险。一旦设置白名单，只有白名单中的IP可以访问负载均衡监听。如果开启了白名单访问，但访问策略组中没有添加任何IP，则负载均衡监听不会转发请求。
  • black：来自所选访问控制策略组中设置的IP地址或地址段的所有请求都不会转发。黑名单适用于应用只限制某些特定IP访问的场景。如果开启了黑名单访问，但访问策略组中没有添加任何IP，则负载均衡监听会转发全部请求。当AclStatus参数的值为on时，该参数为必选参数。
 取值范围：white、black。
Protocol String 是 否 IP协议。 取值范围：http、https、tcp、udp。
ListenerPort Integer 是 否 负载均衡实例前端使用的端口。 取值范围：1~65535。
Bandwidth Integer 是 否 监听的带宽峰值。
  • 取值范围：-1Mbps或1~1000Mbps。
  • 针对按固定带宽计费方式的公网类型实例，不同Listener上的Bandwidth的峰值总和不能超出在创建负载均衡实例时设定的Bandwidth值，且不能将Listener上的Bandwidth值设置为-1。针对按使用流量计费方式的公网类型实例，可以选择将Listener上的Bandwidth值设置为-1，表示不限制带宽峰值。
BackendServerPort Integer 是 否 负载均衡实例后端使用的端口。 取值范围：1~65535。
LoadBalancerId String 是 否 负载均衡实例的ID。 无 。
HealthCheck Map 否 否 健康检查设置。 无。
Persistence Map 否 否 相关参数的持久化。 无。
Scheduler String 否 否 调度算法。

取值范围：wrr（默认值）、wlc。
CACertificateId String 否 否 CA证书ID。 只对https有效。
ServerCertificateId String 否 否 服务器证书的ID。 只对https有效，并且是必须的。
VServerGroupId String 否 否 虚拟服务器组ID。 无。
RequestTimeout Integer 否 否 指定请求超时时间。 取值范围：1~180秒。
IdleTimeout Integer 否 否 指定连接空闲超时时间。 取值范围：1~60秒。

HealthCheck 语法

"HealthCheck": {
  "Domain": String,
  "Interval": Integer,
  "URI": String,
  "HttpCode": String,
  "HealthyThreshold": Integer,
  "Timeout": Integer,
  "UnhealthyThreshold": Integer,
  "Port": Integer
}

HealthCheck 属性

属性名称 类型 必须 允许更新 描述 约束
Domain String 否 否 用于健康检查的域名。
  • 取值范围：$_ip、用户自定义字符串、空。
  • 自定义字符串规则：长度限制为1~80个字符。只能包含字母、数字、连字符（-）和点号（.）。
  • 用户设置此参数为$_ip或为空时，负载均衡会使用各后端服务器的私网IP当做健康检查使用的域名。
Interval Integer 否 否 进行健康检查的时间间隔。 取值范围：1~5，单位：秒。
URI String 否 否 用于健康检查的URI。 长度限制为1~80个字符。必须以正斜线（/）开头，可包含字母、数字、连字符（-）、正斜线（/）、点号（.）、百分号（%）、问号（?）、井号（#）和与符号（&）。
HttpCode String 否 否 健康检查正常的http状态码。
  • 取值范围：http_2xx（默认值）、http_3xx、http_4xx、http_5xx。
  • 多个http状态码间用半角逗号（,）分割。
HealthyThreshold Integer 否 否 判定健康检查结果为success的阈值。即，健康检查连续成功多少次后，将后端服务器的健康检查状态由fail改为success。 取值范围：1~10。
Timeout Integer 否 否 每次健康检查响应的最大超时时间。

取值范围：1~50，单位：秒。

注意 如果Timeout值小于Interval值，则Timeout无效，超时时间为Interval的值。
UnhealthyThreshold Integer 否 否 判定健康检查结果为fail的阈值，即健康检查连续失败多少次后，将后端服务器的健康检查状态由success改为fail。 取值范围：1~10。
Port Integer 否 否 用于健康检查的端口。 取值范围：0~65535。

Persistence 语法

"Persistence": {
  "PersistenceTimeout": Integer,
  "CookieTimeout": Integer,
  "XForwardedFor": String,
  "Cookie": String,
  "StickySession": String,
  "StickySessionType": String
}

Persistence 属性

属性名称 类型 必须 允许更新 描述 约束
StickySession String 是 否 是否开启会话保持。 取值范围：on、off。
PersistenceTimeout Integer 否 否 连接持久化的超时时间。
  • 取值范围：0~1000，单位：秒。
  • 默认值：0。表示关闭。
CookieTimeout Integer 否 否 cookie超时时间。
  • 取值范围：1~86400，单位：秒。
  • 仅当StickySession为 on且StickySessionType为insert时，该参数为必选参数。
XForwardedFor String 否 否 是否开启通过X-Forwarded-For的方式获取来访者真实IP。 取值范围：on（默认值）、off。
Cookie String 否 否 服务器上配置的cookie。
  • 取值范围：遵守RFC 2965，且长度为1~200个字符的字符串。只能包含ASCII英文字母和数字字符，不能包含逗号、分号或空格，也不能以美元符号（$）开头。
  • 仅当StickySession为on且StickySessionType为server时，该参数为必选参数。
StickySessionType String 否 否 cookie的处理方式。
  • 取值范围：insert、server。
  • 当StickySessionType取值为insert时，表示由负载均衡插入；当StickySessionType取值为server时，表示负载均衡从后端服务器学习。
  • 当StickySession为on时，该参数为必选参数；当StickySession为off时，此参数设置将被忽略。

返回值

Fn::GetAtt

  • LoadBalancerId：负载均衡实例的唯一标识。
  • ListenerPortsAndProtocol：数组格式，负载均衡实例前端使用的端口和协议。

示例

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Resources": {
    "LoadBalancer": {
      "Type": "ALIYUN::SLB::LoadBalancer",
      "Properties": {
        "LoadBalancerName": "createdByHeat",
        "AddressType": "internet",
        "InternetChargeType": "paybybandwidth"
      }
    },
    "CreateListener": {
      "Type": "ALIYUN::SLB::Listener",
      "Properties": {
        "LoadBalancerId": {"Ref": "LoadBalancer"},
        "ListenerPort": "8094",
        "BackendServerPort": 8080,
        "Bandwidth": 1,
        "Protocol": "http",
        "HealthCheck": {
          "HealthyThreshold": 3,
          "UnhealthyThreshold": 3,
          "Interval": 2,
          "Timeout": 5,
          "HttpCode": "http_2xx,http_3xx,http_4xx,http_5xx"
        },
        "Scheduler": "wrr",
          "Persistence": {
          "PersistenceTimeout": 1,
          "XForwardedFor": 1,
          "StickySession": 1,
          "StickySessionType": 1,
          "CookieTimeout": 0,
          "Cookie": 1
        }
      }
    }
  },
  "Outputs": {
  "LoadBalanceDetails": {
     "Value": {"Fn::GetAtt": ["LoadBalancer", "LoadBalancerId"]}
  }
  }
}