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

AWS::GlobalAccelerator::Accelerator

AWS::GlobalAccelerator::Accelerator 资源是 Global Accelerator 资源类型,其中包含有关如何创建加速器的信息。加速器包括一个或多个侦听器,这些侦听器用于处理入站连接并将流量定向到一个或多个终端节点组,其中每个终端节点组都包括终端节点,如 Application Load Balancer、网络负载均衡器和 Amazon EC2 实例。

语法

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

JSON

{ "Type" : "AWS::GlobalAccelerator::Accelerator", "Properties" : { "Enabled" : Boolean, "IpAddresses" : [ String, ... ], "IpAddressType" : String, "Name" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::GlobalAccelerator::Accelerator Properties: Enabled: Boolean IpAddresses: - String IpAddressType: String Name: String Tags: - Tag

属性

Enabled

指示是否启用加速器。该值为 true 或 false。默认值为 true。

如果该值设置为 true,则无法删除加速器。如果设置为 false,则可以删除加速器。

必需:否

类型:布尔值

Update requires: No interruption

IpAddresses

(可选)如果您已将自己的 IP 地址池添加到 Global Accelerator (BYOIP),则可以在创建加速器时从自己的池中选择 IP 地址以用于加速器的静态 IP 地址。您可以指定一个或两个地址,用逗号分隔。不要包括 /32 后缀。

对于每个加速器,只能使用每个 IP 地址范围中的一个 IP 地址。如果您只指定 IP 地址范围中的一个 IP 地址,则 Global Accelerator 会从 AWS IP 地址池中为加速器分配第二个静态 IP 地址。

请注意,您无法更新现有加速器的 IP 地址。要更改它们,您必须使用新地址创建新的加速器。

有关更多信息,请参阅 AWS Global Accelerator 开发人员指南 中的自带 IP 地址 (BYOIP)

必需:否

类型:字符串列表

Update requires: No interruption

IpAddressType

地址类型的值必须为 IPv4。

必需:否

类型:字符串

允许的值IPV4

Update requires: No interruption

Name

加速器的名称。名称必须仅包含字母数字字符或连字符 (-),且不得以连字符开头或结尾。

必需:是

类型:字符串

最高255

Update requires: No interruption

Tags

为加速器创建标签。

有关更多信息,请参阅 AWS Global Accelerator 开发人员指南 中的标记 AWS Global Accelerator

必需:否

类型Tag 的列表

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回加速器的 ARN,例如 arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

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

Fn::GetAtt

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

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

AcceleratorArn

加速器的 ARN,例如 arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh

DnsName

Global Accelerator 创建的域名系统 (DNS) 名称,该名称指向您的加速器的静态 IP 地址。

示例

添加加速器

以下是指定加速器的示例。

JSON

"Resources": { "Accelerator": { "Type": "AWS::GlobalAccelerator::Accelerator", "Properties": { "Name": "SampleAccelerator", "Enabled": true } }, "Outputs": { "AcceleratorDnsName": { "Description": "Accelerator DNS Name", "Value": { "Fn::GetAtt": [ "Accelerator", "DnsName" ] } } } }

YAML

Accelerator: Type: AWS::GlobalAccelerator::Accelerator Properties: Name: SampleAccelerator Enabled: true Outputs: AcceleratorDnsName: Description: Accelerator DNS Name Value: Fn::GetAtt: - Accelerator - DnsName