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

AWS::EC2::FlowLog

AWS::EC2::FlowLog 资源创建 Amazon Elastic Compute Cloud (Amazon EC2) 流日志,捕获指定网络接口、子网或 VPC 的 IP 流量。要查看日志数据,请使用 Amazon CloudWatch Logs (CloudWatch Logs) 来帮助排除连接问题。例如,您可以使用流日志来调查为什么特定流量没有达到某个实例,这可以帮助您诊断过于严格的安全组规则。有关更多信息,请参阅 Amazon VPC 用户指南 中的 VPC 流日志

语法

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

JSON

{ "Type" : "AWS::EC2::FlowLog", "Properties" : { "DeliverLogsPermissionArn" : String, "LogGroupName" : String, "ResourceId" : String, "ResourceType" : String, "TrafficType" : String } }

YAML

Type: "AWS::EC2::FlowLog" Properties: DeliverLogsPermissionArn : String LogGroupName : String ResourceId : String ResourceType : String TrafficType : String

属性

DeliverLogsPermissionArn

AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称 (ARN),该角色允许 Amazon EC2 发布流日志到您的账户中的 CloudWatch Logs 日志组。

Required: Yes

Type: String

更新要求替换

LogGroupName

Amazon EC2 在其中发布您的流日志的新的或现有 CloudWatch Logs 日志组的名称。

Required: Yes

Type: String

更新要求替换

ResourceId

您为其创建流日志的子网、网络接口或 VPC 的 ID。

Required: Yes

Type: String

更新要求替换

ResourceType

您在 ResourceId 属性中指定的资源的类型。例如,如果您为 ResourceId 属性指定 VPC ID,则为此属性指定 VPC。有关有效值的信息,请参阅 Amazon EC2 API Reference 中的 CreateFlowLogs 操作的 ResourceType 参数。

Required: Yes

Type: String

更新要求替换

TrafficType

要记录的流量的类型。您可以记录资源接受或拒绝的流量,或者记录所有流量。有关有效值的信息,请参阅 Amazon EC2 API Reference 中的 CreateFlowLogs 操作的 TrafficType 参数。

Required: Yes

Type: String

更新要求替换

返回值

Ref

如果向 Ref 内部函数提供此资源的逻辑 ID,Ref 将返回流日志 ID,如 fl-1a23b456

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

示例

以下示例为名为 MyVPC 的 VPC 创建流日志并记录所有流量类型。Amazon EC2 发布日志到 FlowLogsGroup 日志组。

"MyFlowLog" : { "Type" : "AWS::EC2::FlowLog", "Properties" : { "DeliverLogsPermissionArn" : { "Fn::GetAtt" : ["FlowLogRole", "Arn"] }, "LogGroupName" : "FlowLogsGroup", "ResourceId" : { "Ref" : "MyVPC" }, "ResourceType" : "VPC", "TrafficType" : "ALL" } }

本页内容: