SSM

@aws-lite/ssm

Maintained by: @architect

Install

npm i @aws-lite/ssm

Optionally install types:

npm i -D @aws-lite/ssm-types

Methods

DeleteParameter

Canonical AWS API doc

Properties

Name (string) [required]

The name of the parameter

Example

await aws.SSM.DeleteParameter({
  Name: String, // required
})

DeleteParameters

Canonical AWS API doc

Properties

Names (array) [required]

Array of parameter names to delete

Example

await aws.SSM.DeleteParameters({
  Names: Array, // required
})

GetParameter

Canonical AWS API doc

Properties

Name (string) [required]

The name of the parameter

WithDecryption (boolean)

Decrypt encrypted parameter values

Example

await aws.SSM.GetParameter({
  Name: String, // required
  WithDecryption: Boolean,
})

GetParameters

Canonical AWS API doc

Properties

Names (array) [required]

Array of parameter names to query

WithDecryption (boolean)

Decrypt encrypted parameter values

Example

await aws.SSM.GetParameters({
  Names: Array, // required
  WithDecryption: Boolean,
})

GetParametersByPath

Canonical AWS API doc

Properties

Path (string) [required]

Parameter path hierarchy, beginning with /

MaxResults (number)

Limit the maximum number of items returned

NextToken (string)

Pagination token to start the next set of results

ParameterFilters (array)

Array of filters to limit results

Recursive (boolean)

Retrieve all parameters within a hierarchy

WithDecryption (boolean)

Decrypt encrypted parameter values

paginate (boolean)

Enable automatic result pagination; use this instead of making your own individual pagination requests

Example

await aws.SSM.GetParametersByPath({
  Path: String, // required
  MaxResults: Number,
  NextToken: String,
  ParameterFilters: Array,
  Recursive: Boolean,
  WithDecryption: Boolean,
  paginate: Boolean,
})

PutParameter

Canonical AWS API doc

Properties

Name (string) [required]

The name of the parameter, including the complete path hierarchy

Value (string) [required]

Value of the parameter; can be up to 4KB by default, or 8KB if Advanced

AllowedPattern (string)

Regular expression used to validate the parameter value

DataType (string)

Data type for a String parameter; can be one of: text, aws:ec2:image, aws:ssm:integration

Description (string)

Description of the parameter

KeyId (string)

AWS KMS ID to use to encrypt the parameter

Overwrite (boolean)

Overwrite an existing parameter (defaults to false)

Policies (array)

Array of policies to apply; supports Expiration, ExpirationNotification, NoChangeNotification

More details (AWS)
Tier (string)

Parameter tier; can be one of: Standard, Advanced, Intelligent-Tiering

Example
await aws.SSM.PutParameter({
  Name: String, // required
  Value: String, // required
  AllowedPattern: String,
  DataType: String,
  Description: String,
  KeyId: String,
  Overwrite: Boolean,
  Policies: Array,
  Tags: Array,
  Tier: String,
  Type: String,
})

Methods yet to be implemented

Please help out by opening a PR!

aws-lite is an Apache 2.0-licensed open source project under the umbrella of OpenJS Foundation Architect. aws-lite is not in any way affiliated with Amazon Web Services, Inc. (AWS). All names and trademarks are the property of their respective owners.