Class ReceiptRule
- java.lang.Object
-
- software.amazon.awssdk.services.ses.model.ReceiptRule
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<ReceiptRule.Builder,ReceiptRule>
@Generated("software.amazon.awssdk:codegen") public final class ReceiptRule extends Object implements SdkPojo, Serializable, ToCopyableBuilder<ReceiptRule.Builder,ReceiptRule>
Receipt rules enable you to specify which actions Amazon SES should take when it receives mail on behalf of one or more email addresses or domains that you own.
Each receipt rule defines a set of email addresses or domains that it applies to. If the email addresses or domains match at least one recipient address of the message, Amazon SES executes all of the receipt rule's actions on the message.
For information about setting up receipt rules, see the Amazon SES Developer Guide.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceReceiptRule.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description List<ReceiptAction>actions()An ordered list of actions to perform on messages that match at least one of the recipient email addresses or domains specified in the receipt rule.static ReceiptRule.Builderbuilder()Booleanenabled()Iftrue, the receipt rule is active.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasActions()For responses, this returns true if the service returned a value for the Actions property.inthashCode()booleanhasRecipients()For responses, this returns true if the service returned a value for the Recipients property.Stringname()The name of the receipt rule.List<String>recipients()The recipient domains and email addresses that the receipt rule applies to.BooleanscanEnabled()Iftrue, then messages that this receipt rule applies to are scanned for spam and viruses.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends ReceiptRule.Builder>serializableBuilderClass()TlsPolicytlsPolicy()Specifies whether Amazon SES should require that incoming email is delivered over a connection encrypted with Transport Layer Security (TLS).StringtlsPolicyAsString()Specifies whether Amazon SES should require that incoming email is delivered over a connection encrypted with Transport Layer Security (TLS).ReceiptRule.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
name
public final String name()
The name of the receipt rule. The name must meet the following requirements:
-
Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), dashes (-), or periods (.).
-
Start and end with a letter or number.
-
Contain 64 characters or fewer.
- Returns:
- The name of the receipt rule. The name must meet the following requirements:
-
Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), dashes (-), or periods (.).
-
Start and end with a letter or number.
-
Contain 64 characters or fewer.
-
-
-
enabled
public final Boolean enabled()
If
true, the receipt rule is active. The default value isfalse.- Returns:
- If
true, the receipt rule is active. The default value isfalse.
-
tlsPolicy
public final TlsPolicy tlsPolicy()
Specifies whether Amazon SES should require that incoming email is delivered over a connection encrypted with Transport Layer Security (TLS). If this parameter is set to
Require, Amazon SES bounces emails that are not received over TLS. The default isOptional.If the service returns an enum value that is not available in the current SDK version,
tlsPolicywill returnTlsPolicy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtlsPolicyAsString().- Returns:
- Specifies whether Amazon SES should require that incoming email is delivered over a connection encrypted
with Transport Layer Security (TLS). If this parameter is set to
Require, Amazon SES bounces emails that are not received over TLS. The default isOptional. - See Also:
TlsPolicy
-
tlsPolicyAsString
public final String tlsPolicyAsString()
Specifies whether Amazon SES should require that incoming email is delivered over a connection encrypted with Transport Layer Security (TLS). If this parameter is set to
Require, Amazon SES bounces emails that are not received over TLS. The default isOptional.If the service returns an enum value that is not available in the current SDK version,
tlsPolicywill returnTlsPolicy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtlsPolicyAsString().- Returns:
- Specifies whether Amazon SES should require that incoming email is delivered over a connection encrypted
with Transport Layer Security (TLS). If this parameter is set to
Require, Amazon SES bounces emails that are not received over TLS. The default isOptional. - See Also:
TlsPolicy
-
hasRecipients
public final boolean hasRecipients()
For responses, this returns true if the service returned a value for the Recipients property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
recipients
public final List<String> recipients()
The recipient domains and email addresses that the receipt rule applies to. If this field is not specified, this rule matches all recipients on all verified domains.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasRecipients()method.- Returns:
- The recipient domains and email addresses that the receipt rule applies to. If this field is not specified, this rule matches all recipients on all verified domains.
-
hasActions
public final boolean hasActions()
For responses, this returns true if the service returned a value for the Actions property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
actions
public final List<ReceiptAction> actions()
An ordered list of actions to perform on messages that match at least one of the recipient email addresses or domains specified in the receipt rule.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasActions()method.- Returns:
- An ordered list of actions to perform on messages that match at least one of the recipient email addresses or domains specified in the receipt rule.
-
scanEnabled
public final Boolean scanEnabled()
If
true, then messages that this receipt rule applies to are scanned for spam and viruses. The default value isfalse.- Returns:
- If
true, then messages that this receipt rule applies to are scanned for spam and viruses. The default value isfalse.
-
toBuilder
public ReceiptRule.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<ReceiptRule.Builder,ReceiptRule>
-
builder
public static ReceiptRule.Builder builder()
-
serializableBuilderClass
public static Class<? extends ReceiptRule.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-