Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
SPDX-License-Identifier: CC-BY-SA-4.0
A multi-expression that searches for the specified resource or resources in a search. All resource objects that satisfy the expression’s condition are included in the search results. You must specify at least one subexpression, filter, or nested filter. A SearchExpression
can contain up to twenty elements.
A SearchExpression
contains the following components: + A list of Filter
objects. Each filter defines a simple Boolean expression comprised of a resource property name, Boolean operator, and value. + A list of NestedFilter
objects. Each nested filter defines a list of Boolean expressions using a list of resource properties. A nested filter is satisfied if a single object in the list satisfies all Boolean expressions. + A list of SearchExpression
objects. A search expression object can be nested in a list of search expression objects. + A Boolean operator: And
or Or
.
Filters A list of filter objects.
Type: Array of Filter objects
Array Members: Minimum number of 1 item. Maximum number of 20 items.
Required: No
NestedFilters A list of nested filter objects.
Type: Array of NestedFilters objects
Array Members: Minimum number of 1 item. Maximum number of 20 items.
Required: No
Operator A Boolean operator used to evaluate the search expression. If you want every conditional statement in all lists to be satisfied for the entire search expression to be true, specify And
. If only a single conditional statement needs to be true for the entire search expression to be true, specify Or
. The default value is And
.
Type: String
Valid Values:And | Or
Required: No
SubExpressions A list of search expression objects.
Type: Array of SearchExpression objects
Array Members: Minimum number of 1 item. Maximum number of 20 items.
Required: No
For more information about using this API in one of the language-specific AWS SDKs, see the following: + AWS SDK for C++ + AWS SDK for Go + AWS SDK for Go - Pilot + AWS SDK for Java + AWS SDK for Ruby V2