使用參數版本 - AWS Systems Manager

若我們提供該指南英語版本的翻譯,在有任何牴觸的狀況下請以英文版本的指南為主。其透過機器翻譯提供翻譯。

使用參數版本

每次編輯參數的值時, 參數存放區 創造新的 版本 並保留之前的 版本。最初創建參數時, 參數存放區 分配版本 1 到該參數。更改參數的值時, 參數存放區 自動將版本號迭代一個。您可以查看詳細信息, 包括參數歷史中所有版本的值。

您還可以指定在API命令和SSM中使用的參數版本 文檔;例如: ssm:MyParameter:3。您可以指定參數 API調用和SSM文件中的名稱和特定版本號。如果您不 指定版本號,系統自動使用最新版本。

您可以使用參數版本來查看參數在 時間段。參數版本還可在參數 值意外更改。

您可以創建和維護最多100個版本的參數。之後, 創建了100個版本的參數,每次您創建一個新版本時, 從歷史記錄中刪除該參數版本,以便爲新版本騰出空間。

但歷史上已有100個參數版本, 並且參數標籤被分配給參數的最舊版本。在本 案例,該版本不會從歷史記錄中刪除,並且請求創建新的 參數版本失敗。該安全措施旨在防止參數版本 分配給他們的任務關鍵標籤從刪除。繼續創建 新的參數,首先將標籤從最舊的參數版本移動到 操作中使用的新版本。有關移動參數標籤的信息, 看到 移動參數 標籤(孔)移動參數標籤 (CLI).

以下步驟向您展示如何編輯參數,然後驗證 新版本已創建。

創建新版本 參數(孔)

您可以使用 AWS Systems Manager 控制檯,以創建參數的新版本,以及 查看參數的版本歷史記錄。

創建參數的新版本

  1. https://console.aws.amazon.com/systems-manager/,開啟 AWS Systems Manager 主控台。

  2. 在導覽窗格中,選擇 參數存放區

    -或-

    如果 AWS Systems Manager 首頁先開啟,請選擇選單圖示 ( ) 以開啟導覽窗格,然後選擇 參數存放區

  3. 選擇您之前創建的參數的名稱。對於 有關創建新參數的信息,請參閱 創建 Systems Manager 參數.

  4. 選擇 編輯.

  5. 價值 框,鍵入新值,然後 選擇 保存更改.

  6. 選擇您剛剛更新的參數名稱。在 概述 選項卡,驗證版本號 增加1,然後驗證新值。

  7. 要查看參數的所有版本的歷史記錄,請選擇 歷史 選項卡。

參考參數 版本

您可以在命令、API調用和SSM中引用特定參數版本 文檔:sm: parameter-name:version-number.

在以下示例中,參數版本3 golden-ami 用於EC2 run-instances command.

aws ec2 run-instances \ --image-id resolve:ssm:/golden-ami:3 \ --count 1 \ --instance-type t2.micro \ --key-name my-key-pair \ --security-groups my-security-group
注意

目前,使用 resolve 並且參數值只能 與 --image-id 選項和參數,其中包含 價值爲的admine機器圖像(AMI)。更多信息,請參閱 天然參數對alirocumab的支持 機器圖像ID.

以下是指定名爲的參數版本2的示例 MyRunCommandParameter SSM文件。

{ "schemaVersion": "2.2", "description": "Run a shell script or specify the commands to run.", "parameters": { "commands": { "type": "String", "description": "(Required) Specify a shell script or a command to run.", "displayType": "textarea", "default": "{{ssm:MyRunCommandParameter:2}}" } }, "mainSteps": [ { "action": "aws:runShellScript", "name": "RunScript", "inputs": { "runCommand": [ "{{commands}}" ] } } ] }