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

AWS::GlobalAccelerator::EndpointGroup

AWS::GlobalAccelerator::EndpointGroup 资源是 Global Accelerator 资源类型,其中包含有关如何为指定的侦听器创建终端节点组的信息。终端节点组是一个 AWS 区域中的终端节点集合。

语法

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

JSON

{ "Type" : "AWS::GlobalAccelerator::EndpointGroup", "Properties" : { "EndpointConfigurations" : [ EndpointConfiguration, ... ], "EndpointGroupRegion" : String, "HealthCheckIntervalSeconds" : Integer, "HealthCheckPath" : String, "HealthCheckPort" : Integer, "HealthCheckProtocol" : String, "ListenerArn" : String, "ThresholdCount" : Integer, "TrafficDialPercentage" : Double } }

YAML

Type: AWS::GlobalAccelerator::EndpointGroup Properties: EndpointConfigurations: - EndpointConfiguration EndpointGroupRegion: String HealthCheckIntervalSeconds: Integer HealthCheckPath: String HealthCheckPort: Integer HealthCheckProtocol: String ListenerArn: String ThresholdCount: Integer TrafficDialPercentage: Double

属性

EndpointConfigurations

终端节点对象的列表。

必需:否

类型EndpointConfiguration 的列表

最高10

Update requires: No interruption

EndpointGroupRegion

终端节点组所在的 AWS 区域。

必需:是

类型:字符串

最高255

Update requires: Replacement

HealthCheckIntervalSeconds

每个终端节点的运行状况检查之间的间隔时间(10 秒或 30 秒)。默认值是 30。

必需:否

类型:整数

最低10

最高30

Update requires: No interruption

HealthCheckPath

如果协议为 HTTP/S,则此值将提供 Global Accelerator 用于终端节点上的目标以进行运行状况检查的 ping 路径。默认值为斜杠 (/)。

必需:否

类型:字符串

最高255

Update requires: No interruption

HealthCheckPort

Global Accelerator 用于对属于此终端节点组的终端节点执行运行状况检查的端口。

默认端口是与此终端节点组关联的侦听器的端口。如果侦听器端口为列表,则 Global Accelerator 将使用端口列表中的第一个指定端口。

必需:否

类型:整数

最低1

最高65535

Update requires: No interruption

HealthCheckProtocol

Global Accelerator 用于对属于此终端节点组的终端节点执行运行状况检查的协议。默认值为 TCP。

必需:否

类型:字符串

允许的值HTTP | HTTPS | TCP

Update requires: No interruption

ListenerArn

侦听器的 Amazon 资源名称 (ARN)。

必需:是

类型:字符串

最高255

Update requires: Replacement

ThresholdCount

将运行状况良好的终端节点状态设置为运行状况不佳,或将运行状况不佳的终端节点设置为运行状况正常所需的连续运行状况检查次数。默认值是 3。

必需:否

类型:整数

最低1

最高10

Update requires: No interruption

TrafficDialPercentage

要发送到 AWS 区域的流量百分比。其他流量将分发给此侦听器的其他终端节点组。

使用此操作可增加(上拨)或减少(下拨)到特定区域的流量。该百分比将应用于原本已根据最佳路由路由到该区域的流量。

默认值是 100。

必需:否

类型:双精度

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回终端节点组的 ARN,例如 arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu

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

Fn::GetAtt

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

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

EndpointGroupArn

终端节点组的 ARN,如 arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu

示例

添加终端节点组

以下是指定终端节点组的示例。

JSON

"Resources": { "EndpointGroup": { "Type": "AWS::GlobalAccelerator::EndpointGroup", "Properties": { "ListenerArn": { "Ref": "Listener" }, "EndpointGroupRegion": { "Ref": "EndpointRegion" }, "TrafficDialPercentage": 100.0, "EndpointConfigurations": [ { "EndpointId": { "Ref": "EndpointId" } } ] } } }

YAML

EndpointGroup: Type: AWS::GlobalAccelerator::EndpointGroup Properties: ListenerArn: Ref: Listener EndpointGroupRegion: Ref: EndpointRegion TrafficDialPercentage: 100 EndpointConfigurations: - EndpointId: Ref: EndpointId