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 控制台创建一个新版本的参数。

根据您使用的服务 (AWS Systems Manager 或 Amazon EC2 Systems Manager),请采用下列过程之一:

创建新的参数版本 ( (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,并验证新值。

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

  1. 打开 Amazon EC2 控制台,展开导航窗格中的Systems Manager共享资源,然后选择 Parameter Store

  2. 选择您之前创建的一个参数。有关创建新参数的信息,请参阅创建 Systems Manager 参数

    注意

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

  3. 依次选择 ActionsEdit parameter

  4. Value 框中键入新的值,然后选择 Save parameter

  5. 在参数列表中选择刚刚更新的参数,然后选择 History 选项卡。验证版本号是否增加 1,并验证新值。