Utilizzo delle versioni dei parametri in Parameter Store

Ogni volta che modifichi il valore di un parametro, Parameter Store, una funzionalità di AWS Systems Manager crea una nuova versione del parametro e mantiene le versioni precedenti. Quando inizialmente crei un parametro, Parameter Store assegna la versione 1 a tale parametro. Quando modifichi il valore del parametro, Parameter Store incrementa automaticamente il numero di versione di uno. È possibile visualizzare i dettagli, inclusi i valori, di tutte le versioni nella cronologia di un parametro.

Inoltre, è possibile specificare la versione di un parametro da utilizzare nei comandi API e nei documenti SSM; ad esempio, ssm:MyParameter:3. È possibile specificare un nome di parametro e un numero di versione specifico nelle chiamate API e nei documenti SSM. Se non specifichi un numero di versione, il sistema utilizza in automatico la versione più recente. Se specifichi il numero di una versione che non esiste, il sistema restituisce un errore anziché ricorrere alla versione più recente o predefinita del parametro.

È possibile utilizzare le versioni di un parametro per visualizzare il numero di variazioni di tale parametro in un periodo di tempo. Le versioni dei parametri forniscono inoltre un livello di protezione se un valore del parametro viene modificato per errore.

È possibile creare e mantenere un massimo di 100 versioni di un parametro. Dopo aver creato 100 versioni di un parametro, ogni volta che si crea una nuova versione, la versione meno recente del parametro viene rimossa dalla cronologia per fare spazio alla nuova versione.

Un'eccezione è quando sono presenti già 100 versioni dei parametri nella cronologia e un'etichetta di parametro viene assegnata alla versione meno recente di un parametro. In questo caso, tale versione non viene rimossa dalla cronologia e la richiesta di creare una nuova versione dei parametri non riesce. Questa protezione serve a impedire l'eliminazione delle versioni dei parametri con etichette essenziali per l'organizzazione assegnate loro. Per continuare a creare nuovi parametri, spostare innanzitutto l'etichetta dalla versione meno recente del parametro a una più recente per utilizzarla nelle operazioni. Per informazioni sullo spostamento delle etichette dei parametri, vedere Spostare un'etichetta di parametro utilizzando la console e Spostare un'etichetta di parametro utilizzando la AWS CLI.

Nelle procedure seguenti viene illustrato come modificare un parametro e quindi verificare la creazione di una nuova versione. È possibile utilizzare il plugin get-parameter e get-parameters per visualizzare le versioni dei parametri. Per esempi sull'utilizzo di questi comandi, consulta GetParameter e GetParameters nella Documentazione di riferimento API AWS Systems Manager

Creare una nuova versione di un parametro utilizzando la console

È possibile utilizzare la console di Systems Manager per creare una nuova versione di un parametro e visualizzare la cronologia delle versioni di un parametro.

Riferirsi a una versione di parametro

È possibile fare riferimento a versioni di parametro specifiche nei comandi, nelle chiamate API e nei documenti SSM utilizzando il seguente formato: ssm: parameter-name:version-number.

Nel seguente esempio, Amazon Elastic Compute Cloud (Amazon EC2) run-instances command utilizza la versione 3 del parametro golden-ami.

Linux & macOS

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

Windows

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

Di seguito è riportato un esempio di specifica della versione 2 di un parametro denominato MyRunCommandParameter in un documento SSM.

YAML

---
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}}"

JSON

{
    "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}}"
                ]
            }
        }
    ]
}