@Generated(value="OracleSDKGenerator", comments="API Version: 20170907") public interface EmailAsync extends AutoCloseable
Use the Email Delivery API to do the necessary set up to send high-volume and application-generated emails through the OCI Email Delivery service. For more information, see Overview of the Email Delivery Service.
*Note:** Write actions (POST, UPDATE, DELETE) may take several minutes to propagate and be reflected by the API. If a subsequent read request fails to reflect your changes, wait a few minutes and try again.
close
void refreshClient()
Rebuilds the client from scratch. Useful to refresh certificates.
void setEndpoint(String endpoint)
Sets the endpoint to call (ex, https://www.example.com).
endpoint
- The endpoint of the serice.String getEndpoint()
Gets the set endpoint for REST call (ex, https://www.example.com)
void setRegion(Region region)
Sets the region to call (ex, Region.US_PHOENIX_1).
Note, this will call setEndpoint
after resolving the
endpoint. If the service is not available in this region, however, an
IllegalArgumentException will be raised.
region
- The region of the service.void setRegion(String regionId)
Sets the region to call (ex, ‘us-phoenix-1’).
Note, this will first try to map the region ID to a known Region and call setRegion
.
If no known Region could be determined, it will create an endpoint based on the default
endpoint format (Region.formatDefaultRegionEndpoint(Service, String)
and then call setEndpoint
.
regionId
- The public region ID.void useRealmSpecificEndpointTemplate(boolean realmSpecificEndpointTemplateEnabled)
Determines whether realm specific endpoint should be used or not. Set realmSpecificEndpointTemplateEnabled to “true” if the user wants to enable use of realm specific endpoint template, otherwise set it to “false”
realmSpecificEndpointTemplateEnabled
- flag to enable the use of realm specific endpoint
templateFuture<ChangeEmailDomainCompartmentResponse> changeEmailDomainCompartment(ChangeEmailDomainCompartmentRequest request, AsyncHandler<ChangeEmailDomainCompartmentRequest,ChangeEmailDomainCompartmentResponse> handler)
Moves an email domain into a different compartment. When provided, If-Match is checked against ETag value of the resource. For information about moving resources between compartments, see Moving Resources to a Different Compartment.
*Note:** All DKIM objects associated with this email domain will also be moved into the provided compartment.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ChangeSenderCompartmentResponse> changeSenderCompartment(ChangeSenderCompartmentRequest request, AsyncHandler<ChangeSenderCompartmentRequest,ChangeSenderCompartmentResponse> handler)
Moves a sender into a different compartment. When provided, If-Match is checked against ETag values of the resource.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<CreateDkimResponse> createDkim(CreateDkimRequest request, AsyncHandler<CreateDkimRequest,CreateDkimResponse> handler)
Creates a new DKIM for an email domain. This DKIM signs all approved senders in the tenancy that are in this email domain. Best security practices indicate to periodically rotate the DKIM that is doing the signing. When a second DKIM is applied, all senders seamlessly pick up the new key without interruption in signing.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<CreateEmailDomainResponse> createEmailDomain(CreateEmailDomainRequest request, AsyncHandler<CreateEmailDomainRequest,CreateEmailDomainResponse> handler)
Creates a new email domain. Avoid entering confidential information.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<CreateEmailReturnPathResponse> createEmailReturnPath(CreateEmailReturnPathRequest request, AsyncHandler<CreateEmailReturnPathRequest,CreateEmailReturnPathResponse> handler)
Creates a new email return path. Avoid entering confidential information.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<CreateSenderResponse> createSender(CreateSenderRequest request, AsyncHandler<CreateSenderRequest,CreateSenderResponse> handler)
Creates a sender for a tenancy in a given compartment.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<CreateSuppressionResponse> createSuppression(CreateSuppressionRequest request, AsyncHandler<CreateSuppressionRequest,CreateSuppressionResponse> handler)
Adds recipient email addresses to the suppression list for a tenancy. Addresses added to the
suppression list via the API are denoted as "MANUAL" in the reason
field. Note: All
email addresses added to the suppression list are normalized to include only lowercase
letters.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<DeleteDkimResponse> deleteDkim(DeleteDkimRequest request, AsyncHandler<DeleteDkimRequest,DeleteDkimResponse> handler)
Deletes a DKIM. If this key is currently the active key for the email domain, deleting the key will stop signing the domain’s outgoing mail. DKIM keys are left in DELETING state for about a day to allow DKIM signatures on in-transit mail to be validated. Consider creating a new DKIM for this domain so the signing can be rotated to it instead of deletion.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<DeleteEmailDomainResponse> deleteEmailDomain(DeleteEmailDomainRequest request, AsyncHandler<DeleteEmailDomainRequest,DeleteEmailDomainResponse> handler)
Deletes an email domain.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<DeleteEmailReturnPathResponse> deleteEmailReturnPath(DeleteEmailReturnPathRequest request, AsyncHandler<DeleteEmailReturnPathRequest,DeleteEmailReturnPathResponse> handler)
Deletes an email return path.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<DeleteSenderResponse> deleteSender(DeleteSenderRequest request, AsyncHandler<DeleteSenderRequest,DeleteSenderResponse> handler)
Deletes an approved sender for a tenancy in a given compartment for a provided senderId
.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<DeleteSuppressionResponse> deleteSuppression(DeleteSuppressionRequest request, AsyncHandler<DeleteSuppressionRequest,DeleteSuppressionResponse> handler)
Removes a suppressed recipient email address from the suppression list for a tenancy in a
given compartment for a provided suppressionId
.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<GetDkimResponse> getDkim(GetDkimRequest request, AsyncHandler<GetDkimRequest,GetDkimResponse> handler)
Retrieves the specified DKIM.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<GetEmailConfigurationResponse> getEmailConfiguration(GetEmailConfigurationRequest request, AsyncHandler<GetEmailConfigurationRequest,GetEmailConfigurationResponse> handler)
Returns email configuration associated with the specified compartment.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<GetEmailDomainResponse> getEmailDomain(GetEmailDomainRequest request, AsyncHandler<GetEmailDomainRequest,GetEmailDomainResponse> handler)
Retrieves the specified email domain.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<GetEmailReturnPathResponse> getEmailReturnPath(GetEmailReturnPathRequest request, AsyncHandler<GetEmailReturnPathRequest,GetEmailReturnPathResponse> handler)
Retrieves the specified email return path.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<GetSenderResponse> getSender(GetSenderRequest request, AsyncHandler<GetSenderRequest,GetSenderResponse> handler)
Gets an approved sender for a given senderId
.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<GetSuppressionResponse> getSuppression(GetSuppressionRequest request, AsyncHandler<GetSuppressionRequest,GetSuppressionResponse> handler)
Gets the details of a suppressed recipient email address for a given suppressionId
. Each
suppression is given a unique OCID.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<GetWorkRequestResponse> getWorkRequest(GetWorkRequestRequest request, AsyncHandler<GetWorkRequestRequest,GetWorkRequestResponse> handler)
Gets the status of the work request with the given ID.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListDkimsResponse> listDkims(ListDkimsRequest request, AsyncHandler<ListDkimsRequest,ListDkimsResponse> handler)
Lists DKIMs for an email domain.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListEmailDomainsResponse> listEmailDomains(ListEmailDomainsRequest request, AsyncHandler<ListEmailDomainsRequest,ListEmailDomainsResponse> handler)
Lists email domains in the specified compartment.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListEmailReturnPathsResponse> listEmailReturnPaths(ListEmailReturnPathsRequest request, AsyncHandler<ListEmailReturnPathsRequest,ListEmailReturnPathsResponse> handler)
Lists email return paths in the specified compartment or emaildomain.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListSendersResponse> listSenders(ListSendersRequest request, AsyncHandler<ListSendersRequest,ListSendersResponse> handler)
Gets a collection of approved sender email addresses and sender IDs.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListSuppressionsResponse> listSuppressions(ListSuppressionsRequest request, AsyncHandler<ListSuppressionsRequest,ListSuppressionsResponse> handler)
Gets a list of suppressed recipient email addresses for a user. The compartmentId
for
suppressions must be a tenancy OCID. The returned list is sorted by creation time in
descending order.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListWorkRequestErrorsResponse> listWorkRequestErrors(ListWorkRequestErrorsRequest request, AsyncHandler<ListWorkRequestErrorsRequest,ListWorkRequestErrorsResponse> handler)
Return a (paginated) list of errors for a given work request.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListWorkRequestLogsResponse> listWorkRequestLogs(ListWorkRequestLogsRequest request, AsyncHandler<ListWorkRequestLogsRequest,ListWorkRequestLogsResponse> handler)
Return a (paginated) list of logs for a given work request.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<ListWorkRequestsResponse> listWorkRequests(ListWorkRequestsRequest request, AsyncHandler<ListWorkRequestsRequest,ListWorkRequestsResponse> handler)
Lists the work requests in a compartment.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<UpdateDkimResponse> updateDkim(UpdateDkimRequest request, AsyncHandler<UpdateDkimRequest,UpdateDkimResponse> handler)
Modifies a DKIM.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<UpdateEmailDomainResponse> updateEmailDomain(UpdateEmailDomainRequest request, AsyncHandler<UpdateEmailDomainRequest,UpdateEmailDomainResponse> handler)
Modifies an email domain.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<UpdateEmailReturnPathResponse> updateEmailReturnPath(UpdateEmailReturnPathRequest request, AsyncHandler<UpdateEmailReturnPathRequest,UpdateEmailReturnPathResponse> handler)
Modifies an email return path.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Future<UpdateSenderResponse> updateSender(UpdateSenderRequest request, AsyncHandler<UpdateSenderRequest,UpdateSenderResponse> handler)
Replaces the set of tags for a sender with the tags provided. If either freeform or defined tags are omitted, the tags for that set remain the same. Each set must include the full set of tags for the sender, partial updates are not permitted. For more information about tagging, see Resource Tags.
request
- The request object containing the details to sendhandler
- The request handler to invoke upon completion, may be null.Copyright © 2016–2024. All rights reserved.