aws-param-store

Module for loading parameter-store values from AWS SSM

Now updated to use the AWS SDK v3, only requiring the SSMClient module.

Features

* Gets parameters by name(s) or path
* Recursively resolves paths and decodes parameters by default
* Paginates results automatically
* Supports both synchronous and asynchronous querying of parameters
* Uses Promises for asynchronous calls
* Can run inside AWS Lambda environment
* Lightweight and does not require additional dependencies other than the AWS-SDK

Installation

Install via npm.

npm install aws-param-store-sdkv3 --save

Getting Started

``js
const awsParamStore = require( 'aws-param-store-sdkv3' );

awsParamStore.getParametersByPath( '/project1/service1/production' )
.then( (parameters) => {

// do something here
});
`

If your AWS region is not set in your environment variables, then it can be set programmatically by supplying
options when calling newQuery():

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

awsParamStore.getParametersByPath( '/project1/service1/production', { region: 'us-east-1' } )
.then( (parameters) => {

// do something here
});
`

API

$3

Most API method calls in this library have both asynchronous and synchronous versions.
When an asynchronous version is called, a Promise is returned to resolve the value
once the operation completes. When an options parameter is allowed, it can be used
to specify specific AWS service options such as the region. All of the
getParameter* methods will request that the values are decoded. If you require
further control, please use the parameterQuery() method.

$3

Gets a parameter by name. This method returns a promise that resolves the Parameter.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

awsParamStore.getParameter( '/project1/my-parameter', { region: 'us-east-1' } )
.then( (parameter) => {

// Parameter info object for '/project1/my-parameter'
});
`

$3

Gets a parameter by name. This method will block until the operation completes.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

let parameter = awsParamStore.getParameterSync( '/project1/my-parameter',
{ region: 'us-east-1' } );

// Parameter info object for '/project1/my-parameter'
`




$3

Gets one or more parameters by name. This method returns a promise that resolves
an object that contains Parameters and InvalidParameters.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

awsParamStore.getParameters( ['/project1/my-parameter1', '/project1/my-parameter2'],
{ region: 'us-east-1' } )
.then( (results) => {

// results.Parameters will contain an array of parameters that were found
// results.InvalidParameters will contain an array of parameters that were
// not found
});
`

$3

Gets one or more parameters by name. This method will
block until the operation completes, and will return an object that contains
Parameters and InvalidParameters.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

let results = awsParamStore.getParametersSync( ['/project1/my-parameter1', '/project1/my-parameter2'],
{ region: 'us-east-1' } );

// results.Parameters will contain an array of parameters that were found
// results.InvalidParameters will contain an array of parameters that were
// not found
`

$3

Gets parameters by recursively traversing the supplied path. This method returns
a promise that resolves the parameters that were found.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

awsParamStore.getParametersByPath( '/project1' )
.then( (parameters) => {

// parameters contains an array of parameter objects
});
`

$3

Gets parameters by recursively traversing the supplied path. This method will
block until the operation completes, and will return a list of matching
parameters.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

let parameters = awsParamStore.getParametersByPathSync( '/project1' );

// parameters contains an array of parameter objects
`

$3

Puts parameter. This method returns a promise that resolves to the version returned back.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

awsParamStore.putParameter('key', 'value1,value2', 'StringList', {region: 'us-east-1', Overwrite: false})
.then( (results) => {

// results is the version of the value created
});
`

$3

Puts parameter. This method. This method will block until the version returned back.

`js
const awsParamStore = require( 'aws-param-store-sdkv3' );

let results = awsParamStore.putParameterSync('key', 'securedstring', 'SecureString', {region: 'us-east-1'});

`

$3

Instances of ParameterQuery can be created by calling parameterQuery( [options] ).
This object is implementation behind the getParameter* methods, and allows further
control over how the calls are made to resolve parameters.

$3

Sets the path name not be queried. Returns a reference to the ParameterQuery
instance.

$3

Sets the name or names (if an array) to be queried. Returns a reference to the
ParameterQuery instance.

$3

Indicates that the decryption of the values is enabled/disabled. Returns a
reference to the ParameterQuery instance.

$3

Enables or disables recursive operations when resolving parameters by path.
Returns a reference to the ParameterQuery` instance.

$3

Executes the query based on path or name(s) that were selected. Returns a Promise
that resolves the parameter results.

$3

Executes the query based on path or name(s) that were selected. This operation
will block until complete.

License

BSD-3-Clause