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

AWS::EC2::PrefixList

指定托管前缀列表。您可以将一个或多个条目添加到前缀列表中。每个条目都包含一个 CIDR 块和一个可选的说明。

必须为前缀列表指定最大条目数。以后无法更改最大条目数。

语法

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

JSON

{ "Type" : "AWS::EC2::PrefixList", "Properties" : { "AddressFamily" : String, "Entries" : [ Entry, ... ], "MaxEntries" : Integer, "PrefixListName" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::EC2::PrefixList Properties: AddressFamily: String Entries: - Entry MaxEntries: Integer PrefixListName: String Tags: - Tag

属性

AddressFamily

IP 地址类型。

有效值:IPv4 | IPv6

必需:是

类型:字符串

Update requires: No interruption

Entries

前缀列表的一个或多个条目。

必需:否

类型条目的列表

最高1000

Update requires: No interruption

MaxEntries

前缀列表的最大条目数。

必需:是

类型:整数

Update requires: Updates are not supported.

PrefixListName

前缀列表的名称。

约束:最多 255 个字符。名称不能以 com.amazonaws 开头。

必需:是

类型:字符串

Update requires: No interruption

Tags

前缀列表的标签。

必需:否

类型Tag 的列表

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回前缀列表的 ID。

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

Fn::GetAtt

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

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

Arn

前缀列表的 ARN。例如:arn:aws:ec2:us-east-1:123456789012:prefix-list/pl-0123123123123abcd

OwnerId

前缀列表的所有者的 ID。例如:123456789012

PrefixListId

前缀列表的 ID。例如:pl-0123123123123abcd

Version

前缀列表的版本。例如:1

示例

创建前缀列表

以下示例会创建最多可包含 10 个条目的 IPv4 前缀列表,并在前缀列表中创建 2 个条目。

JSON

{ "Resources": { "NewPrefixList": { "Type": "AWS::EC2::PrefixList", "Properties": { "PrefixListName": "vpc-1-servers", "AddressFamily": "IPv4", "MaxEntries": 10, "Entries": [ { "Cidr": "10.0.0.5/32", "Description": "Server 1" }, { "Cidr": "10.0.0.10/32", "Description": "Server 2" } ], "Tags": [ { "Key": "Name", "Value": "VPC-1-Servers" } ] } } } }

YAML

Resources: NewPrefixList: Type: AWS::EC2::PrefixList Properties: PrefixListName: "vpc-1-servers" AddressFamily: "IPv4" MaxEntries: 10 Entries: - Cidr: "10.0.0.5/32" Description: "Server 1" - Cidr: "10.0.0.10/32" Description: "Server 2" Tags: - Key: "Name" Value: "VPC-1-Servers"