AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a receipt rule.

For information about setting up receipt rules, see the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Note:

For PCL and Unity this operation is only available in asynchronous form. Please refer to CreateReceiptRuleAsync.

Namespace: Amazon.SimpleEmail
Assembly: AWSSDK.SimpleEmail.dll
Version: 3.x.y.z

Syntax

C#
public virtual CreateReceiptRuleResponse CreateReceiptRule(
         CreateReceiptRuleRequest request
)
Parameters
request
Type: Amazon.SimpleEmail.Model.CreateReceiptRuleRequest

Container for the necessary parameters to execute the CreateReceiptRule service method.

Return Value
The response from the CreateReceiptRule service method, as returned by SimpleEmailService.

Exceptions

ExceptionCondition
AlreadyExistsException Indicates that a resource could not be created because of a naming conflict.
InvalidLambdaFunctionException Indicates that the provided AWS Lambda function is invalid, or that Amazon SES could not execute the provided function, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.
InvalidS3ConfigurationException Indicates that the provided Amazon S3 bucket or AWS KMS encryption key is invalid, or that Amazon SES could not publish to the bucket, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.
InvalidSnsTopicException Indicates that the provided Amazon SNS topic is invalid, or that Amazon SES could not publish to the topic, possibly due to permissions issues. For information about giving permissions, see the Amazon SES Developer Guide.
LimitExceededException Indicates that a resource could not be created because of service limits. For a list of Amazon SES limits, see the Amazon SES Developer Guide.
RuleDoesNotExistException Indicates that the provided receipt rule does not exist.
RuleSetDoesNotExistException Indicates that the provided receipt rule set does not exist.

Examples

The following example creates a new receipt rule:

CreateReceiptRule


var response = client.CreateReceiptRule(new CreateReceiptRuleRequest 
{
    After = "",
    Rule = new ReceiptRule {
        Actions = new List {
            new ReceiptAction { S3Action = new S3Action {
                BucketName = "MyBucket",
                ObjectKeyPrefix = "email"
            } }
        },
        Enabled = true,
        Name = "MyRule",
        ScanEnabled = true,
        TlsPolicy = "Optional"
    },
    RuleSetName = "MyRuleSet"
});


            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

Unity:
Supported Versions: 4.6 and above
Supported Platforms: Android, iOS, Standalone

See Also