AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::EC2::VPCEndpoint

AWS::EC2::VPCEndpoint 资源会创建一个 VPC 终端节点,您可以用它在您的 VPC 和其他 AWS 服务之间建立私有连接,无需通过 Internet、VPN 连接或 AWS Direct Connect 进行访问。

语法

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

JSON

{ "Type" : "AWS::EC2::VPCEndpoint", "Properties" : { "PolicyDocument" : JSON object, "RouteTableIds" : [ String, ... ], "ServiceName" : String, "VpcId" : String } }

YAML

Type: "AWS::EC2::VPCEndpoint" Properties: PolicyDocument: JSON object RouteTableIds: - 字符串 ServiceName: String VpcId: String

属性

PolicyDocument

一个附加到终端节点的策略,用于控制对服务的访问。策略必须为有效的 JSON。默认策略允许对 AWS 服务进行完全访问。有关更多信息,请参阅 Amazon VPC 用户指南 中的控制对服务的访问

Required: No

Type: JSON object

更新要求无需中断

RouteTableIds

VPC 用于访问终端节点的一个或多个路由表 ID。

Required: No

Type: List of String values

更新要求无需中断

ServiceName

要与其建立连接的 AWS 服务。以 com.amazonaws.region.service 的形式指定服务名称。

Required: Yes

Type: String

更新要求替换

VpcId

使用终端节点的 VPC 的 ID。

Required: Yes

Type: String

更新要求替换

返回值

Ref

当您将 AWS::EC2::VPCEndpoint 资源的逻辑 ID 传递给内部函数 Ref 时,此函数返回终端节点 ID,例如 vpce-a123d0d1

有关使用 Ref 功能的更多信息,请参阅参考

示例

下面的示例创建一个只允许在 examplebucket 存储桶上执行 s3:GetObject 操作的 VPC 端点。前往与 routetableAroutetableB 路由表关联的子网中的 S3 的通信通过 VPC 端点自动路由。

JSON

"S3Endpoint" : { "Type" : "AWS::EC2::VPCEndpoint", "Properties" : { "PolicyDocument" : { "Version":"2012-10-17", "Statement":[{ "Effect":"Allow", "Principal": "*", "Action":["s3:GetObject"], "Resource":["arn:aws:s3:::examplebucket/*"] }] }, "RouteTableIds" : [ {"Ref" : "routetableA"}, {"Ref" : "routetableB"} ], "ServiceName" : { "Fn::Join": [ "", [ "com.amazonaws.", { "Ref": "AWS::Region" }, ".s3" ] ] }, "VpcId" : {"Ref" : "VPCID"} } }

YAML

S3Endpoint: Type: 'AWS::EC2::VPCEndpoint' Properties: PolicyDocument: Version: 2012-10-17 Statement: - Effect: Allow Principal: '*' Action: - 's3:GetObject' Resource: - 'arn:aws:s3:::examplebucket/*' RouteTableIds: - !Ref routetableA - !Ref routetableB ServiceName: !Join - '' - - com.amazonaws. - !Ref 'AWS::Region' - .s3 VpcId: !Ref VPCID

本页内容: