如何在AWS SSM文档的不同步骤间传递前序步骤的输出值
AWS SSM 跨步骤传递PowerShell生成变量到被调用文档的实现方法
完全可以实现这类跨步骤的参数传递,不需要依赖临时文件、参数存储等额外中间组件,依托SSM原生的步骤输出引用机制即可完成,具体配置逻辑如下:
第一步:将PowerShell生成的$var暴露为可引用的步骤输出
你当前第一步使用aws:runPowerShellScript执行逻辑时,要注意SSM对脚本输出的捕获规则:
- 脚本运行在临时启动的PowerShell进程中,执行完成后进程就会销毁,脚本内部定义的
$var哈希变量本身没法被后续步骤直接读取 - 只有通过标准输出流输出的结构化JSON内容,才会被SSM解析为当前步骤的正式可引用输出。你需要把生成的
$var通过命令序列化为紧凑JSON后输出,对应写在PowerShell脚本末尾的语句为:$var | ConvertTo-Json -Compress | Write-Output - 注意不要用
Write-Host输出需要传递的变量,这类内容只会被记录到步骤的运行日志里,不会被SSM纳入结构化输出范围
第二步:在调用目标文档时引用第一步的输出
在第二步配置aws:runDocument动作调用egsl_him_second文档时,通过SSM原生的动态占位语法,直接把第一步的输出映射为被调用文档的入参即可:
- 占位符语法格式为
{{ 第一步的步骤名称.Output.<$var里对应的自定义属性名> }} - 举个配置示例:如果第一步的步骤名叫
BuildCustomInput,你在PowerShell里生成的$var结构为@{ TenantId = "001"; AppVersion = "v2.3.1" },那么在第二步的Parameters配置块里,就可以用{{ BuildCustomInput.Output.TenantId }}、{{ BuildCustomInput.Output.AppVersion }}作为实际传值
配置注意事项
- 提前在被调用的
egsl_him_second独立文档的输入参数定义块里,声明好需要接收的参数名称、类型,和主文档传递的参数一一对应,未定义的参数无法被目标文档接收 - 如果
$var是多层嵌套的哈希结构,SSM支持通过点号逐层引用嵌套属性,不需要手动拍平结构 - 如果脚本执行过程中有多段零散输出,SSM会自动识别最后一段可解析的JSON为正式的步骤输出,前面的普通日志不会干扰结构化结果的读取
内容的提问来源于stack exchange,提问作者Himanshu Rai
相关产品推荐
相关产品推荐

