@Generated(value="OracleSDKGenerator", comments="API Version: 20170907") public class EmailClient extends BaseSyncClient implements Email
Modifier and Type | Class and Description |
---|---|
static class |
EmailClient.Builder
Builder class for this client.
|
Modifier and Type | Field and Description |
---|---|
String |
clientCommonLibraryVersion
Compatible SDK version, provided by the codegen.
|
Optional<String> |
minimumClientCommonLibraryVersionFromClient
Minimum compatible SDK version, maybe provided by the codegen.
|
static Service |
SERVICE
Service instance for Email.
|
Constructor and Description |
---|
EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory)
Deprecated.
Use the
builder instead. |
EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators)
Deprecated.
Use the
builder instead. |
EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint)
Deprecated.
Use the
builder instead. |
EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator,
RequestSignerFactory defaultRequestSignerFactory,
Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories,
List<ClientConfigurator> additionalClientConfigurators,
String endpoint,
ExecutorService executorService)
Deprecated.
Use the
builder instead. |
EmailClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
Deprecated.
Use the
builder instead. |
EmailClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration)
Deprecated.
Use the
builder instead. |
EmailClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider,
ClientConfiguration configuration,
ClientConfigurator clientConfigurator)
Deprecated.
Use the
builder instead. |
Modifier and Type | Method and Description |
---|---|
static EmailClient.Builder |
builder()
Create a builder for this client.
|
ChangeEmailDomainCompartmentResponse |
changeEmailDomainCompartment(ChangeEmailDomainCompartmentRequest request)
Moves an email domain into a different compartment.
|
ChangeSenderCompartmentResponse |
changeSenderCompartment(ChangeSenderCompartmentRequest request)
Moves a sender into a different compartment.
|
void |
close() |
CreateDkimResponse |
createDkim(CreateDkimRequest request)
Creates a new DKIM for an email domain.
|
CreateEmailDomainResponse |
createEmailDomain(CreateEmailDomainRequest request)
Creates a new email domain.
|
CreateEmailReturnPathResponse |
createEmailReturnPath(CreateEmailReturnPathRequest request)
Creates a new email return path.
|
CreateSenderResponse |
createSender(CreateSenderRequest request)
Creates a sender for a tenancy in a given compartment.
|
CreateSuppressionResponse |
createSuppression(CreateSuppressionRequest request)
Adds recipient email addresses to the suppression list for a tenancy.
|
DeleteDkimResponse |
deleteDkim(DeleteDkimRequest request)
Deletes a DKIM.
|
DeleteEmailDomainResponse |
deleteEmailDomain(DeleteEmailDomainRequest request)
Deletes an email domain.
|
DeleteEmailReturnPathResponse |
deleteEmailReturnPath(DeleteEmailReturnPathRequest request)
Deletes an email return path.
|
DeleteSenderResponse |
deleteSender(DeleteSenderRequest request)
Deletes an approved sender for a tenancy in a given compartment for a provided
senderId . |
DeleteSuppressionResponse |
deleteSuppression(DeleteSuppressionRequest request)
Removes a suppressed recipient email address from the suppression list for a tenancy in a
given compartment for a provided
suppressionId . |
String |
getClientCommonLibraryVersion() |
protected ClientConfigurator |
getDefaultConfigurator() |
GetDkimResponse |
getDkim(GetDkimRequest request)
Retrieves the specified DKIM.
|
GetEmailConfigurationResponse |
getEmailConfiguration(GetEmailConfigurationRequest request)
Returns email configuration associated with the specified compartment.
|
GetEmailDomainResponse |
getEmailDomain(GetEmailDomainRequest request)
Retrieves the specified email domain.
|
GetEmailReturnPathResponse |
getEmailReturnPath(GetEmailReturnPathRequest request)
Retrieves the specified email return path.
|
String |
getEndpoint() |
Optional<String> |
getMinimumClientCommonLibraryVersionFromClient() |
EmailPaginators |
getPaginators()
Gets the pre-configured paginators available for list operations in this service which may
return multiple pages of data.
|
GetSenderResponse |
getSender(GetSenderRequest request)
Gets an approved sender for a given
senderId . |
GetSuppressionResponse |
getSuppression(GetSuppressionRequest request)
Gets the details of a suppressed recipient email address for a given
suppressionId . |
EmailWaiters |
getWaiters()
Gets the pre-configured waiters available for resources for this service.
|
GetWorkRequestResponse |
getWorkRequest(GetWorkRequestRequest request)
Gets the status of the work request with the given ID.
|
ListDkimsResponse |
listDkims(ListDkimsRequest request)
Lists DKIMs for an email domain.
|
ListEmailDomainsResponse |
listEmailDomains(ListEmailDomainsRequest request)
Lists email domains in the specified compartment.
|
ListEmailReturnPathsResponse |
listEmailReturnPaths(ListEmailReturnPathsRequest request)
Lists email return paths in the specified compartment or emaildomain.
|
ListSendersResponse |
listSenders(ListSendersRequest request)
Gets a collection of approved sender email addresses and sender IDs.
|
ListSuppressionsResponse |
listSuppressions(ListSuppressionsRequest request)
Gets a list of suppressed recipient email addresses for a user.
|
ListWorkRequestErrorsResponse |
listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Return a (paginated) list of errors for a given work request.
|
ListWorkRequestLogsResponse |
listWorkRequestLogs(ListWorkRequestLogsRequest request)
Return a (paginated) list of logs for a given work request.
|
ListWorkRequestsResponse |
listWorkRequests(ListWorkRequestsRequest request)
Lists the work requests in a compartment.
|
void |
populateServiceParametersInEndpoint(String endpoint,
Map<String,Object> requiredParametersMap)
Populate the parameters in the endpoint with its corresponding value and update the base
endpoint.
|
void |
refreshClient()
Rebuild the backing
HttpClient . |
void |
setEndpoint(String endpoint) |
void |
setRegion(Region region)
Sets the region to call (ex, Region.US_PHOENIX_1).
|
void |
setRegion(String regionId)
Sets the region to call (ex, ‘us-phoenix-1’).
|
void |
updateBaseEndpoint(String endpoint)
This method should be used for parameterized endpoint templates only.
|
UpdateDkimResponse |
updateDkim(UpdateDkimRequest request)
Modifies a DKIM.
|
UpdateEmailDomainResponse |
updateEmailDomain(UpdateEmailDomainRequest request)
Modifies an email domain.
|
UpdateEmailReturnPathResponse |
updateEmailReturnPath(UpdateEmailReturnPathRequest request)
Modifies an email return path.
|
UpdateSenderResponse |
updateSender(UpdateSenderRequest request)
Replaces the set of tags for a sender with the tags provided.
|
void |
useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)
This method should be used to enable or disable the use of realm-specific endpoint template.
|
clientCall
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
getEndpoint, refreshClient, setEndpoint, useRealmSpecificEndpointTemplate
close
public static final Service SERVICE
Service instance for Email.
public final String clientCommonLibraryVersion
@Deprecated public EmailClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)@Deprecated public EmailClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
@Deprecated public EmailClient(BasicAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
@Deprecated public EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
@Deprecated public EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
@Deprecated public EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
endpoint
- ClientBuilderBase.endpoint(java.lang.String)
@Deprecated public EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
endpoint
- ClientBuilderBase.endpoint(java.lang.String)
signingStrategyRequestSignerFactories
- ClientBuilderBase.signingStrategyRequestSignerFactories
@Deprecated public EmailClient(AbstractAuthenticationDetailsProvider authenticationDetailsProvider, ClientConfiguration configuration, ClientConfigurator clientConfigurator, RequestSignerFactory defaultRequestSignerFactory, Map<SigningStrategy,RequestSignerFactory> signingStrategyRequestSignerFactories, List<ClientConfigurator> additionalClientConfigurators, String endpoint, ExecutorService executorService)
builder
instead.Create a new client instance.
authenticationDetailsProvider
- The authentication details (see EmailClient.Builder.build(com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider)
)configuration
- ClientBuilderBase.configuration
clientConfigurator
- ClientBuilderBase.clientConfigurator(com.oracle.bmc.http.ClientConfigurator)
defaultRequestSignerFactory
- ClientBuilderBase.requestSignerFactory
additionalClientConfigurators
- ClientBuilderBase.additionalClientConfigurators
endpoint
- ClientBuilderBase.endpoint(java.lang.String)
signingStrategyRequestSignerFactories
- ClientBuilderBase.signingStrategyRequestSignerFactories
executorService
- EmailClient.Builder.executorService
public static EmailClient.Builder builder()
Create a builder for this client.
public void setRegion(Region region)
Email
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.
public void setRegion(String regionId)
Email
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
.
public ChangeEmailDomainCompartmentResponse changeEmailDomainCompartment(ChangeEmailDomainCompartmentRequest request)
Email
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.
changeEmailDomainCompartment
in interface Email
request
- The request object containing the details to sendpublic ChangeSenderCompartmentResponse changeSenderCompartment(ChangeSenderCompartmentRequest request)
Email
Moves a sender into a different compartment. When provided, If-Match is checked against ETag values of the resource.
changeSenderCompartment
in interface Email
request
- The request object containing the details to sendpublic CreateDkimResponse createDkim(CreateDkimRequest request)
Email
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.
createDkim
in interface Email
request
- The request object containing the details to sendpublic CreateEmailDomainResponse createEmailDomain(CreateEmailDomainRequest request)
Email
Creates a new email domain. Avoid entering confidential information.
createEmailDomain
in interface Email
request
- The request object containing the details to sendpublic CreateEmailReturnPathResponse createEmailReturnPath(CreateEmailReturnPathRequest request)
Email
Creates a new email return path. Avoid entering confidential information.
createEmailReturnPath
in interface Email
request
- The request object containing the details to sendpublic CreateSenderResponse createSender(CreateSenderRequest request)
Email
Creates a sender for a tenancy in a given compartment.
createSender
in interface Email
request
- The request object containing the details to sendpublic CreateSuppressionResponse createSuppression(CreateSuppressionRequest request)
Email
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.
createSuppression
in interface Email
request
- The request object containing the details to sendpublic DeleteDkimResponse deleteDkim(DeleteDkimRequest request)
Email
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.
deleteDkim
in interface Email
request
- The request object containing the details to sendpublic DeleteEmailDomainResponse deleteEmailDomain(DeleteEmailDomainRequest request)
Email
Deletes an email domain.
deleteEmailDomain
in interface Email
request
- The request object containing the details to sendpublic DeleteEmailReturnPathResponse deleteEmailReturnPath(DeleteEmailReturnPathRequest request)
Email
Deletes an email return path.
deleteEmailReturnPath
in interface Email
request
- The request object containing the details to sendpublic DeleteSenderResponse deleteSender(DeleteSenderRequest request)
Email
Deletes an approved sender for a tenancy in a given compartment for a provided senderId
.
deleteSender
in interface Email
request
- The request object containing the details to sendpublic DeleteSuppressionResponse deleteSuppression(DeleteSuppressionRequest request)
Email
Removes a suppressed recipient email address from the suppression list for a tenancy in a
given compartment for a provided suppressionId
.
deleteSuppression
in interface Email
request
- The request object containing the details to sendpublic GetDkimResponse getDkim(GetDkimRequest request)
Email
Retrieves the specified DKIM.
public GetEmailConfigurationResponse getEmailConfiguration(GetEmailConfigurationRequest request)
Email
Returns email configuration associated with the specified compartment.
getEmailConfiguration
in interface Email
request
- The request object containing the details to sendpublic GetEmailDomainResponse getEmailDomain(GetEmailDomainRequest request)
Email
Retrieves the specified email domain.
getEmailDomain
in interface Email
request
- The request object containing the details to sendpublic GetEmailReturnPathResponse getEmailReturnPath(GetEmailReturnPathRequest request)
Email
Retrieves the specified email return path.
getEmailReturnPath
in interface Email
request
- The request object containing the details to sendpublic GetSenderResponse getSender(GetSenderRequest request)
Email
Gets an approved sender for a given senderId
.
public GetSuppressionResponse getSuppression(GetSuppressionRequest request)
Email
Gets the details of a suppressed recipient email address for a given suppressionId
. Each
suppression is given a unique OCID.
getSuppression
in interface Email
request
- The request object containing the details to sendpublic GetWorkRequestResponse getWorkRequest(GetWorkRequestRequest request)
Email
Gets the status of the work request with the given ID.
getWorkRequest
in interface Email
request
- The request object containing the details to sendpublic ListDkimsResponse listDkims(ListDkimsRequest request)
Email
Lists DKIMs for an email domain.
public ListEmailDomainsResponse listEmailDomains(ListEmailDomainsRequest request)
Email
Lists email domains in the specified compartment.
listEmailDomains
in interface Email
request
- The request object containing the details to sendpublic ListEmailReturnPathsResponse listEmailReturnPaths(ListEmailReturnPathsRequest request)
Email
Lists email return paths in the specified compartment or emaildomain.
listEmailReturnPaths
in interface Email
request
- The request object containing the details to sendpublic ListSendersResponse listSenders(ListSendersRequest request)
Email
Gets a collection of approved sender email addresses and sender IDs.
listSenders
in interface Email
request
- The request object containing the details to sendpublic ListSuppressionsResponse listSuppressions(ListSuppressionsRequest request)
Email
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.
listSuppressions
in interface Email
request
- The request object containing the details to sendpublic ListWorkRequestErrorsResponse listWorkRequestErrors(ListWorkRequestErrorsRequest request)
Email
Return a (paginated) list of errors for a given work request.
listWorkRequestErrors
in interface Email
request
- The request object containing the details to sendpublic ListWorkRequestLogsResponse listWorkRequestLogs(ListWorkRequestLogsRequest request)
Email
Return a (paginated) list of logs for a given work request.
listWorkRequestLogs
in interface Email
request
- The request object containing the details to sendpublic ListWorkRequestsResponse listWorkRequests(ListWorkRequestsRequest request)
Email
Lists the work requests in a compartment.
listWorkRequests
in interface Email
request
- The request object containing the details to sendpublic UpdateDkimResponse updateDkim(UpdateDkimRequest request)
Email
Modifies a DKIM.
updateDkim
in interface Email
request
- The request object containing the details to sendpublic UpdateEmailDomainResponse updateEmailDomain(UpdateEmailDomainRequest request)
Email
Modifies an email domain.
updateEmailDomain
in interface Email
request
- The request object containing the details to sendpublic UpdateEmailReturnPathResponse updateEmailReturnPath(UpdateEmailReturnPathRequest request)
Email
Modifies an email return path.
updateEmailReturnPath
in interface Email
request
- The request object containing the details to sendpublic UpdateSenderResponse updateSender(UpdateSenderRequest request)
Email
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.
updateSender
in interface Email
request
- The request object containing the details to sendpublic EmailWaiters getWaiters()
Email
Gets the pre-configured waiters available for resources for this service.
getWaiters
in interface Email
public EmailPaginators getPaginators()
Email
Gets the pre-configured paginators available for list operations in this service which may
return multiple pages of data. These paginators provide an Iterable
interface so that service responses, or resources/records, can be iterated through without
having to manually deal with pagination and page tokens.
getPaginators
in interface Email
protected ClientConfigurator getDefaultConfigurator()
public void useRealmSpecificEndpointTemplate(boolean useOfRealmSpecificEndpointTemplateEnabled)
useOfRealmSpecificEndpointTemplateEnabled
- This flag can be set to true or false to
enable or disable the use of realm-specific endpoint template respectivelypublic final void populateServiceParametersInEndpoint(String endpoint, Map<String,Object> requiredParametersMap)
endpoint
- The endpoint template in userequiredParametersMap
- Map of parameter name as key and value set in request path or
query parameter as valuepublic final void updateBaseEndpoint(String endpoint)
endpoint
- The updated endpoint to usepublic final void setEndpoint(String endpoint)
public final String getEndpoint()
public final void refreshClient()
HttpClient
. This will call ClientConfigurator
s again, and
can be used to e.g. refresh the SSL certificate.public final void close()
close
in interface AutoCloseable
public String getClientCommonLibraryVersion()
Copyright © 2016–2024. All rights reserved.