@Generated(value="com.ibm.cos.v2:codegen") public final class FilterRule extends Object implements SdkPojo, Serializable, ToCopyableBuilder<FilterRule.Builder,FilterRule>
Specifies the Amazon S3 object key name to filter on. An object key name is the name assigned to an object in your
Amazon S3 bucket. You specify whether to filter on the suffix or prefix of the object key name. A prefix is a
specific string of characters at the beginning of an object key name, which you can use to organize objects. For
example, you can start the key names of related objects with a prefix, such as 2023- or
engineering/. Then, you can use FilterRule to find objects in a bucket with key names that
have the same prefix. A suffix is similar to a prefix, but it is at the end of the object key name instead of at the
beginning.
| Modifier and Type | Class and Description |
|---|---|
static interface |
FilterRule.Builder |
| Modifier and Type | Method and Description |
|---|---|
static FilterRule.Builder |
builder() |
boolean |
equals(Object obj) |
boolean |
equalsBySdkFields(Object obj) |
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
int |
hashCode() |
FilterRuleName |
name()
The object key name prefix or suffix identifying one or more objects to which the filtering rule applies.
|
String |
nameAsString()
The object key name prefix or suffix identifying one or more objects to which the filtering rule applies.
|
Map<String,SdkField<?>> |
sdkFieldNameToField() |
List<SdkField<?>> |
sdkFields() |
static Class<? extends FilterRule.Builder> |
serializableBuilderClass() |
FilterRule.Builder |
toBuilder() |
String |
toString()
Returns a string representation of this object.
|
String |
value()
The value that the filter searches for in object key names.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, waitcopypublic final FilterRuleName name()
The object key name prefix or suffix identifying one or more objects to which the filtering rule applies. The maximum length is 1,024 characters. Overlapping prefixes and suffixes are not supported. For more information, see Configuring Event Notifications in the Amazon S3 User Guide.
If the service returns an enum value that is not available in the current SDK version, name will return
FilterRuleName.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
nameAsString().
FilterRuleNamepublic final String nameAsString()
The object key name prefix or suffix identifying one or more objects to which the filtering rule applies. The maximum length is 1,024 characters. Overlapping prefixes and suffixes are not supported. For more information, see Configuring Event Notifications in the Amazon S3 User Guide.
If the service returns an enum value that is not available in the current SDK version, name will return
FilterRuleName.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
nameAsString().
FilterRuleNamepublic final String value()
The value that the filter searches for in object key names.
public FilterRule.Builder toBuilder()
toBuilder in interface ToCopyableBuilder<FilterRule.Builder,FilterRule>public static FilterRule.Builder builder()
public static Class<? extends FilterRule.Builder> serializableBuilderClass()
public final boolean equalsBySdkFields(Object obj)
equalsBySdkFields in interface SdkPojopublic final String toString()
public final Map<String,SdkField<?>> sdkFieldNameToField()
sdkFieldNameToField in interface SdkPojoCopyright © 2026. All rights reserved.