AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

使用参数版本

在最初创建一个参数时,Parameter Store 为该参数分配版本 1。每次编辑参数时,Parameter Store 自动将其版本号增加 1。您可以在 API 调用和 SSM 文档中指定参数名和特定版本号。如果不指定版本号,系统自动使用最新版本。

参数版本针对意外更改参数的情况提供额外保护。您可以查看详细信息,包括所有版本的值。还可以使用参数版本查看一段时间内更改参数的次数。

可以使用以下格式,在命令、API 调用和 SSM 文档中引用包括旧版本在内的特定参数版本:{{ssm:parameter_name:version}}。以下示例是关于在 SSM 文档中指定的、名为 RunCommand 的参数:

{ "schemaVersion":"1.2", "description":"Run a shell script or specify the commands to run.", "parameters":{ "commands":{ "type":"StringList", "description":"(Required) Specify a shell script or a command to run.", "minItems":1, "displayType":"textarea", "default":"{{ssm:RunCommand:2}}" }, "executionTimeout":{ "type":"String", "default":"3600", "description":"(Optional) The time in seconds for a command to complete before it is considered to have failed. Default is 3600 (1 hour). Maximum is 172800 (48 hours).", "allowedPattern":"([1-9][0-9]{0,3})|(1[0-9]{1,4})|(2[0-7][0-9]{1,3})|(28[0-7][0-9]{1,2})|(28800)" } }, "runtimeConfig":{ "aws:runShellScript":{ "properties":[ { "id":"0.aws:runShellScript", "runCommand":"{{ commands }}", "timeoutSeconds":"{{ executionTimeout }}" } ] } } }

以下过程向您说明了如何编辑参数,并在之后验证是否已创建新版本。

创建新的参数版本 (控制台)

可以使用 Amazon EC2 控制台或 AWS Systems Manager 控制台创建一个新版本的参数。

创建新的参数版本

  1. 通过以下网址打开 AWS Systems Manager 控制台:https://console.amazonaws.cn/systems-manager/

  2. 在导航窗格中,选择 Parameter Store

    -或者-

    如果 AWS Systems Manager 主页首先打开,请选择菜单图标 ( ) 以打开导航窗格,然后选择 Parameter Store

  3. 选择之前创建的参数的名称。有关创建新参数的信息,请参阅创建 Systems Manager 参数

    注意

    参数只在创建它的区域可用。如果看不到要更新的参数,请验证您的区域。

  4. 选择 Edit

  5. Value 框中键入新的值,然后选择 Save changes

  6. 在参数列表中选择刚才更新的参数的名称,然后查看 History 选项卡。在 Overview 选项卡上,验证版本号是否增加 1,并验证新值。