面向所有环境的常规选项

Availability Zones

可用区 (AZs) 是一个 Amazon 区域内的不同位置，经过精心设计，可与其他区域的故障隔离开来 AZs。它们为同一地区的其他人提供低成本、低延迟 AZs 的网络连接。 AZs 为您的实例选择数量。

Any

Any

Any 1

Any 2

Any 3

Cooldown

冷却时间有助于防止 Amazon A EC2 uto Scaling 在之前活动的影响显现之前启动额外的扩展活动。冷却时间是一个调整活动完成后、另一个调整活动开始前的时长（秒）。

360

0 到 10000

Custom Availability Zones

AZs 为您的实例定义。

无

us-east-1a

us-east-1b

us-east-1c

us-east-1d

us-east-1e

eu-central-1

EnableCapacityRebalancing

指定是否为 Auto Scaling 组中的 Spot 实例启用容量再平衡功能。有关更多信息，请参阅 Amazon A EC2 uto Scaling 用户指南中的容量重新平衡。

只有在 aws:ec2:instances 命名空间里将 EnableSpot 设置为 true，并且 Auto Scaling 组中至少有一个 Spot 实例时，此选项才会相关联。

false

true

false

MinSize

您希望 Auto Scaling 组中拥有的最小实例数。

1

1 到 10000

MaxSize

您希望 Auto Scaling 组中拥有的最大实例数。

4

1 到 10000

DisableDefaultEC2SecurityGroup

当设置为默认值时false，Elastic Beanstalk 会创建一个默认安全组，允许来自互联网或负载均衡器的流量通过 HTTP (80) 的标准端口。它在创建环境时将此安全组附加到环境的 EC2 实例。

设置为 E true lastic 时，Beanstalk 不会为新环境的实例分配默认安全组 EC2 。对于现有环境，Elastic Beanstalk 将从您的环境实例 EC2 中取消分配默认安全组。 EC2 因此，您还必须设置以下配置：

如果EC2KeyName在已DisableDefaultEC2SecurityGroup设置为默认安全组的环境中为指定值，则不会与 EC2实例关联。true

false

true

false

DisableIMDSv1

设置为true以禁用实例元数据服务版本 1 (IMDSv1) 并强制执行 IMDSv2。

设置为false可同时启用 IMDSv1 和 IMDSv2。

根据平台操作系统，您的环境的实例默认如下所示：

有关更多信息，请参阅配置实例元数据服务。

false – 基于 Windows 服务器、Amazon Linux 2 及更早版本的平台

true – 基于 Amazon Linux 2023 的平台

true

false

EC2KeyName

您可以使用 key pair 安全地登录您的 EC2 实例。

如果EC2KeyName在已DisableDefaultEC2SecurityGroup设置为默认安全组的环境中为指定值，则不会与 EC2 实例关联。true

无

IamInstanceProfile

实例配置文件允许 Amazon Identity and Access Management (IAM) 用户和 Amazon 服务访问临时安全证书以进行 Amazon API 调用。指定实例配置文件的名称或其 ARN。

示例：

无

实例配置文件名称或 ARN。

ImageId

通过指定自定义 AMI ID，您可以覆盖默认的 Amazon Machine Image（AMI）。

示例：ami-1f316660

无

InstanceType

用于在 Elastic Beanstalk 环境中运行您的应用程序的实例类型。

可用的实例类型取决于使用的可用区和区域。如果您选择子网，则包含该子网的可用区将决定可用的实例类型。

因账户和区域而异。

一种 EC2 实例类型。

因账户、区域和可用区而异。您可以获得按这些值筛选的 Amazon EC2 实例类型列表。有关更多信息，请参阅 Amazon EC2 用户指南中的可用实例类型。

LaunchTemplateTagPropagationEnabled

设置为 true，以允许将环境标签传播到为环境预调配的特定资源的启动模板。

Elastic Beanstalk 只能将标签传播到以下资源的启动模板：

之所以存在此限制，是因为 CloudFormation 仅允许在为特定资源创建模板时使用标签。有关更多信息，请参阅TagSpecification《Amazon CloudFormation 用户指南》。

有关启动模板的更多信息，请参阅以下内容：

有关此选项的更多信息，请参阅 标签传播到启动模板。

false

true

false

MonitoringInterval

您希望返回 Amazon CloudWatch 指标的时间间隔（以分钟为单位）。

5 minute

1 minute

5 minute

SecurityGroups

列出 IDs 要分配给 Auto Scaling 组中 EC2 实例的 Amazon EC2 安全组，以便为实例定义防火墙规则。

使用此选项可以附加您自己的自定义安全组，这些安全组为 EC2 实例定义防火墙规则。DisableDefaultEC2SecurityGroup有关更多信息，请参阅 负载均衡（多实例）环境。

您可以提供一串以逗号分隔的值，其中包含现有的 Amazon EC2 安全组 IDs 或对模板中创建的 AWS::EC2::SecurityGroup 资源的引用。

如果将此命名空间设置为，则必须DisableDefaultEC2SecurityGroup为此选项提供至少一个值true。

elasticbeanstalk-default

SSHSourceRestriction

用于锁定 SSH 对环境的访问权限。例如，您可以锁定对 EC2 实例的 SSH 访问权限，这样只有堡垒主机才能访问私有子网中的实例。

该字符串采用以下形式：

protocol, fromPort, toPort, source_restriction

无

BlockDeviceMappings

在 Auto Scaling 组中的所有实例上挂载其他 Amazon EBS 卷或实例存储卷。

映射实例存储卷时，您只需将设备名称映射到卷名称。但是，我们建议在映射 Amazon EBS 卷时，另外指定以下部分或全部字段（每个字段必须用冒号分隔）：

下面的示例附加三个 Amazon EBS 卷：一个空白 100GB gp2 卷和一个快照、一个具有 2000 个预配置 IOPS 的空白 20GB io1 卷以及一个实例存储卷 ephemeral0。如果实例类型支持，则可以附加多个实例存储卷。

/dev/sdj=:100:true:gp2,/dev/sdh=snap-51eef269,/dev/sdi=:20:true:io1:2000,/dev/sdb=ephemeral0

无

RootVolumeType

用于连接到您的环境 EC2 实例的 Amazon EBS 根卷的卷类型（磁性、通用型 SSD 或预配置 IOPS 固态硬盘）。

因平台而异。

对于机械硬盘存储，为 standard。

对于通用型 SSD，为gp2 或 gp3。

对于预配置的 IOPS SSD，为 io1。

RootVolumeSize

根 Amazon EBS 卷的存储容量（以完整 GB 为单位）。

如果将 RootVolumeType 设置为预配置的 IOPS SSD，则是必需的。

例如 。"64"

对于机械硬盘存储和通用型 SSD，因平台而异。

对于预配置的 IOPS SSD，为“无”。

对于通用型和预配置的 IOPS SSD，为 10 至 16384 GB。

对于机械硬盘存储，为 8 至 1024 GB。

RootVolumeIOPS

预配置 IOPS SSD 根卷或通用 gp3 SSD 根卷所需的每秒 input/output 操作数 (IOPS)。

IOPS 与卷大小的最大比率为 500:1。例如，IOPS 为 3000 的卷至少必须为 6 GiB。

无

对于 io1 预置 IOPS 固态硬盘根卷，范围为 100 到 20000。

对于通用型 gp3 固态硬盘根卷，范围为 3000 到 16000。

RootVolumeThroughput

为连接到您的环境实例的 Amazon EBS 根卷预配置所需的吞吐量（每秒 MiB/s）。 EC2

无

125 到 1000

StartTime

对于一次性操作，请选择运行操作的日期和时间。对于重复操作，请选择激活操作的时间。

无

跨所有计划的扩展操作的唯一 ISO-8601 时间戳。

EndTime

您希望计划扩展操作停止重复的将来的日期和 UTC/GMT 时间（以时区为单位）。如果未指定 EndTime，则操作将根据Recurrence表达式重复。

示例：2015-04-28T04:07:2Z

计划操作结束后，Amazon A EC2 uto Scaling 不会自动恢复到之前的设置。配置第二个计划操作，以根据需要返回原始设置。

无

跨所有计划的扩展操作的唯一 ISO-8601 时间戳。

MaxSize

运行操作时要应用的最大实例计数。

无

0 到 10000

MinSize

运行操作时要应用的最小实例计数。

无

0 到 10000

DesiredCapacity

为 Auto Scaling 组设置初始所需容量。在应用计划的操作后，触发器将根据其设置调整所需容量。

无

0 到 10000

Recurrence

您希望计划操作发生的频率。如果不指定循环，则扩展操作仅发生一次，如 StartTime 所指定。

无

Cron 表达式。

Suspend

设置为 true 可临时停用重复的计划操作。

false

true

false

BreachDuration

调用触发器前，指标可以超出所定义限制（如 UpperThreshold 和 LowerThreshold 所指定）的时间（单位：分钟）。

5

1 到 600

LowerBreachScaleIncrement

执行扩展活动时要移除多少 EC2 个 Amazon 实例。

-1

LowerThreshold

如果测量值低于该违例持续时间值，则会调用触发器。

2000000

0 到 20000000

MeasureName

用于 Auto Scaling 触发器的指标。

NetworkOut

CPUUtilization

NetworkIn

NetworkOut

DiskWriteOps

DiskReadBytes

DiskReadOps

DiskWriteBytes

Latency

RequestCount

HealthyHostCount

UnhealthyHostCount

TargetResponseTime

Period

指定 Amazon CloudWatch 衡量触发器指标的频率。此值是两个连续时间段之间的分钟数。

5

1 到 600

EvaluationPeriods

用于确定是否违例的连续评估期的数量。

1

1 到 600

Statistic

触发器使用的统计数据，例如 Average。

Average

Minimum

Maximum

Sum

Average

Unit

触发器度量单位，例如 Bytes。

Bytes

Seconds

Percent

Bytes

Bits

Count

Bytes/Second

Bits/Second

Count/Second

None

UpperBreachScaleIncrement

指定在执行扩展活动时要添加多少 EC2 个 Amazon 实例。

1

UpperThreshold

如果测量值高于该违例持续时间值，则会调用触发器。

6000000

0 到 20000000

MaxBatchSize

滚动更新的每个批次中包含的实例数。

Auto Scaling 组的最小大小的三分之一（舍入到下一个最大整数）

1 到 10000

MinInstancesInService

终止其他实例时，Auto Scaling 组中必须处于运行中的最小实例数。

Auto Scaling 组的最小大小，或 Auto Scaling 组的最大大小减一（取二者中的较小值）。

0 到 9999

RollingUpdateEnabled

如果为 true，则为环境启用滚动更新。在您需要对 Elastic Beanstalk 软件应用程序进行频繁的少量更新，并且希望避免应用程序停机时，滚动更新很有用。

将此值设置为 true 会自动启用 MaxBatchSize、MinInstancesInService 和 PauseTime 选项。设置这些选项中的任何选项也会自动将 RollingUpdateEnabled 选项值设置为 true。将此选项设置为 false 会禁用滚动更新。

false

true

false

RollingUpdateType

其中包括三种类型：基于时间的滚动更新、基于运行状况的滚动更新和不可变更新。

基于时间的滚动更新在批次 PauseTime 之间应用。基于运行状况的滚动更新会等新实例通过运行状况检查后再继续下一个批次。不可变更新将启动新 Auto Scaling 组中的一整组实例。

Time

Time

Health

Immutable

PauseTime

Elastic Beanstalk 服务在完成一批实例更新之后到开始下一批实例更新之前要等待的时长（以秒、分钟或小时为单位）。

基于实例类型和容器自动计算。

PT0S*（0 秒）至 PT1H（1 小时）

Timeout

在取消更新之前，等待一个实例批次中的所有实例通过运行状况检查的最长时间（以分钟或小时为单位）。

PT30M（30 分钟）

PT5M*（5 分钟）至 PT1H（1 小时）

* ISO8601 持续时间格式：PT#H#M#S其中每个 # 分别是小时、分钟、 and/or 秒数。

EnableSpot

为您的环境启用 Spot 实例请求。如果为 false，此命名空间中的某些选项不会生效。

false

true

false

InstanceTypes

您希望环境使用的实例类型的逗号分隔列表（例如，t2.micro,t3.micro）。

如果设置EnableSpotSpotAllocationStrategy为 truecapacity-optimized-prioritized，则此选项中指定的值列表决定竞价型实例分配策略的实例类型优先级。

当未激活 Spot 实例（EnableSpot 为 false）时，仅使用列表中的第一种实例类型。

此选项的列表中的第一个实例类型等同于 InstanceType 命名空间中的 aws:autoscaling:launchconfiguration 选项的值。我们不建议使用后一个选项，因为它已经过时了。如果您同时指定两者，则使用 InstanceTypes 选项的列表中的第一个实例类型，并忽略 InstanceType。

可用的实例类型取决于使用的可用区和区域。如果您选择子网，则包含该子网的可用区将决定可用的实例类型。

当您更新环境配置并从InstanceTypes选项中移除一个或多个实例类型时，Elastic Beanstalk 会终止在 EC2 任何已删除的实例类型上运行的所有 Amazon 实例。然后，您环境的 Auto Scaling 组根据需要启动新实例，以使用当前指定的实例类型来完成所需的容量。

两种实例类型的列表。

因账户和区域而异。

一到四十种 EC2 实例类型。我们建议至少两种。

因账户、区域和可用区而异。您可以获得按这些值筛选的 Amazon EC2 实例类型列表。有关更多信息，请参阅 Amazon EC2 用户指南中的可用实例类型。

实例类型必须均属于同一架构（arm64、x86_64、i386）。

SupportedArchitectures 也是此命名空间的一部分。如果您为 SupportedArchitectures 提供了任何值，则为 InstanceTypes 输入的值必须属于且仅属于为 SupportedArchitectures 提供的架构之一。

SpotAllocationStrategy

指定竞价型实例分配策略，该策略决定如何从可用的竞价容量池中分配竞价型实例。

如果设置为capacity-optimized-prioritized，则中值的顺序InstanceTypes将设置分配的实例类型优先级。

此选项仅在 EnableSpot 为 true 时有意义。

capacity-optimized

capacity-optimized

price-capacity-optimized

capacity-optimized-prioritized

lowest-price

SpotFleetOnDemandBase

扩展环境时，在考虑 Spot 实例之前，Auto Scaling 组预配置的最小按需实例数。

此选项仅在 EnableSpot 为 true 时有意义。

0

0 命名空间中 MaxSize 至 aws:autoscaling:asg 选项

SpotFleetOnDemandAboveBasePercentage

Auto Scaling 组在 SpotOnDemandBase 实例之外作为额外容量预配置的按需实例的百分比。

此选项仅在 EnableSpot 为 true 时有意义。

0 适用于单实例环境

70 适用于负载均衡环境

0 到 100

SpotMaxPrice

您愿意为 Spot 实例支付的每单位小时的最高价（USD）。有关竞价型实例最高价格选项的建议，请参阅 Amazon EC2 用户指南中的竞价型实例定价历史记录。

此选项仅在 EnableSpot 为 true 时有意义。

每种实例类型的按需价格。在这种情况下，该选项的值为 null。

0.001 到 20.0

null

SupportedArchitectures

以逗号分隔的 EC2 实例架构类型列表，供您的环境使用。

Elastic Beanstalk 支持基于以下处理器架构的实例类型：

有关处理器架构和 Amazon EC2 实例类型的更多信息，请参阅亚马逊 EC2 实例类型。

无

arm64

x86_64

i386

VPCId

您的 Amazon VPC 的 ID。

无

Subnets

Auto Scaling 组 IDs 的一个或多个子网中的一个或多个子网。如果您有多个子网，请将该值指定为单个以逗号分隔的子网字符串 IDs （例如）。"subnet-11111111,subnet-22222222"

无

ELBSubnets

弹性负载均衡器 IDs 的一个或多个子网的。如果您有多个子网，请将该值指定为单个以逗号分隔的子网字符串 IDs（例如）。"subnet-11111111,subnet-22222222"

无

ELBScheme

如果您要在 Amazon VPC 中创建一个内部负载均衡器，请指定 internal，从而确保不能从 Amazon VPC 的外部访问您的 Elastic Beanstalk 应用程序。如果指定 public 或 internal 以外的值，Elastic Beanstalk 会忽略此值。

public

public

internal

DBSubnets

包含数据库 IDs 子网的。这仅可用于以下情况：需要将 Amazon RDS 数据库实例添加到应用程序中。如果您有多个子网，请将该值指定为单个以逗号分隔的子网字符串 IDs （例如）。"subnet-11111111,subnet-22222222"

无

AssociatePublicIpAddress

指定是否在您的 Amazon VPC 中启动具有公有 IP 地址的实例。具有公有 IP 地址的实例无需 NAT 设备即可与 Internet 通信。如果要在单个公有子网中包含您的负载均衡器和实例，则必须将值设置为 true。

此选项对单实例环境没有影响，单实例环境中始终有一个带有弹性 IP 地址的 Amazon EC2 实例。该选项与负载平衡、可扩展的环境相关。

无

true

false

应用程序运行状况检查 URL

运行状况检查请求发送到的路径。如果未设置此路径，负载均衡器将尝试在端口 80 上建立一个 TCP 连接，以验证应用程序的运行状况状态。设置为以 / 开头的路径可将 HTTP GET 请求发送到该路径。您还可以在该路径前面包含协议 (HTTP、HTTPS、TCP 或 SSL) 和端口以检查 HTTPS 连接情况或使用非默认端口。

无

有效值包括：

/ (HTTP GET to root path)

/health

HTTPS:443/

HTTPS:443/health

任意环境变量名称。

传入密钥-值对。

无

任意环境变量值。

OptionName

指定用于保存密钥存储库或参数存储值的环境变量的名称。

无

值

为存储在 Amazon Secrets Manager 或 Amazon Systems Manager 参数存储中的值指定 ARN。在实例引导期间，Elastic Beanstalk 会将环境变量初始化为存储在此 ARN 资源中的值。

None（无）

Amazon Secrets Manager 密钥或 Amazon Systems Manager 参数存储参数值的有效 ARN 值。

StreamLogs

指定是否在 CloudWatch 日志中为代理和部署日志创建组，以及是否从环境中的每个实例流式传输日志。

false

true

false

DeleteOnTerminate

指定是否在环境终止后删除日志组。如果为 false，则日志保留 RetentionInDays 天。

false

true

false

RetentionInDays

日志事件在到期前保留的天数。

7

1、3、5、7、14、30、60、90、120、150、180、365、400、545、731、1827、3653

HealthStreamingEnabled

对于启用了增强型运行状况报告的环境，指定是否在环境运行状况 CloudWatch 日志中创建群组并存档 Elastic Beanstalk 环境运行状况数据。有关启用增强型运行状况的信息，请参阅 aws:elasticbeanstalk:healthreporting:system。

false

true

false

DeleteOnTerminate

指定是否在终止环境后删除日志组。如果为 false，则运行状况数据将保留 RetentionInDays 天。

false

true

false

RetentionInDays

在存档的运行状况数据过期前要保留其的天数。

7

1、3、5、7、14、30、60、90、120、150、180、365、400、545、731、1827、3653

DeploymentPolicy

选择应用程序版本部署的部署策略。

AllAtOnce

AllAtOnce

Rolling

RollingWithAdditionalBatch

Immutable

TrafficSplitting

Timeout

等待实例完成执行命令的时间（单位：秒）。

Elastic Beanstalk 内部向 Timeout 值添加 240 秒（4 分钟）。例如，默认的有效超时为 840 秒（600 + 240）或 14 分钟。

600

1 到 3600

BatchSizeType

中指定的数字类型BatchSize。

Percentage

Percentage

Fixed

BatchSize

Auto Scaling 组中要同时执行部署的 Amazon EC2 实例的百分比或固定数量。有效值因使用的BatchSizeType设置而异。

100

1 到 100 (Percentage)。

1到 aws: autoscaling: asg:: () MaxSize Fixed

IgnoreHealthCheck

不要由于运行状况检查失败而取消部署。

true

false

EnvironmentType

设置SingleInstance为可启动一个没有负载均衡器的 EC2 实例。

LoadBalanced

SingleInstance

LoadBalanced

ServiceRole

一个 IAM 角色的名称，该角色供 Elastic Beanstalk 用来管理环境的资源。指定角色名称（可以选择添加自定义路径作为前缀）或其 ARN。

示例：

无

IAM 角色名称、路径/名称或 ARN

LoadBalancerType

用于环境的负载均衡器的类型。有关更多信息，请参阅 Elastic Beanstalk 环境的负载均衡器。

classic

classic

application

network

LoadBalancerIsShared

指定环境的负载均衡器是专用的还是共享的。只能为 Application Load Balancer 设置此选项。环境创建后无法更改。

当为 false 时，环境具有自己的专用负载均衡器（由 Elastic Beanstalk 创建和管理）。当为 true 时，环境使用共享的负载均衡器，该负载均衡器由您创建并在 aws:elbv2:loadbalancer 命名空间的 SharedLoadBalancer 选项中指定。

false

true

false

DeregistrationDelay

在取消注册之前等待活动请求完成的时间（单位：秒）。

20

0 到 3600

HealthCheckInterval

Elastic Load Balancing 检查应用程序的亚马逊 EC2实例运行状况的时间间隔，以秒为单位。

使用 Classic 或应用程序负载均衡器：15

使用网络负载均衡器：30

使用 Classic 或应用程序负载均衡器：5 至 300

使用网络负载均衡器：10、30

HealthCheckPath

运行状况检查的 HTTP 请求发送到的路径。

/

可路由路径。

HealthCheckTimeout

在运行状况检查期间等待响应的时间（单位：秒）。

此选项仅适用于使用应用程序负载均衡器的环境。

5

1 到 60

HealthyThresholdCount

Elastic Load Balancing 更改实例运行状况状态前的连续成功请求数。

使用 Classic 或应用程序负载均衡器：3

使用网络负载均衡器：5

2 到 10

MatcherHTTPCode

指示实例正常的 HTTP 代码 (以逗号分隔) 的列表。

此选项仅适用于使用网络或应用程序负载均衡器的环境。

200

使用应用程序负载均衡器：200 至 499

使用网络负载均衡器：200 至 399

Port

进程侦听的端口。

80

1 到 65535

Protocol

进程使用的协议。

使用应用程序负载均衡器时，您只能将此选项设置为 HTTP 或 HTTPS。

使用网络负载均衡器时，您只能将此选项设置为 TCP。

使用 Classic 或应用程序负载均衡器：HTTP

使用网络负载均衡器：TCP

TCP

HTTP

HTTPS

StickinessEnabled

设置为 true 可启用粘性会话。

此选项仅适用于使用应用程序负载均衡器的环境。

'false'

'false'

'true'

StickinessLBCookieDuration

粘性会话 Cookie 的生存期（单位：秒）

此选项仅适用于使用应用程序负载均衡器的环境。

86400 (一天)

1 到 604800

StickinessType

设置为 lb_cookie 可以为粘性会话使用 Cookie。

此选项仅适用于使用应用程序负载均衡器的环境。

lb_cookie

lb_cookie

UnhealthyThresholdCount

Elastic Load Balancing 更改实例运行状况状态前的连续失败请求数。

5

2 到 10

DeregistrationDelay

在取消注册之前等待活动请求完成的时间（单位：秒）。

20

0 到 3600

HealthCheckInterval

Elastic Load Balancing 检查应用程序的亚马逊 EC2 实例运行状况的时间间隔，以秒为单位。

使用 Classic 或应用程序负载均衡器：15

使用网络负载均衡器：30

使用 Classic 或应用程序负载均衡器：5 至 300

使用网络负载均衡器：10、30

HealthCheckPath

运行状况检查的 HTTP 请求发送到的路径。

/

可路由路径。

HealthCheckTimeout

在运行状况检查期间等待响应的时间（单位：秒）。

此选项仅适用于使用应用程序负载均衡器的环境。

5

1 到 60

HealthyThresholdCount

Elastic Load Balancing 更改实例运行状况状态前的连续成功请求数。

使用 Classic 或应用程序负载均衡器：3

使用网络负载均衡器：5

2 到 10

MatcherHTTPCode

指示实例正常的 HTTP 代码（以逗号分隔）的列表。

此选项仅适用于使用网络或应用程序负载均衡器的环境。

200

使用应用程序负载均衡器：200 至 499

使用网络负载均衡器：200 至 399

Port

进程侦听的端口。

80

1 到 65535

Protocol

进程使用的协议。

使用应用程序负载均衡器时，您只能将此选项设置为 HTTP 或 HTTPS。

使用网络负载均衡器时，您只能将此选项设置为 TCP。

使用 Classic 或应用程序负载均衡器：HTTP

使用网络负载均衡器：TCP

TCP

HTTP

HTTPS

StickinessEnabled

设置为 true 可启用粘性会话。

此选项仅适用于使用应用程序负载均衡器的环境。

'false'

'false'

'true'

StickinessLBCookieDuration

粘性会话 Cookie 的生存期（单位：秒）

此选项仅适用于使用应用程序负载均衡器的环境。

86400 (一天)

1 到 604800

StickinessType

设置为 lb_cookie 可以为粘性会话使用 Cookie。

此选项仅适用于使用应用程序负载均衡器的环境。

lb_cookie

lb_cookie

UnhealthyThresholdCount

Elastic Load Balancing 更改实例运行状况状态前的连续失败请求数。

5

2 到 10

代理服务器提供文件的路径。值以 / 开始。

例如，指定 /images 以在 subdomain.eleasticbeanstalk.com/images 提供文件。

包含文件的文件夹名称。

例如，指定 staticimages 以在源代码包顶层从名为 staticimages 的文件夹中提供文件。

SystemType

运行状况报告系统（基本或增强）。增强型运行状况报告需要一个服务角色和一个版本 2 或更高的平台版本。

basic

basic

enhanced

EnhancedHealthAuthEnabled

为内部 API 启用授权，Elastic Beanstalk 使用此授权将增强型运行状况信息从您的环境实例传达到 Elastic Beanstalk 服务。

有关更多信息，请参阅 增强型运行状况角色。

true

true

false

HealthCheckSuccessThreshold

降低阈值以便实例能够通过运行状况检查。

Ok

Ok

Warning

Degraded

Severe

LogPublicationControl

将您的应用程序的 Amazon EC2 实例的日志文件复制到与您的应用程序关联的 Amazon S3 存储桶中。

false

true

false

ManagedActionsEnabled

启用托管平台更新。

在将此项设置为 true 时，还必须指定 PreferredStartTime 和 UpdateLevel。

false

true

false

PreferredStartTime

配置托管操作的维护时段 (采用 UTC 表示)。

例如 "Tue:09:00"。

无

日期和时间

day:hour:minute

格式的日期和时间。

ServiceRoleForManagedUpdates

Elastic Beanstalk 用于为您的环境执行托管平台更新的 IAM 角色的名称。

您可以使用为 ServiceRole 命名空间的 aws:elasticbeanstalk:environment 选项指定同一个角色，也可以使用账户的托管更新服务相关角色。在后一种情况下，如果账户还没有托管更新服务相关角色，Elastic Beanstalk 会创建该角色。

无

与 ServiceRole 相同

或

AWSServiceRoleForElasticBeanstalkManagedUpdates

UpdateLevel

要通过托管平台更新应用的最高级别的更新。平台已版本化。major minor。 patch。例如，在 2.0.8 中，主版本为 2，次版本为 0，修补版本为 8。

无

patch 仅适用于修补版本更新。

minor 适用于次版本更新和修补版本更新。

InstanceRefreshEnabled

启用每周实例替换。

需要将 ManagedActionsEnabled 设置为 true。

true

false

Automatically Terminate Unhealthy Instances

如果实例无法通过运行状况检查，请将其终止。

true

true

false

Notification Endpoint

在该端点处，系统会通知您对应用程序产生影响的重要事件。

无

Notification Protocol

用于向您的端点发送通知的协议。

email

http

https

email

email-json

sqs

Notification Topic ARN

已订阅主题的 Amazon Resource Name (ARN)。

无

Notification Topic Name

已订阅主题的名称。

无

WorkerQueueURL

队列的 URL，工作线程环境层中的守护程序从该队列读取消息。

自动生成

如果您不指定值，则 Elastic Beanstalk 会自动创建队列。

HttpPath

将 HTTP POST 消息发送到的应用程序的相对路径。

/

MimeType

HTTP POST 请求中发送的消息的 MIME 类型。

application/json

application/json

application/x-www-form-urlencoded

application/xml

text/plain

自定义 MIME 类型。

HttpConnections

Amazon EC2 实例中所有应用程序的最大并发连接数。

50

1 到 100

ConnectTimeout

等待成功连接到应用程序的时长（单位：秒）。

5

1 到 60

InactivityTimeout

在与应用程序的现有连接上等待响应的时长（单位：秒）。

299

1 到 36000

VisibilityTimeout

锁定来自 Amazon SQS 队列的入站消息以进行处理的时长（以秒为单位）。在配置的时长之后，再次使消息在队列中可见，以供任何其他守护程序读取。

300

0 到 43200

ErrorVisibilityTimeout

在处理尝试由于显式错误而失败后，Elastic Beanstalk 将消息返回到 Amazon SQS 队列之前经过的时长（以秒为单位）。

2 秒

0 至 43200 秒

RetentionPeriod

消息有效和等待主动处理的时长（单位：秒）

345600

60 到 1209600

MaxRetries

Elastic Beanstalk 在将消息移动到死信队列之前，尝试向处理消息的 Web 应用程序发送消息的最大尝试次数。

10

1 到 100

NewVersionPercent

对于运行您正在部署的新应用程序版本的环境实例，Elastic Beanstalk 转移到这些实例的传入客户端流量的初始百分比。

10

1 到 100

EvaluationTime

在初始正常部署之后，Elastic Beanstalk 等待的时间段（以分钟为单位），在经过该时间后，会继续将所有传入的客户端流量转移到正在部署的新应用程序版本。

5

3 到 600

XRayEnabled

设为 true 可在环境中的实例上运行 X-Ray 守护程序。

false

true

false

HealthyThreshold

Elastic Load Balancing 更改实例运行状况状态前的连续成功请求数。

3

2 到 10

Interval

Elastic Load Balancing 检查应用程序的 Amazon EC2 实例运行状况的时间间隔。

10

5 到 300

Timeout

Elastic Load Balancing 在将实例视为无响应之前等待的时间（单位：秒）

5

2 到 60

UnhealthyThreshold

Elastic Load Balancing 更改实例运行状况状态前的连续失败请求数。

5

2 到 10

（已弃用）Target

运行状况检查发送到的后端实例上的目标。请改为在 Application Healthcheck URL 命名空间中使用 aws:elasticbeanstalk:application。

TCP:80

目标格式为PROTOCOL：PORT/PATH

CrossZone

将负载均衡器配置为在所有可用区中的所有实例间 (而不是仅在每个区域中) 均匀地路由流量。

false

true

false

SecurityGroups

将您创建的一个或多个安全组分配到负载均衡器。

如果 DisableDefaultEC2SecurityGroup (aws:autoscaling:launchconfiguration) 设置为，则为必填项true。选择退出默认 Elastic Beanstalk EC2 安全组的负载平衡环境必须为一个或多个安全组提供此选项。有关更多信息，请参阅管理 EC2 安全组。

None（无）

一个或多个安全组 IDs。

将现有安全组分配给环境的负载均衡器，而不是创建一个新安全组。要使用此设置，请更新此命名空间中的 SecurityGroups 设置以包含安全组的 ID，然后删除自动创建的安全组 ID（如果已创建）。

为了允许流量从负载均衡器流向您的环境的 EC2 实例，Elastic Beanstalk 向实例的安全组添加了一条规则，允许来自托管安全组的入站流量。

（已弃用）LoadBalancerHTTPPort

80

OFF

80

（已弃用）LoadBalancerPortProtocol

不安全的侦听器上使用的协议。

HTTP

HTTP

TCP

（已弃用）LoadBalancerHTTPSPort

OFF

OFF

443

8443

（已弃用）LoadBalancerSSLPortProtocol

HTTPS

HTTPS

SSL

（已弃用）SSLCertificateId

无

此侦听器用于与 EC2实例通信的协议。

它必须位于与 ListenerProtocol 相同的 Internet 协议层中。其安全级别也必须与使用与该侦听器相同的 InstancePort 的任何其他侦听器相同。

例如，如果 ListenerProtocol 是 HTTPS (应用程序层，使用安全连接)，您可以将 InstanceProtocol 设置为 HTTP (也位于应用程序层，使用不安全的连接)。此外，如果将 InstancePort 设置为 80，您必须在将 InstanceProtocol 设置为 HTTP 的所有其他侦听器中将 InstancePort 设置为 80。

HTTP (当 ListenerProtocol 为 HTTP 时)

TCP (当 ListenerProtocol 为 TCP 时)

TCP 或 SSL 当 ListenerProtocol 为 TCP 或 SSL

true

false

ListenerProtocol

InstancePort

InstanceProtocol

此侦听器用于与 EC2实例通信的协议。

它必须位于与 ListenerProtocol 相同的 Internet 协议层中。其安全级别也必须与使用与该侦听器相同的 InstancePort 的任何其他侦听器相同。

例如，如果 ListenerProtocol 是 HTTPS (应用程序层，使用安全连接)，您可以将 InstanceProtocol 设置为 HTTP (也位于应用程序层，使用不安全的连接)。此外，如果将 InstancePort 设置为 80，您必须在将 InstanceProtocol 设置为 HTTP 的所有其他侦听器中将 InstancePort 设置为 80。

HTTP 当 ListenerProtocol 为 HTTP 或 HTTPS

TCP 当 ListenerProtocol 为 TCP 或 SSL

TCP 或 SSL 当 ListenerProtocol 为 TCP 或 SSL

PolicyNames

SSLCertificateId

无

ListenerEnabled

ConnectionDrainingEnabled

指定负载均衡器是否维持与已运行状况不佳或取消注册的实例之间的现有连接以完成正在进行的请求。

false

true

false

ConnectionDrainingTimeout

在强制关闭连接之前，负载均衡器在连接耗尽过程中维持与实例之间的现有连接的最大秒数。

20

1 到 3600

ConnectionSettingIdleTimeout

负载均衡器等待通过连接发送或接收任何数据的时间（单位：秒）。如果此时段后未发送或接收任何数据，则负载均衡器将关闭连接。

60

1 到 3600

应用默认策略 (AWSEB-ELB-StickinessPolicy) 的侦听器端口的逗号分隔列表。

Stickiness Cookie Expiration

每个 Cookie 的有效时间，以秒为单位。使用默认策略 (AWSEB-ELB-StickinessPolicy)。

0

0 到 1000000

Stickiness Policy

将一个用户会话绑定到某一特定的服务器实例，以便系统将用户在此会话期间发出的所有请求都发送到同一服务器实例。使用默认策略 (AWSEB-ELB-StickinessPolicy)。

false

CookieName

InstancePorts

应用此策略的实例端口的逗号分隔列表。

LoadBalancerPorts

应用此策略的侦听器端口的逗号分隔列表。

ProxyProtocol

对于 ProxyProtocolPolicyType 策略，指定是否包含 TCP 消息的原始请求的 IP 地址和端口。此策略只能与 TCP/SSL 监听器关联。

PublicKey

对后端服务器进行身份验证时要使用的 PublicKeyPolicyType 策略的公有密钥的内容。此策略不能直接应用于后端服务器或侦听器。必须作为 BackendServerAuthenticationPolicyType 策略的一部分。

PublicKeyPolicyNames

控制后端服务器身份验证的 PublicKeyPolicyType 策略的策略名称（来自 BackendServerAuthenticationPolicyType 策略）的逗号分隔列表。此策略只能与使用 HTTPS/SSL 的后端服务器关联。

SSLProtocols

对 SSLNegotiationPolicyType 策略（用于定义负载均衡器所接受的密码和协议）启用的 SSL 协议的逗号分隔列表。此策略只能与 HTTPS/SSL 监听器关联。

SSLReferencePolicy

符合安全最佳实践的预定义 Amazon 安全策略的名称，您要为定义负载均衡器接受的密码和协议的SSLNegotiationPolicyType策略激活该策略。此策略只能与 HTTPS/SSL 监听器关联。

Stickiness Cookie Expiration

每个 Cookie 的有效时间，以秒为单位。

0

0 到 1000000

Stickiness Policy

将一个用户会话绑定到某一特定的服务器实例，以便系统将用户在此会话期间发出的所有请求都发送到同一服务器实例。

false

DefaultProcess

无规则匹配时将流量转发到的流程的名称。

default

过程名称。

ListenerEnabled

设置为 false 可禁用侦听器。您可以使用此选项对端口 80 禁用默认侦听器。

true

true

false

Protocol

要处理的流量的协议。

使用应用程序负载均衡器：HTTP

使用网络负载均衡器：TCP

使用应用程序负载均衡器：HTTP、HTTPS

使用网络负载均衡器：TCP

Rules

应用于侦听器的规则的列表

此选项仅适用于带 Application Load Balancer 的环境。

无

逗号分隔的规则名称列表。

SSLCertificateArns

要绑定到侦听器的 SSL 证书的 Amazon Resource Name (ARN)。

此选项仅适用于带 Application Load Balancer 的环境。

无

存储在 IAM 或 ACM 中的证书的 ARN。

SSLPolicy

指定要应用于监听器的安全策略。

此选项仅适用于带 Application Load Balancer 的环境。

负载均衡器安全策略的名称。

DefaultProcess

无规则匹配时将流量转发到的流程的名称。

default

过程名称。

ListenerEnabled

设置为 false 可禁用侦听器。您可以使用此选项对端口 80 禁用默认侦听器。

true

true

false

Protocol

要处理的流量的协议。

使用应用程序负载均衡器：HTTP

使用网络负载均衡器：TCP

使用应用程序负载均衡器：HTTP、HTTPS

使用网络负载均衡器：TCP

Rules

要应用于侦听器的规则的列表

此选项仅适用于带 Application Load Balancer 的环境。

如果您的环境使用共享的 Application Load Balancer，并且您没有为任何侦听器指定此选项，则 Elastic Beanstalk 自动将 default 规则与端口 80 侦听器关联。

无

逗号分隔的规则名称列表。

SSLCertificateArns

要绑定到侦听器的 SSL 证书的 Amazon Resource Name (ARN)。

此选项仅适用于带 Application Load Balancer 的环境。

无

存储在 IAM 或 ACM 中的证书的 ARN。

SSLPolicy

指定要应用于监听器的安全策略。

此选项仅适用于带 Application Load Balancer 的环境。

负载均衡器安全策略的名称。

HostHeaders

要匹配的主机名列表。例如 my.example.com。

专用负载均衡器：无

共享的负载均衡器：环境的 CNAME

每个名称最多可以包含 128 个字符。模式可包含大写和小写字母、数字、连字符 (–) 以及最多三个通配符（* 匹配零个或多个字符；? 恰好匹配一个字符）。您可以列出多个名称，每个名称用逗号分隔。Application Load Balancer 最多支持五个 HostHeader 和 PathPattern 规则组合。

有关更多信息，请参阅 Application Load Balancer 用户指南中的主机条件。

PathPatterns

要匹配的路径模式（例如，/img/*)。

此选项仅适用于使用应用程序负载均衡器的环境。

无

每个模式最多可包含 128 个字符。模式可包含大写和小写字母、数字、连字符 (–) 以及最多三个通配符（* 匹配零个或多个字符；? 恰好匹配一个字符）。您可以添加多个逗号分隔的路径模式。Application Load Balancer 最多支持五个 HostHeader 和 PathPattern 规则组合。

有关更多信息，请参阅 Application Load Balancer 用户指南中的路径条件。

Priority

多个规则匹配时此规则的优先顺序。较小的数字优先。任何两个规则的优先级不能相同。

利用共享的负载均衡器，Elastic Beanstalk 将规则优先级视为跨共享环境的相对优先级，并在创建过程中将其映射到绝对优先级。

1

1 到 1000

Process

此规则与请求匹配时要将流量转发到的流程的名称。

default

过程名称。

AccessLogsS3Bucket

存储访问日志的 Amazon S3 存储桶。存储桶必须与环境处于同一区域并授予负载均衡器的写入访问权限。

无

存储桶名称。

AccessLogsS3Enabled

启用访问日志存储。

false

true

false

AccessLogsS3Prefix

放在访问日志名称前的前缀。默认情况下，负载均衡器会将日志上传到您指定的存储桶 AWSLogs 中名为的目录。指定前缀以将该 AWSLogs 目录放在另一个目录中。

无

IdleTimeout

在关闭到客户端和实例的连接之前，等待请求完成的时间（单位：秒）。

无

1 到 3600

IpAddressType

指定环境负载均衡器的 IP 地址格式配置。使用 d ualstack 选项启用 IPv6 协议和 IPv4 协议。

只有应用程序负载均衡器和网络负载均衡器支持 du alstack 选项。单实例环境和使用传统负载均衡器的环境不支持它。

您必须将环境的 VPC 和所有 VPC 子网与 IPv6 CIDR 块关联才能支持双堆栈选项。

有关更多信息，请参阅 配置双栈 Elastic Beanstalk 负载均衡器。

ManagedSecurityGroup

将现有安全组分配给环境的负载均衡器，而不是创建一个新安全组。要使用此设置，请更新此命名空间中的 SecurityGroups 设置以包括安全组的 ID，并删除自动创建的安全组 ID (如果存在)。

为了允许流量从负载均衡器流向您的环境中的 EC2 实例，Elastic Beanstalk 会向您的实例的安全组添加一条规则，允许来自托管安全组的入站流量。

Elastic Beanstalks 为您的负载均衡器闯进的安全组。

安全组 ID。

SecurityGroups

附加到负载均衡器的安全组的列表。

如果 DisableDefaultEC2SecurityGroup (aws:autoscaling:launchconfiguration) 设置为，则为必填项true。选择退出默认 Elastic Beanstalk EC2 安全组的负载平衡环境必须为一个或多个安全组提供此选项。有关更多信息，请参阅管理 EC2 安全组。

对于共享的负载均衡器，如果您未指定此值，则 Elastic Beanstalk 将检查其管理的现有安全组是否已连接到负载均衡器。如果没有连接到负载均衡器，Elastic Beanstalk 将创建一个安全组并将其附加到负载均衡器。当最后一个共享负载均衡器的环境终止时，Elastic Beanstalk 将删除此安全组。

负载均衡器安全组用于设置 Amazon EC2 实例安全组入口规则。

Elastic Beanstalks 为您的负载均衡器创建的安全组。

以逗号分隔的安全组列表。 IDs

SharedLoadBalancer

共享负载均衡器的 Amazon Resource Name (ARN)。此选项仅与 Application Load Balancer 相关。当 aws:elasticbeanstalk:environment 命名空间的 LoadBalancerIsShared 选项设置为 true 时，这是必需的。创建环境后，您将无法更改共享的负载均衡器 ARN。

有效值的条件：

例如：

arn:aws:elasticloadbalancing:us-east-2:123456789012:loadbalancer/app/FrontEndLB/0dbf78d8ad96abbc

无

符合此处所述全部条件的有效负载均衡器的 ARN。

DBAllocatedStorage

分配的数据库存储大小 (以吉字节为单位来指定)。

MySQL：5

Oracle：10

sqlserver-se：200

sqlserver-ex：30

sqlserver-web：30

MySQL：5-1024

Oracle：10-1024

sqlserver：无法修改

DBDeletionPolicy

指定在环境终止时保留、删除或创建数据库实例还是为数据库实例拍摄快照。

此选项与 HasCoupledDatabase 结合使用，也是此命名空间的一个选项。

Delete

Delete

Retain

Snapshot

DBEngine

要用于此实例的数据库引擎的名称。

mysql

mysql

oracle-se1

sqlserver-ex

sqlserver-web

sqlserver-se

postgres

DBEngineVersion

数据库引擎的版本号。

5.5

DBInstanceClass

数据库实例类型。

db.t2.micro

（对于并未在 Amazon VPC 中运行的环境，为 db.m1.large）

有关更多信息，请参阅 Amazon Relational Database Service 用户指南中的数据库实例类。

DBPassword

数据库实例的主用户密码。

无

DBSnapshotIdentifier

要用来恢复数据库的数据库快照的标识符。

无

DBUser

数据库实例的主用户名称。

ebroot

HasCoupledDatabase

指定数据库实例是否与环境耦合。如果切换为 true，Elastic Beanstalk 会创建一个与您的环境耦合的新数据库实例。如果切换为 false，Elastic Beanstalk 开始将数据库实例与您的环境解耦。

此选项与 DBDeletionPolicy 结合使用，也是此命名空间的一个选项。

false

true

false

MultiAZDatabase

指定是否需要创建数据库实例的多可用区部署。有关使用 Amazon Relational Database Service (RDS) 进行多可用区部署的更多信息，请参阅 Amazon Relational Database Service 用户指南中的区域和可用区。

false

true

false