aws_workmail
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
Summary
Functions
-
associate_delegate_to_resource(Client, Input)
Adds a member (user or group) to the resource's set of delegates.
- associate_delegate_to_resource(Client, Input, Options)
-
associate_member_to_group(Client, Input)
Adds a member (user or group) to the group's set.
- associate_member_to_group(Client, Input, Options)
-
cancel_mailbox_export_job(Client, Input)
Cancels a mailbox export job.
- cancel_mailbox_export_job(Client, Input, Options)
-
create_alias(Client, Input)
Adds an alias to the set of a given member (user or group) of Amazon WorkMail.
- create_alias(Client, Input, Options)
-
create_group(Client, Input)
Creates a group that can be used in Amazon WorkMail by calling the
RegisterToWorkMail
operation. - create_group(Client, Input, Options)
-
create_organization(Client, Input)
Creates a new Amazon WorkMail organization.
- create_organization(Client, Input, Options)
-
create_resource(Client, Input)
Creates a new Amazon WorkMail resource.
- create_resource(Client, Input, Options)
-
create_user(Client, Input)
Creates a user who can be used in Amazon WorkMail by calling the
RegisterToWorkMail
operation. - create_user(Client, Input, Options)
-
delete_access_control_rule(Client, Input)
Deletes an access control rule for the specified WorkMail organization.
- delete_access_control_rule(Client, Input, Options)
-
delete_alias(Client, Input)
Remove one or more specified aliases from a set of aliases for a given user.
- delete_alias(Client, Input, Options)
-
delete_group(Client, Input)
Deletes a group from Amazon WorkMail.
- delete_group(Client, Input, Options)
-
delete_mailbox_permissions(Client, Input)
Deletes permissions granted to a member (user or group).
- delete_mailbox_permissions(Client, Input, Options)
-
delete_organization(Client, Input)
Deletes an Amazon WorkMail organization and all underlying AWS resources managed by Amazon WorkMail as part of the organization.
- delete_organization(Client, Input, Options)
-
delete_resource(Client, Input)
Deletes the specified resource.
- delete_resource(Client, Input, Options)
-
delete_retention_policy(Client, Input)
Deletes the specified retention policy from the specified organization.
- delete_retention_policy(Client, Input, Options)
-
delete_user(Client, Input)
Deletes a user from Amazon WorkMail and all subsequent systems.
- delete_user(Client, Input, Options)
-
deregister_from_work_mail(Client, Input)
Mark a user, group, or resource as no longer used in Amazon WorkMail.
- deregister_from_work_mail(Client, Input, Options)
-
describe_group(Client, Input)
Returns the data available for the group.
- describe_group(Client, Input, Options)
-
describe_mailbox_export_job(Client, Input)
Describes the current status of a mailbox export job.
- describe_mailbox_export_job(Client, Input, Options)
-
describe_organization(Client, Input)
Provides more information regarding a given organization based on its identifier.
- describe_organization(Client, Input, Options)
-
describe_resource(Client, Input)
Returns the data available for the resource.
- describe_resource(Client, Input, Options)
-
describe_user(Client, Input)
Provides information regarding the user.
- describe_user(Client, Input, Options)
-
disassociate_delegate_from_resource(Client, Input)
Removes a member from the resource's set of delegates.
- disassociate_delegate_from_resource(Client, Input, Options)
-
disassociate_member_from_group(Client, Input)
Removes a member from a group.
- disassociate_member_from_group(Client, Input, Options)
-
get_access_control_effect(Client, Input)
Gets the effects of an organization's access control rules as they apply to a specified IPv4 address, access protocol action, or user ID.
- get_access_control_effect(Client, Input, Options)
-
get_default_retention_policy(Client, Input)
Gets the default retention policy details for the specified organization.
- get_default_retention_policy(Client, Input, Options)
-
get_mailbox_details(Client, Input)
Requests a user's mailbox details for a specified organization and user.
- get_mailbox_details(Client, Input, Options)
-
list_access_control_rules(Client, Input)
Lists the access control rules for the specified organization.
- list_access_control_rules(Client, Input, Options)
-
list_aliases(Client, Input)
Creates a paginated call to list the aliases associated with a given entity.
- list_aliases(Client, Input, Options)
-
list_group_members(Client, Input)
Returns an overview of the members of a group.
- list_group_members(Client, Input, Options)
-
list_groups(Client, Input)
Returns summaries of the organization's groups.
- list_groups(Client, Input, Options)
-
list_mailbox_export_jobs(Client, Input)
Lists the mailbox export jobs started for the specified organization within the last seven days.
- list_mailbox_export_jobs(Client, Input, Options)
-
list_mailbox_permissions(Client, Input)
Lists the mailbox permissions associated with a user, group, or resource mailbox.
- list_mailbox_permissions(Client, Input, Options)
-
list_organizations(Client, Input)
Returns summaries of the customer's organizations.
- list_organizations(Client, Input, Options)
-
list_resource_delegates(Client, Input)
Lists the delegates associated with a resource.
- list_resource_delegates(Client, Input, Options)
-
list_resources(Client, Input)
Returns summaries of the organization's resources.
- list_resources(Client, Input, Options)
-
list_tags_for_resource(Client, Input)
Lists the tags applied to an Amazon WorkMail organization resource.
- list_tags_for_resource(Client, Input, Options)
-
list_users(Client, Input)
Returns summaries of the organization's users.
- list_users(Client, Input, Options)
-
put_access_control_rule(Client, Input)
Adds a new access control rule for the specified organization.
- put_access_control_rule(Client, Input, Options)
-
put_mailbox_permissions(Client, Input)
Sets permissions for a user, group, or resource.
- put_mailbox_permissions(Client, Input, Options)
-
put_retention_policy(Client, Input)
Puts a retention policy to the specified organization.
- put_retention_policy(Client, Input, Options)
-
register_to_work_mail(Client, Input)
Registers an existing and disabled user, group, or resource for Amazon WorkMail use by associating a mailbox and calendaring capabilities.
- register_to_work_mail(Client, Input, Options)
-
reset_password(Client, Input)
Allows the administrator to reset the password for a user.
- reset_password(Client, Input, Options)
-
start_mailbox_export_job(Client, Input)
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.
- start_mailbox_export_job(Client, Input, Options)
-
tag_resource(Client, Input)
Applies the specified tags to the specified Amazon WorkMail organization resource.
- tag_resource(Client, Input, Options)
-
untag_resource(Client, Input)
Untags the specified tags from the specified Amazon WorkMail organization resource.
- untag_resource(Client, Input, Options)
-
update_mailbox_quota(Client, Input)
Updates a user's current mailbox quota for a specified organization and user.
- update_mailbox_quota(Client, Input, Options)
-
update_primary_email_address(Client, Input)
Updates the primary email for a user, group, or resource.
- update_primary_email_address(Client, Input, Options)
-
update_resource(Client, Input)
Updates data for the resource.
- update_resource(Client, Input, Options)
Functions
associate_delegate_to_resource(Client, Input)
Adds a member (user or group) to the resource's set of delegates.
associate_delegate_to_resource(Client, Input, Options)
associate_member_to_group(Client, Input)
Adds a member (user or group) to the group's set.
associate_member_to_group(Client, Input, Options)
cancel_mailbox_export_job(Client, Input)
Cancels a mailbox export job.
If the mailbox export job is near completion, it might not be possible to cancel it.cancel_mailbox_export_job(Client, Input, Options)
create_alias(Client, Input)
Adds an alias to the set of a given member (user or group) of Amazon WorkMail.
create_alias(Client, Input, Options)
create_group(Client, Input)
Creates a group that can be used in Amazon WorkMail by calling the
RegisterToWorkMail
operation.
create_group(Client, Input, Options)
create_organization(Client, Input)
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.create_organization(Client, Input, Options)
create_resource(Client, Input)
Creates a new Amazon WorkMail resource.
create_resource(Client, Input, Options)
create_user(Client, Input)
Creates a user who can be used in Amazon WorkMail by calling the
RegisterToWorkMail
operation.
create_user(Client, Input, Options)
delete_access_control_rule(Client, Input)
Deletes an access control rule for the specified WorkMail organization.
delete_access_control_rule(Client, Input, Options)
delete_alias(Client, Input)
Remove one or more specified aliases from a set of aliases for a given user.
delete_alias(Client, Input, Options)
delete_group(Client, Input)
Deletes a group from Amazon WorkMail.
delete_group(Client, Input, Options)
delete_mailbox_permissions(Client, Input)
Deletes permissions granted to a member (user or group).
delete_mailbox_permissions(Client, Input, Options)
delete_organization(Client, Input)
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.delete_organization(Client, Input, Options)
delete_resource(Client, Input)
Deletes the specified resource.
delete_resource(Client, Input, Options)
delete_retention_policy(Client, Input)
Deletes the specified retention policy from the specified organization.
delete_retention_policy(Client, Input, Options)
delete_user(Client, Input)
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.
delete_user(Client, Input, Options)
deregister_from_work_mail(Client, Input)
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.deregister_from_work_mail(Client, Input, Options)
describe_group(Client, Input)
Returns the data available for the group.
describe_group(Client, Input, Options)
describe_mailbox_export_job(Client, Input)
Describes the current status of a mailbox export job.
describe_mailbox_export_job(Client, Input, Options)
describe_organization(Client, Input)
Provides more information regarding a given organization based on its identifier.
describe_organization(Client, Input, Options)
describe_resource(Client, Input)
Returns the data available for the resource.
describe_resource(Client, Input, Options)
describe_user(Client, Input)
Provides information regarding the user.
describe_user(Client, Input, Options)
disassociate_delegate_from_resource(Client, Input)
Removes a member from the resource's set of delegates.
disassociate_delegate_from_resource(Client, Input, Options)
disassociate_member_from_group(Client, Input)
Removes a member from a group.
disassociate_member_from_group(Client, Input, Options)
get_access_control_effect(Client, Input)
Gets the effects of an organization's access control rules as they apply to a specified IPv4 address, access protocol action, or user ID.
get_access_control_effect(Client, Input, Options)
get_default_retention_policy(Client, Input)
Gets the default retention policy details for the specified organization.
get_default_retention_policy(Client, Input, Options)
get_mailbox_details(Client, Input)
Requests a user's mailbox details for a specified organization and user.
get_mailbox_details(Client, Input, Options)
list_access_control_rules(Client, Input)
Lists the access control rules for the specified organization.
list_access_control_rules(Client, Input, Options)
list_aliases(Client, Input)
Creates a paginated call to list the aliases associated with a given entity.
list_aliases(Client, Input, Options)
list_group_members(Client, Input)
Returns an overview of the members of a group.
Users and groups can be members of a group.list_group_members(Client, Input, Options)
list_groups(Client, Input)
Returns summaries of the organization's groups.
list_groups(Client, Input, Options)
list_mailbox_export_jobs(Client, Input)
Lists the mailbox export jobs started for the specified organization within the last seven days.
list_mailbox_export_jobs(Client, Input, Options)
list_mailbox_permissions(Client, Input)
Lists the mailbox permissions associated with a user, group, or resource mailbox.
list_mailbox_permissions(Client, Input, Options)
list_organizations(Client, Input)
Returns summaries of the customer's organizations.
list_organizations(Client, Input, Options)
list_resource_delegates(Client, Input)
Lists the delegates associated with a resource.
Users and groups can be resource delegates and answer requests on behalf of the resource.list_resource_delegates(Client, Input, Options)
list_resources(Client, Input)
Returns summaries of the organization's resources.
list_resources(Client, Input, Options)
list_tags_for_resource(Client, Input)
Lists the tags applied to an Amazon WorkMail organization resource.
list_tags_for_resource(Client, Input, Options)
list_users(Client, Input)
Returns summaries of the organization's users.
list_users(Client, Input, Options)
put_access_control_rule(Client, Input)
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.put_access_control_rule(Client, Input, Options)
put_mailbox_permissions(Client, Input)
Sets permissions for a user, group, or resource.
This replaces any pre-existing permissions.put_mailbox_permissions(Client, Input, Options)
put_retention_policy(Client, Input)
Puts a retention policy to the specified organization.
put_retention_policy(Client, Input, Options)
register_to_work_mail(Client, Input)
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 theCreateUser
API operation or
they can be synchronized from your directory. For more information, see
DeregisterFromWorkMail
.
register_to_work_mail(Client, Input, Options)
reset_password(Client, Input)
Allows the administrator to reset the password for a user.
reset_password(Client, Input, Options)
start_mailbox_export_job(Client, Input)
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.start_mailbox_export_job(Client, Input, Options)
tag_resource(Client, Input)
Applies the specified tags to the specified Amazon WorkMail organization resource.
tag_resource(Client, Input, Options)
untag_resource(Client, Input)
Untags the specified tags from the specified Amazon WorkMail organization resource.
untag_resource(Client, Input, Options)
update_mailbox_quota(Client, Input)
Updates a user's current mailbox quota for a specified organization and user.
update_mailbox_quota(Client, Input, Options)
update_primary_email_address(Client, Input)
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.update_primary_email_address(Client, Input, Options)
update_resource(Client, Input)
Updates data for the resource.
To have the latest information, it must be preceded by aDescribeResource
call. The dataset in the request should be the one
expected when performing another DescribeResource
call.