pub struct Client { /* private fields */ }
Expand description

Client for Amazon Simple Email Service

Client for invoking operations on Amazon Simple Email Service. Each operation on Amazon Simple Email Service is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Examples

Constructing a client and invoking an operation

    // create a shared configuration. This can be used & shared between multiple service clients.
    let shared_config = aws_config::load_from_env().await;
    let client = aws_sdk_sesv2::Client::new(&shared_config);
    // invoke an operation
    /* let rsp = client
        .<operation_name>().
        .<param>("some value")
        .send().await; */

Constructing a client with custom configuration

use aws_config::RetryConfig;
    let shared_config = aws_config::load_from_env().await;
    let config = aws_sdk_sesv2::config::Builder::from(&shared_config)
        .retry_config(RetryConfig::disabled())
        .build();
    let client = aws_sdk_sesv2::Client::from_conf(config);

Implementations

Creates a client with the given service configuration.

Returns the client’s configuration.

Constructs a fluent builder for the CreateConfigurationSet operation.

Constructs a fluent builder for the CreateConfigurationSetEventDestination operation.

Constructs a fluent builder for the CreateContact operation.

Constructs a fluent builder for the CreateContactList operation.

Constructs a fluent builder for the CreateCustomVerificationEmailTemplate operation.

Constructs a fluent builder for the CreateDedicatedIpPool operation.

Constructs a fluent builder for the CreateDeliverabilityTestReport operation.

Constructs a fluent builder for the CreateEmailIdentity operation.

Constructs a fluent builder for the CreateEmailIdentityPolicy operation.

Constructs a fluent builder for the CreateEmailTemplate operation.

Constructs a fluent builder for the CreateImportJob operation.

Constructs a fluent builder for the DeleteConfigurationSet operation.

Constructs a fluent builder for the DeleteConfigurationSetEventDestination operation.

Constructs a fluent builder for the DeleteContact operation.

Constructs a fluent builder for the DeleteContactList operation.

Constructs a fluent builder for the DeleteCustomVerificationEmailTemplate operation.

Constructs a fluent builder for the DeleteDedicatedIpPool operation.

Constructs a fluent builder for the DeleteEmailIdentity operation.

Constructs a fluent builder for the DeleteEmailIdentityPolicy operation.

Constructs a fluent builder for the DeleteEmailTemplate operation.

Constructs a fluent builder for the DeleteSuppressedDestination operation.

Constructs a fluent builder for the GetAccount operation.

  • The fluent builder takes no input, just send it.
  • On success, responds with GetAccountOutput with field(s):
    • dedicated_ip_auto_warmup_enabled(bool):

      Indicates whether or not the automatic warm-up feature is enabled for dedicated IP addresses that are associated with your account.

    • enforcement_status(Option<String>):

      The reputation status of your Amazon SES account. The status can be one of the following:

      • HEALTHY – There are no reputation-related issues that currently impact your account.

      • PROBATION – We’ve identified potential issues with your Amazon SES account. We’re placing your account under review while you work on correcting these issues.

      • SHUTDOWN – Your account’s ability to send email is currently paused because of an issue with the email sent from your account. When you correct the issue, you can contact us and request that your account’s ability to send email is resumed.

    • production_access_enabled(bool):

      Indicates whether or not your account has production access in the current Amazon Web Services Region.

      If the value is false, then your account is in the sandbox. When your account is in the sandbox, you can only send email to verified identities. Additionally, the maximum number of emails you can send in a 24-hour period (your sending quota) is 200, and the maximum number of emails you can send per second (your maximum sending rate) is 1.

      If the value is true, then your account has production access. When your account has production access, you can send email to any address. The sending quota and maximum sending rate for your account vary based on your specific use case.

    • send_quota(Option<SendQuota>):

      An object that contains information about the per-day and per-second sending limits for your Amazon SES account in the current Amazon Web Services Region.

    • sending_enabled(bool):

      Indicates whether or not email sending is enabled for your Amazon SES account in the current Amazon Web Services Region.

    • suppression_attributes(Option<SuppressionAttributes>):

      An object that contains information about the email address suppression preferences for your account in the current Amazon Web Services Region.

    • details(Option<AccountDetails>):

      An object that defines your account details.

  • On failure, responds with SdkError<GetAccountError>

Constructs a fluent builder for the GetBlacklistReports operation.

Constructs a fluent builder for the GetConfigurationSet operation.

Constructs a fluent builder for the GetConfigurationSetEventDestinations operation.

Constructs a fluent builder for the GetContact operation.

Constructs a fluent builder for the GetContactList operation.

Constructs a fluent builder for the GetCustomVerificationEmailTemplate operation.

Constructs a fluent builder for the GetDedicatedIp operation.

Constructs a fluent builder for the GetDedicatedIps operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the GetDeliverabilityDashboardOptions operation.

Constructs a fluent builder for the GetDeliverabilityTestReport operation.

Constructs a fluent builder for the GetDomainDeliverabilityCampaign operation.

Constructs a fluent builder for the GetDomainStatisticsReport operation.

Constructs a fluent builder for the GetEmailIdentity operation.

Constructs a fluent builder for the GetEmailIdentityPolicies operation.

Constructs a fluent builder for the GetEmailTemplate operation.

Constructs a fluent builder for the GetImportJob operation.

Constructs a fluent builder for the GetSuppressedDestination operation.

Constructs a fluent builder for the ListConfigurationSets operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListContactLists operation. This operation supports pagination; See into_paginator().

  • The fluent builder is configurable:
    • page_size(i32) / set_page_size(Option<i32>):

      Maximum number of contact lists to return at once. Use this parameter to paginate results. If additional contact lists exist beyond the specified limit, the NextToken element is sent in the response. Use the NextToken value in subsequent requests to retrieve additional lists.

    • next_token(impl Into<String>) / set_next_token(Option<String>):

      A string token indicating that there might be additional contact lists available to be listed. Use the token provided in the Response to use in the subsequent call to ListContactLists with the same parameters to retrieve the next page of contact lists.

  • On success, responds with ListContactListsOutput with field(s):
  • On failure, responds with SdkError<ListContactListsError>

Constructs a fluent builder for the ListContacts operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListCustomVerificationEmailTemplates operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListDedicatedIpPools operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListDeliverabilityTestReports operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListDomainDeliverabilityCampaigns operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListEmailIdentities operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListEmailTemplates operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListImportJobs operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListSuppressedDestinations operation. This operation supports pagination; See into_paginator().

Constructs a fluent builder for the ListTagsForResource operation.

Constructs a fluent builder for the PutAccountDedicatedIpWarmupAttributes operation.

Constructs a fluent builder for the PutAccountDetails operation.

Constructs a fluent builder for the PutAccountSendingAttributes operation.

Constructs a fluent builder for the PutAccountSuppressionAttributes operation.

Constructs a fluent builder for the PutConfigurationSetDeliveryOptions operation.

Constructs a fluent builder for the PutConfigurationSetReputationOptions operation.

Constructs a fluent builder for the PutConfigurationSetSendingOptions operation.

Constructs a fluent builder for the PutConfigurationSetSuppressionOptions operation.

Constructs a fluent builder for the PutConfigurationSetTrackingOptions operation.

Constructs a fluent builder for the PutDedicatedIpInPool operation.

Constructs a fluent builder for the PutDedicatedIpWarmupAttributes operation.

Constructs a fluent builder for the PutDeliverabilityDashboardOption operation.

Constructs a fluent builder for the PutEmailIdentityConfigurationSetAttributes operation.

Constructs a fluent builder for the PutEmailIdentityDkimAttributes operation.

Constructs a fluent builder for the PutEmailIdentityDkimSigningAttributes operation.

  • The fluent builder is configurable:
  • On success, responds with PutEmailIdentityDkimSigningAttributesOutput with field(s):
    • dkim_status(Option<DkimStatus>):

      The DKIM authentication status of the identity. Amazon SES determines the authentication status by searching for specific records in the DNS configuration for your domain. If you used Easy DKIM to set up DKIM authentication, Amazon SES tries to find three unique CNAME records in the DNS configuration for your domain.

      If you provided a public key to perform DKIM authentication, Amazon SES tries to find a TXT record that uses the selector that you specified. The value of the TXT record must be a public key that’s paired with the private key that you specified in the process of creating the identity.

      The status can be one of the following:

      • PENDING – The verification process was initiated, but Amazon SES hasn’t yet detected the DKIM records in the DNS configuration for the domain.

      • SUCCESS – The verification process completed successfully.

      • FAILED – The verification process failed. This typically occurs when Amazon SES fails to find the DKIM records in the DNS configuration of the domain.

      • TEMPORARY_FAILURE – A temporary issue is preventing Amazon SES from determining the DKIM authentication status of the domain.

      • NOT_STARTED – The DKIM verification process hasn’t been initiated for the domain.

    • dkim_tokens(Option<Vec<String>>):

      If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete.

      If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector that’s associated with your public key.

      Regardless of the DKIM authentication method you use, Amazon SES searches for the appropriate records in the DNS configuration of the domain for up to 72 hours.

  • On failure, responds with SdkError<PutEmailIdentityDkimSigningAttributesError>

Constructs a fluent builder for the PutEmailIdentityFeedbackAttributes operation.

Constructs a fluent builder for the PutEmailIdentityMailFromAttributes operation.

Constructs a fluent builder for the PutSuppressedDestination operation.

Constructs a fluent builder for the SendBulkEmail operation.

Constructs a fluent builder for the SendCustomVerificationEmail operation.

Constructs a fluent builder for the SendEmail operation.

Constructs a fluent builder for the TagResource operation.

Constructs a fluent builder for the TestRenderEmailTemplate operation.

Constructs a fluent builder for the UntagResource operation.

Constructs a fluent builder for the UpdateConfigurationSetEventDestination operation.

Constructs a fluent builder for the UpdateContact operation.

Constructs a fluent builder for the UpdateContactList operation.

Constructs a fluent builder for the UpdateCustomVerificationEmailTemplate operation.

Constructs a fluent builder for the UpdateEmailIdentityPolicy operation.

Constructs a fluent builder for the UpdateEmailTemplate operation.

Creates a client with the given service config and connector override.

Creates a new client from a shared config.

Creates a new client from the service Config.

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Performs the conversion.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more