{"id":20385126,"url":"https://github.com/poad/get-aws-ssm-parameter","last_synced_at":"2026-05-04T17:34:32.820Z","repository":{"id":65262427,"uuid":"589116968","full_name":"poad/get-aws-ssm-parameter","owner":"poad","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-11T23:49:46.000Z","size":152820,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-14T10:49:18.891Z","etag":null,"topics":["aws","github-actions"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/poad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-01-15T05:20:02.000Z","updated_at":"2024-04-15T23:26:51.307Z","dependencies_parsed_at":"2023-09-28T04:33:10.767Z","dependency_job_id":"ea1600ed-3785-46b8-bfd9-ee2e6afe3fc3","html_url":"https://github.com/poad/get-aws-ssm-parameter","commit_stats":{"total_commits":57,"total_committers":3,"mean_commits":19.0,"dds":"0.21052631578947367","last_synced_commit":"42a31f5c7d83c1665b956c5e8bda869805176944"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":"actions/typescript-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poad%2Fget-aws-ssm-parameter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poad%2Fget-aws-ssm-parameter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poad%2Fget-aws-ssm-parameter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/poad%2Fget-aws-ssm-parameter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/poad","download_url":"https://codeload.github.com/poad/get-aws-ssm-parameter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241935267,"owners_count":20044827,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","github-actions"],"created_at":"2024-11-15T02:32:32.657Z","updated_at":"2026-05-04T17:34:32.815Z","avatar_url":"https://github.com/poad.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub Action to get value from AWS Systems Manager Parameter Store\n\n[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](LICENSE)\n[![PRs welcome!](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![version](https://img.shields.io/github/v/release/poad/get-aws-ssm-parameter?display_name=tag\u0026include_prereleases\u0026sort=semver)](VERSION)\n\n## Usage\n\n```yaml\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n    - name: 'Get value from Parameter Store'\n      id: parameter\n      uses: poad/get-aws-ssm-parameter@v3.1.0\n      with: \n        parameter-name: /example/parameter\n        aws-region: us-west-2\n        decryption: false\n  \n    - name: 'Another example step'\n      run: echo ${{ steps.parameter.outputs.value }}\n```\n\n### Ignoring parameter not found error\n\nWhen `ignore-parameter-not-found` is set to `true`, the action will not fail even if the specified parameter does not exist. The output `value` will be an empty string.\n\n```yaml\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n    - name: 'Get value from Parameter Store (may not exist)'\n      id: parameter\n      uses: poad/get-aws-ssm-parameter@v3.1.0\n      with: \n        parameter-name: /example/optional-parameter\n        aws-region: us-west-2\n        decryption: false\n        ignore-parameter-not-found: true\n  \n    - name: 'Check if parameter exists'\n      run: |\n        if [ -n \"${{ steps.parameter.outputs.value }}\" ]; then\n          echo \"Parameter exists: ${{ steps.parameter.outputs.value }}\"\n        else\n          echo \"Parameter does not exist\"\n        fi\n```\n\n## Additional Arguments\n\n| Name | Required | Default | Description |\n| ---- | -------- | ------- | ----------- |\n| `parameter-name` | true | - | Parameter name |\n| `aws-region` | true | - | AWS region |\n| `decryption` | true | false | Value specified for WithDecryption |\n| `ignore-parameter-not-found` | false | false | If true, the action will not fail when the specified parameter does not exist |\n\n## Outputs\n\nThe action outputs an string to the action output named `value`.  You can access and manipulate this data using [workflow expressions](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/contexts-and-expression-syntax-for-github-actions#steps-context).\n\n## Contributing\n\nWe welcome your interest in contributing to this project. Please read the [Contribution Guidelines](CONTRIBUTING.md) for more guidance.\n\n## License\n\nAny contributions made under this project will be governed by the [MIT License](LICENSE)\n\n## Security Policy\n\nSee [SECURITY.md](./SECURITY.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpoad%2Fget-aws-ssm-parameter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpoad%2Fget-aws-ssm-parameter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpoad%2Fget-aws-ssm-parameter/lists"}