Trabajo con versiones de parámetros

Cada vez que edita el valor de un parámetro, Parameter Store, una capacidad de AWS Systems Manager, crea una nueva versión del parámetro y conserva las versiones anteriores. Al crear inicialmente un parámetro, Parameter Store asigna la versión 1 a dicho parámetro. Cuando cambia el valor del parámetro, incrementa Parameter Store automáticamente el número de versión por uno. Puede ver los detalles, incluidos los valores, de todas las versiones del historial de un parámetro.

También puede especificar la versión de un parámetro que se va a utilizar en comandos API y documentos SSM; por ejemplo: ssm:MyParameter:3. Puede especificar un nombre de parámetro y un número de versión específico en las llamadas a la API y los documentos de &SSM;. Si no especifica un número de versión, el sistema utiliza automáticamente la versión más reciente. Si especifica el número de una versión que no existe, el sistema devuelve un error en lugar de recurrir a la versión más reciente o predeterminada del parámetro.

También puede utilizar versiones de parámetros para ver la cantidad de veces que ha cambiado un parámetro durante un período de tiempo. Las versiones de parámetros también proporcionan una capa de protección si un valor de parámetro se cambia accidentalmente.

Puede crear y mantener un máximo de 100 versiones de un parámetro. Después de crear 100 versiones de un parámetro, cada vez que cree una nueva versión, la versión más antigua del parámetro se elimina del historial para dejar espacio a la nueva versión.

Una excepción a esto es cuando ya hay 100 versiones de parámetros en el historial y se asigna una etiqueta de parámetro a la versión más antigua de un parámetro. En este caso, esa versión no se elimina del historial y se produce un error en la solicitud de crear una nueva versión de parámetro. Esta protección es para evitar que se eliminen las versiones de parámetros con etiquetas esenciales asignadas a ellas. Para continuar creando nuevos parámetros, primero mueva la etiqueta de la versión más antigua del parámetro a una más nueva para utilizarla en sus operaciones. Para obtener información acerca de cómo mover etiquetas de parámetros, consulte Mover una etiqueta de parámetro (consola) y Traslado de una etiqueta de parámetro (AWS CLI).

Los siguientes procedimientos muestran cómo editar un parámetro y, a continuación, verificar que ha creado una nueva versión. Puede utilizar los comandos get-parameter y get-parameters para ver las versiones de parámetros. Para obtener ejemplos sobre el uso de estos comandos, consulte GetParameter y GetParameters en la Referencia de la API AWS Systems Manager

Crear una nueva versión de un parámetro (consola)

Puede utilizar la consola de Systems Manager para crear una nueva versión de un parámetro y ver su historial de versiones.

Para crear una nueva versión de un parámetro

1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

2. En el panel de navegación, elija Parameter Store.

3. Seleccione el nombre de un parámetro que creó anteriormente. Para obtener información acerca de cómo crear un nuevo parámetro, consulte Creación de parámetros de Systems Manager.

4. Elija Editar.

5. En el cuadro Value (Valor), ingrese un nuevo valor y, a continuación, elija Save changes (Guardar cambios).

6. Elija el nombre del parámetro que acaba de actualizar. En la pestaña Información general, verifique que el número de versión se incrementa en 1 y verifique el nuevo valor.

7. Para ver el historial de todas las versiones de un parámetro, elija la ficha Historial .

Hacer referencia a una versión de parámetro

Puede hacer referencia a versiones específicas de parámetros en comandos, llamadas a la API y documentos de SSM utilizando el siguiente formato: ssm:parameter-name:version-number.

En el ejemplo siguiente, Amazon Elastic Compute Cloud (Amazon EC2) run-instances command utiliza la versión 3 del parámetro 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

nota

El uso de resolve y un valor de parámetro solo funciona con la opción --image-id y un parámetro que contenga una Amazon Machine Image (AMI) como su valor. Para obtener más información, consulte Compatibilidad con parámetros nativos para los ID de Amazon Machine Image.

A continuación se muestra un ejemplo para especificar la versión 2 de un parámetro denominado MyRunCommandParameter en 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}}"
                ]
            }
        }
    ]
}