aws-ssm-tool 2024.3.13.0.39

AWS SSM tool

aws-ssm-tool
	SSM tool is a small helper for interacting with Amazon Simple Systems Manager, focusing on secrets storage/retrieval.

---

• Overview
• Installation
• Usage

---

Overview

The AWS SSM Parameter-Store is great, but can be awkward to work with via the awscli tool. This project provides the ssm tool as an alternative interface with simple CRUD. It also supports moving or copying trees of multiple parameters, and performing those operations across multiple AWS profiles.

See setup.cfg to find the latest info about required versions of boto. There are other dependencies, including the popular click library for CLI support and rich for pretty output.

See the Usage section for more details.

---

Installation

See pypi for available releases.

pip install aws-ssm-tool

---

Usage

After installation, you can invoke this tool as either ssm or python -m ssm.

Usage info follows:

Usage info follows:

$ ssm --help

Usage: ssm [OPTIONS] COMMAND [ARGS]...

  SSM tool, a small helper for interacting with Amazon Simple Systems Manager
  for secrets storage/retrieval.

Options:
  --help  Show this message and exit.

Commands:
  copy       copies a secret from given source to destination
  delete     deletes secret (keeping a local-backup is default)
  get-many   gets many secrets from specified hierarchy/namespace
  list       Lists parameters with prefixes below the given path.
  list-dirs  lists subpaths (i.e.
  move       moves a secret from src to dest
  move-many  moves a whole path of secrets to a new location
  put-many   put many secrets
  read       reads a secret
  stat       reports status, including account details and metadata...
  update     updates secret in given location with new value
  cp         ALIAS for `copy`
  get        ALIAS for `read`
  get-path   ALIAS for `get-many`
  ls         ALIAS for `list`
  ls-dirs    ALIAS for `list-dirs`
  move-path  ALIAS for `move-many`
  mv         ALIAS for `move`
  mv-many    ALIAS for `move-many`
  mv-path    ALIAS for `move-many`
  put        ALIAS for `update`
  put-path   ALIAS for `put-many`
  rm         ALIAS for `delete`
  set        ALIAS for `update`
  st         ALIAS for `stat`

See the integration tests for more examples.

---