@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.
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.
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.
|
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 Amazon WorkMail.
|
CreateGroupResult |
createGroup(CreateGroupRequest createGroupRequest)
Creates a group that can be used in Amazon WorkMail by calling the RegisterToWorkMail operation.
|
CreateMobileDeviceAccessRuleResult |
createMobileDeviceAccessRule(CreateMobileDeviceAccessRuleRequest createMobileDeviceAccessRuleRequest)
Creates a new mobile device access rule for the specified Amazon WorkMail organization.
|
CreateOrganizationResult |
createOrganization(CreateOrganizationRequest createOrganizationRequest)
Creates a new Amazon WorkMail organization.
|
CreateResourceResult |
createResource(CreateResourceRequest createResourceRequest)
Creates a new Amazon WorkMail resource.
|
CreateUserResult |
createUser(CreateUserRequest createUserRequest)
Creates a user who can be used in Amazon 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.
|
DeleteGroupResult |
deleteGroup(DeleteGroupRequest deleteGroupRequest)
Deletes a group from Amazon WorkMail.
|
DeleteMailboxPermissionsResult |
deleteMailboxPermissions(DeleteMailboxPermissionsRequest deleteMailboxPermissionsRequest)
Deletes permissions granted to a member (user or group).
|
DeleteMobileDeviceAccessRuleResult |
deleteMobileDeviceAccessRule(DeleteMobileDeviceAccessRuleRequest deleteMobileDeviceAccessRuleRequest)
Deletes a mobile device access rule for the specified Amazon WorkMail organization.
|
DeleteOrganizationResult |
deleteOrganization(DeleteOrganizationRequest deleteOrganizationRequest)
Deletes an Amazon WorkMail organization and all underlying AWS resources managed by Amazon 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 Amazon WorkMail and all subsequent systems.
|
DeregisterFromWorkMailResult |
deregisterFromWorkMail(DeregisterFromWorkMailRequest deregisterFromWorkMailRequest)
Mark a user, group, or resource as no longer used in Amazon WorkMail.
|
DescribeGroupResult |
describeGroup(DescribeGroupRequest describeGroupRequest)
Returns the data available for the group.
|
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, 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 getDefaultRetentionPolicyRequest)
Gets the default retention policy details for the specified organization.
|
GetMailboxDetailsResult |
getMailboxDetails(GetMailboxDetailsRequest getMailboxDetailsRequest)
Requests a user's mailbox details for a specified organization and user.
|
GetMobileDeviceAccessEffectResult |
getMobileDeviceAccessEffect(GetMobileDeviceAccessEffectRequest getMobileDeviceAccessEffectRequest)
Simulates the effect of the mobile device access rules for the given attributes of a sample access event.
|
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.
|
ListGroupMembersResult |
listGroupMembers(ListGroupMembersRequest listGroupMembersRequest)
Returns an overview of the members of a group.
|
ListGroupsResult |
listGroups(ListGroupsRequest listGroupsRequest)
Returns summaries of the organization's groups.
|
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.
|
ListMobileDeviceAccessRulesResult |
listMobileDeviceAccessRules(ListMobileDeviceAccessRulesRequest listMobileDeviceAccessRulesRequest)
Lists the mobile device access rules for the specified Amazon 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 Amazon 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.
|
PutMailboxPermissionsResult |
putMailboxPermissions(PutMailboxPermissionsRequest putMailboxPermissionsRequest)
Sets permissions for a user, group, or resource.
|
PutRetentionPolicyResult |
putRetentionPolicy(PutRetentionPolicyRequest putRetentionPolicyRequest)
Puts a retention policy to the specified organization.
|
RegisterToWorkMailResult |
registerToWorkMail(RegisterToWorkMailRequest registerToWorkMailRequest)
Registers an existing and disabled user, group, or resource for Amazon 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 Amazon WorkMail organization resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Untags the specified tags from the specified Amazon WorkMail organization resource.
|
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 Amazon 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.
|
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.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.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 Amazon 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
- 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.CreateGroupResult createGroup(CreateGroupRequest createGroupRequest)
Creates a group that can be used in Amazon 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 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.CreateMobileDeviceAccessRuleResult createMobileDeviceAccessRule(CreateMobileDeviceAccessRuleRequest createMobileDeviceAccessRuleRequest)
Creates a new mobile device access rule for the specified Amazon 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 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.
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.CreateResourceResult createResource(CreateResourceRequest createResourceRequest)
Creates a new Amazon 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 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.CreateUserResult createUser(CreateUserRequest createUserRequest)
Creates a user who can be used in Amazon 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 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.DeleteAccessControlRuleResult deleteAccessControlRule(DeleteAccessControlRuleRequest deleteAccessControlRuleRequest)
Deletes an access control rule for the specified WorkMail organization.
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.DeleteGroupResult deleteGroup(DeleteGroupRequest deleteGroupRequest)
Deletes a group from Amazon 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.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.DeleteMobileDeviceAccessRuleResult deleteMobileDeviceAccessRule(DeleteMobileDeviceAccessRuleRequest deleteMobileDeviceAccessRuleRequest)
Deletes a mobile device access rule for the specified Amazon WorkMail organization.
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 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.
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.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 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.
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 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.
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.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.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.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.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, or user ID.
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.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.GetMailboxDetailsResult getMailboxDetails(GetMailboxDetailsRequest getMailboxDetailsRequest)
Requests a user's mailbox details for a specified organization and user.
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.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 Amazon 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.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.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.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.ListMobileDeviceAccessRulesResult listMobileDeviceAccessRules(ListMobileDeviceAccessRulesRequest listMobileDeviceAccessRulesRequest)
Lists the mobile device access rules for the specified Amazon 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.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.ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists the tags applied to an Amazon 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, and user 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.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.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.RegisterToWorkMailResult registerToWorkMail(RegisterToWorkMailRequest registerToWorkMailRequest)
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.
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.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 Amazon 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 Amazon WorkMail organization resource.
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.UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Untags the specified tags from the specified Amazon WorkMail organization resource.
untagResourceRequest
- ResourceNotFoundException
- The resource cannot be found.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 Amazon 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
- 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.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
- 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.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.