aws-sdk-workmail 1.21.0 → 1.26.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a5c1a31caca5a34b43b3793f9a5205aa5df5acf6
-  data.tar.gz: 90bfa47e61f9cf814476d1c9e1a0ad9a0c9d43a0
+SHA256:
+  metadata.gz: ed70c2f1707b432796fbcb7e7317467a787a09cbcd88d41b25d354b8c10b42d8
+  data.tar.gz: 62a69c41242f0e7ff71e940906f66522b95c8b89c3c3faed15bcc425016acad8
 SHA512:
-  metadata.gz: c6dd425a6372cb24aa40b50059d977443be97a94625fc3cd7c0222727860e2c3bb72db6185cdfb769999ef1aab1fdb3af342bd682bb786b82e809ecf6366e8db
-  data.tar.gz: bef43b086a68227097bd674e097035472dac6dfd94b21db4acfb03e7d8fa0ff482e39ab655a3591bfc4fb448575c34514d67294180bdb9d9602d7d8fc409054e
+  metadata.gz: 402d6c475a06e0d4579351ab2f0924277f91bea7dec3ef61ea33156a5c7010c5e11ea12ae54e7a1cb6a7b0c7c9642926f5a9315aa354c8c338ee1c118de31568
+  data.tar.gz: 6809a4a4c5b7052408ab467d87c669e4334f08c5ea171066cd7861c8d3b81afceded6ac2d867360b5e0a0604a30627fb2dad78d269d2690d95152c3ee84a4672

data/lib/aws-sdk-workmail.rb

@@ -24,17 +24,20 @@ require_relative 'aws-sdk-workmail/customizations'
 # methods each accept a hash of request parameters and return a response
 # structure.
 #
+#     work_mail = Aws::WorkMail::Client.new
+#     resp = work_mail.associate_delegate_to_resource(params)
+#
 # See {Client} for more information.
 #
 # # Errors
 #
-# Errors returned from Amazon WorkMail all
-# extend {Errors::ServiceError}.
+# Errors returned from Amazon WorkMail are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
 #
 #     begin
 #       # do stuff
 #     rescue Aws::WorkMail::Errors::ServiceError
-#       # rescues all service API errors
+#       # rescues all Amazon WorkMail API errors
 #     end
 #
 # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-workmail/customizations'
 # @service
 module Aws::WorkMail
 
-  GEM_VERSION = '1.21.0'
+  GEM_VERSION = '1.26.1'
 
 end

data/lib/aws-sdk-workmail/client.rb

@@ -24,12 +24,25 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
 Aws::Plugins::GlobalConfiguration.add_identifier(:workmail)
 
 module Aws::WorkMail
+  # An API client for WorkMail.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::WorkMail::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
+  #
+  # For details on configuring region and credentials see
+  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
+  #
+  # See {#initialize} for a full list of supported configuration options.
   class Client < Seahorse::Client::Base
 
     include Aws::ClientStubs
@@ -57,6 +70,7 @@ module Aws::WorkMail
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -93,7 +107,7 @@ module Aws::WorkMail
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -108,6 +122,12 @@ module Aws::WorkMail
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
     #
+    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
+    #     Used only in `adaptive` retry mode.  When true, the request will sleep
+    #     until there is sufficent client side capacity to retry the request.
+    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
+    #     not retry instead of sleeping.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -132,6 +152,10 @@ module Aws::WorkMail
     #     When `true`, an attempt is made to coerce request parameters into
     #     the required types.
     #
+    #   @option options [Boolean] :correct_clock_skew (true)
+    #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
+    #     a clock skew correction and retry requests with skewed client clocks.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -139,7 +163,7 @@ module Aws::WorkMail
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +178,7 @@ module Aws::WorkMail
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -166,15 +190,29 @@ module Aws::WorkMail
     #     The Logger instance to send log messages to.  If this option
     #     is not set, logging will be disabled.
     #
+    #   @option options [Integer] :max_attempts (3)
+    #     An integer representing the maximum number attempts that will be made for
+    #     a single request, including the initial attempt.  For example,
+    #     setting this value to 5 will result in a request being retried up to
+    #     4 times. Used in `standard` and `adaptive` retry modes.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Proc] :retry_backoff
+    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
+    #     This option is only used in the `legacy` retry mode.
+    #
     #   @option options [Float] :retry_base_delay (0.3)
-    #     The base delay in seconds used by the default backoff function.
+    #     The base delay in seconds used by the default backoff function. This option
+    #     is only used in the `legacy` retry mode.
     #
     #   @option options [Symbol] :retry_jitter (:none)
-    #     A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
+    #     A delay randomiser function used by the default backoff function.
+    #     Some predefined functions can be referenced by name - :none, :equal, :full,
+    #     otherwise a Proc that takes and returns a number. This option is only used
+    #     in the `legacy` retry mode.
     #
     #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
     #
@@ -182,11 +220,30 @@ module Aws::WorkMail
     #     The maximum number of times to retry failed requests.  Only
     #     ~ 500 level server errors and certain ~ 400 level client errors
     #     are retried.  Generally, these are throttling errors, data
-    #     checksum errors, networking errors, timeout errors and auth
-    #     errors from expired credentials.
+    #     checksum errors, networking errors, timeout errors, auth errors,
+    #     endpoint discovery, and errors from expired credentials.
+    #     This option is only used in the `legacy` retry mode.
     #
     #   @option options [Integer] :retry_max_delay (0)
-    #     The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
+    #     The maximum number of seconds to delay between retries (0 for no limit)
+    #     used by the default backoff function. This option is only used in the
+    #     `legacy` retry mode.
+    #
+    #   @option options [String] :retry_mode ("legacy")
+    #     Specifies which retry algorithm to use. Values are:
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -219,16 +276,15 @@ module Aws::WorkMail
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
     #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before rasing a
+    #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
     #   @option options [Integer] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
-    #     safely be set
-    #     per-request on the session yeidled by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idble before it is
+    #     seconds a connection is allowed to sit idle before it is
     #     considered stale.  Stale connections are closed and removed
     #     from the pool before making a request.
     #
@@ -237,7 +293,7 @@ module Aws::WorkMail
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yeidled by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -471,7 +527,7 @@ module Aws::WorkMail
     # Deletes an access control rule for the specified WorkMail
     # organization.
     #
-    # @option params [String] :organization_id
+    # @option params [required, String] :organization_id
     #   The identifier for the organization.
     #
     # @option params [required, String] :name
@@ -482,7 +538,7 @@ module Aws::WorkMail
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_access_control_rule({
-    #     organization_id: "OrganizationId",
+    #     organization_id: "OrganizationId", # required
     #     name: "AccessControlRuleName", # required
     #   })
     #
@@ -614,6 +670,33 @@ module Aws::WorkMail
       req.send_request(options)
     end
 
+    # Deletes the specified retention policy from the specified
+    # organization.
+    #
+    # @option params [required, String] :organization_id
+    #   The organization ID.
+    #
+    # @option params [required, String] :id
+    #   The retention policy ID.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_retention_policy({
+    #     organization_id: "OrganizationId", # required
+    #     id: "ShortString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/DeleteRetentionPolicy AWS API Documentation
+    #
+    # @overload delete_retention_policy(params = {})
+    # @param [Hash] params ({})
+    def delete_retention_policy(params = {}, options = {})
+      req = build_request(:delete_retention_policy, params)
+      req.send_request(options)
+    end
+
     # 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.
@@ -965,6 +1048,44 @@ module Aws::WorkMail
       req.send_request(options)
     end
 
+    # Gets the default retention policy details for the specified
+    # organization.
+    #
+    # @option params [required, String] :organization_id
+    #   The organization ID.
+    #
+    # @return [Types::GetDefaultRetentionPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetDefaultRetentionPolicyResponse#id #id} => String
+    #   * {Types::GetDefaultRetentionPolicyResponse#name #name} => String
+    #   * {Types::GetDefaultRetentionPolicyResponse#description #description} => String
+    #   * {Types::GetDefaultRetentionPolicyResponse#folder_configurations #folder_configurations} => Array&lt;Types::FolderConfiguration&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_default_retention_policy({
+    #     organization_id: "OrganizationId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.id #=> String
+    #   resp.name #=> String
+    #   resp.description #=> String
+    #   resp.folder_configurations #=> Array
+    #   resp.folder_configurations[0].name #=> String, one of "INBOX", "DELETED_ITEMS", "SENT_ITEMS", "DRAFTS", "JUNK_EMAIL"
+    #   resp.folder_configurations[0].action #=> String, one of "NONE", "DELETE", "PERMANENTLY_DELETE"
+    #   resp.folder_configurations[0].period #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/GetDefaultRetentionPolicy AWS API Documentation
+    #
+    # @overload get_default_retention_policy(params = {})
+    # @param [Hash] params ({})
+    def get_default_retention_policy(params = {}, options = {})
+      req = build_request(:get_default_retention_policy, params)
+      req.send_request(options)
+    end
+
     # Requests a user's mailbox details for a specified organization and
     # user.
     #
@@ -1067,6 +1188,8 @@ module Aws::WorkMail
     #   * {Types::ListAliasesResponse#aliases #aliases} => Array&lt;String&gt;
     #   * {Types::ListAliasesResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_aliases({
@@ -1113,6 +1236,8 @@ module Aws::WorkMail
     #   * {Types::ListGroupMembersResponse#members #members} => Array&lt;Types::Member&gt;
     #   * {Types::ListGroupMembersResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_group_members({
@@ -1159,6 +1284,8 @@ module Aws::WorkMail
     #   * {Types::ListGroupsResponse#groups #groups} => Array&lt;Types::Group&gt;
     #   * {Types::ListGroupsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_groups({
@@ -1210,6 +1337,8 @@ module Aws::WorkMail
     #   * {Types::ListMailboxPermissionsResponse#permissions #permissions} => Array&lt;Types::Permission&gt;
     #   * {Types::ListMailboxPermissionsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_mailbox_permissions({
@@ -1237,7 +1366,7 @@ module Aws::WorkMail
       req.send_request(options)
     end
 
-    # Returns summaries of the customer's non-deleted organizations.
+    # Returns summaries of the customer's organizations.
     #
     # @option params [String] :next_token
     #   The token to use to retrieve the next page of results. The first call
@@ -1251,6 +1380,8 @@ module Aws::WorkMail
     #   * {Types::ListOrganizationsResponse#organization_summaries #organization_summaries} => Array&lt;Types::OrganizationSummary&gt;
     #   * {Types::ListOrganizationsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_organizations({
@@ -1298,6 +1429,8 @@ module Aws::WorkMail
     #   * {Types::ListResourceDelegatesResponse#delegates #delegates} => Array&lt;Types::Delegate&gt;
     #   * {Types::ListResourceDelegatesResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_resource_delegates({
@@ -1340,6 +1473,8 @@ module Aws::WorkMail
     #   * {Types::ListResourcesResponse#resources #resources} => Array&lt;Types::Resource&gt;
     #   * {Types::ListResourcesResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_resources({
@@ -1416,6 +1551,8 @@ module Aws::WorkMail
     #   * {Types::ListUsersResponse#users #users} => Array&lt;Types::User&gt;
     #   * {Types::ListUsersResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_users({
@@ -1555,6 +1692,50 @@ module Aws::WorkMail
       req.send_request(options)
     end
 
+    # Puts a retention policy to the specified organization.
+    #
+    # @option params [required, String] :organization_id
+    #   The organization ID.
+    #
+    # @option params [String] :id
+    #   The retention policy ID.
+    #
+    # @option params [required, String] :name
+    #   The retention policy name.
+    #
+    # @option params [String] :description
+    #   The retention policy description.
+    #
+    # @option params [required, Array<Types::FolderConfiguration>] :folder_configurations
+    #   The retention policy folder configurations.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_retention_policy({
+    #     organization_id: "OrganizationId", # required
+    #     id: "ShortString",
+    #     name: "ShortString", # required
+    #     description: "PolicyDescription",
+    #     folder_configurations: [ # required
+    #       {
+    #         name: "INBOX", # required, accepts INBOX, DELETED_ITEMS, SENT_ITEMS, DRAFTS, JUNK_EMAIL
+    #         action: "NONE", # required, accepts NONE, DELETE, PERMANENTLY_DELETE
+    #         period: 1,
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/PutRetentionPolicy AWS API Documentation
+    #
+    # @overload put_retention_policy(params = {})
+    # @param [Hash] params ({})
+    def put_retention_policy(params = {}, options = {})
+      req = build_request(:put_retention_policy, params)
+      req.send_request(options)
+    end
+
     # 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
@@ -1810,7 +1991,7 @@ module Aws::WorkMail
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-workmail'
-      context[:gem_version] = '1.21.0'
+      context[:gem_version] = '1.26.1'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-workmail/client_api.rb

@@ -46,6 +46,8 @@ module Aws::WorkMail
     DeleteMailboxPermissionsResponse = Shapes::StructureShape.new(name: 'DeleteMailboxPermissionsResponse')
     DeleteResourceRequest = Shapes::StructureShape.new(name: 'DeleteResourceRequest')
     DeleteResourceResponse = Shapes::StructureShape.new(name: 'DeleteResourceResponse')
+    DeleteRetentionPolicyRequest = Shapes::StructureShape.new(name: 'DeleteRetentionPolicyRequest')
+    DeleteRetentionPolicyResponse = Shapes::StructureShape.new(name: 'DeleteRetentionPolicyResponse')
     DeleteUserRequest = Shapes::StructureShape.new(name: 'DeleteUserRequest')
     DeleteUserResponse = Shapes::StructureShape.new(name: 'DeleteUserResponse')
     DeregisterFromWorkMailRequest = Shapes::StructureShape.new(name: 'DeregisterFromWorkMailRequest')
@@ -70,8 +72,13 @@ module Aws::WorkMail
     EntityNotFoundException = Shapes::StructureShape.new(name: 'EntityNotFoundException')
     EntityState = Shapes::StringShape.new(name: 'EntityState')
     EntityStateException = Shapes::StructureShape.new(name: 'EntityStateException')
+    FolderConfiguration = Shapes::StructureShape.new(name: 'FolderConfiguration')
+    FolderConfigurations = Shapes::ListShape.new(name: 'FolderConfigurations')
+    FolderName = Shapes::StringShape.new(name: 'FolderName')
     GetAccessControlEffectRequest = Shapes::StructureShape.new(name: 'GetAccessControlEffectRequest')
     GetAccessControlEffectResponse = Shapes::StructureShape.new(name: 'GetAccessControlEffectResponse')
+    GetDefaultRetentionPolicyRequest = Shapes::StructureShape.new(name: 'GetDefaultRetentionPolicyRequest')
+    GetDefaultRetentionPolicyResponse = Shapes::StructureShape.new(name: 'GetDefaultRetentionPolicyResponse')
     GetMailboxDetailsRequest = Shapes::StructureShape.new(name: 'GetMailboxDetailsRequest')
     GetMailboxDetailsResponse = Shapes::StructureShape.new(name: 'GetMailboxDetailsResponse')
     Group = Shapes::StructureShape.new(name: 'Group')
@@ -125,10 +132,13 @@ module Aws::WorkMail
     PermissionType = Shapes::StringShape.new(name: 'PermissionType')
     PermissionValues = Shapes::ListShape.new(name: 'PermissionValues')
     Permissions = Shapes::ListShape.new(name: 'Permissions')
+    PolicyDescription = Shapes::StringShape.new(name: 'PolicyDescription')
     PutAccessControlRuleRequest = Shapes::StructureShape.new(name: 'PutAccessControlRuleRequest')
     PutAccessControlRuleResponse = Shapes::StructureShape.new(name: 'PutAccessControlRuleResponse')
     PutMailboxPermissionsRequest = Shapes::StructureShape.new(name: 'PutMailboxPermissionsRequest')
     PutMailboxPermissionsResponse = Shapes::StructureShape.new(name: 'PutMailboxPermissionsResponse')
+    PutRetentionPolicyRequest = Shapes::StructureShape.new(name: 'PutRetentionPolicyRequest')
+    PutRetentionPolicyResponse = Shapes::StructureShape.new(name: 'PutRetentionPolicyResponse')
     RegisterToWorkMailRequest = Shapes::StructureShape.new(name: 'RegisterToWorkMailRequest')
     RegisterToWorkMailResponse = Shapes::StructureShape.new(name: 'RegisterToWorkMailResponse')
     ReservedNameException = Shapes::StructureShape.new(name: 'ReservedNameException')
@@ -141,6 +151,9 @@ module Aws::WorkMail
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResourceType = Shapes::StringShape.new(name: 'ResourceType')
     Resources = Shapes::ListShape.new(name: 'Resources')
+    RetentionAction = Shapes::StringShape.new(name: 'RetentionAction')
+    RetentionPeriod = Shapes::IntegerShape.new(name: 'RetentionPeriod')
+    ShortString = Shapes::StringShape.new(name: 'ShortString')
     String = Shapes::StringShape.new(name: 'String')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
@@ -242,7 +255,7 @@ module Aws::WorkMail
     Delegate.add_member(:type, Shapes::ShapeRef.new(shape: MemberType, required: true, location_name: "Type"))
     Delegate.struct_class = Types::Delegate
 
-    DeleteAccessControlRuleRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, location_name: "OrganizationId"))
+    DeleteAccessControlRuleRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
     DeleteAccessControlRuleRequest.add_member(:name, Shapes::ShapeRef.new(shape: AccessControlRuleName, required: true, location_name: "Name"))
     DeleteAccessControlRuleRequest.struct_class = Types::DeleteAccessControlRuleRequest
 
@@ -274,6 +287,12 @@ module Aws::WorkMail
 
     DeleteResourceResponse.struct_class = Types::DeleteResourceResponse
 
+    DeleteRetentionPolicyRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
+    DeleteRetentionPolicyRequest.add_member(:id, Shapes::ShapeRef.new(shape: ShortString, required: true, location_name: "Id"))
+    DeleteRetentionPolicyRequest.struct_class = Types::DeleteRetentionPolicyRequest
+
+    DeleteRetentionPolicyResponse.struct_class = Types::DeleteRetentionPolicyResponse
+
     DeleteUserRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
     DeleteUserRequest.add_member(:user_id, Shapes::ShapeRef.new(shape: WorkMailIdentifier, required: true, location_name: "UserId"))
     DeleteUserRequest.struct_class = Types::DeleteUserRequest
@@ -372,6 +391,13 @@ module Aws::WorkMail
     EntityStateException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     EntityStateException.struct_class = Types::EntityStateException
 
+    FolderConfiguration.add_member(:name, Shapes::ShapeRef.new(shape: FolderName, required: true, location_name: "Name"))
+    FolderConfiguration.add_member(:action, Shapes::ShapeRef.new(shape: RetentionAction, required: true, location_name: "Action"))
+    FolderConfiguration.add_member(:period, Shapes::ShapeRef.new(shape: RetentionPeriod, location_name: "Period"))
+    FolderConfiguration.struct_class = Types::FolderConfiguration
+
+    FolderConfigurations.member = Shapes::ShapeRef.new(shape: FolderConfiguration)
+
     GetAccessControlEffectRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
     GetAccessControlEffectRequest.add_member(:ip_address, Shapes::ShapeRef.new(shape: IpAddress, required: true, location_name: "IpAddress"))
     GetAccessControlEffectRequest.add_member(:action, Shapes::ShapeRef.new(shape: AccessControlRuleAction, required: true, location_name: "Action"))
@@ -382,6 +408,15 @@ module Aws::WorkMail
     GetAccessControlEffectResponse.add_member(:matched_rules, Shapes::ShapeRef.new(shape: AccessControlRuleNameList, location_name: "MatchedRules"))
     GetAccessControlEffectResponse.struct_class = Types::GetAccessControlEffectResponse
 
+    GetDefaultRetentionPolicyRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
+    GetDefaultRetentionPolicyRequest.struct_class = Types::GetDefaultRetentionPolicyRequest
+
+    GetDefaultRetentionPolicyResponse.add_member(:id, Shapes::ShapeRef.new(shape: ShortString, location_name: "Id"))
+    GetDefaultRetentionPolicyResponse.add_member(:name, Shapes::ShapeRef.new(shape: ShortString, location_name: "Name"))
+    GetDefaultRetentionPolicyResponse.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "Description"))
+    GetDefaultRetentionPolicyResponse.add_member(:folder_configurations, Shapes::ShapeRef.new(shape: FolderConfigurations, location_name: "FolderConfigurations"))
+    GetDefaultRetentionPolicyResponse.struct_class = Types::GetDefaultRetentionPolicyResponse
+
     GetMailboxDetailsRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
     GetMailboxDetailsRequest.add_member(:user_id, Shapes::ShapeRef.new(shape: WorkMailIdentifier, required: true, location_name: "UserId"))
     GetMailboxDetailsRequest.struct_class = Types::GetMailboxDetailsRequest
@@ -565,6 +600,15 @@ module Aws::WorkMail
 
     PutMailboxPermissionsResponse.struct_class = Types::PutMailboxPermissionsResponse
 
+    PutRetentionPolicyRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
+    PutRetentionPolicyRequest.add_member(:id, Shapes::ShapeRef.new(shape: ShortString, location_name: "Id"))
+    PutRetentionPolicyRequest.add_member(:name, Shapes::ShapeRef.new(shape: ShortString, required: true, location_name: "Name"))
+    PutRetentionPolicyRequest.add_member(:description, Shapes::ShapeRef.new(shape: PolicyDescription, location_name: "Description"))
+    PutRetentionPolicyRequest.add_member(:folder_configurations, Shapes::ShapeRef.new(shape: FolderConfigurations, required: true, location_name: "FolderConfigurations"))
+    PutRetentionPolicyRequest.struct_class = Types::PutRetentionPolicyRequest
+
+    PutRetentionPolicyResponse.struct_class = Types::PutRetentionPolicyResponse
+
     RegisterToWorkMailRequest.add_member(:organization_id, Shapes::ShapeRef.new(shape: OrganizationId, required: true, location_name: "OrganizationId"))
     RegisterToWorkMailRequest.add_member(:entity_id, Shapes::ShapeRef.new(shape: WorkMailIdentifier, required: true, location_name: "EntityId"))
     RegisterToWorkMailRequest.add_member(:email, Shapes::ShapeRef.new(shape: EmailAddress, required: true, location_name: "Email"))
@@ -835,6 +879,17 @@ module Aws::WorkMail
         o.errors << Shapes::ShapeRef.new(shape: OrganizationStateException)
       end)
 
+      api.add_operation(:delete_retention_policy, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DeleteRetentionPolicy"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DeleteRetentionPolicyRequest)
+        o.output = Shapes::ShapeRef.new(shape: DeleteRetentionPolicyResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: OrganizationNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OrganizationStateException)
+      end)
+
       api.add_operation(:delete_user, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DeleteUser"
         o.http_method = "POST"
@@ -950,6 +1005,18 @@ module Aws::WorkMail
         o.errors << Shapes::ShapeRef.new(shape: OrganizationStateException)
       end)
 
+      api.add_operation(:get_default_retention_policy, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetDefaultRetentionPolicy"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetDefaultRetentionPolicyRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetDefaultRetentionPolicyResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: OrganizationNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OrganizationStateException)
+        o.errors << Shapes::ShapeRef.new(shape: EntityNotFoundException)
+      end)
+
       api.add_operation(:get_mailbox_details, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetMailboxDetails"
         o.http_method = "POST"
@@ -1148,6 +1215,18 @@ module Aws::WorkMail
         o.errors << Shapes::ShapeRef.new(shape: OrganizationStateException)
       end)
 
+      api.add_operation(:put_retention_policy, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutRetentionPolicy"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PutRetentionPolicyRequest)
+        o.output = Shapes::ShapeRef.new(shape: PutRetentionPolicyResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: OrganizationNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OrganizationStateException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+      end)
+
       api.add_operation(:register_to_work_mail, Seahorse::Model::Operation.new.tap do |o|
         o.name = "RegisterToWorkMail"
         o.http_method = "POST"

data/lib/aws-sdk-workmail/errors.rb

@@ -6,6 +6,47 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::WorkMail
+
+  # When WorkMail returns an error response, the Ruby SDK constructs and raises an error.
+  # These errors all extend Aws::WorkMail::Errors::ServiceError < {Aws::Errors::ServiceError}
+  #
+  # You can rescue all WorkMail errors using ServiceError:
+  #
+  #     begin
+  #       # do stuff
+  #     rescue Aws::WorkMail::Errors::ServiceError
+  #       # rescues all WorkMail API errors
+  #     end
+  #
+  #
+  # ## Request Context
+  # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
+  # information about the request that generated the error.
+  # See {Seahorse::Client::RequestContext} for more information.
+  #
+  # ## Error Classes
+  # * {DirectoryServiceAuthenticationFailedException}
+  # * {DirectoryUnavailableException}
+  # * {EmailAddressInUseException}
+  # * {EntityAlreadyRegisteredException}
+  # * {EntityNotFoundException}
+  # * {EntityStateException}
+  # * {InvalidConfigurationException}
+  # * {InvalidParameterException}
+  # * {InvalidPasswordException}
+  # * {LimitExceededException}
+  # * {MailDomainNotFoundException}
+  # * {MailDomainStateException}
+  # * {NameAvailabilityException}
+  # * {OrganizationNotFoundException}
+  # * {OrganizationStateException}
+  # * {ReservedNameException}
+  # * {ResourceNotFoundException}
+  # * {TooManyTagsException}
+  # * {UnsupportedOperationException}
+  #
+  # Additionally, error classes are dynamically generated for service errors based on the error code
+  # if they are not defined above.
   module Errors
 
     extend Aws::Errors::DynamicErrors
@@ -23,7 +64,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class DirectoryUnavailableException < ServiceError
@@ -39,7 +79,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class EmailAddressInUseException < ServiceError
@@ -55,7 +94,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class EntityAlreadyRegisteredException < ServiceError
@@ -71,7 +109,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class EntityNotFoundException < ServiceError
@@ -87,7 +124,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class EntityStateException < ServiceError
@@ -103,7 +139,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidConfigurationException < ServiceError
@@ -119,7 +154,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidParameterException < ServiceError
@@ -135,7 +169,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidPasswordException < ServiceError
@@ -151,7 +184,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class LimitExceededException < ServiceError
@@ -167,7 +199,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class MailDomainNotFoundException < ServiceError
@@ -183,7 +214,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class MailDomainStateException < ServiceError
@@ -199,7 +229,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class NameAvailabilityException < ServiceError
@@ -215,7 +244,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class OrganizationNotFoundException < ServiceError
@@ -231,7 +259,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class OrganizationStateException < ServiceError
@@ -247,7 +274,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class ReservedNameException < ServiceError
@@ -263,7 +289,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class ResourceNotFoundException < ServiceError
@@ -279,7 +304,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class TooManyTagsException < ServiceError
@@ -295,7 +319,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
     class UnsupportedOperationException < ServiceError
@@ -311,7 +334,6 @@ module Aws::WorkMail
       def message
         @message || @data[:message]
       end
-
     end
 
   end

data/lib/aws-sdk-workmail/resource.rb

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::WorkMail
+
   class Resource
 
     # @param options ({})

data/lib/aws-sdk-workmail/types.rb

@@ -363,7 +363,7 @@ module Aws::WorkMail
     #   data as a hash:
     #
     #       {
-    #         organization_id: "OrganizationId",
+    #         organization_id: "OrganizationId", # required
     #         name: "AccessControlRuleName", # required
     #       }
     #
@@ -517,6 +517,34 @@ module Aws::WorkMail
     #
     class DeleteResourceResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass DeleteRetentionPolicyRequest
+    #   data as a hash:
+    #
+    #       {
+    #         organization_id: "OrganizationId", # required
+    #         id: "ShortString", # required
+    #       }
+    #
+    # @!attribute [rw] organization_id
+    #   The organization ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The retention policy ID.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/DeleteRetentionPolicyRequest AWS API Documentation
+    #
+    class DeleteRetentionPolicyRequest < Struct.new(
+      :organization_id,
+      :id)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/DeleteRetentionPolicyResponse AWS API Documentation
+    #
+    class DeleteRetentionPolicyResponse < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass DeleteUserRequest
     #   data as a hash:
     #
@@ -1010,6 +1038,41 @@ module Aws::WorkMail
       include Aws::Structure
     end
 
+    # The configuration applied to an organization's folders by its
+    # retention policy.
+    #
+    # @note When making an API call, you may pass FolderConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         name: "INBOX", # required, accepts INBOX, DELETED_ITEMS, SENT_ITEMS, DRAFTS, JUNK_EMAIL
+    #         action: "NONE", # required, accepts NONE, DELETE, PERMANENTLY_DELETE
+    #         period: 1,
+    #       }
+    #
+    # @!attribute [rw] name
+    #   The folder name.
+    #   @return [String]
+    #
+    # @!attribute [rw] action
+    #   The action to take on the folder contents at the end of the folder
+    #   configuration period.
+    #   @return [String]
+    #
+    # @!attribute [rw] period
+    #   The period of time at which the folder configuration action is
+    #   applied.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/FolderConfiguration AWS API Documentation
+    #
+    class FolderConfiguration < Struct.new(
+      :name,
+      :action,
+      :period)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetAccessControlEffectRequest
     #   data as a hash:
     #
@@ -1064,6 +1127,50 @@ module Aws::WorkMail
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetDefaultRetentionPolicyRequest
+    #   data as a hash:
+    #
+    #       {
+    #         organization_id: "OrganizationId", # required
+    #       }
+    #
+    # @!attribute [rw] organization_id
+    #   The organization ID.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/GetDefaultRetentionPolicyRequest AWS API Documentation
+    #
+    class GetDefaultRetentionPolicyRequest < Struct.new(
+      :organization_id)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] id
+    #   The retention policy ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The retention policy name.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The retention policy description.
+    #   @return [String]
+    #
+    # @!attribute [rw] folder_configurations
+    #   The retention policy folder configurations.
+    #   @return [Array<Types::FolderConfiguration>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/GetDefaultRetentionPolicyResponse AWS API Documentation
+    #
+    class GetDefaultRetentionPolicyResponse < Struct.new(
+      :id,
+      :name,
+      :description,
+      :folder_configurations)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetMailboxDetailsRequest
     #   data as a hash:
     #
@@ -1960,6 +2067,58 @@ module Aws::WorkMail
     #
     class PutMailboxPermissionsResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass PutRetentionPolicyRequest
+    #   data as a hash:
+    #
+    #       {
+    #         organization_id: "OrganizationId", # required
+    #         id: "ShortString",
+    #         name: "ShortString", # required
+    #         description: "PolicyDescription",
+    #         folder_configurations: [ # required
+    #           {
+    #             name: "INBOX", # required, accepts INBOX, DELETED_ITEMS, SENT_ITEMS, DRAFTS, JUNK_EMAIL
+    #             action: "NONE", # required, accepts NONE, DELETE, PERMANENTLY_DELETE
+    #             period: 1,
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] organization_id
+    #   The organization ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The retention policy ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The retention policy name.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The retention policy description.
+    #   @return [String]
+    #
+    # @!attribute [rw] folder_configurations
+    #   The retention policy folder configurations.
+    #   @return [Array<Types::FolderConfiguration>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/PutRetentionPolicyRequest AWS API Documentation
+    #
+    class PutRetentionPolicyRequest < Struct.new(
+      :organization_id,
+      :id,
+      :name,
+      :description,
+      :folder_configurations)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workmail-2017-10-01/PutRetentionPolicyResponse AWS API Documentation
+    #
+    class PutRetentionPolicyResponse < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass RegisterToWorkMailRequest
     #   data as a hash:
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-workmail
 version: !ruby/object:Gem::Version
-  version: 1.21.0
+  version: 1.26.1
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-12 00:00:00.000000000 Z
+date: 2020-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.71.0
+        version: 3.99.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.71.0
+        version: 3.99.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -81,7 +81,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2.3
+rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - Amazon WorkMail