自动化系统变量 - AWS Systems Manager
术语支持的场景不支持的场景

自动化系统变量

AWS Systems Manager 自动化运行手册使用以下变量。有关如何使用这些变量的示例，请查看 AWS-UpdateWindowsAmi 运行手册的 JSON 源。

查看 AWS-UpdateWindowsAmi 运行手册的 JSON 源

  1. 访问 https://console.aws.amazon.com/systems-manager/，打开 AWS Systems Manager 控制台。

  2. 在导航窗格中，选择文档。

  3. 在文档列表中，使用“搜索栏”或“搜索栏”右侧的数字选择运行手册 AWS-UpdateWindowsAmi。

  4. 选择内容选项卡。

系统变量

自动化运行手册目前支持以下系统变量。

Variable 详细信息

global:ACCOUNT_ID

在其中运行自动化的用户或角色的 AWS 账户 ID。

global:DATE

格式为 yyyy-MM-dd 的日期（运行时间）。

global:DATE_TIME

格式为 yyyy-MM-dd_HH.mm.ss 的日期和时间（运行时间）。

global:AWS_PARTITION

资源所处的分区。对于标准 AWS 区域，分区是 aws。对于位于其他分区中的资源，则分区是 aws-partitionname。例如，AWS GovCloud (US-West) 区域中资源的区域为 aws-us-gov。

global:REGION

运行手册在其中运行的区域。例如，us-east-2。
自动化变量

自动化运行手册支持以下自动化变量。

Variable 详细信息

automation:EXECUTION_ID

分配给当前自动化的唯一标识符。例如，1a2b3c-1a2b3c-1a2b3c-1a2b3c1a2b3c1a2b3c。

术语

以下术语描述了如何解析变量和参数。

租期 定义 示例

常量 ARN

无变量的有效 Amazon Resource Name (ARN)。

arn:aws:iam::123456789012:role/roleName

运行手册参数

在运行手册级别定义的参数（例如 instanceId）。可在替换基本字符串时使用该参数。系统会在启动执行时间提供该参数的值。

 
{ 
   "description": "Create Image Demo",
   "version": "0.3",
   "assumeRole": "Your_Automation_Assume_Role_ARN",
   "parameters":{ 
      "instanceId": { 
         "type": "String",
         "description": "Instance to create image from"
   }
}

系统变量

在评估运行手册的任何部分时，被替换到运行手册中的常规变量。

 
"activities": [ 
   { 
      "id": "copyImage",
      "activityType": "AWS-CopyImage",
      "maxAttempts": 1,
      "onFailure": "Continue",
      "inputs": { 
         "ImageName": "{{imageName}}",
         "SourceImageId": "{{sourceImageId}}",
         "SourceRegion": "{{sourceRegion}}",
         "Encrypted": true,
         "ImageDescription": "Test CopyImage Description created on {{global:DATE}}"
      }
   }
]

自动化变量

在评估运行手册的任何部分时，被替换到运行手册中且与自动化执行相关的变量。

 
{ 
   "name": "runFixedCmds",
   "action": "aws:runCommand",
   "maxAttempts": 1,
   "onFailure": "Continue",
   "inputs": { 
      "DocumentName": "AWS-RunPowerShellScript",
      "InstanceIds": [ 
         "{{LaunchInstance.InstanceIds}}"
      ],
      "Parameters": { 
         "commands": [ 
            "dir",
            "date",
            "“{{outputFormat}}” -f “left”,”right”,”{{global:DATE}}”,”{{automation:EXECUTION_ID}}”
         ]
      }
   }
}

Systems Manager 参数

在 AWS Systems Manager Parameter Store 内定义的变量。该参数不能在步骤输入中直接引用。访问该参数可能需要权限。

 

description: Launch new Windows test instance
schemaVersion: '0.3'
assumeRole: '{{AutomationAssumeRole}}'
parameters:
  AutomationAssumeRole:
    type: String
    default: ''
    description: >-
      (Required) The ARN of the role that allows Automation to perform the
      actions on your behalf. If no role is specified, Systems Manager
      Automation uses your IAM permissions to run this runbook.
  LatestAmi:
    type: String
    default: >-
      {{ssm:/aws/service/ami-windows-latest/Windows_Server-2016-English-Full-Base}}
    description: The latest Windows Server 2016 AMI queried from the public parameter.
mainSteps:
  - name: launchInstance
    action: 'aws:runInstances'
    maxAttempts: 3
    timeoutSeconds: 1200
    onFailure: Abort
    inputs:
      ImageId: '{{LatestAmi}}'
...

支持的场景

场景 注释 示例

创建时的常量 ARN assumeRole。

执行授权检查来验证是否允许调用用户传递给定的 assumeRole。

 
{
  "description": "Test all Automation resolvable parameters",
  "schemaVersion": "0.3",
  "assumeRole": "arn:aws:iam::123456789012:role/roleName",
  "parameters": { 
  ...

启动自动化时为 AssumeRole 提供的运行手册参数。

必须在运行手册的参数列表中定义。

 
{
  "description": "Test all Automation resolvable parameters",
  "schemaVersion": "0.3",
  "assumeRole": "{{dynamicARN}}",
  "parameters": {
 ...

启动时为运行手册参数提供的值。

客户提供要用于参数的值。需在运行手册的参数列表中定义在启动时提供的所有输入。

 
...
"parameters": {
    "amiId": {
      "type": "String",
      "default": "ami-12345678",
      "description": "list of commands to run as part of first step"
    },
...

“启动自动化执行”的输入包括：{"amiId" : ["ami-12345678"] }

在运行手册内容中引用的 Systems Manager 参数。

变量存在于客户账户中，或者是公开访问的参数，并且运行手册的 AssumeRole 有权访问该变量。创建时将执行检查，以确认 AssumeRole 都不能访问它。不能在步骤输入中直接引用参数。

 

...
parameters:
    LatestAmi:
    type: String
    default: >-
      {{ssm:/aws/service/ami-windows-latest/Windows_Server-2016-English-Full-Base}}
    description: The latest Windows Server 2016 AMI queried from the public parameter.
mainSteps:
  - name: launchInstance
    action: 'aws:runInstances'
    maxAttempts: 3
    timeoutSeconds: 1200
    onFailure: Abort
    inputs:
      ImageId: '{{LatestAmi}}'
...

在步骤定义中引用的系统变量

启动自动化时被替换到运行手册中的系统变量。注入到运行手册中的值与替换发生的时间相关。换言之，由于在运行步骤之间需要花费一定时间，因此在步骤 1 中注入的时间变量的值将与在步骤 3 中注入的值不同。无需在运行手册的参数列表中设置系统变量。

 
...
  "mainSteps": [
    {
      "name": "RunSomeCommands",
      "action": "aws:runCommand",
      "maxAttempts": 1,
      "onFailure": "Continue",
      "inputs": {
        "DocumentName": "AWS:RunPowerShell",
        "InstanceIds": ["{{LaunchInstance.InstanceIds}}"],
        "Parameters": {
            "commands" : [
                "echo {The time is now {{global:DATE_TIME}}}"
            ]
        }
    }
}, ...

在步骤定义中引用的自动化变量。

无需在运行手册的参数列表中设置自动化变量。唯一的受支持自动化变量是 自动化:EXECUTION_ID。

 
...
"mainSteps": [
    {
      "name": "invokeLambdaFunction",
      "action": "aws:invokeLambdaFunction",
      "maxAttempts": 1,
      "onFailure": "Continue",
      "inputs": {
        "FunctionName": "Hello-World-LambdaFunction",

"Payload" : "{ "executionId" : "{{automation:EXECUTION_ID}}" }"
      }
    }
...

在下一步的定义中参考上一步的输出。

这是一个参数重定向。可使用语法 {{stepName.OutputName}} 引用上一步的输出。客户不能将该语法用于运行手册参数。在引用步骤运行时解决此问题。运行手册的参数中未列出该参数。

 
...
"mainSteps": [
    {
      "name": "LaunchInstance",
      "action": "aws:runInstances",
      "maxAttempts": 1,
      "onFailure": "Continue",
      "inputs": {
        "ImageId": "{{amiId}}",
        "MinInstanceCount": 1,
        "MaxInstanceCount": 2
      }
    },
    {
      "name":"changeState",
      "action": "aws:changeInstanceState",
      "maxAttempts": 1,
      "onFailure": "Continue",
      "inputs": {
        "InstanceIds": ["{{LaunchInstance.InstanceIds}}"],
        "DesiredState": "terminated"
      }
    }

...

不支持的场景

场景 注释 示例

为 assumeRole 提供的 Systems Manager 参数创建时

不支持。

 
...

{
  "description": "Test all Automation resolvable parameters",
  "schemaVersion": "0.3",
  "assumeRole": "{{ssm:administratorRoleARN}}",
  "parameters": {

...

步骤输入中直接引用的 Systems Manager 参数。

在创建时返回 InvalidDocumentContent 异常。

 

...
mainSteps:
  - name: launchInstance
    action: 'aws:runInstances'
    maxAttempts: 3
    timeoutSeconds: 1200
    onFailure: Abort
    inputs:
      ImageId: '{{ssm:/aws/service/ami-windows-latest/Windows_Server-2016-English-Full-Base}}'
...

变量步骤定义

运行手册中步骤的定义由变量构建而成。

 
...

"mainSteps": [
    {
      "name": "LaunchInstance",
      "action": "aws:runInstances",
      "{{attemptModel}}": 1,
      "onFailure": "Continue",
      "inputs": {
        "ImageId": "ami-12345678",
        "MinInstanceCount": 1,
        "MaxInstanceCount": 2
      }

...

User supplies input : { "attemptModel" : "minAttempts" }

交叉引用运行手册参数

用户在启动时提供了输入参数，而该参数引用了运行手册中的另一参数。

 
...
"parameters": {
    "amiId": {
      "type": "String",
      "default": "ami-7f2e6015",
      "description": "list of commands to run as part of first step"
    },
    "alternateAmiId": {
      "type": "String",
      "description": "The alternate AMI to try if this first fails".

"default" : "{{amiId}}"
    },

...

多层扩展

运行手册定义了评估变量名称的变量。它位于变量分隔符（即 {{ }}）内，并扩展为变量/参数的值。

 
...
  "parameters": {
    "firstParameter": {
      "type": "String",
      "default": "param2",
      "description": "The parameter to reference"
    },
    "secondParameter": {
      "type": "String",
      "default" : "echo {Hello world}",
      "description": "What to run"
    }
  },
  "mainSteps": [{
      "name": "runFixedCmds",
      "action": "aws:runCommand",
      "maxAttempts": 1,
      "onFailure": "Continue",
      "inputs": {
        "DocumentName": "AWS-RunPowerShellScript",

"InstanceIds" : "{{LaunchInstance.InstanceIds}}",
        "Parameters": {
          "commands": [ "{{ {{firstParameter}} }}"]

}

...

Note: The customer intention here would be to run a command of "echo {Hello world}"

引用属于不同变量类型的运行手册步骤的输出

用户在后续步骤中引用前面运行手册步骤的输出。输出是一个不符合后续步骤中的操作要求的变量类型。

 
...
mainSteps:
- name: getImageId
  action: aws:executeAwsApi
  inputs:
    Service: ec2
    Api: DescribeImages
    Filters:  
    - Name: "name"
      Values: 
      - "{{ImageName}}"
  outputs:
  - Name: ImageIdList
    Selector: "$.Images"
    Type: "StringList"
- name: copyMyImages
  action: aws:copyImage
  maxAttempts: 3
  onFailure: Abort
  inputs:
    SourceImageId: {{getImageId.ImageIdList}}
    SourceRegion: ap-northeast-2
    ImageName: Encrypted Copies of LAMP base AMI in ap-northeast-2
    Encrypted: true 
... 
Note: You must provide the type required by the Automation action. 
In this case, aws:copyImage requires a "String" type variable but the preceding step outputs a "StringList" type variable.