[MrForward]

Issue number: closes #8595

Summary

Changes

• GetSecretError now subclasses GetParameterError instead of Exception, so it matches the Raises GetParameterError docstrings on get_secrets_by_name and SecretsProvider.get_multiple, and matches what get_secret already raises.
• GetSecretError is now exported from aws_lambda_powertools.utilities.parameters alongside GetParameterError.
• Added a functional test asserting except GetParameterError catches a get_multiple failure and that the class is exported.

No behaviour change for code that already catches GetSecretError.

User experience

Before: except GetParameterError: around get_secrets_by_name(...) did not catch batch failures; callers had to import GetSecretError from the private secrets or exceptions module.

After:

from aws_lambda_powertools.utilities.parameters import GetParameterError, get_secrets_by_name

try:
    secrets = get_secrets_by_name(["a", "b"])
except GetParameterError:  # now also catches GetSecretError
    ...

Verified locally: tests/functional/parameters (139 passed), ruff format --check, ruff check, mypy on the parameters package.

AI disclosure: implemented with Claude Code assistance; reviewed and tested by me.

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[boring-cyborg]

Thanks a lot for your first contribution! Please check out our contributing guidelines and don't hesitate to ask whatever you need.
In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: Invite link

[leandrodamascena]

Thanks @MrForward, this is the right fix. The docstrings on get_secrets_by_name and SecretsProvider.get_multiple already said GetParameterError, the code just never kept that promise. I ran it against a real Secrets Manager with missing names and an empty list and except GetParameterError now catches all of them, and the export from the package is a nice touch.

I'm approving now. This goes out in 3.39.0, so it will sit here for a while before I merge it. No rebase needed in the meantime, and you'll be credited in the release notes.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.95%. Comparing base (df93108) to head (ce5fe07).
⚠️ Report is 2 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #8611   +/-   ##
========================================
  Coverage    96.95%   96.95%           
========================================
  Files          321      321           
  Lines        16253    16253           
  Branches      1453     1453           
========================================
  Hits         15758    15758           
  Misses         353      353           
  Partials       142      142           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[boring-cyborg]

Awesome work, congrats on your first merged pull request and thank you for helping improve everyone's experience!

[powertools-for-aws-oss-automation]

Awesome work, congrats on your first merged pull request and thank you for helping improve everyone's experience!