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.
workmail(config = list())A client for the service. You can call the service's operations using
syntax like svc$operation(...), where svc is the name you've assigned
to the client. The available operations are listed in the
Operations section.
Optional configuration of credentials, endpoint, and/or region.
access_key_id: AWS access key ID
secret_access_key: AWS secret access key
session_token: AWS temporary session token
profile: The name of a profile to use. If not given, then the default profile is used.
anonymous: Set anonymous credentials.
endpoint: The complete URL to use for the constructed client.
region: The AWS Region used in instantiating the client.
close_connection: Immediately close all HTTP connections.
timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.
s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e., http://s3.amazonaws.com/BUCKET/KEY.
svc <- workmail(
config = list(
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string",
close_connection = "logical",
timeout = "numeric",
s3_force_path_style = "logical"
)
)
| associate_delegate_to_resource | Adds a member (user or group) to the resource's set of delegates |
| associate_member_to_group | Adds a member (user or group) to the group's set |
| cancel_mailbox_export_job | Cancels a mailbox export job |
| create_alias | Adds an alias to the set of a given member (user or group) of Amazon WorkMail |
| create_availability_configuration | Creates an AvailabilityConfiguration for the given WorkMail organization and domain |
| create_group | Creates a group that can be used in Amazon WorkMail by calling the RegisterToWorkMail operation |
| create_mobile_device_access_rule | Creates a new mobile device access rule for the specified Amazon WorkMail organization |
| create_organization | Creates a new Amazon WorkMail organization |
| create_resource | Creates a new Amazon WorkMail resource |
| create_user | Creates a user who can be used in Amazon WorkMail by calling the RegisterToWorkMail operation |
| delete_access_control_rule | Deletes an access control rule for the specified WorkMail organization |
| delete_alias | Remove one or more specified aliases from a set of aliases for a given user |
| delete_availability_configuration | Deletes the AvailabilityConfiguration for the given WorkMail organization and domain |
| delete_email_monitoring_configuration | Deletes the email monitoring configuration for a specified organization |
| delete_group | Deletes a group from Amazon WorkMail |
| delete_mailbox_permissions | Deletes permissions granted to a member (user or group) |
| delete_mobile_device_access_override | Deletes the mobile device access override for the given WorkMail organization, user, and device |
| delete_mobile_device_access_rule | Deletes a mobile device access rule for the specified Amazon WorkMail organization |
| delete_organization | Deletes an Amazon WorkMail organization and all underlying AWS resources managed by Amazon WorkMail as part of the organization |
| delete_resource | Deletes the specified resource |
| delete_retention_policy | Deletes the specified retention policy from the specified organization |
| delete_user | Deletes a user from Amazon WorkMail and all subsequent systems |
| deregister_from_work_mail | Mark a user, group, or resource as no longer used in Amazon WorkMail |
| deregister_mail_domain | Removes a domain from Amazon WorkMail, stops email routing to WorkMail, and removes the authorization allowing WorkMail use |
| describe_email_monitoring_configuration | Describes the current email monitoring configuration for a specified organization |
| describe_group | Returns the data available for the group |
| describe_inbound_dmarc_settings | Lists the settings in a DMARC policy for a specified organization |
| describe_mailbox_export_job | Describes the current status of a mailbox export job |
| describe_organization | Provides more information regarding a given organization based on its identifier |
| describe_resource | Returns the data available for the resource |
| describe_user | Provides information regarding the user |
| disassociate_delegate_from_resource | Removes a member from the resource's set of delegates |
| disassociate_member_from_group | Removes a member from a group |
| get_access_control_effect | 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_default_retention_policy | Gets the default retention policy details for the specified organization |
| get_mailbox_details | Requests a user's mailbox details for a specified organization and user |
| get_mail_domain | Gets details for a mail domain, including domain records required to configure your domain with recommended security |
| get_mobile_device_access_effect | Simulates the effect of the mobile device access rules for the given attributes of a sample access event |
| get_mobile_device_access_override | Gets the mobile device access override for the given WorkMail organization, user, and device |
| list_access_control_rules | Lists the access control rules for the specified organization |
| list_aliases | Creates a paginated call to list the aliases associated with a given entity |
| list_availability_configurations | List all the AvailabilityConfiguration's for the given WorkMail organization |
| list_group_members | Returns an overview of the members of a group |
| list_groups | Returns summaries of the organization's groups |
| list_mailbox_export_jobs | Lists the mailbox export jobs started for the specified organization within the last seven days |
| list_mailbox_permissions | Lists the mailbox permissions associated with a user, group, or resource mailbox |
| list_mail_domains | Lists the mail domains in a given Amazon WorkMail organization |
| list_mobile_device_access_overrides | Lists all the mobile device access overrides for any given combination of WorkMail organization, user, or device |
| list_mobile_device_access_rules | Lists the mobile device access rules for the specified Amazon WorkMail organization |
| list_organizations | Returns summaries of the customer's organizations |
| list_resource_delegates | Lists the delegates associated with a resource |
| list_resources | Returns summaries of the organization's resources |
| list_tags_for_resource | Lists the tags applied to an Amazon WorkMail organization resource |
| list_users | Returns summaries of the organization's users |
| put_access_control_rule | Adds a new access control rule for the specified organization |
| put_email_monitoring_configuration | Creates or updates the email monitoring configuration for a specified organization |
| put_inbound_dmarc_settings | Enables or disables a DMARC policy for a given organization |
| put_mailbox_permissions | Sets permissions for a user, group, or resource |
| put_mobile_device_access_override | Creates or updates a mobile device access override for the given WorkMail organization, user, and device |
| put_retention_policy | Puts a retention policy to the specified organization |
| register_mail_domain | Registers a new domain in Amazon WorkMail and SES, and configures it for use by WorkMail |
| register_to_work_mail | Registers an existing and disabled user, group, or resource for Amazon WorkMail use by associating a mailbox and calendaring capabilities |
| reset_password | Allows the administrator to reset the password for a user |
| start_mailbox_export_job | 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 |
| tag_resource | Applies the specified tags to the specified Amazon WorkMail organization resource |
| test_availability_configuration | Performs a test on an availability provider to ensure that access is allowed |
| untag_resource | Untags the specified tags from the specified Amazon WorkMail organization resource |
| update_availability_configuration | Updates an existing AvailabilityConfiguration for the given WorkMail organization and domain |
| update_default_mail_domain | Updates the default mail domain for an organization |
| update_mailbox_quota | Updates a user's current mailbox quota for a specified organization and user |
| update_mobile_device_access_rule | Updates a mobile device access rule for the specified Amazon WorkMail organization |
| update_primary_email_address | Updates the primary email for a user, group, or resource |
| update_resource | Updates data for the resource |
if (FALSE) {
svc <- workmail()
svc$associate_delegate_to_resource(
Foo = 123
)
}
Run the code above in your browser using DataLab