@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonWorkMailClient extends AmazonWebServiceClient implements AmazonWorkMail
Amazon 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.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
AssociateDelegateToResourceResult |
associateDelegateToResource(AssociateDelegateToResourceRequest request)
Adds a member (user or group) to the resource's set of delegates.
|
AssociateMemberToGroupResult |
associateMemberToGroup(AssociateMemberToGroupRequest request)
Adds a member (user or group) to the group's set.
|
static AmazonWorkMailClientBuilder |
builder() |
CancelMailboxExportJobResult |
cancelMailboxExportJob(CancelMailboxExportJobRequest request)
Cancels a mailbox export job.
|
CreateAliasResult |
createAlias(CreateAliasRequest request)
Adds an alias to the set of a given member (user or group) of Amazon WorkMail.
|
CreateGroupResult |
createGroup(CreateGroupRequest request)
Creates a group that can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.
|
CreateMobileDeviceAccessRuleResult |
createMobileDeviceAccessRule(CreateMobileDeviceAccessRuleRequest request)
Creates a new mobile device access rule for the specified Amazon WorkMail organization.
|
CreateOrganizationResult |
createOrganization(CreateOrganizationRequest request)
Creates a new Amazon WorkMail organization.
|
CreateResourceResult |
createResource(CreateResourceRequest request)
Creates a new Amazon WorkMail resource.
|
CreateUserResult |
createUser(CreateUserRequest request)
Creates a user who can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.
|
DeleteAccessControlRuleResult |
deleteAccessControlRule(DeleteAccessControlRuleRequest request)
Deletes an access control rule for the specified WorkMail organization.
|
DeleteAliasResult |
deleteAlias(DeleteAliasRequest request)
Remove one or more specified aliases from a set of aliases for a given user.
|
DeleteGroupResult |
deleteGroup(DeleteGroupRequest request)
Deletes a group from Amazon WorkMail.
|
DeleteMailboxPermissionsResult |
deleteMailboxPermissions(DeleteMailboxPermissionsRequest request)
Deletes permissions granted to a member (user or group).
|
DeleteMobileDeviceAccessRuleResult |
deleteMobileDeviceAccessRule(DeleteMobileDeviceAccessRuleRequest request)
Deletes a mobile device access rule for the specified Amazon WorkMail organization.
|
DeleteOrganizationResult |
deleteOrganization(DeleteOrganizationRequest request)
Deletes an Amazon WorkMail organization and all underlying AWS resources managed by Amazon WorkMail as part of
the organization.
|
DeleteResourceResult |
deleteResource(DeleteResourceRequest request)
Deletes the specified resource.
|
DeleteRetentionPolicyResult |
deleteRetentionPolicy(DeleteRetentionPolicyRequest request)
Deletes the specified retention policy from the specified organization.
|
DeleteUserResult |
deleteUser(DeleteUserRequest request)
Deletes a user from Amazon WorkMail and all subsequent systems.
|
DeregisterFromWorkMailResult |
deregisterFromWorkMail(DeregisterFromWorkMailRequest request)
Mark a user, group, or resource as no longer used in Amazon WorkMail.
|
DescribeGroupResult |
describeGroup(DescribeGroupRequest request)
Returns the data available for the group.
|
DescribeMailboxExportJobResult |
describeMailboxExportJob(DescribeMailboxExportJobRequest request)
Describes the current status of a mailbox export job.
|
DescribeOrganizationResult |
describeOrganization(DescribeOrganizationRequest request)
Provides more information regarding a given organization based on its identifier.
|
DescribeResourceResult |
describeResource(DescribeResourceRequest request)
Returns the data available for the resource.
|
DescribeUserResult |
describeUser(DescribeUserRequest request)
Provides information regarding the user.
|
DisassociateDelegateFromResourceResult |
disassociateDelegateFromResource(DisassociateDelegateFromResourceRequest request)
Removes a member from the resource's set of delegates.
|
DisassociateMemberFromGroupResult |
disassociateMemberFromGroup(DisassociateMemberFromGroupRequest request)
Removes a member from a group.
|
GetAccessControlEffectResult |
getAccessControlEffect(GetAccessControlEffectRequest request)
Gets the effects of an organization's access control rules as they apply to a specified IPv4 address, access
protocol action, or user 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 request)
Gets the default retention policy details for the specified organization.
|
GetMailboxDetailsResult |
getMailboxDetails(GetMailboxDetailsRequest request)
Requests a user's mailbox details for a specified organization and user.
|
GetMobileDeviceAccessEffectResult |
getMobileDeviceAccessEffect(GetMobileDeviceAccessEffectRequest request)
Simulates the effect of the mobile device access rules for the given attributes of a sample access event.
|
ListAccessControlRulesResult |
listAccessControlRules(ListAccessControlRulesRequest request)
Lists the access control rules for the specified organization.
|
ListAliasesResult |
listAliases(ListAliasesRequest request)
Creates a paginated call to list the aliases associated with a given entity.
|
ListGroupMembersResult |
listGroupMembers(ListGroupMembersRequest request)
Returns an overview of the members of a group.
|
ListGroupsResult |
listGroups(ListGroupsRequest request)
Returns summaries of the organization's groups.
|
ListMailboxExportJobsResult |
listMailboxExportJobs(ListMailboxExportJobsRequest request)
Lists the mailbox export jobs started for the specified organization within the last seven days.
|
ListMailboxPermissionsResult |
listMailboxPermissions(ListMailboxPermissionsRequest request)
Lists the mailbox permissions associated with a user, group, or resource mailbox.
|
ListMobileDeviceAccessRulesResult |
listMobileDeviceAccessRules(ListMobileDeviceAccessRulesRequest request)
Lists the mobile device access rules for the specified Amazon WorkMail organization.
|
ListOrganizationsResult |
listOrganizations(ListOrganizationsRequest request)
Returns summaries of the customer's organizations.
|
ListResourceDelegatesResult |
listResourceDelegates(ListResourceDelegatesRequest request)
Lists the delegates associated with a resource.
|
ListResourcesResult |
listResources(ListResourcesRequest request)
Returns summaries of the organization's resources.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
Lists the tags applied to an Amazon WorkMail organization resource.
|
ListUsersResult |
listUsers(ListUsersRequest request)
Returns summaries of the organization's users.
|
PutAccessControlRuleResult |
putAccessControlRule(PutAccessControlRuleRequest request)
Adds a new access control rule for the specified organization.
|
PutMailboxPermissionsResult |
putMailboxPermissions(PutMailboxPermissionsRequest request)
Sets permissions for a user, group, or resource.
|
PutRetentionPolicyResult |
putRetentionPolicy(PutRetentionPolicyRequest request)
Puts a retention policy to the specified organization.
|
RegisterToWorkMailResult |
registerToWorkMail(RegisterToWorkMailRequest request)
Registers an existing and disabled user, group, or resource for Amazon WorkMail use by associating a mailbox and
calendaring capabilities.
|
ResetPasswordResult |
resetPassword(ResetPasswordRequest request)
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 request)
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 request)
Applies the specified tags to the specified Amazon WorkMail organization resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Untags the specified tags from the specified Amazon WorkMail organization resource.
|
UpdateMailboxQuotaResult |
updateMailboxQuota(UpdateMailboxQuotaRequest request)
Updates a user's current mailbox quota for a specified organization and user.
|
UpdateMobileDeviceAccessRuleResult |
updateMobileDeviceAccessRule(UpdateMobileDeviceAccessRuleRequest request)
Updates a mobile device access rule for the specified Amazon WorkMail organization.
|
UpdatePrimaryEmailAddressResult |
updatePrimaryEmailAddress(UpdatePrimaryEmailAddressRequest request)
Updates the primary email for a user, group, or resource.
|
UpdateResourceResult |
updateResource(UpdateResourceRequest request)
Updates data for the resource.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
public static AmazonWorkMailClientBuilder builder()
public AssociateDelegateToResourceResult associateDelegateToResource(AssociateDelegateToResourceRequest request)
Adds a member (user or group) to the resource's set of delegates.
associateDelegateToResource
in interface AmazonWorkMail
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.public AssociateMemberToGroupResult associateMemberToGroup(AssociateMemberToGroupRequest request)
Adds a member (user or group) to the group's set.
associateMemberToGroup
in interface AmazonWorkMail
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.public CancelMailboxExportJobResult cancelMailboxExportJob(CancelMailboxExportJobRequest request)
Cancels a mailbox export job.
If the mailbox export job is near completion, it might not be possible to cancel it.
cancelMailboxExportJob
in interface AmazonWorkMail
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.public CreateAliasResult createAlias(CreateAliasRequest request)
Adds an alias to the set of a given member (user or group) of Amazon WorkMail.
createAlias
in interface AmazonWorkMail
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
- For an email or alias to be created in Amazon WorkMail, the included domain must be defined in the
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.public CreateGroupResult createGroup(CreateGroupRequest request)
Creates a group that can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.
createGroup
in interface AmazonWorkMail
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 Amazon 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 Amazon WorkMail.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.public CreateMobileDeviceAccessRuleResult createMobileDeviceAccessRule(CreateMobileDeviceAccessRuleRequest request)
Creates a new mobile device access rule for the specified Amazon WorkMail organization.
createMobileDeviceAccessRule
in interface AmazonWorkMail
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.public CreateOrganizationResult createOrganization(CreateOrganizationRequest request)
Creates a new Amazon 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 Amazon WorkMail directory for you. For more information, see Adding an organization in the Amazon WorkMail Administrator Guide.
You can associate multiple email domains with an organization, then set your default email domain from the Amazon 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 Amazon WorkMail Administrator Guide.
Optionally, you can use a customer managed master key from AWS Key Management Service (AWS KMS) to encrypt email for your organization. If you don't associate an AWS KMS key, Amazon WorkMail creates a default AWS managed master key for you.
createOrganization
in interface AmazonWorkMail
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 Amazon WorkMail.public CreateResourceResult createResource(CreateResourceRequest request)
Creates a new Amazon WorkMail resource.
createResource
in interface AmazonWorkMail
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 Amazon 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 Amazon WorkMail.public CreateUserResult createUser(CreateUserRequest request)
Creates a user who can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.
createUser
in interface AmazonWorkMail
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 Amazon 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 Amazon WorkMail.UnsupportedOperationException
- You can't perform a write operation against a read-only directory.public DeleteAccessControlRuleResult deleteAccessControlRule(DeleteAccessControlRuleRequest request)
Deletes an access control rule for the specified WorkMail organization.
deleteAccessControlRule
in interface AmazonWorkMail
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.public DeleteAliasResult deleteAlias(DeleteAliasRequest request)
Remove one or more specified aliases from a set of aliases for a given user.
deleteAlias
in interface AmazonWorkMail
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.public DeleteGroupResult deleteGroup(DeleteGroupRequest request)
Deletes a group from Amazon WorkMail.
deleteGroup
in interface AmazonWorkMail
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.public DeleteMailboxPermissionsResult deleteMailboxPermissions(DeleteMailboxPermissionsRequest request)
Deletes permissions granted to a member (user or group).
deleteMailboxPermissions
in interface AmazonWorkMail
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.public DeleteMobileDeviceAccessRuleResult deleteMobileDeviceAccessRule(DeleteMobileDeviceAccessRuleRequest request)
Deletes a mobile device access rule for the specified Amazon WorkMail organization.
deleteMobileDeviceAccessRule
in interface AmazonWorkMail
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.public DeleteOrganizationResult deleteOrganization(DeleteOrganizationRequest request)
Deletes an Amazon WorkMail organization and all underlying AWS resources managed by Amazon WorkMail as part of the organization. You can choose whether to delete the associated directory. For more information, see Removing an organization in the Amazon WorkMail Administrator Guide.
deleteOrganization
in interface AmazonWorkMail
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.public DeleteResourceResult deleteResource(DeleteResourceRequest request)
Deletes the specified resource.
deleteResource
in interface AmazonWorkMail
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.public DeleteRetentionPolicyResult deleteRetentionPolicy(DeleteRetentionPolicyRequest request)
Deletes the specified retention policy from the specified organization.
deleteRetentionPolicy
in interface AmazonWorkMail
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.public DeleteUserResult deleteUser(DeleteUserRequest request)
Deletes a user from Amazon 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.
deleteUser
in interface AmazonWorkMail
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.public DeregisterFromWorkMailResult deregisterFromWorkMail(DeregisterFromWorkMailRequest request)
Mark a user, group, or resource as no longer used in Amazon 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.
deregisterFromWorkMail
in interface AmazonWorkMail
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.public DescribeGroupResult describeGroup(DescribeGroupRequest request)
Returns the data available for the group.
describeGroup
in interface AmazonWorkMail
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.public DescribeMailboxExportJobResult describeMailboxExportJob(DescribeMailboxExportJobRequest request)
Describes the current status of a mailbox export job.
describeMailboxExportJob
in interface AmazonWorkMail
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.public DescribeOrganizationResult describeOrganization(DescribeOrganizationRequest request)
Provides more information regarding a given organization based on its identifier.
describeOrganization
in interface AmazonWorkMail
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.public DescribeResourceResult describeResource(DescribeResourceRequest request)
Returns the data available for the resource.
describeResource
in interface AmazonWorkMail
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.public DescribeUserResult describeUser(DescribeUserRequest request)
Provides information regarding the user.
describeUser
in interface AmazonWorkMail
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.public DisassociateDelegateFromResourceResult disassociateDelegateFromResource(DisassociateDelegateFromResourceRequest request)
Removes a member from the resource's set of delegates.
disassociateDelegateFromResource
in interface AmazonWorkMail
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.public DisassociateMemberFromGroupResult disassociateMemberFromGroup(DisassociateMemberFromGroupRequest request)
Removes a member from a group.
disassociateMemberFromGroup
in interface AmazonWorkMail
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.public GetAccessControlEffectResult getAccessControlEffect(GetAccessControlEffectRequest request)
Gets the effects of an organization's access control rules as they apply to a specified IPv4 address, access protocol action, or user ID.
getAccessControlEffect
in interface AmazonWorkMail
getAccessControlEffectRequest
- 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.public GetDefaultRetentionPolicyResult getDefaultRetentionPolicy(GetDefaultRetentionPolicyRequest request)
Gets the default retention policy details for the specified organization.
getDefaultRetentionPolicy
in interface AmazonWorkMail
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.public GetMailboxDetailsResult getMailboxDetails(GetMailboxDetailsRequest request)
Requests a user's mailbox details for a specified organization and user.
getMailboxDetails
in interface AmazonWorkMail
getMailboxDetailsRequest
- 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.public GetMobileDeviceAccessEffectResult getMobileDeviceAccessEffect(GetMobileDeviceAccessEffectRequest request)
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 Amazon WorkMail organization for a particular user's attributes.
getMobileDeviceAccessEffect
in interface AmazonWorkMail
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.public ListAccessControlRulesResult listAccessControlRules(ListAccessControlRulesRequest request)
Lists the access control rules for the specified organization.
listAccessControlRules
in interface AmazonWorkMail
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.public ListAliasesResult listAliases(ListAliasesRequest request)
Creates a paginated call to list the aliases associated with a given entity.
listAliases
in interface AmazonWorkMail
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.public ListGroupMembersResult listGroupMembers(ListGroupMembersRequest request)
Returns an overview of the members of a group. Users and groups can be members of a group.
listGroupMembers
in interface AmazonWorkMail
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.public ListGroupsResult listGroups(ListGroupsRequest request)
Returns summaries of the organization's groups.
listGroups
in interface AmazonWorkMail
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.public ListMailboxExportJobsResult listMailboxExportJobs(ListMailboxExportJobsRequest request)
Lists the mailbox export jobs started for the specified organization within the last seven days.
listMailboxExportJobs
in interface AmazonWorkMail
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.public ListMailboxPermissionsResult listMailboxPermissions(ListMailboxPermissionsRequest request)
Lists the mailbox permissions associated with a user, group, or resource mailbox.
listMailboxPermissions
in interface AmazonWorkMail
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.public ListMobileDeviceAccessRulesResult listMobileDeviceAccessRules(ListMobileDeviceAccessRulesRequest request)
Lists the mobile device access rules for the specified Amazon WorkMail organization.
listMobileDeviceAccessRules
in interface AmazonWorkMail
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.public ListOrganizationsResult listOrganizations(ListOrganizationsRequest request)
Returns summaries of the customer's organizations.
listOrganizations
in interface AmazonWorkMail
listOrganizationsRequest
- InvalidParameterException
- One or more of the input parameters don't match the service's restrictions.public ListResourceDelegatesResult listResourceDelegates(ListResourceDelegatesRequest request)
Lists the delegates associated with a resource. Users and groups can be resource delegates and answer requests on behalf of the resource.
listResourceDelegates
in interface AmazonWorkMail
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.public ListResourcesResult listResources(ListResourcesRequest request)
Returns summaries of the organization's resources.
listResources
in interface AmazonWorkMail
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.public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
Lists the tags applied to an Amazon WorkMail organization resource.
listTagsForResource
in interface AmazonWorkMail
listTagsForResourceRequest
- ResourceNotFoundException
- The resource cannot be found.public ListUsersResult listUsers(ListUsersRequest request)
Returns summaries of the organization's users.
listUsers
in interface AmazonWorkMail
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.public PutAccessControlRuleResult putAccessControlRule(PutAccessControlRuleRequest request)
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, and user IDs. Adding a new rule with the same name as an existing rule replaces the older rule.
putAccessControlRule
in interface AmazonWorkMail
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.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.public PutMailboxPermissionsResult putMailboxPermissions(PutMailboxPermissionsRequest request)
Sets permissions for a user, group, or resource. This replaces any pre-existing permissions.
putMailboxPermissions
in interface AmazonWorkMail
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.public PutRetentionPolicyResult putRetentionPolicy(PutRetentionPolicyRequest request)
Puts a retention policy to the specified organization.
putRetentionPolicy
in interface AmazonWorkMail
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.public RegisterToWorkMailResult registerToWorkMail(RegisterToWorkMailRequest request)
Registers an existing and disabled user, group, or resource for Amazon 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.
registerToWorkMail
in interface AmazonWorkMail
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
- For an email or alias to be created in Amazon WorkMail, the included domain must be defined in the
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.public ResetPasswordResult resetPassword(ResetPasswordRequest request)
Allows the administrator to reset the password for a user.
resetPassword
in interface AmazonWorkMail
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.public StartMailboxExportJobResult startMailboxExportJob(StartMailboxExportJobRequest request)
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 Amazon WorkMail Administrator Guide.
startMailboxExportJob
in interface AmazonWorkMail
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.public TagResourceResult tagResource(TagResourceRequest request)
Applies the specified tags to the specified Amazon WorkMail organization resource.
tagResource
in interface AmazonWorkMail
tagResourceRequest
- 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.public UntagResourceResult untagResource(UntagResourceRequest request)
Untags the specified tags from the specified Amazon WorkMail organization resource.
untagResource
in interface AmazonWorkMail
untagResourceRequest
- ResourceNotFoundException
- The resource cannot be found.public UpdateMailboxQuotaResult updateMailboxQuota(UpdateMailboxQuotaRequest request)
Updates a user's current mailbox quota for a specified organization and user.
updateMailboxQuota
in interface AmazonWorkMail
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.public UpdateMobileDeviceAccessRuleResult updateMobileDeviceAccessRule(UpdateMobileDeviceAccessRuleRequest request)
Updates a mobile device access rule for the specified Amazon WorkMail organization.
updateMobileDeviceAccessRule
in interface AmazonWorkMail
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.public UpdatePrimaryEmailAddressResult updatePrimaryEmailAddress(UpdatePrimaryEmailAddressRequest request)
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.
updatePrimaryEmailAddress
in interface AmazonWorkMail
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
- For an email or alias to be created in Amazon WorkMail, the included domain must be defined in the
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.public UpdateResourceResult updateResource(UpdateResourceRequest request)
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.
updateResource
in interface AmazonWorkMail
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
- For an email or alias to be created in Amazon WorkMail, the included domain must be defined in the
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 Amazon 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.public 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 the request.
getCachedResponseMetadata
in interface AmazonWorkMail
request
- The originally executed requestpublic void shutdown()
AmazonWebServiceClient
shutdown
in interface AmazonWorkMail
shutdown
in class AmazonWebServiceClient