適用於所有環境的一般選項

Availability Zones

可用區域 (AZs) 是 AWS 區域中的不同位置，其設計旨在與其他 AZs 中的故障隔離。它們提供同一區域中其他可用區域的價廉、低延遲網路連線能力。為您的執行個體選擇可用區域數目。

Any

Any

Any 1

Any 2

Any 3

Cooldown

冷卻時間有助於在之前的活動產生影響之前，避免 Amazon EC2 Auto Scaling 啟動額外擴展活動。冷卻時間是指一個擴展活動完成後、另一個擴展活動可開始前的時間量 (以秒為單位)。

360

0 至 10000

Custom Availability Zones

為您的執行個體定義可用區域。

無

us-east-1a

us-east-1b

us-east-1c

us-east-1d

us-east-1e

eu-central-1

EnableCapacityRebalancing

指定是否為 Auto Scaling 群組中的 Spot 執行個體啟用容量重新平衡功能。如需詳細資訊，請參閱 Amazon EC2 Auto Scaling 使用者指南中的容量重新平衡。

此選項只有在 EnableSpot 於 aws:ec2:instances 命名空間中設定為 true，且 Auto Scaling 群組中至少有一個 Spot 執行個體時有用。

false

true

false

MinSize

在 Auto Scaling 群組中您想要的執行個體的最小數量。

1

1 至 10000

MaxSize

在 Auto Scaling 群組中您想要的執行個體的最大數量。

4

1 至 10000

DisableIMDSv1

設定為 true以停用執行個體中繼資料服務第 1 版 (IMDSv1) 並強制執行 IMDSv2。

設定為 false 以啟用 IMDSv1 和 IMDSv2。

根據平台作業系統，您環境的執行個體預設如下：

如需詳細資訊，請參閱設定執行個體中繼資料服務。

false – 以 Windows 伺服器、Amazon Linux 2 和更早版本為基礎的平台

true – 以 Amazon Linux 2023 為基礎的平台

true

false

EC2KeyName

您可以使用金鑰對安全地登入 EC2 執行個體。

無

IamInstanceProfile

執行個體描述檔可讓 AWS Identity and Access Management (IAM) 使用者 AWS 和服務存取臨時安全登入資料，以進行 AWS 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 僅允許在建立範本時為資源設定標籤。如需詳細資訊，請參閱《AWS CloudFormation 使用者指南》中的 TagSpecification。

如需有關啟動範本的詳細資訊，請參閱以下內容：

如需有關此選項的詳細資訊，請參閱 對啟動範本的標籤傳輸。

false

true

false

MonitoringInterval

您希望 Amazon CloudWatch 指標傳回的間隔 (在幾分鐘內)。

5 minute

1 minute

5 minute

SecurityGroups

列出要指派給 Auto Scaling 群組中 EC2 執行個體的 Amazon EC2 安全群組 IDs，以定義執行個體的防火牆規則。 EC2

您可以提供逗號分隔值的單一字串，其中包含在範本中建立的現有 Amazon EC2 安全群組 IDs 或 AWS::EC2::SecurityGroup 資源的參考。

elasticbeanstalk-default

SSHSourceRestriction

用於鎖定 SSH 對環境的存取。例如，您可以鎖定 SSH 對 EC2 執行個體的存取，因此只有 Bastion 主機可以存取私有子網路中的執行個體。

此字串的格式如下：

protocol, fromPort, toPort, source_restriction

無

BlockDeviceMappings

將其他 Amazon EBS 磁碟區或執行個體存放區磁碟區連接到 Auto Scaling 群組上的所有執行個體。

映射執行個體存放區時，您只需將裝置名稱映射至磁碟區名稱。不過，我們建議在映射 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

磁碟區類型 (磁帶、一般用途 SSD 或佈建 IOPS SSD)，以用於連接到您環境的 EC2 執行個體的根 Amazon EBS 磁碟區。

依平台而有所不同。

standard 用於磁帶儲存。

gp2 或 gp3 用於一般用途 SSD。

io1 用於佈建 IOPS SSD。

RootVolumeSize

整個 GB 中根 Amazon EBS 磁碟區的儲存容量。

如果您設定 RootVolumeType 為佈建 IOPS SSD，則此為必要。

例如："64"。

對磁帶儲存和一般用途 SSD 而言，每個平台都不同。

非用於佈建 IOPS SSD。

10 以 16384 GB 為一般用途和佈建 IOPS SSD。

8 以 1024 GB 為磁帶用途。

RootVolumeIOPS

所需的佈建 IOPS SSD 根磁碟區或一般用途 gp3 SSD 根磁碟區每秒輸入/輸出操作次數 (IOPS)。

IOPS 與磁碟區大小的最大比例為 500 比 1。例如，有 3000 IOPS 的磁碟區必須至少為 6 GiB。

無

io1 佈建 IOPS SSD 根磁碟區為 100 至 20000。

一般用途 gp3 SSD 根磁碟區為 3000 至 16000。

RootVolumeThroughput

要為連接至您環境 EC2 執行個體的 Amazon EBS 根磁碟區佈建的每秒 MiB (MiB/s) 輸送量。

無

125 至 1000

StartTime

如需一次性動作，選擇執行動作的日期和時間。對於重複的動作，選擇何時要啟動該動作。

無

ISO-8601 時間戳記 在所有已排程擴展動作中都是獨一無二的。

EndTime

當您希望重複排定的擴展動作在未來的日期和時間 (在 UTC/GMT 時區) 停止重複。如果您沒有指定 EndTime (結束時間)，該動作會根據 Recurrence 表達式重複執行。

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

當排定的動作結束時，Amazon EC2 Auto 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

執行擴展活動時需移除多少個 Amazon EC2 執行個體。

-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

指定執行縮放活動時需新增多少個 Amazon EC2 執行個體。

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，其中每個 # 分別代表小時、分鐘，和/或秒。

EnableSpot

為您的環境啟用 Spot 執行個體請求。若為 false，此命名空間中的某些選項則無法生效。

false

true

false

InstanceTypes

您要讓環境使用的執行個體類型清單，以逗號分隔 (例如 t2.micro,t3.micro)。

當 EnableSpot為 true且 SpotAllocationStrategy 設定為 時capacity-optimized-prioritized，此選項中指定的值清單會決定 Spot 執行個體配置策略的執行個體類型優先順序。

Spot 執行個體未啟用 (EnableSpot 為 false) 時，系統只會使用清單上的第一個執行個體類型。

此選項清單上的第一個執行個體類型等於 InstanceType 命名空間中 aws:autoscaling:launchconfiguration 選項的數值。我們不建議使用後一個選項，因為其已淘汰。如果您同時指定這兩者，則會使用 InstanceTypes 選項清單上的第一個執行個體類型，並忽略 InstanceType。

可用的執行個體類型會依使用的可用區域和區域而定。如果您選擇一個子網路，包含該子網路的可用區域會決定可用的執行個體類型。

當您更新環境資訊並從 InstanceTypes 選項中移除一或多個執行個體類型時，Elastic Beanstalk 會終止在已移除的執行個體類型上執行的任何 Amazon EC2 執行個體。然後，您環境的 Auto Scaling 群組會視需要啟動新執行個體，以使用目前指定的執行個體類型來完成所需的容量。

包含兩個執行個體類型的清單。

因帳戶和區域而異。

一到四十個 EC2 執行個體類型。建議至少使用兩種。

因帳戶、區域和可用區域而異。您可以取得依據這些值篩選的 Amazon EC2 執行個體類型清單。如需詳細資訊，請參閱《Amazon EC2 使用者指南》中的可用執行個體類型。

執行個體類型必須全部屬於相同架構 (arm64、x86_64、i386)。

SupportedArchitectures 也是這個命名空間的一部分。如果您針對 SupportedArchitectures 提供任何值，您為 InstanceTypes 輸入的值必須屬於您為 SupportedArchitectures 提供的任何一個架構，而且只能屬於這個架構。

SpotAllocationStrategy

指定 Spot 執行個體配置策略，以決定 Spot 執行個體如何從可用的 Spot 容量集區配置。

如果設定為 capacity-optimized-prioritized， 中值的順序會InstanceTypes設定分配的執行個體類型優先順序。

此選項只有在 EnableSpot 為 true 時有用。

capacity-optimized

capacity-optimized

price-capacity-optimized

capacity-optimized-prioritized

lowest-price

SpotFleetOnDemandBase

隨著環境擴展，Auto Scaling 群組在考量 Spot 執行個體前佈建的最小隨需執行個體數量。

此選項只有在 EnableSpot 為 true 時有用。

0

0 命名空間中的 MaxSize 至 aws:autoscaling:asg 選項

SpotFleetOnDemandAboveBasePercentage

隨需執行個體百分比 (Auto Scaling 群組超出 SpotOnDemandBase 個執行個體數量所怖建的一部分額外容量)。

此選項只有在 EnableSpot 為 true 時有用。

0：適用於單一執行個體環境

70：適用於負載平衡的環境

0 至 100

SpotMaxPrice

您願意為 Spot 執行個體支付的每單位小時最高價格 (USD)。如需 Spot 執行個體最高價格選項的建議，請參閱《Amazon EC2 使用者指南》中的 Spot 執行個體定價歷史記錄。

此選項只有在 EnableSpot 為 true 時有用。

每個執行個體類型的隨需價格。在此情況下，選項的數值為 null。

0.001 至 20.0

null

SupportedArchitectures

您要讓環境使用的 EC2 執行個體架構類型清單 (各項間以逗號分隔)。

Elastic Beanstalk 支援以下列處理器架構為基礎的執行個體類型：

如需處理器架構和 Amazon EC2 執行個體類型的詳細資訊，請參閱Amazon EC2 執行個體類型。

無

arm64

x86_64

i386

VPCId

您的 Amazon VPC 的 ID。

無

Subnets

Auto Scaling 群組子網路或子網路的 ID。如果您有多個子網路，指定一個值作為子網路 ID 的一個單一逗號分隔字串 (例如"subnet-11111111,subnet-22222222")。

無

ELBSubnets

Elastic Load Balancer 的子網路或子網路 ID。如果您有多個子網路，指定一個值作為子網路 ID 的一個單一逗號分隔字串 (例如"subnet-11111111,subnet-22222222")。

無

ELBScheme

如果您想要在 Amazon VPC 中建立一個內部負載平衡器，以讓您的 Elastic Beanstalk 應用程式無法從 Amazon VPC 外部存取，則請指定 internal。如果您指定 public 或 internal 以外的數值，Elastic Beanstalk 會忽略該數值。

public

public

internal

DBSubnets

包含資料庫子網路的 ID。這僅適用於當您希望新增 Amazon RDS 資料庫執行個體做為您應用程式的一部分時。如果您有多個子網路，指定一個值作為子網路 ID 的一個單一逗號分隔字串 (例如"subnet-11111111,subnet-22222222")。

無

AssociatePublicIpAddress

指定是否要使用公有 IP 地址來啟動 Amazon VPC 中的執行個體。公有 IP 地址執行個體不需藉由 NAT 裝置與網際網路通訊。如果要在單一公有子網路中納入您的負載平衡器與執行個體，您必須將值設為 true。

此選項並不會影響單一執行個體環境，該環境一律都有具備彈性 IP 地址的單一 Amazon EC2 執行個體。此選項與有負載平衡且可擴展的環境相關。

無

true

false

應用程式狀況檢查 URL

傳送運作狀態檢查請求的路徑。如果未設定此路徑，負載平衡器會嘗試在連接埠 80 上建立 TCP 連線，以確認應用程式的運作狀態。設定開始為 / 的路徑，以向該路徑傳送一個 HTTP GET 請求。您也可以在路徑前先包含通訊協定 (HTTP、HTTPS、TCP 或 SSL) 和連接埠，以檢查 HTTPS 連線或使用非預設的連接埠。

無

有效值包含：

/ (HTTP GET 到根路徑)

/health

HTTPS:443/

HTTPS:443/health

任何環境變數名稱。

以金鑰數值組通過。

無

任何環境變數值。

StreamLogs

指定是否要在 CloudWatch Logs 中建立 Proxy 和部署日誌的群組，以及在您環境中的各個執行個體串流日誌。

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 Logs 為環境運作狀態建立群組並對 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 秒 (四分鐘)。例如，預設的有效逾時是 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

Elastic Beanstalk 用來為環境管理資源的 IAM 角色名稱。指定角色名稱 (選擇性地在字首加上自訂路徑) 或其 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 會檢查應用程式 Amazon EC2 執行個體之運作狀態的時間間隔 (以秒為單位)。

使用傳統或 Application Load Balancer：15

使用 Network Load Balancer：30

使用傳統或 Application Load Balancer：5到300

使用 Network Load Balancer：10、30

HealthCheckPath

運作狀態檢查 HTTP 請求傳送的路徑。

/

可路由路徑。

HealthCheckTimeout

運作狀態檢查期間等待回應的時間，以秒為單位。

此選項只適用於 Application Load Balancer 的環境。

5

1 至 60

HealthyThresholdCount

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。

使用傳統或 Application Load Balancer：3

使用 Network Load Balancer：5

2 至 10

MatcherHTTPCode

以逗號分隔的 HTTP 程式碼清單，表示執行個體正常運作。

此選項只適用於具有 Network Load Balancer 或 Application Load Balancer 的環境。

200

使用 Application Load Balancer：200 至 499

使用 Network Load Balancer：200 至 399

Port

接聽處理程序的連接埠。

80

1 至 65535

Protocol

處理程序使用的通訊協定。

透過 Application Load Balancer，您僅能將此選項設為HTTP或HTTPS。

透過 Network Load Balancer，您僅能將此選項設為TCP。

使用傳統或 Application Load Balancer：HTTP

使用 Network Load Balancer：TCP

TCP

HTTP

HTTPS

StickinessEnabled

設定為 true，以啟用黏性工作階段。

此選項只適用於 Application Load Balancer 的環境。

'false'

'false'

'true'

StickinessLBCookieDuration

黏性工作階段 Cookie 的生命週期 (以秒為單位)。

此選項只適用於 Application Load Balancer 的環境。

86400 (一天)

1 至 604800

StickinessType

設定為 lb_cookie以為黏性工作階段使用 cookies。

此選項只適用於 Application Load Balancer 的環境。

lb_cookie

lb_cookie

UnhealthyThresholdCount

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續不成功請求數目。

5

2 至 10

DeregistrationDelay

取消註冊之前等待作用中請求完成的時間 (以秒為單位)。

20

0 至 3600

HealthCheckInterval

Elastic Load Balancing 會檢查應用程式的 Amazon EC2 執行個體運作狀態的間隔 (以秒為單位)。

使用傳統或 Application Load Balancer：15

使用 Network Load Balancer：30

使用傳統或 Application Load Balancer：5到300

使用 Network Load Balancer：10、30

HealthCheckPath

運作狀態檢查 HTTP 請求傳送的路徑。

/

可路由路徑。

HealthCheckTimeout

運作狀態檢查期間等待回應的時間，以秒為單位。

此選項只適用於 Application Load Balancer 的環境。

5

1 至 60

HealthyThresholdCount

在 Elastic Load Balancing 變更執行個體運作狀態之前的連續成功請求數目。

使用傳統或 Application Load Balancer：3

使用 Network Load Balancer：5

2 至 10

MatcherHTTPCode

以逗號分隔的 HTTP 程式碼清單，表示執行個體正常運作。

此選項只適用於具有 Network Load Balancer 或 Application Load Balancer 的環境。

200

使用 Application Load Balancer：200 至 499

使用 Network Load Balancer：200 至 399

Port

接聽處理程序的連接埠。

80

1 至 65535

Protocol

處理程序使用的通訊協定。

透過 Application Load Balancer，您僅能將此選項設為HTTP或HTTPS。

透過 Network Load Balancer，您僅能將此選項設為TCP。

使用傳統或 Application Load Balancer：HTTP

使用 Network Load Balancer：TCP

TCP

HTTP

HTTPS

StickinessEnabled

設定為 true，以啟用黏性工作階段。

此選項只適用於 Application Load Balancer 的環境。

'false'

'false'

'true'

StickinessLBCookieDuration

黏性工作階段 Cookie 的生命週期 (以秒為單位)。

此選項只適用於 Application Load Balancer 的環境。

86400 (一天)

1 至 604800

StickinessType

設定為 lb_cookie以為黏性工作階段使用 cookies。

此選項只適用於 Application Load Balancer 的環境。

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"。

無

日期和時間格式：

天：小時：分鐘

格式。

ServiceRoleForManagedUpdates

Elastic Beanstalk 用來執行您環境的受管平台更新的 IAM 角色名稱。

您可以使用與針對 ServiceRole 命名空間之 aws:elasticbeanstalk:environment 選項所指定相同的角色，或使用您帳戶的受管更新服務連結角色。在後者的情況中，如果帳戶還沒有受管更新服務連結角色，則 Elastic Beanstalk 會建立。

無

與 ServiceRole 相同

或

AWSServiceRoleForElasticBeanstalkManagedUpdates

UpdateLevel

使用受管平台更新套用最高層級的更新。平台的版本命名方式為 major.minor.patch。例如，2.0.8 有 2 主要版本、無次要版本，和 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

指派一或多個安全群組，讓您建立負載平衡器。

無

一或多個安全群組 ID。

為您環境的負載平衡器指派現有的安全群組，而不用建立新的。若要使用此設定，請更新此命名空間中的 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 有相同的網際網路通訊協定。也必須與任何其他接聽程式有相同的安全性等級，使用 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 有相同的網際網路通訊協定。也必須與任何其他接聽程式有相同的安全性等級，使用 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 原則，指定是否包含 IP 地址和連接埠的原始請求 TCP 訊息。此原則僅可與 TCP/SSL 接聽程式關聯。

PublicKey

在身分驗證後端伺服器或伺服器時，PublicKeyPolicyType 政策所使用的公有金鑰內容。此政策無法直接套用至後端伺服器或接聽程式。它必須是 BackendServerAuthenticationPolicyType 政策的一部分。

PublicKeyPolicyNames

以逗號分隔清單政策名稱 (從 PublicKeyPolicyType 政策) 的 BackendServerAuthenticationPolicyType 政策，控制身分驗證到後端伺服器或伺服器。此政策僅可與使用 HTTPS/SSL 的後端伺服器相關聯。

SSLProtocols

為 SSLNegotiationPolicyType 政策啟用以逗號分隔的 SSL 通訊協定，以定義負載平衡器可接受的加密方式和通訊協定。此原則僅可與 HTTPS/SSL 接聽程式關聯。

SSLReferencePolicy

預先定義安全政策的名稱，該政策遵循 AWS 安全最佳實務，而且您想要為定義負載平衡器接受的密碼和通訊協定SSLNegotiationPolicyType的政策啟用 。此原則僅可與 HTTPS/SSL 接聽程式關聯。

Stickiness Cookie Expiration

每個 Cookie 有效所需的時間 (秒)。

0

0 至 1000000

Stickiness Policy

將使用者會話繫結到特定的伺服器執行個體，以便會話期間來自使用者的所有請求都發送到相同的伺服器執行個體。

false

DefaultProcess

當沒有相符的規則時，轉送流量至該處理程序的名稱。

default

程序名稱。

ListenerEnabled

設定為false以停用接聽程式。您可以使用此選項，停用連接埠 80 上的預設接聽程式。

true

true

false

Protocol

要處理的流量通訊協定。

使用 Application Load Balancer：HTTP

使用 Network Load Balancer：TCP

使用 Application Load Balancer：HTTP、HTTPS

使用 Network Load Balancer：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

要處理的流量通訊協定。

使用 Application Load Balancer：HTTP

使用 Network Load Balancer：TCP

使用 Application Load Balancer：HTTP、HTTPS

使用 Network Load Balancer：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/*)。

此選項只適用於 Application Load Balancer 的環境。

無

每個模式最多可包含 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

ManagedSecurityGroup

為您環境的負載平衡器指派現有的安全群組，而不用建立新的。若要使用此設定，請在這個命名空間包含您的安全群組 ID 以更新SecurityGroups設定，並移除自動建立的安全群組 ID (若有的話)。

若要允許流量從負載平衡器到您環境的 EC2 執行個體，Elastic Beanstalk 會將規則新增至執行個體的安全群組，允許從受管安全群組的傳入流量。

Elastic Beanstalks 為您的負載平衡器建立的安全群組。

一個安全群組 ID。

SecurityGroups

連接到負載平衡器的安全群組清單。

對於共享負載平衡器，如果您未指定此值，Elastic Beanstalk 會檢查其管理的現有安全群組是否已連接至負載平衡器。如果沒有連接到負載平衡器，Elastic Beanstalk 會建立安全群組並將其連接到負載平衡器。當共享負載平衡器的最後一個環境終止時，Elastic Beanstalk 會刪除此安全群組。

負載平衡器安全群組用於設定 Amazon EC2 執行個體安全群組輸入規則。

Elastic Beanstalk 為您的負載平衡器建立的安全群組。

以逗號分隔的安全群組 ID 清單。

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

分配的資料庫儲存大小，以 GB 為單位。

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

(db.m1.large 適用於不在 Amazon VPC 中執行的環境)

如需詳細資訊，請參閱 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