/* * Copyright 2010-2020 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ package com.amazonaws.services.simpleemail.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; /** *

* Composes an email message and immediately queues it for sending. *

* This operation is more flexible than the SendEmail API * operation. When you use the SendRawEmail operation, you can * specify the headers of the message as well as its content. This flexibility * is useful, for example, when you want to send a multipart MIME email (such a * message that contains both a text and an HTML version). You can also use this * operation to send messages that include attachments. *

* The SendRawEmail operation has the following requirements: *

*
* You can only send email from verified email addresses or domains. If you try to send email from an * address that isn't verified, the operation results in an * "Email address not verified" error. *
*
*
* If your account is still in the Amazon SES sandbox, you can only send email to other verified addresses * in your account, or to addresses that are associated with the Amazon SES mailbox simulator. *
*
*
* The maximum message size, including attachments, is 10 MB. *
*
*
* Each message has to include at least one recipient address. A recipient * address includes any address on the To:, CC:, or BCC: lines. *
*
*
* If you send a single message to more than one recipient address, and one of * the recipient addresses isn't in a valid format (that is, it's not in the * format UserName@[SubDomain.]Domain.TopLevelDomain), Amazon SES rejects * the entire message, even if the other addresses are valid. *
*
*
* Each message can include up to 50 recipient addresses across the To:, CC:, or * BCC: lines. If you need to send a single message to more than 50 recipients, * you have to split the list of recipient addresses into groups of less than 50 * recipients, and send separate messages to each group. *
*
*
* Amazon SES allows you to specify 8-bit Content-Transfer-Encoding for MIME * message parts. However, if Amazon SES has to modify the contents of your * message (for example, if you use open and click tracking), 8-bit content * isn't preserved. For this reason, we highly recommend that you encode all * content that isn't 7-bit ASCII. For more information, see MIME Encoding in the Amazon SES Developer Guide. *
*

* Additionally, keep the following considerations in mind when using the * SendRawEmail operation: *

*
* Although you can customize the message headers when using the * SendRawEmail operation, Amazon SES will automatically apply its * own Message-ID and Date headers; if you passed * these headers when creating the message, they will be overwritten by the * values that Amazon SES provides. *
*
*
* If you are using sending authorization to send on behalf of another user, * SendRawEmail enables you to specify the cross-account identity * for the email's Source, From, and Return-Path parameters in one of two ways: * you can pass optional parameters SourceArn, FromArn * , and/or ReturnPathArn to the API, or you can include the * following X-headers in the header of your raw email: *
*
- *
  * X-SES-SOURCE-ARN *
  *
- *
  * X-SES-FROM-ARN *
  *
- *
  * X-SES-RETURN-PATH-ARN *
  *
* *
* Don't include these X-headers in the DKIM signature. Amazon SES removes these * before it sends the email. *
* *
* If you only specify the SourceIdentityArn parameter, Amazon SES * sets the From and Return-Path addresses to the same identity that you * specified. *
*
* For more information about sending authorization, see the Using Sending Authorization with Amazon SES in the Amazon SES * Developer Guide. *
*
*
* For every message that you send, the total number of recipients (including * each recipient in the To:, CC: and BCC: fields) is counted against the * maximum number of emails you can send in a 24-hour period (your sending * quota). For more information about sending quotas in Amazon SES, see Managing Your Amazon SES Sending Limits in the Amazon SES Developer * Guide. *
*

*/ public class SendRawEmailRequest extends AmazonWebServiceRequest implements Serializable { /** *

* The identity's email address. If you do not provide a value for this * parameter, you must specify a "From" address in the raw text of the * message. (You can also specify both.) *

* *

* Amazon SES does not support the SMTPUTF8 extension, as described inRFC6531. For this reason, * the local part of a source email address (the part of the email * address that precedes the @ sign) may only contain 7-bit ASCII * characters. If the domain part of an address (the part after * the @ sign) contains non-ASCII characters, they must be encoded using * Punycode, as described in RFC3492. The sender * name (also known as the friendly name) may contain non-ASCII * characters. These characters must be encoded using MIME encoded-word * syntax, as described in RFC * 2047. MIME encoded-word syntax uses the following form: * =?charset?encoding?encoded-text?=. *

* *

* If you specify the Source parameter and have feedback * forwarding enabled, then bounces and complaints will be sent to this * email address. This takes precedence over any Return-Path header that you * might include in the raw text of the message. *

*/ private String source; /** *

* A list of destinations for the message, consisting of To:, CC:, and BCC: * addresses. *

*/ private java.util.List destinations = new java.util.ArrayList(); /** *

* The raw email message itself. The message has to meet the following * criteria: *

*
* The message has to contain a header and a body, separated by a blank * line. *
*
*
* All of the required header fields must be present in the message. *
*
*
* Each part of a multipart MIME message must be formatted properly. *
*
*
* Attachments must be of a content type that Amazon SES supports. For a * list on unsupported content types, see Unsupported Attachment Types in the Amazon SES Developer * Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that is outside * of the 7-bit ASCII character range, we highly recommend that you encode * that content. For more information, see Sending Raw Email in the Amazon SES Developer Guide. *
*
*
* Per RFC * 5321, the maximum length of each line of text, including the * <CRLF>, must not exceed 1,000 characters. *
*

*/ private RawMessage rawMessage; /** *

* This parameter is used only for sending authorization. It is the ARN of * the identity that is associated with the sending authorization policy * that permits you to specify a particular "From" address in the header of * the raw email. *

* Instead of using this parameter, you can use the X-header * X-SES-FROM-ARN in the raw message of the email. If you use * both the FromArn parameter and the corresponding X-header, * Amazon SES uses the value of the FromArn parameter. *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* */ private String fromArn; /** *

* This parameter is used only for sending authorization. It is the ARN of * the identity that is associated with the sending authorization policy * that permits you to send for the email address specified in the * Source parameter. *

* For example, if the owner of example.com (which has ARN * arn:aws:ses:us-east-1:123456789012:identity/example.com) * attaches a policy to it that authorizes you to send from * user@example.com, then you would specify the * SourceArn to be * arn:aws:ses:us-east-1:123456789012:identity/example.com, and * the Source to be user@example.com. *

* Instead of using this parameter, you can use the X-header * X-SES-SOURCE-ARN in the raw message of the email. If you use * both the SourceArn parameter and the corresponding X-header, * Amazon SES uses the value of the SourceArn parameter. *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* */ private String sourceArn; /** *

* This parameter is used only for sending authorization. It is the ARN of * the identity that is associated with the sending authorization policy * that permits you to use the email address specified in the * ReturnPath parameter. *

* For example, if the owner of example.com (which has ARN * arn:aws:ses:us-east-1:123456789012:identity/example.com) * attaches a policy to it that authorizes you to use * feedback@example.com, then you would specify the * ReturnPathArn to be * arn:aws:ses:us-east-1:123456789012:identity/example.com, and * the ReturnPath to be feedback@example.com. *

* Instead of using this parameter, you can use the X-header * X-SES-RETURN-PATH-ARN in the raw message of the email. If * you use both the ReturnPathArn parameter and the * corresponding X-header, Amazon SES uses the value of the * ReturnPathArn parameter. *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* */ private String returnPathArn; /** *

* A list of tags, in the form of name/value pairs, to apply to an email * that you send using SendRawEmail. Tags correspond to * characteristics of the email that you define, so that you can publish * email sending events. *

*/ private java.util.List tags = new java.util.ArrayList(); /** *

* The name of the configuration set to use when you send an email using * SendRawEmail. *

*/ private String configurationSetName; /** * Default constructor for SendRawEmailRequest object. Callers should use * the setter or fluent setter (with...) methods to initialize any * additional object members. */ public SendRawEmailRequest() { } /** * Constructs a new SendRawEmailRequest object. Callers should use the * setter or fluent setter (with...) methods to initialize any additional * object members. * * @param rawMessage

* The raw email message itself. The message has to meet the * following criteria: *

*
* The message has to contain a header and a body, separated by a * blank line. *
*
*
* All of the required header fields must be present in the * message. *
*
*
* Each part of a multipart MIME message must be formatted * properly. *
*
*
* Attachments must be of a content type that Amazon SES * supports. For a list on unsupported content types, see Unsupported Attachment Types in the Amazon SES * Developer Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that * is outside of the 7-bit ASCII character range, we highly * recommend that you encode that content. For more information, * see Sending Raw Email in the Amazon SES Developer * Guide. *
*
*
* Per RFC 5321, the maximum length of each line of text, * including the <CRLF>, must not exceed 1,000 characters. *
*

*/ public SendRawEmailRequest(RawMessage rawMessage) { setRawMessage(rawMessage); } /** *

* The identity's email address. If you do not provide a value for this * parameter, you must specify a "From" address in the raw text of the * message. (You can also specify both.) *

* *

* * @return

* The identity's email address. If you do not provide a value for * this parameter, you must specify a "From" address in the raw text * of the message. (You can also specify both.) *

* *

* Amazon SES does not support the SMTPUTF8 extension, as described * inRFC6531. For * this reason, the local part of a source email address (the * part of the email address that precedes the @ sign) may only * contain 7-bit ASCII characters. If the domain part of an * address (the part after the @ sign) contains non-ASCII * characters, they must be encoded using Punycode, as described in * RFC3492. * The sender name (also known as the friendly name) may * contain non-ASCII characters. These characters must be encoded * using MIME encoded-word syntax, as described in RFC 2047. MIME * encoded-word syntax uses the following form: * =?charset?encoding?encoded-text?=. *

* *

* If you specify the Source parameter and have * feedback forwarding enabled, then bounces and complaints will be * sent to this email address. This takes precedence over any * Return-Path header that you might include in the raw text of the * message. *

*/ public String getSource() { return source; } /** *

* The identity's email address. If you do not provide a value for this * parameter, you must specify a "From" address in the raw text of the * message. (You can also specify both.) *

* *

* * @param source

* The identity's email address. If you do not provide a value * for this parameter, you must specify a "From" address in the * raw text of the message. (You can also specify both.) *

* *

* Amazon SES does not support the SMTPUTF8 extension, as * described inRFC6531. For * this reason, the local part of a source email address * (the part of the email address that precedes the @ sign) may * only contain 7-bit * ASCII characters. If the domain part of an address * (the part after the @ sign) contains non-ASCII characters, * they must be encoded using Punycode, as described in RFC3492. * The sender name (also known as the friendly name) may * contain non-ASCII characters. These characters must be encoded * using MIME encoded-word syntax, as described in RFC 2047. MIME * encoded-word syntax uses the following form: * =?charset?encoding?encoded-text?=. *

* *

* If you specify the Source parameter and have * feedback forwarding enabled, then bounces and complaints will * be sent to this email address. This takes precedence over any * Return-Path header that you might include in the raw text of * the message. *

*/ public void setSource(String source) { this.source = source; } /** *

* The identity's email address. If you do not provide a value for this * parameter, you must specify a "From" address in the raw text of the * message. (You can also specify both.) *

* *

* Returns a reference to this object so that method calls can be chained * together. * * @param source

* The identity's email address. If you do not provide a value * for this parameter, you must specify a "From" address in the * raw text of the message. (You can also specify both.) *

* *

* @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withSource(String source) { this.source = source; return this; } /** *

* A list of destinations for the message, consisting of To:, CC:, and BCC: * addresses. *

* * @return

* A list of destinations for the message, consisting of To:, CC:, * and BCC: addresses. *

*/ public java.util.List getDestinations() { return destinations; } /** *

* A list of destinations for the message, consisting of To:, CC:, and BCC: * addresses. *

* * @param destinations

* A list of destinations for the message, consisting of To:, * CC:, and BCC: addresses. *

*/ public void setDestinations(java.util.Collection destinations) { if (destinations == null) { this.destinations = null; return; } this.destinations = new java.util.ArrayList(destinations); } /** *

* A list of destinations for the message, consisting of To:, CC:, and BCC: * addresses. *

* Returns a reference to this object so that method calls can be chained * together. * * @param destinations

* A list of destinations for the message, consisting of To:, * CC:, and BCC: addresses. *

* @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withDestinations(String... destinations) { if (getDestinations() == null) { this.destinations = new java.util.ArrayList(destinations.length); } for (String value : destinations) { this.destinations.add(value); } return this; } /** *

* A list of destinations for the message, consisting of To:, CC:, and BCC: * addresses. *

* Returns a reference to this object so that method calls can be chained * together. * * @param destinations

* A list of destinations for the message, consisting of To:, * CC:, and BCC: addresses. *

* @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withDestinations(java.util.Collection destinations) { setDestinations(destinations); return this; } /** *

* The raw email message itself. The message has to meet the following * criteria: *

*
* The message has to contain a header and a body, separated by a blank * line. *
*
*
* All of the required header fields must be present in the message. *
*
*
* Each part of a multipart MIME message must be formatted properly. *
*
*
* Attachments must be of a content type that Amazon SES supports. For a * list on unsupported content types, see Unsupported Attachment Types in the Amazon SES Developer * Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that is outside * of the 7-bit ASCII character range, we highly recommend that you encode * that content. For more information, see Sending Raw Email in the Amazon SES Developer Guide. *
*
*
* Per RFC * 5321, the maximum length of each line of text, including the * <CRLF>, must not exceed 1,000 characters. *
*

* * @return

* The raw email message itself. The message has to meet the * following criteria: *

*
* The message has to contain a header and a body, separated by a * blank line. *
*
*
* All of the required header fields must be present in the message. *
*
*
* Each part of a multipart MIME message must be formatted properly. *
*
*
* Attachments must be of a content type that Amazon SES supports. * For a list on unsupported content types, see Unsupported Attachment Types in the Amazon SES Developer * Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that is * outside of the 7-bit ASCII character range, we highly recommend * that you encode that content. For more information, see Sending Raw Email in the Amazon SES Developer Guide. *
*
*
* Per RFC * 5321, the maximum length of each line of text, including the * <CRLF>, must not exceed 1,000 characters. *
*

*/ public RawMessage getRawMessage() { return rawMessage; } /** *

* The raw email message itself. The message has to meet the following * criteria: *

*
* The message has to contain a header and a body, separated by a blank * line. *
*
*
* All of the required header fields must be present in the message. *
*
*
* Each part of a multipart MIME message must be formatted properly. *
*
*
* Attachments must be of a content type that Amazon SES supports. For a * list on unsupported content types, see Unsupported Attachment Types in the Amazon SES Developer * Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that is outside * of the 7-bit ASCII character range, we highly recommend that you encode * that content. For more information, see Sending Raw Email in the Amazon SES Developer Guide. *
*
*
* Per RFC * 5321, the maximum length of each line of text, including the * <CRLF>, must not exceed 1,000 characters. *
*

* * @param rawMessage

* The raw email message itself. The message has to meet the * following criteria: *

*
* The message has to contain a header and a body, separated by a * blank line. *
*
*
* All of the required header fields must be present in the * message. *
*
*
* Each part of a multipart MIME message must be formatted * properly. *
*
*
* Attachments must be of a content type that Amazon SES * supports. For a list on unsupported content types, see Unsupported Attachment Types in the Amazon SES * Developer Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that * is outside of the 7-bit ASCII character range, we highly * recommend that you encode that content. For more information, * see Sending Raw Email in the Amazon SES Developer * Guide. *
*
*
* Per RFC 5321, the maximum length of each line of text, * including the <CRLF>, must not exceed 1,000 characters. *
*

*/ public void setRawMessage(RawMessage rawMessage) { this.rawMessage = rawMessage; } /** *

* The raw email message itself. The message has to meet the following * criteria: *

*
* The message has to contain a header and a body, separated by a blank * line. *
*
*
* All of the required header fields must be present in the message. *
*
*
* Each part of a multipart MIME message must be formatted properly. *
*
*
* Attachments must be of a content type that Amazon SES supports. For a * list on unsupported content types, see Unsupported Attachment Types in the Amazon SES Developer * Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that is outside * of the 7-bit ASCII character range, we highly recommend that you encode * that content. For more information, see Sending Raw Email in the Amazon SES Developer Guide. *
*
*
* Per RFC * 5321, the maximum length of each line of text, including the * <CRLF>, must not exceed 1,000 characters. *
*

* Returns a reference to this object so that method calls can be chained * together. * * @param rawMessage

* The raw email message itself. The message has to meet the * following criteria: *

*
* The message has to contain a header and a body, separated by a * blank line. *
*
*
* All of the required header fields must be present in the * message. *
*
*
* Each part of a multipart MIME message must be formatted * properly. *
*
*
* Attachments must be of a content type that Amazon SES * supports. For a list on unsupported content types, see Unsupported Attachment Types in the Amazon SES * Developer Guide. *
*
*
* The entire message must be base64-encoded. *
*
*
* If any of the MIME parts in your message contain content that * is outside of the 7-bit ASCII character range, we highly * recommend that you encode that content. For more information, * see Sending Raw Email in the Amazon SES Developer * Guide. *
*
*
* Per RFC 5321, the maximum length of each line of text, * including the <CRLF>, must not exceed 1,000 characters. *
*

* @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withRawMessage(RawMessage rawMessage) { this.rawMessage = rawMessage; return this; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* * * @return

* This parameter is used only for sending authorization. It is the * ARN of the identity that is associated with the sending * authorization policy that permits you to specify a particular * "From" address in the header of the raw email. *

* Instead of using this parameter, you can use the X-header * X-SES-FROM-ARN in the raw message of the email. If * you use both the FromArn parameter and the * corresponding X-header, Amazon SES uses the value of the * FromArn parameter. *

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* */ public String getFromArn() { return fromArn; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* * * @param fromArn

* This parameter is used only for sending authorization. It is * the ARN of the identity that is associated with the sending * authorization policy that permits you to specify a particular * "From" address in the header of the raw email. *

* Instead of using this parameter, you can use the X-header * X-SES-FROM-ARN in the raw message of the email. * If you use both the FromArn parameter and the * corresponding X-header, Amazon SES uses the value of the * FromArn parameter. *

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* */ public void setFromArn(String fromArn) { this.fromArn = fromArn; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* *

* Returns a reference to this object so that method calls can be chained * together. * * @param fromArn

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* * @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withFromArn(String fromArn) { this.fromArn = fromArn; return this; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* * * @return

* This parameter is used only for sending authorization. It is the * ARN of the identity that is associated with the sending * authorization policy that permits you to send for the email * address specified in the Source parameter. *

* For example, if the owner of example.com (which has * ARN * arn:aws:ses:us-east-1:123456789012:identity/example.com * ) attaches a policy to it that authorizes you to send from * user@example.com, then you would specify the * SourceArn to be * arn:aws:ses:us-east-1:123456789012:identity/example.com * , and the Source to be user@example.com * . *

* Instead of using this parameter, you can use the X-header * X-SES-SOURCE-ARN in the raw message of the email. If * you use both the SourceArn parameter and the * corresponding X-header, Amazon SES uses the value of the * SourceArn parameter. *

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* */ public String getSourceArn() { return sourceArn; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* * * @param sourceArn

* This parameter is used only for sending authorization. It is * the ARN of the identity that is associated with the sending * authorization policy that permits you to send for the email * address specified in the Source parameter. *

* For example, if the owner of example.com (which * has ARN * arn:aws:ses:us-east-1:123456789012:identity/example.com * ) attaches a policy to it that authorizes you to send from * user@example.com, then you would specify the * SourceArn to be * arn:aws:ses:us-east-1:123456789012:identity/example.com * , and the Source to be * user@example.com. *

* Instead of using this parameter, you can use the X-header * X-SES-SOURCE-ARN in the raw message of the email. * If you use both the SourceArn parameter and the * corresponding X-header, Amazon SES uses the value of the * SourceArn parameter. *

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* */ public void setSourceArn(String sourceArn) { this.sourceArn = sourceArn; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* *

* Returns a reference to this object so that method calls can be chained * together. * * @param sourceArn

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* * @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withSourceArn(String sourceArn) { this.sourceArn = sourceArn; return this; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* * * @return

* This parameter is used only for sending authorization. It is the * ARN of the identity that is associated with the sending * authorization policy that permits you to use the email address * specified in the ReturnPath parameter. *

* For example, if the owner of example.com (which has * ARN * arn:aws:ses:us-east-1:123456789012:identity/example.com * ) attaches a policy to it that authorizes you to use * feedback@example.com, then you would specify the * ReturnPathArn to be * arn:aws:ses:us-east-1:123456789012:identity/example.com * , and the ReturnPath to be * feedback@example.com. *

* Instead of using this parameter, you can use the X-header * X-SES-RETURN-PATH-ARN in the raw message of the * email. If you use both the ReturnPathArn parameter * and the corresponding X-header, Amazon SES uses the value of the * ReturnPathArn parameter. *

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* */ public String getReturnPathArn() { return returnPathArn; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* * * @param returnPathArn

* This parameter is used only for sending authorization. It is * the ARN of the identity that is associated with the sending * authorization policy that permits you to use the email address * specified in the ReturnPath parameter. *

* For example, if the owner of example.com (which * has ARN * arn:aws:ses:us-east-1:123456789012:identity/example.com * ) attaches a policy to it that authorizes you to use * feedback@example.com, then you would specify the * ReturnPathArn to be * arn:aws:ses:us-east-1:123456789012:identity/example.com * , and the ReturnPath to be * feedback@example.com. *

* Instead of using this parameter, you can use the X-header * X-SES-RETURN-PATH-ARN in the raw message of the * email. If you use both the ReturnPathArn * parameter and the corresponding X-header, Amazon SES uses the * value of the ReturnPathArn parameter. *

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* */ public void setReturnPathArn(String returnPathArn) { this.returnPathArn = returnPathArn; } /** *

* *

* For information about when to use this parameter, see the description of * SendRawEmail in this guide, or see the Amazon SES Developer Guide. *

* *

* Returns a reference to this object so that method calls can be chained * together. * * @param returnPathArn

* *

* For information about when to use this parameter, see the * description of SendRawEmail in this guide, or see * the Amazon SES Developer Guide. *

* * @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withReturnPathArn(String returnPathArn) { this.returnPathArn = returnPathArn; return this; } /** *

* * @return

* A list of tags, in the form of name/value pairs, to apply to an * email that you send using SendRawEmail. Tags * correspond to characteristics of the email that you define, so * that you can publish email sending events. *

*/ public java.util.List getTags() { return tags; } /** *

* * @param tags

* A list of tags, in the form of name/value pairs, to apply to * an email that you send using SendRawEmail. Tags * correspond to characteristics of the email that you define, so * that you can publish email sending events. *

*/ public void setTags(java.util.Collection tags) { if (tags == null) { this.tags = null; return; } this.tags = new java.util.ArrayList(tags); } /** *

* Returns a reference to this object so that method calls can be chained * together. * * @param tags

* @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withTags(MessageTag... tags) { if (getTags() == null) { this.tags = new java.util.ArrayList(tags.length); } for (MessageTag value : tags) { this.tags.add(value); } return this; } /** *

* Returns a reference to this object so that method calls can be chained * together. * * @param tags

* @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withTags(java.util.Collection tags) { setTags(tags); return this; } /** *

* The name of the configuration set to use when you send an email using * SendRawEmail. *

* * @return

* The name of the configuration set to use when you send an email * using SendRawEmail. *

*/ public String getConfigurationSetName() { return configurationSetName; } /** *

* The name of the configuration set to use when you send an email using * SendRawEmail. *

* * @param configurationSetName

* The name of the configuration set to use when you send an * email using SendRawEmail. *

*/ public void setConfigurationSetName(String configurationSetName) { this.configurationSetName = configurationSetName; } /** *

* The name of the configuration set to use when you send an email using * SendRawEmail. *

* Returns a reference to this object so that method calls can be chained * together. * * @param configurationSetName

* The name of the configuration set to use when you send an * email using SendRawEmail. *

* @return A reference to this updated object so that method calls can be * chained together. */ public SendRawEmailRequest withConfigurationSetName(String configurationSetName) { this.configurationSetName = configurationSetName; return this; } /** * Returns a string representation of this object; useful for testing and * debugging. * * @return A string representation of this object. * @see java.lang.Object#toString() */ @Override public String toString() { StringBuilder sb = new StringBuilder(); sb.append("{"); if (getSource() != null) sb.append("Source: " + getSource() + ","); if (getDestinations() != null) sb.append("Destinations: " + getDestinations() + ","); if (getRawMessage() != null) sb.append("RawMessage: " + getRawMessage() + ","); if (getFromArn() != null) sb.append("FromArn: " + getFromArn() + ","); if (getSourceArn() != null) sb.append("SourceArn: " + getSourceArn() + ","); if (getReturnPathArn() != null) sb.append("ReturnPathArn: " + getReturnPathArn() + ","); if (getTags() != null) sb.append("Tags: " + getTags() + ","); if (getConfigurationSetName() != null) sb.append("ConfigurationSetName: " + getConfigurationSetName()); sb.append("}"); return sb.toString(); } @Override public int hashCode() { final int prime = 31; int hashCode = 1; hashCode = prime * hashCode + ((getSource() == null) ? 0 : getSource().hashCode()); hashCode = prime * hashCode + ((getDestinations() == null) ? 0 : getDestinations().hashCode()); hashCode = prime * hashCode + ((getRawMessage() == null) ? 0 : getRawMessage().hashCode()); hashCode = prime * hashCode + ((getFromArn() == null) ? 0 : getFromArn().hashCode()); hashCode = prime * hashCode + ((getSourceArn() == null) ? 0 : getSourceArn().hashCode()); hashCode = prime * hashCode + ((getReturnPathArn() == null) ? 0 : getReturnPathArn().hashCode()); hashCode = prime * hashCode + ((getTags() == null) ? 0 : getTags().hashCode()); hashCode = prime * hashCode + ((getConfigurationSetName() == null) ? 0 : getConfigurationSetName().hashCode()); return hashCode; } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (obj instanceof SendRawEmailRequest == false) return false; SendRawEmailRequest other = (SendRawEmailRequest) obj; if (other.getSource() == null ^ this.getSource() == null) return false; if (other.getSource() != null && other.getSource().equals(this.getSource()) == false) return false; if (other.getDestinations() == null ^ this.getDestinations() == null) return false; if (other.getDestinations() != null && other.getDestinations().equals(this.getDestinations()) == false) return false; if (other.getRawMessage() == null ^ this.getRawMessage() == null) return false; if (other.getRawMessage() != null && other.getRawMessage().equals(this.getRawMessage()) == false) return false; if (other.getFromArn() == null ^ this.getFromArn() == null) return false; if (other.getFromArn() != null && other.getFromArn().equals(this.getFromArn()) == false) return false; if (other.getSourceArn() == null ^ this.getSourceArn() == null) return false; if (other.getSourceArn() != null && other.getSourceArn().equals(this.getSourceArn()) == false) return false; if (other.getReturnPathArn() == null ^ this.getReturnPathArn() == null) return false; if (other.getReturnPathArn() != null && other.getReturnPathArn().equals(this.getReturnPathArn()) == false) return false; if (other.getTags() == null ^ this.getTags() == null) return false; if (other.getTags() != null && other.getTags().equals(this.getTags()) == false) return false; if (other.getConfigurationSetName() == null ^ this.getConfigurationSetName() == null) return false; if (other.getConfigurationSetName() != null && other.getConfigurationSetName().equals(this.getConfigurationSetName()) == false) return false; return true; } }