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

AWS::Logs::Destination

AWS::Logs::Destination 资源创建一个 Amazon CloudWatch Logs (CloudWatch Logs) 目标,让您能够指定物理资源(如 Kinesis 流),以便从其他 AWS 账户订阅 CloudWatch Logs 日志事件。有关更多信息,请参阅 Amazon CloudWatch 用户指南 中的使用订阅跨账户共享日志数据

语法

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

JSON

Copy
{ "Type" : "AWS::Logs::Destination", "Properties" : { "DestinationName" : String, "DestinationPolicy" : String, "RoleArn" : String, "TargetArn" : String } }

YAML

Copy
Type: "AWS::Logs::Destination" Properties: DestinationName: String DestinationPolicy: String RoleArn: String TargetArn: String

属性

DestinationName

CloudWatch Logs 目标的名称。

Required: Yes

Type: String

更新要求替换

DestinationPolicy

一条 AWS Identity and Access Management (IAM) 策略,用于指定谁可以写入您的目标。

Required: Yes

Type: String

更新要求无需中断

RoleArn

IAM 角色的 Amazon 资源名称 (ARN),允许 CloudWatch Logs 向指定的 AWS 资源 (TargetArn) 发送数据。

Required: Yes

Type: String

更新要求无需中断

TargetArn

接受日志事件的 AWS 资源的 ARN。当前只能指定 Kinesis 流。

Required: Yes

Type: String

更新要求无需中断

返回值

Ref

当向 Ref 内部函数提供此资源的逻辑 ID 时,Ref 将返回此资源名称,如 TestDestination

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

Fn::GetAtt

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

Arn

CloudWatch Logs 目的地的 ARN,例如 arn:aws:logs:us-west-2:123456789012:destination:MyDestination

有关使用 Fn::GetAtt 的更多信息,请参见 Fn::GetAtt

示例

在下面的示例中,目标流 (TestStream) 可以接收来自 234567890123 AWS 账户中的 logger IAM 用户的日志事件。对于 TestDestination 目标,用户只能调用 PutSubscriptionFilter 操作。

JSON

Copy
"DestinationWithName" : { "Type" : "AWS::Logs::Destination", "Properties" : { "DestinationName": "TestDestination", "RoleArn": "arn:aws:iam::123456789012:role/LogKinesisRole", "TargetArn": "arn:aws:kinesis:us-east-1:123456789012:stream/TestStream", "DestinationPolicy": "{\"Version\" : \"2012-10-17\",\"Statement\" : [{\"Effect\" : \"Allow\", \"Principal\" : {\"AWS\" : \"arn:aws:iam::234567890123:user/logger\"}, \"Action\" : \"logs:PutSubscriptionFilter\", \"Resource\" : \"arn:aws:logs:us-east-1:123456789012:destination:TestDestination\"}]}" } }

YAML

Copy
DestinationWithName: Type: "AWS::Logs::Destination" Properties: DestinationName: "TestDestination" RoleArn: "arn:aws:iam::123456789012:role/LogKinesisRole" TargetArn: "arn:aws:kinesis:us-east-1:123456789012:stream/TestStream" DestinationPolicy: > {"Version" : "2012-10-17","Statement" : [{"Effect" : "Allow", "Principal" : {"AWS" : "arn:aws:iam::234567890123:user/logger"},"Action" : "logs:PutSubscriptionFilter", "Resource" : "arn:aws:logs:us-east-1:123456789012:destination:TestDestination"}]}

本页内容: