aws ssm get-parameter-history

Retrieves the history of all changes to a parameter. AWS CLI reference

1 example 4 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To get a value history for a parameter

The following get-parameter-history example lists the history of changes for the specified parameter, including its value.

aws ssm get-parameter-history --name "MyStringParameter"Identify

--nameThe name or Amazon Resource Name (ARN) of the parameter for which you want to review history.

Its output, shortened

{
    "Parameters": [
        {
            "Name": "MyStringParameter",
            "Type": "String",
            "LastModifiedDate": 1582154711.976,
            "LastModifiedUser": "arn:aws:iam::123456789012:user/Mary-Major",
            "Description": "This is the first version of my String parameter",
            "Value": "Veni",
            "Version": 1,
            "Labels": [],
            "Tier": "Standard",
            "Policies": []
        },
        {
            "Name": "MyStringParameter",
            "Type": "String",
            "LastModifiedDate": 1582156093.471,
            "LastModifiedUser": "arn:aws:iam::123456789012:user/Mary-Major",
            "Description": "This is the second version of my String parameter",
            "Value": "Vidi",
            "Version": 2,
            "Labels": [],
            "Tier": "Standard",
            "Policies": []
        },
        {
            "Name": "MyStringParameter",
            "Type": "String",
            "LastModifiedDate": 1582156117.545,
… 10 more lines

For more information, see Working with parameter versions in the AWS Systems Manager User Guide.

Options

4 in the AWS CLI reference

--max-resultsThe maximum number of items to return for this call.

--nameThe name or Amazon Resource Name (ARN) of the parameter for which you want to review history.

--next-tokenThe token for the next set of items to return.

--with-decryptionReturn decrypted values for secure string parameters.