Filter - Amazon Secrets Manager
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Allows you to add filters when you use the search function in Secrets Manager. For more information, see Find secrets in Secrets Manager.



The following are keys you can use:

  • description: Prefix match, not case-sensitive.

  • name: Prefix match, case-sensitive.

  • tag-key: Prefix match, case-sensitive.

  • tag-value: Prefix match, case-sensitive.

  • primary-region: Prefix match, case-sensitive.

  • owning-service: Prefix match, case-sensitive.

  • all: Breaks the filter value string into words and then searches all attributes for matches. Not case-sensitive.

Type: String

Valid Values: description | name | tag-key | tag-value | primary-region | owning-service | all

Required: No


The keyword to filter for.

You can prefix your search value with an exclamation mark (!) in order to perform negation filters.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 10 items.

Length Constraints: Maximum length of 512.

Pattern: ^\!?[a-zA-Z0-9 :_@\/\+\=\.\-\!]*$

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: