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

AWS::SSM::Association

AWS::SSM::Association 资源将某个 Amazon EC2 Systems Manager (SSM) 文档与包含用于处理该文档的配置代理的 EC2 实例相关联。

语法

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

JSON

{ "Type" : "AWS::SSM::Association", "Properties" : { "DocumentVersion" : String, "InstanceId" : String, "Name" : String, "Parameters" : { String: [String, ...] }, "ScheduleExpression" : String, "Targets" : [ Targets ] } }

YAML

Type: "AWS::SSM::Association" Properties: DocumentVersion: String InstanceId: String Name: String Parameters: String: - String ScheduleExpression: String Targets: - Targets

属性

DocumentVersion

要与目标关联的 SSM 文档的版本。

Required: No

Type: String

更新要求无需中断

InstanceId

与 SSM 文档关联的实例的 ID。

Required: Conditional。您必须指定 InstanceIdTargets 属性。

Type: String

更新要求替换

Name

SSM 文档的名称。

Required: Yes

Type: String

更新要求替换

Parameters

SSM 文档在运行时使用的参数值。

Required: No

Type: 字符串到字符串列表映射

更新要求无需中断

ScheduleExpression

一个指定何时将关联应用于目标的 Cron 表达式。有关使用 Cron 表达式的更多信息,请参阅使用 Systems Manager 的 Cron 和 Rate 表达式

Required: No

Type: String

更新要求无需中断

Targets

SSM 文档将命令发送到的目标。

Required: Conditional。您必须指定 InstanceIdTargets 属性。

Type: Amazon EC2 Systems Manager 关联目标 列表

更新要求替换

示例

以下示例将 SSM 文档与特定实例相关联。该实例的 ID 由 myInstanceId 参数指定。

JSON

"association": { "Type": "AWS::SSM::Association", "Properties": { "Name": { "Ref": "document" }, "Parameters": { "Directory": ["myWorkSpace"] }, "Targets": [{ "Key": "InstanceIds", "Values": [{ "Ref": "myInstanceId" }] }] } }

YAML

association: Type: AWS::SSM::Association Properties: Name: !Ref 'document' Parameters: Directory: [FakeDirectory] Targets: - Key: InstanceIds Values: [!Ref 'myInstanceId']

本页内容: