@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AmazonWorkMail
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAmazonWorkMail
instead.
WorkMail is a secure, managed business email and calendaring service with support for existing desktop and mobile email clients. You can access your email, contacts, and calendars using Microsoft Outlook, your browser, or other native iOS and Android email applications. You can integrate WorkMail with your existing corporate directory and control both the keys that encrypt your data and the location in which your data is stored.
The WorkMail API is designed for the following scenarios:
Listing and describing organizations
Managing users
Managing groups
Managing resources
All WorkMail API operations are Amazon-authenticated and certificate-signed. They not only require the use of the AWS SDK, but also allow for the exclusive use of AWS Identity and Access Management users and roles to help facilitate access, trust, and permission policies. By creating a role and allowing an IAM user to access the WorkMail site, the IAM user gains full administrative visibility into the entire WorkMail organization (or as set in the IAM policy). This includes, but is not limited to, the ability to create, update, and delete users, groups, and resources. This allows developers to perform the scenarios listed above, as well as give users the ability to grant access on a selective basis using the IAM model.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
AssociateDelegateToResourceResult |
associateDelegateToResource(AssociateDelegateToResourceRequest associateDelegateToResourceRequest)
Adds a member (user or group) to the resource's set of delegates.
|
AssociateMemberToGroupResult |
associateMemberToGroup(AssociateMemberToGroupRequest associateMemberToGroupRequest)
Adds a member (user or group) to the group's set.
|
AssumeImpersonationRoleResult |
assumeImpersonationRole(AssumeImpersonationRoleRequest assumeImpersonationRoleRequest)
Assumes an impersonation role for the given WorkMail organization.
|
CancelMailboxExportJobResult |
cancelMailboxExportJob(CancelMailboxExportJobRequest cancelMailboxExportJobRequest)
Cancels a mailbox export job.
|
CreateAliasResult |
createAlias(CreateAliasRequest createAliasRequest)
Adds an alias to the set of a given member (user or group) of WorkMail.
|
CreateAvailabilityConfigurationResult |
createAvailabilityConfiguration(CreateAvailabilityConfigurationRequest createAvailabilityConfigurationRequest)
Creates an
AvailabilityConfiguration for the given WorkMail organization and domain. |
CreateGroupResult |
createGroup(CreateGroupRequest createGroupRequest)
Creates a group that can be used in WorkMail by calling the RegisterToWorkMail operation.
|
CreateImpersonationRoleResult |
createImpersonationRole(CreateImpersonationRoleRequest createImpersonationRoleRequest)
Creates an impersonation role for the given WorkMail organization.
|
CreateMobileDeviceAccessRuleResult |
createMobileDeviceAccessRule(CreateMobileDeviceAccessRuleRequest createMobileDeviceAccessRuleRequest)
Creates a new mobile device access rule for the specified WorkMail organization.
|
CreateOrganizationResult |
createOrganization(CreateOrganizationRequest createOrganizationRequest)
Creates a new WorkMail organization.
|
CreateResourceResult |
createResource(CreateResourceRequest createResourceRequest)
Creates a new WorkMail resource.
|
CreateUserResult |
createUser(CreateUserRequest createUserRequest)
Creates a user who can be used in WorkMail by calling the RegisterToWorkMail operation.
|
DeleteAccessControlRuleResult |
deleteAccessControlRule(DeleteAccessControlRuleRequest deleteAccessControlRuleRequest)
Deletes an access control rule for the specified WorkMail organization.
|
DeleteAliasResult |
deleteAlias(DeleteAliasRequest deleteAliasRequest)
Remove one or more specified aliases from a set of aliases for a given user.
|
DeleteAvailabilityConfigurationResult |
deleteAvailabilityConfiguration(DeleteAvailabilityConfigurationRequest deleteAvailabilityConfigurationRequest)
Deletes the
AvailabilityConfiguration for the given WorkMail organization and domain. |
DeleteEmailMonitoringConfigurationResult |
deleteEmailMonitoringConfiguration(DeleteEmailMonitoringConfigurationRequest deleteEmailMonitoringConfigurationRequest)
Deletes the email monitoring configuration for a specified organization.
|
DeleteGroupResult |
deleteGroup(DeleteGroupRequest deleteGroupRequest)
Deletes a group from WorkMail.
|
DeleteImpersonationRoleResult |
deleteImpersonationRole(DeleteImpersonationRoleRequest deleteImpersonationRoleRequest)
Deletes an impersonation role for the given WorkMail organization.
|
DeleteMailboxPermissionsResult |
deleteMailboxPermissions(DeleteMailboxPermissionsRequest deleteMailboxPermissionsRequest)
Deletes permissions granted to a member (user or group).
|
DeleteMobileDeviceAccessOverrideResult |
deleteMobileDeviceAccessOverride(DeleteMobileDeviceAccessOverrideRequest deleteMobileDeviceAccessOverrideRequest)
Deletes the mobile device access override for the given WorkMail organization, user, and device.
|
DeleteMobileDeviceAccessRuleResult |
deleteMobileDeviceAccessRule(DeleteMobileDeviceAccessRuleRequest deleteMobileDeviceAccessRuleRequest)
Deletes a mobile device access rule for the specified WorkMail organization.
|
DeleteOrganizationResult |
deleteOrganization(DeleteOrganizationRequest deleteOrganizationRequest)
Deletes an WorkMail organization and all underlying AWS resources managed by WorkMail as part of the
organization.
|
DeleteResourceResult |
deleteResource(DeleteResourceRequest deleteResourceRequest)
Deletes the specified resource.
|
DeleteRetentionPolicyResult |
deleteRetentionPolicy(DeleteRetentionPolicyRequest deleteRetentionPolicyRequest)
Deletes the specified retention policy from the specified organization.
|
DeleteUserResult |
deleteUser(DeleteUserRequest deleteUserRequest)
Deletes a user from WorkMail and all subsequent systems.
|
DeregisterFromWorkMailResult |
deregisterFromWorkMail(DeregisterFromWorkMailRequest deregisterFromWorkMailRequest)
Mark a user, group, or resource as no longer used in WorkMail.
|
DeregisterMailDomainResult |
deregisterMailDomain(DeregisterMailDomainRequest deregisterMailDomainRequest)
Removes a domain from WorkMail, stops email routing to WorkMail, and removes the authorization allowing WorkMail
use.
|
DescribeEmailMonitoringConfigurationResult |
describeEmailMonitoringConfiguration(DescribeEmailMonitoringConfigurationRequest describeEmailMonitoringConfigurationRequest)
Describes the current email monitoring configuration for a specified organization.
|
DescribeEntityResult |
describeEntity(DescribeEntityRequest describeEntityRequest)
Returns basic details about an entity in WorkMail.
|
DescribeGroupResult |
describeGroup(DescribeGroupRequest describeGroupRequest)
Returns the data available for the group.
|
DescribeInboundDmarcSettingsResult |
describeInboundDmarcSettings(DescribeInboundDmarcSettingsRequest describeInboundDmarcSettingsRequest)
Lists the settings in a DMARC policy for a specified organization.
|
DescribeMailboxExportJobResult |
describeMailboxExportJob(DescribeMailboxExportJobRequest describeMailboxExportJobRequest)
Describes the current status of a mailbox export job.
|
DescribeOrganizationResult |
describeOrganization(DescribeOrganizationRequest describeOrganizationRequest)
Provides more information regarding a given organization based on its identifier.
|
DescribeResourceResult |
describeResource(DescribeResourceRequest describeResourceRequest)
Returns the data available for the resource.
|
DescribeUserResult |
describeUser(DescribeUserRequest describeUserRequest)
Provides information regarding the user.
|
DisassociateDelegateFromResourceResult |
disassociateDelegateFromResource(DisassociateDelegateFromResourceRequest disassociateDelegateFromResourceRequest)
Removes a member from the resource's set of delegates.
|
DisassociateMemberFromGroupResult |
disassociateMemberFromGroup(DisassociateMemberFromGroupRequest disassociateMemberFromGroupRequest)
Removes a member from a group.
|
GetAccessControlEffectResult |
getAccessControlEffect(GetAccessControlEffectRequest getAccessControlEffectRequest)
Gets the effects of an organization's access control rules as they apply to a specified IPv4 address, access
protocol action, and user ID or impersonation role ID.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetDefaultRetentionPolicyResult |
getDefaultRetentionPolicy(GetDefaultRetentionPolicyRequest getDefaultRetentionPolicyRequest)
Gets the default retention policy details for the specified organization.
|
GetImpersonationRoleResult |
getImpersonationRole(GetImpersonationRoleRequest getImpersonationRoleRequest)
Gets the impersonation role details for the given WorkMail organization.
|
GetImpersonationRoleEffectResult |
getImpersonationRoleEffect(GetImpersonationRoleEffectRequest getImpersonationRoleEffectRequest)
Tests whether the given impersonation role can impersonate a target user.
|
GetMailboxDetailsResult |
getMailboxDetails(GetMailboxDetailsRequest getMailboxDetailsRequest)
Requests a user's mailbox details for a specified organization and user.
|
GetMailDomainResult |
getMailDomain(GetMailDomainRequest getMailDomainRequest)
Gets details for a mail domain, including domain records required to configure your domain with recommended
security.
|
GetMobileDeviceAccessEffectResult |
getMobileDeviceAccessEffect(GetMobileDeviceAccessEffectRequest getMobileDeviceAccessEffectRequest)
Simulates the effect of the mobile device access rules for the given attributes of a sample access event.
|
GetMobileDeviceAccessOverrideResult |
getMobileDeviceAccessOverride(GetMobileDeviceAccessOverrideRequest getMobileDeviceAccessOverrideRequest)
Gets the mobile device access override for the given WorkMail organization, user, and device.
|
ListAccessControlRulesResult |
listAccessControlRules(ListAccessControlRulesRequest listAccessControlRulesRequest)
Lists the access control rules for the specified organization.
|
ListAliasesResult |
listAliases(ListAliasesRequest listAliasesRequest)
Creates a paginated call to list the aliases associated with a given entity.
|
ListAvailabilityConfigurationsResult |
listAvailabilityConfigurations(ListAvailabilityConfigurationsRequest listAvailabilityConfigurationsRequest)
List all the
AvailabilityConfiguration 's for the given WorkMail organization. |
ListGroupMembersResult |
listGroupMembers(ListGroupMembersRequest listGroupMembersRequest)
Returns an overview of the members of a group.
|
ListGroupsResult |
listGroups(ListGroupsRequest listGroupsRequest)
Returns summaries of the organization's groups.
|
ListGroupsForEntityResult |
listGroupsForEntity(ListGroupsForEntityRequest listGroupsForEntityRequest)
Returns all the groups to which an entity belongs.
|
ListImpersonationRolesResult |
listImpersonationRoles(ListImpersonationRolesRequest listImpersonationRolesRequest)
Lists all the impersonation roles for the given WorkMail organization.
|
ListMailboxExportJobsResult |
listMailboxExportJobs(ListMailboxExportJobsRequest listMailboxExportJobsRequest)
Lists the mailbox export jobs started for the specified organization within the last seven days.
|
ListMailboxPermissionsResult |
listMailboxPermissions(ListMailboxPermissionsRequest listMailboxPermissionsRequest)
Lists the mailbox permissions associated with a user, group, or resource mailbox.
|
ListMailDomainsResult |
listMailDomains(ListMailDomainsRequest listMailDomainsRequest)
Lists the mail domains in a given WorkMail organization.
|
ListMobileDeviceAccessOverridesResult |
listMobileDeviceAccessOverrides(ListMobileDeviceAccessOverridesRequest listMobileDeviceAccessOverridesRequest)
Lists all the mobile device access overrides for any given combination of WorkMail organization, user, or device.
|
ListMobileDeviceAccessRulesResult |
listMobileDeviceAccessRules(ListMobileDeviceAccessRulesRequest listMobileDeviceAccessRulesRequest)
Lists the mobile device access rules for the specified WorkMail organization.
|
ListOrganizationsResult |
listOrganizations(ListOrganizationsRequest listOrganizationsRequest)
Returns summaries of the customer's organizations.
|
ListResourceDelegatesResult |
listResourceDelegates(ListResourceDelegatesRequest listResourceDelegatesRequest)
Lists the delegates associated with a resource.
|
ListResourcesResult |
listResources(ListResourcesRequest listResourcesRequest)
Returns summaries of the organization's resources.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags applied to an WorkMail organization resource.
|
ListUsersResult |
listUsers(ListUsersRequest listUsersRequest)
Returns summaries of the organization's users.
|
PutAccessControlRuleResult |
putAccessControlRule(PutAccessControlRuleRequest putAccessControlRuleRequest)
Adds a new access control rule for the specified organization.
|
PutEmailMonitoringConfigurationResult |
putEmailMonitoringConfiguration(PutEmailMonitoringConfigurationRequest putEmailMonitoringConfigurationRequest)
Creates or updates the email monitoring configuration for a specified organization.
|
PutInboundDmarcSettingsResult |
putInboundDmarcSettings(PutInboundDmarcSettingsRequest putInboundDmarcSettingsRequest)
Enables or disables a DMARC policy for a given organization.
|
PutMailboxPermissionsResult |
putMailboxPermissions(PutMailboxPermissionsRequest putMailboxPermissionsRequest)
Sets permissions for a user, group, or resource.
|
PutMobileDeviceAccessOverrideResult |
putMobileDeviceAccessOverride(PutMobileDeviceAccessOverrideRequest putMobileDeviceAccessOverrideRequest)
Creates or updates a mobile device access override for the given WorkMail organization, user, and device.
|
PutRetentionPolicyResult |
putRetentionPolicy(PutRetentionPolicyRequest putRetentionPolicyRequest)
Puts a retention policy to the specified organization.
|
RegisterMailDomainResult |
registerMailDomain(RegisterMailDomainRequest registerMailDomainRequest)
Registers a new domain in WorkMail and SES, and configures it for use by WorkMail.
|
RegisterToWorkMailResult |
registerToWorkMail(RegisterToWorkMailRequest registerToWorkMailRequest)
Registers an existing and disabled user, group, or resource for WorkMail use by associating a mailbox and
calendaring capabilities.
|
ResetPasswordResult |
resetPassword(ResetPasswordRequest resetPasswordRequest)
Allows the administrator to reset the password for a user.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartMailboxExportJobResult |
startMailboxExportJob(StartMailboxExportJobRequest startMailboxExportJobRequest)
Starts a mailbox export job to export MIME-format email messages and calendar items from the specified mailbox to
the specified Amazon Simple Storage Service (Amazon S3) bucket.
|
TagResourceResult |
tagResource(TagResourceRequest tagResourceRequest)
Applies the specified tags to the specified WorkMailorganization resource.
|
TestAvailabilityConfigurationResult |
testAvailabilityConfiguration(TestAvailabilityConfigurationRequest testAvailabilityConfigurationRequest)
Performs a test on an availability provider to ensure that access is allowed.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Untags the specified tags from the specified WorkMail organization resource.
|
UpdateAvailabilityConfigurationResult |
updateAvailabilityConfiguration(UpdateAvailabilityConfigurationRequest updateAvailabilityConfigurationRequest)
Updates an existing
AvailabilityConfiguration for the given WorkMail organization and domain. |
UpdateDefaultMailDomainResult |
updateDefaultMailDomain(UpdateDefaultMailDomainRequest updateDefaultMailDomainRequest)
Updates the default mail domain for an organization.
|
UpdateGroupResult |
updateGroup(UpdateGroupRequest updateGroupRequest)
Updates attibutes in a group.
|
UpdateImpersonationRoleResult |
updateImpersonationRole(UpdateImpersonationRoleRequest updateImpersonationRoleRequest)
Updates an impersonation role for the given WorkMail organization.
|
UpdateMailboxQuotaResult |
updateMailboxQuota(UpdateMailboxQuotaRequest updateMailboxQuotaRequest)
Updates a user's current mailbox quota for a specified organization and user.
|
UpdateMobileDeviceAccessRuleResult |
updateMobileDeviceAccessRule(UpdateMobileDeviceAccessRuleRequest updateMobileDeviceAccessRuleRequest)
Updates a mobile device access rule for the specified WorkMail organization.
|
UpdatePrimaryEmailAddressResult |
updatePrimaryEmailAddress(UpdatePrimaryEmailAddressRequest updatePrimaryEmailAddressRequest)
Updates the primary email for a user, group, or resource.
|
UpdateResourceResult |
updateResource(UpdateResourceRequest updateResourceRequest)
Updates data for the resource.
|
UpdateUserResult |
updateUser(UpdateUserRequest updateUserRequest)
Updates data for the user.
|
static final String ENDPOINT_PREFIX
AssociateDelegateToResourceResult associateDelegateToResource(AssociateDelegateToResourceRequest associateDelegateToResourceRequest)
Adds a member (user or group) to the resource's set of delegates.
associateDelegateToResourceRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.AssociateMemberToGroupResult associateMemberToGroup(AssociateMemberToGroupRequest associateMemberToGroupRequest)
Adds a member (user or group) to the group's set.
associateMemberToGroupRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.AssumeImpersonationRoleResult assumeImpersonationRole(AssumeImpersonationRoleRequest assumeImpersonationRoleRequest)
Assumes an impersonation role for the given WorkMail organization. This method returns an authentication token you can use to make impersonated calls.
assumeImpersonationRoleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ResourceNotFoundException
- The resource cannot be found.CancelMailboxExportJobResult cancelMailboxExportJob(CancelMailboxExportJobRequest cancelMailboxExportJobRequest)
Cancels a mailbox export job.
If the mailbox export job is near completion, it might not be possible to cancel it.
cancelMailboxExportJobRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.CreateAliasResult createAlias(CreateAliasRequest createAliasRequest)
Adds an alias to the set of a given member (user or group) of WorkMail.
createAliasRequest
- EmailAddressInUseException
- The email address that you're trying to assign is already created for a different user, group, or
resource.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.MailDomainNotFoundException
- The domain specified is not found in your organization.MailDomainStateException
- After a domain has been added to the organization, it must be verified. The domain is not yet verified.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.LimitExceededException
- The request exceeds the limit of the resource.CreateAvailabilityConfigurationResult createAvailabilityConfiguration(CreateAvailabilityConfigurationRequest createAvailabilityConfigurationRequest)
Creates an AvailabilityConfiguration
for the given WorkMail organization and domain.
createAvailabilityConfigurationRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.NameAvailabilityException
- The user, group, or resource name isn't unique in WorkMail.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.LimitExceededException
- The request exceeds the limit of the resource.CreateGroupResult createGroup(CreateGroupRequest createGroupRequest)
Creates a group that can be used in WorkMail by calling the RegisterToWorkMail operation.
createGroupRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.NameAvailabilityException
- The user, group, or resource name isn't unique in WorkMail.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ReservedNameException
- This user, group, or resource name is not allowed in WorkMail.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.CreateImpersonationRoleResult createImpersonationRole(CreateImpersonationRoleRequest createImpersonationRoleRequest)
Creates an impersonation role for the given WorkMail organization.
Idempotency ensures that an API request completes no more than one time. With an idempotent request, if the original request completes successfully, any subsequent retries also complete successfully without performing any further actions.
createImpersonationRoleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.LimitExceededException
- The request exceeds the limit of the resource.CreateMobileDeviceAccessRuleResult createMobileDeviceAccessRule(CreateMobileDeviceAccessRuleRequest createMobileDeviceAccessRuleRequest)
Creates a new mobile device access rule for the specified WorkMail organization.
createMobileDeviceAccessRuleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.LimitExceededException
- The request exceeds the limit of the resource.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.CreateOrganizationResult createOrganization(CreateOrganizationRequest createOrganizationRequest)
Creates a new WorkMail organization. Optionally, you can choose to associate an existing AWS Directory Service directory with your organization. If an AWS Directory Service directory ID is specified, the organization alias must match the directory alias. If you choose not to associate an existing directory with your organization, then we create a new WorkMail directory for you. For more information, see Adding an organization in the WorkMail Administrator Guide.
You can associate multiple email domains with an organization, then choose your default email domain from the WorkMail console. You can also associate a domain that is managed in an Amazon Route 53 public hosted zone. For more information, see Adding a domain and Choosing the default domain in the WorkMail Administrator Guide.
Optionally, you can use a customer managed key from AWS Key Management Service (AWS KMS) to encrypt email for your organization. If you don't associate an AWS KMS key, WorkMail creates a default, AWS managed key for you.
createOrganizationRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.DirectoryInUseException
- The directory is already in use by another WorkMail organization in the same account and Region.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.LimitExceededException
- The request exceeds the limit of the resource.NameAvailabilityException
- The user, group, or resource name isn't unique in WorkMail.CreateResourceResult createResource(CreateResourceRequest createResourceRequest)
Creates a new WorkMail resource.
createResourceRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.NameAvailabilityException
- The user, group, or resource name isn't unique in WorkMail.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ReservedNameException
- This user, group, or resource name is not allowed in WorkMail.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.CreateUserResult createUser(CreateUserRequest createUserRequest)
Creates a user who can be used in WorkMail by calling the RegisterToWorkMail operation.
createUserRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.InvalidPasswordException
- The supplied password doesn't match the minimum security constraints, such as length or use of special
characters.NameAvailabilityException
- The user, group, or resource name isn't unique in WorkMail.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ReservedNameException
- This user, group, or resource name is not allowed in WorkMail.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.DeleteAccessControlRuleResult deleteAccessControlRule(DeleteAccessControlRuleRequest deleteAccessControlRuleRequest)
Deletes an access control rule for the specified WorkMail organization.
Deleting already deleted and non-existing rules does not produce an error. In those cases, the service sends back an HTTP 200 response with an empty HTTP body.
deleteAccessControlRuleRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteAliasResult deleteAlias(DeleteAliasRequest deleteAliasRequest)
Remove one or more specified aliases from a set of aliases for a given user.
deleteAliasRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteAvailabilityConfigurationResult deleteAvailabilityConfiguration(DeleteAvailabilityConfigurationRequest deleteAvailabilityConfigurationRequest)
Deletes the AvailabilityConfiguration
for the given WorkMail organization and domain.
deleteAvailabilityConfigurationRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteEmailMonitoringConfigurationResult deleteEmailMonitoringConfiguration(DeleteEmailMonitoringConfigurationRequest deleteEmailMonitoringConfigurationRequest)
Deletes the email monitoring configuration for a specified organization.
deleteEmailMonitoringConfigurationRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteGroupResult deleteGroup(DeleteGroupRequest deleteGroupRequest)
Deletes a group from WorkMail.
deleteGroupRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.DeleteImpersonationRoleResult deleteImpersonationRole(DeleteImpersonationRoleRequest deleteImpersonationRoleRequest)
Deletes an impersonation role for the given WorkMail organization.
deleteImpersonationRoleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteMailboxPermissionsResult deleteMailboxPermissions(DeleteMailboxPermissionsRequest deleteMailboxPermissionsRequest)
Deletes permissions granted to a member (user or group).
deleteMailboxPermissionsRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteMobileDeviceAccessOverrideResult deleteMobileDeviceAccessOverride(DeleteMobileDeviceAccessOverrideRequest deleteMobileDeviceAccessOverrideRequest)
Deletes the mobile device access override for the given WorkMail organization, user, and device.
Deleting already deleted and non-existing overrides does not produce an error. In those cases, the service sends back an HTTP 200 response with an empty HTTP body.
deleteMobileDeviceAccessOverrideRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.DeleteMobileDeviceAccessRuleResult deleteMobileDeviceAccessRule(DeleteMobileDeviceAccessRuleRequest deleteMobileDeviceAccessRuleRequest)
Deletes a mobile device access rule for the specified WorkMail organization.
Deleting already deleted and non-existing rules does not produce an error. In those cases, the service sends back an HTTP 200 response with an empty HTTP body.
deleteMobileDeviceAccessRuleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteOrganizationResult deleteOrganization(DeleteOrganizationRequest deleteOrganizationRequest)
Deletes an WorkMail organization and all underlying AWS resources managed by WorkMail as part of the organization. You can choose whether to delete the associated directory. For more information, see Removing an organization in the WorkMail Administrator Guide.
deleteOrganizationRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteResourceResult deleteResource(DeleteResourceRequest deleteResourceRequest)
Deletes the specified resource.
deleteResourceRequest
- EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.DeleteRetentionPolicyResult deleteRetentionPolicy(DeleteRetentionPolicyRequest deleteRetentionPolicyRequest)
Deletes the specified retention policy from the specified organization.
deleteRetentionPolicyRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeleteUserResult deleteUser(DeleteUserRequest deleteUserRequest)
Deletes a user from WorkMail and all subsequent systems. Before you can delete a user, the user state must be
DISABLED
. Use the DescribeUser action to confirm the user state.
Deleting a user is permanent and cannot be undone. WorkMail archives user mailboxes for 30 days before they are permanently removed.
deleteUserRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.DeregisterFromWorkMailResult deregisterFromWorkMail(DeregisterFromWorkMailRequest deregisterFromWorkMailRequest)
Mark a user, group, or resource as no longer used in WorkMail. This action disassociates the mailbox and schedules it for clean-up. WorkMail keeps mailboxes for 30 days before they are permanently removed. The functionality in the console is Disable.
deregisterFromWorkMailRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DeregisterMailDomainResult deregisterMailDomain(DeregisterMailDomainRequest deregisterMailDomainRequest)
Removes a domain from WorkMail, stops email routing to WorkMail, and removes the authorization allowing WorkMail use. SES keeps the domain because other applications may use it. You must first remove any email address used by WorkMail entities before you remove the domain.
deregisterMailDomainRequest
- MailDomainInUseException
- The domain you're trying to change is in use by another user or organization in your account. See the
error message for details.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.InvalidCustomSesConfigurationException
- You SES configuration has customizations that WorkMail cannot save. The error message lists the invalid
setting. For examples of invalid settings, refer to CreateReceiptRule.DescribeEmailMonitoringConfigurationResult describeEmailMonitoringConfiguration(DescribeEmailMonitoringConfigurationRequest describeEmailMonitoringConfigurationRequest)
Describes the current email monitoring configuration for a specified organization.
describeEmailMonitoringConfigurationRequest
- ResourceNotFoundException
- The resource cannot be found.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DescribeEntityResult describeEntity(DescribeEntityRequest describeEntityRequest)
Returns basic details about an entity in WorkMail.
describeEntityRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DescribeGroupResult describeGroup(DescribeGroupRequest describeGroupRequest)
Returns the data available for the group.
describeGroupRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DescribeInboundDmarcSettingsResult describeInboundDmarcSettings(DescribeInboundDmarcSettingsRequest describeInboundDmarcSettingsRequest)
Lists the settings in a DMARC policy for a specified organization.
describeInboundDmarcSettingsRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DescribeMailboxExportJobResult describeMailboxExportJob(DescribeMailboxExportJobRequest describeMailboxExportJobRequest)
Describes the current status of a mailbox export job.
describeMailboxExportJobRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.DescribeOrganizationResult describeOrganization(DescribeOrganizationRequest describeOrganizationRequest)
Provides more information regarding a given organization based on its identifier.
describeOrganizationRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.DescribeResourceResult describeResource(DescribeResourceRequest describeResourceRequest)
Returns the data available for the resource.
describeResourceRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.DescribeUserResult describeUser(DescribeUserRequest describeUserRequest)
Provides information regarding the user.
describeUserRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.DisassociateDelegateFromResourceResult disassociateDelegateFromResource(DisassociateDelegateFromResourceRequest disassociateDelegateFromResourceRequest)
Removes a member from the resource's set of delegates.
disassociateDelegateFromResourceRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.DisassociateMemberFromGroupResult disassociateMemberFromGroup(DisassociateMemberFromGroupRequest disassociateMemberFromGroupRequest)
Removes a member from a group.
disassociateMemberFromGroupRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.GetAccessControlEffectResult getAccessControlEffect(GetAccessControlEffectRequest getAccessControlEffectRequest)
Gets the effects of an organization's access control rules as they apply to a specified IPv4 address, access protocol action, and user ID or impersonation role ID. You must provide either the user ID or impersonation role ID. Impersonation role ID can only be used with Action EWS.
getAccessControlEffectRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.ResourceNotFoundException
- The resource cannot be found.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.GetDefaultRetentionPolicyResult getDefaultRetentionPolicy(GetDefaultRetentionPolicyRequest getDefaultRetentionPolicyRequest)
Gets the default retention policy details for the specified organization.
getDefaultRetentionPolicyRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.GetImpersonationRoleResult getImpersonationRole(GetImpersonationRoleRequest getImpersonationRoleRequest)
Gets the impersonation role details for the given WorkMail organization.
getImpersonationRoleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ResourceNotFoundException
- The resource cannot be found.GetImpersonationRoleEffectResult getImpersonationRoleEffect(GetImpersonationRoleEffectRequest getImpersonationRoleEffectRequest)
Tests whether the given impersonation role can impersonate a target user.
getImpersonationRoleEffectRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ResourceNotFoundException
- The resource cannot be found.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.GetMailDomainResult getMailDomain(GetMailDomainRequest getMailDomainRequest)
Gets details for a mail domain, including domain records required to configure your domain with recommended security.
getMailDomainRequest
- MailDomainNotFoundException
- The domain specified is not found in your organization.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.GetMailboxDetailsResult getMailboxDetails(GetMailboxDetailsRequest getMailboxDetailsRequest)
Requests a user's mailbox details for a specified organization and user.
getMailboxDetailsRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.GetMobileDeviceAccessEffectResult getMobileDeviceAccessEffect(GetMobileDeviceAccessEffectRequest getMobileDeviceAccessEffectRequest)
Simulates the effect of the mobile device access rules for the given attributes of a sample access event. Use this method to test the effects of the current set of mobile device access rules for the WorkMail organization for a particular user's attributes.
getMobileDeviceAccessEffectRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.GetMobileDeviceAccessOverrideResult getMobileDeviceAccessOverride(GetMobileDeviceAccessOverrideRequest getMobileDeviceAccessOverrideRequest)
Gets the mobile device access override for the given WorkMail organization, user, and device.
getMobileDeviceAccessOverrideRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.ResourceNotFoundException
- The resource cannot be found.ListAccessControlRulesResult listAccessControlRules(ListAccessControlRulesRequest listAccessControlRulesRequest)
Lists the access control rules for the specified organization.
listAccessControlRulesRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListAliasesResult listAliases(ListAliasesRequest listAliasesRequest)
Creates a paginated call to list the aliases associated with a given entity.
listAliasesRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListAvailabilityConfigurationsResult listAvailabilityConfigurations(ListAvailabilityConfigurationsRequest listAvailabilityConfigurationsRequest)
List all the AvailabilityConfiguration
's for the given WorkMail organization.
listAvailabilityConfigurationsRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListGroupMembersResult listGroupMembers(ListGroupMembersRequest listGroupMembersRequest)
Returns an overview of the members of a group. Users and groups can be members of a group.
listGroupMembersRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListGroupsResult listGroups(ListGroupsRequest listGroupsRequest)
Returns summaries of the organization's groups.
listGroupsRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListGroupsForEntityResult listGroupsForEntity(ListGroupsForEntityRequest listGroupsForEntityRequest)
Returns all the groups to which an entity belongs.
listGroupsForEntityRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.ListImpersonationRolesResult listImpersonationRoles(ListImpersonationRolesRequest listImpersonationRolesRequest)
Lists all the impersonation roles for the given WorkMail organization.
listImpersonationRolesRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListMailDomainsResult listMailDomains(ListMailDomainsRequest listMailDomainsRequest)
Lists the mail domains in a given WorkMail organization.
listMailDomainsRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListMailboxExportJobsResult listMailboxExportJobs(ListMailboxExportJobsRequest listMailboxExportJobsRequest)
Lists the mailbox export jobs started for the specified organization within the last seven days.
listMailboxExportJobsRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListMailboxPermissionsResult listMailboxPermissions(ListMailboxPermissionsRequest listMailboxPermissionsRequest)
Lists the mailbox permissions associated with a user, group, or resource mailbox.
listMailboxPermissionsRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListMobileDeviceAccessOverridesResult listMobileDeviceAccessOverrides(ListMobileDeviceAccessOverridesRequest listMobileDeviceAccessOverridesRequest)
Lists all the mobile device access overrides for any given combination of WorkMail organization, user, or device.
listMobileDeviceAccessOverridesRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.ListMobileDeviceAccessRulesResult listMobileDeviceAccessRules(ListMobileDeviceAccessRulesRequest listMobileDeviceAccessRulesRequest)
Lists the mobile device access rules for the specified WorkMail organization.
listMobileDeviceAccessRulesRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ListOrganizationsResult listOrganizations(ListOrganizationsRequest listOrganizationsRequest)
Returns summaries of the customer's organizations.
listOrganizationsRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.ListResourceDelegatesResult listResourceDelegates(ListResourceDelegatesRequest listResourceDelegatesRequest)
Lists the delegates associated with a resource. Users and groups can be resource delegates and answer requests on behalf of the resource.
listResourceDelegatesRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.ListResourcesResult listResources(ListResourcesRequest listResourcesRequest)
Returns summaries of the organization's resources.
listResourcesRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags applied to an WorkMail organization resource.
listTagsForResourceRequest
- ResourceNotFoundException
- The resource cannot be found.ListUsersResult listUsers(ListUsersRequest listUsersRequest)
Returns summaries of the organization's users.
listUsersRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.PutAccessControlRuleResult putAccessControlRule(PutAccessControlRuleRequest putAccessControlRuleRequest)
Adds a new access control rule for the specified organization. The rule allows or denies access to the organization for the specified IPv4 addresses, access protocol actions, user IDs and impersonation IDs. Adding a new rule with the same name as an existing rule replaces the older rule.
putAccessControlRuleRequest
- LimitExceededException
- The request exceeds the limit of the resource.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.ResourceNotFoundException
- The resource cannot be found.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.PutEmailMonitoringConfigurationResult putEmailMonitoringConfiguration(PutEmailMonitoringConfigurationRequest putEmailMonitoringConfigurationRequest)
Creates or updates the email monitoring configuration for a specified organization.
putEmailMonitoringConfigurationRequest
- ResourceNotFoundException
- The resource cannot be found.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.PutInboundDmarcSettingsResult putInboundDmarcSettings(PutInboundDmarcSettingsRequest putInboundDmarcSettingsRequest)
Enables or disables a DMARC policy for a given organization.
putInboundDmarcSettingsRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.PutMailboxPermissionsResult putMailboxPermissions(PutMailboxPermissionsRequest putMailboxPermissionsRequest)
Sets permissions for a user, group, or resource. This replaces any pre-existing permissions.
putMailboxPermissionsRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.PutMobileDeviceAccessOverrideResult putMobileDeviceAccessOverride(PutMobileDeviceAccessOverrideRequest putMobileDeviceAccessOverrideRequest)
Creates or updates a mobile device access override for the given WorkMail organization, user, and device.
putMobileDeviceAccessOverrideRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.PutRetentionPolicyResult putRetentionPolicy(PutRetentionPolicyRequest putRetentionPolicyRequest)
Puts a retention policy to the specified organization.
putRetentionPolicyRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.LimitExceededException
- The request exceeds the limit of the resource.RegisterMailDomainResult registerMailDomain(RegisterMailDomainRequest registerMailDomainRequest)
Registers a new domain in WorkMail and SES, and configures it for use by WorkMail. Emails received by SES for this domain are routed to the specified WorkMail organization, and WorkMail has permanent permission to use the specified domain for sending your users' emails.
registerMailDomainRequest
- MailDomainInUseException
- The domain you're trying to change is in use by another user or organization in your account. See the
error message for details.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.LimitExceededException
- The request exceeds the limit of the resource.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.RegisterToWorkMailResult registerToWorkMail(RegisterToWorkMailRequest registerToWorkMailRequest)
Registers an existing and disabled user, group, or resource for WorkMail use by associating a mailbox and calendaring capabilities. It performs no change if the user, group, or resource is enabled and fails if the user, group, or resource is deleted. This operation results in the accumulation of costs. For more information, see Pricing. The equivalent console functionality for this operation is Enable.
Users can either be created by calling the CreateUser API operation or they can be synchronized from your directory. For more information, see DeregisterFromWorkMail.
registerToWorkMailRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EmailAddressInUseException
- The email address that you're trying to assign is already created for a different user, group, or
resource.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.EntityAlreadyRegisteredException
- The user, group, or resource that you're trying to register is already registered.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.MailDomainNotFoundException
- The domain specified is not found in your organization.MailDomainStateException
- After a domain has been added to the organization, it must be verified. The domain is not yet verified.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ResetPasswordResult resetPassword(ResetPasswordRequest resetPasswordRequest)
Allows the administrator to reset the password for a user.
resetPasswordRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.InvalidPasswordException
- The supplied password doesn't match the minimum security constraints, such as length or use of special
characters.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.StartMailboxExportJobResult startMailboxExportJob(StartMailboxExportJobRequest startMailboxExportJobRequest)
Starts a mailbox export job to export MIME-format email messages and calendar items from the specified mailbox to the specified Amazon Simple Storage Service (Amazon S3) bucket. For more information, see Exporting mailbox content in the WorkMail Administrator Guide.
startMailboxExportJobRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.LimitExceededException
- The request exceeds the limit of the resource.TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
Applies the specified tags to the specified WorkMailorganization resource.
tagResourceRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.ResourceNotFoundException
- The resource cannot be found.TooManyTagsException
- The resource can have up to 50 user-applied tags.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.TestAvailabilityConfigurationResult testAvailabilityConfiguration(TestAvailabilityConfigurationRequest testAvailabilityConfigurationRequest)
Performs a test on an availability provider to ensure that access is allowed. For EWS, it verifies the provided
credentials can be used to successfully log in. For Lambda, it verifies that the Lambda function can be invoked
and that the resource access policy was configured to deny anonymous access. An anonymous invocation is one done
without providing either a SourceArn
or SourceAccount
header.
The request must contain either one provider definition (EwsProvider
or LambdaProvider
)
or the DomainName
parameter. If the DomainName
parameter is provided, the configuration
stored under the DomainName
will be tested.
testAvailabilityConfigurationRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ResourceNotFoundException
- The resource cannot be found.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Untags the specified tags from the specified WorkMail organization resource.
untagResourceRequest
- ResourceNotFoundException
- The resource cannot be found.UpdateAvailabilityConfigurationResult updateAvailabilityConfiguration(UpdateAvailabilityConfigurationRequest updateAvailabilityConfigurationRequest)
Updates an existing AvailabilityConfiguration
for the given WorkMail organization and domain.
updateAvailabilityConfigurationRequest
- OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ResourceNotFoundException
- The resource cannot be found.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.UpdateDefaultMailDomainResult updateDefaultMailDomain(UpdateDefaultMailDomainRequest updateDefaultMailDomainRequest)
Updates the default mail domain for an organization. The default mail domain is used by the WorkMail AWS Console to suggest an email address when enabling a mail user. You can only have one default domain.
updateDefaultMailDomainRequest
- MailDomainNotFoundException
- The domain specified is not found in your organization.MailDomainStateException
- After a domain has been added to the organization, it must be verified. The domain is not yet verified.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.UpdateGroupResult updateGroup(UpdateGroupRequest updateGroupRequest)
Updates attibutes in a group.
updateGroupRequest
- EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.UpdateImpersonationRoleResult updateImpersonationRole(UpdateImpersonationRoleRequest updateImpersonationRoleRequest)
Updates an impersonation role for the given WorkMail organization.
updateImpersonationRoleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.ResourceNotFoundException
- The resource cannot be found.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.LimitExceededException
- The request exceeds the limit of the resource.UpdateMailboxQuotaResult updateMailboxQuota(UpdateMailboxQuotaRequest updateMailboxQuotaRequest)
Updates a user's current mailbox quota for a specified organization and user.
updateMailboxQuotaRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.UpdateMobileDeviceAccessRuleResult updateMobileDeviceAccessRule(UpdateMobileDeviceAccessRuleRequest updateMobileDeviceAccessRuleRequest)
Updates a mobile device access rule for the specified WorkMail organization.
updateMobileDeviceAccessRuleRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UpdatePrimaryEmailAddressResult updatePrimaryEmailAddress(UpdatePrimaryEmailAddressRequest updatePrimaryEmailAddressRequest)
Updates the primary email for a user, group, or resource. The current email is moved into the list of aliases (or swapped between an existing alias and the current primary email), and the email provided in the input is promoted as the primary.
updatePrimaryEmailAddressRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EmailAddressInUseException
- The email address that you're trying to assign is already created for a different user, group, or
resource.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.MailDomainNotFoundException
- The domain specified is not found in your organization.MailDomainStateException
- After a domain has been added to the organization, it must be verified. The domain is not yet verified.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.UpdateResourceResult updateResource(UpdateResourceRequest updateResourceRequest)
Updates data for the resource. To have the latest information, it must be preceded by a DescribeResource
call. The dataset in the request should be the one expected when performing another DescribeResource
call.
updateResourceRequest
- DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.InvalidConfigurationException
- The configuration for a resource isn't valid. A resource must either be able to auto-respond to requests
or have at least one delegate associated that can do so on its behalf.EmailAddressInUseException
- The email address that you're trying to assign is already created for a different user, group, or
resource.MailDomainNotFoundException
- The domain specified is not found in your organization.MailDomainStateException
- After a domain has been added to the organization, it must be verified. The domain is not yet verified.NameAvailabilityException
- The user, group, or resource name isn't unique in WorkMail.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.UpdateUserResult updateUser(UpdateUserRequest updateUserRequest)
Updates data for the user. To have the latest information, it must be preceded by a DescribeUser call. The
dataset in the request should be the one expected when performing another DescribeUser
call.
updateUserRequest
- DirectoryServiceAuthenticationFailedException
- The directory service doesn't recognize the credentials supplied by WorkMail.DirectoryUnavailableException
- The directory is unavailable. It might be located in another Region or deleted.EntityNotFoundException
- The identifier supplied for the user, group, or resource does not exist in your organization.InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.OrganizationNotFoundException
- An operation received a valid organization identifier that either doesn't belong or exist in the system.OrganizationStateException
- The organization must have a valid state to perform certain operations on the organization or its
members.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.EntityStateException
- You are performing an operation on a user, group, or resource that isn't in the expected state, such as
trying to delete an active user.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.