aws-sdk-backup 1.10.0 → 1.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 60dec10e57dc78bb51f2d71535e6e3cdcb3b3e12
-  data.tar.gz: 4407ecf91bc6ad35017373b3990d99afe0a8b8b4
+SHA256:
+  metadata.gz: b506b404fb3b2a29aed6bf3a11a4686caf792c18c1225893010edf06f431c4c9
+  data.tar.gz: fe03cad0a710225a98309c2fdcabea2148110e3af9ba8c119259ed5866fb5a94
 SHA512:
-  metadata.gz: c14c1525c4bb0d75815fd9b31a5e2a374bd11d6e1e6e928da443a7bf3d83aa9e95e432552183f6acb7911b08179deddbecc29f850d1146b66867ff1c7d7ea501
-  data.tar.gz: '025559144030cd4823b8e095a120a11a63b4c9536c93bc86f8c2ee40a9285f17fd61c5a4f8bbf55d985ad808497c48390cad8ac789d29b7e1cc30e522eeb41b8'
+  metadata.gz: 3a2dafd8f7a852ca4853d007c2dfc4f77a9fd87f559b86f981428df69ae6c7353ab857b9daca8f57f137fb98cbb8a66ba16d5a758eca79687cf68d2998a5acce
+  data.tar.gz: e1d5a55159523049ed6ea2ca4135d6d6aee018d31712076936887d7599bcc9fa543ab20fc4649fff026cce301c393241179694a529e7652db8ac9b9f1741fc19

data/lib/aws-sdk-backup.rb

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

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

@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 Aws::Plugins::GlobalConfiguration.add_identifier(:backup)
 
 module Aws::Backup
+  # An API client for Backup.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::Backup::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
@@ -93,7 +105,7 @@ module Aws::Backup
     #   @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 +120,12 @@ module Aws::Backup
     #     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 +150,10 @@ module Aws::Backup
     #     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 +161,7 @@ module Aws::Backup
     #   @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 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 +176,7 @@ module Aws::Backup
     #     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 +188,29 @@ module Aws::Backup
     #     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 +218,30 @@ module Aws::Backup
     #     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
     #
@@ -209,16 +264,15 @@ module Aws::Backup
     #     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.
     #
@@ -227,7 +281,7 @@ module Aws::Backup
     #     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`.
@@ -257,8 +311,8 @@ module Aws::Backup
     # Backup plans are documents that contain information that AWS Backup
     # uses to schedule tasks that create recovery points of resources.
     #
-    # If you call `CreateBackupPlan` with a plan that already exists, the
-    # existing `backupPlanId` is returned.
+    # If you call `CreateBackupPlan` with a plan that already exists, an
+    # `AlreadyExistsException` is returned.
     #
     # @option params [required, Types::BackupPlanInput] :backup_plan
     #   Specifies the body of a backup plan. Includes a `BackupPlanName` and
@@ -301,6 +355,15 @@ module Aws::Backup
     #           recovery_point_tags: {
     #             "TagKey" => "TagValue",
     #           },
+    #           copy_actions: [
+    #             {
+    #               lifecycle: {
+    #                 move_to_cold_storage_after_days: 1,
+    #                 delete_after_days: 1,
+    #               },
+    #               destination_backup_vault_arn: "ARN", # required
+    #             },
+    #           ],
     #         },
     #       ],
     #     },
@@ -338,13 +401,13 @@ module Aws::Backup
     #
     #   `ConditionValue:"finance"`
     #
-    #   `ConditionType:"StringEquals"`
+    #   `ConditionType:"STRINGEQUALS"`
     #
     # * `ConditionKey:"importance"`
     #
     #   `ConditionValue:"critical"`
     #
-    #   `ConditionType:"StringEquals"`
+    #   `ConditionType:"STRINGEQUALS"`
     #
     # Using these patterns would back up all Amazon Elastic Block Store
     # (Amazon EBS) volumes that are tagged as `"department=finance"`,
@@ -365,11 +428,6 @@ module Aws::Backup
     #   Specifies the body of a request to assign a set of resources to a
     #   backup plan.
     #
-    #   It includes an array of resources, an optional array of patterns to
-    #   exclude resources, an optional role to provide access to the AWS
-    #   service the resource belongs to, and an optional array of tags used to
-    #   identify a set of resources.
-    #
     # @option params [String] :creator_request_id
     #   A unique string that identifies the request and allows failed requests
     #   to be retried without the risk of executing the operation twice.
@@ -545,7 +603,7 @@ module Aws::Backup
     # @option params [required, String] :backup_vault_name
     #   The name of a logical container where backups are stored. Backup
     #   vaults are identified by names that are unique to the account used to
-    #   create them and theAWS Region where they are created. They consist of
+    #   create them and the AWS Region where they are created. They consist of
     #   lowercase letters, numbers, and hyphens.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -751,8 +809,52 @@ module Aws::Backup
       req.send_request(options)
     end
 
+    # Returns metadata associated with creating a copy of a resource.
+    #
+    # @option params [required, String] :copy_job_id
+    #   Uniquely identifies a copy job.
+    #
+    # @return [Types::DescribeCopyJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeCopyJobOutput#copy_job #copy_job} => Types::CopyJob
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_copy_job({
+    #     copy_job_id: "string", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.copy_job.copy_job_id #=> String
+    #   resp.copy_job.source_backup_vault_arn #=> String
+    #   resp.copy_job.source_recovery_point_arn #=> String
+    #   resp.copy_job.destination_backup_vault_arn #=> String
+    #   resp.copy_job.destination_recovery_point_arn #=> String
+    #   resp.copy_job.resource_arn #=> String
+    #   resp.copy_job.creation_date #=> Time
+    #   resp.copy_job.completion_date #=> Time
+    #   resp.copy_job.state #=> String, one of "CREATED", "RUNNING", "COMPLETED", "FAILED"
+    #   resp.copy_job.status_message #=> String
+    #   resp.copy_job.backup_size_in_bytes #=> Integer
+    #   resp.copy_job.iam_role_arn #=> String
+    #   resp.copy_job.created_by.backup_plan_id #=> String
+    #   resp.copy_job.created_by.backup_plan_arn #=> String
+    #   resp.copy_job.created_by.backup_plan_version #=> String
+    #   resp.copy_job.created_by.backup_rule_id #=> String
+    #   resp.copy_job.resource_type #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/DescribeCopyJob AWS API Documentation
+    #
+    # @overload describe_copy_job(params = {})
+    # @param [Hash] params ({})
+    def describe_copy_job(params = {}, options = {})
+      req = build_request(:describe_copy_job, params)
+      req.send_request(options)
+    end
+
     # Returns information about a saved resource, including the last time it
-    # was backed-up, its Amazon Resource Name (ARN), and the AWS service
+    # was backed up, its Amazon Resource Name (ARN), and the AWS service
     # type of the saved resource.
     #
     # @option params [required, String] :resource_arn
@@ -861,6 +963,31 @@ module Aws::Backup
       req.send_request(options)
     end
 
+    # Returns the current service opt-in settings for the region. If the
+    # service has a value set to true, AWS Backup will attempt to protect
+    # that service's resources in this region, when included in an
+    # on-demand backup or scheduled backup plan. If the value is set to
+    # false for a service, AWS Backup will not attempt to protect that
+    # service's resources in this region.
+    #
+    # @return [Types::DescribeRegionSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeRegionSettingsOutput#resource_type_opt_in_preference #resource_type_opt_in_preference} => Hash&lt;String,Boolean&gt;
+    #
+    # @example Response structure
+    #
+    #   resp.resource_type_opt_in_preference #=> Hash
+    #   resp.resource_type_opt_in_preference["ResourceType"] #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/DescribeRegionSettings AWS API Documentation
+    #
+    # @overload describe_region_settings(params = {})
+    # @param [Hash] params ({})
+    def describe_region_settings(params = {}, options = {})
+      req = build_request(:describe_region_settings, params)
+      req.send_request(options)
+    end
+
     # Returns metadata associated with a restore job that is specified by a
     # job ID.
     #
@@ -981,6 +1108,10 @@ module Aws::Backup
     #   resp.backup_plan.rules[0].recovery_point_tags #=> Hash
     #   resp.backup_plan.rules[0].recovery_point_tags["TagKey"] #=> String
     #   resp.backup_plan.rules[0].rule_id #=> String
+    #   resp.backup_plan.rules[0].copy_actions #=> Array
+    #   resp.backup_plan.rules[0].copy_actions[0].lifecycle.move_to_cold_storage_after_days #=> Integer
+    #   resp.backup_plan.rules[0].copy_actions[0].lifecycle.delete_after_days #=> Integer
+    #   resp.backup_plan.rules[0].copy_actions[0].destination_backup_vault_arn #=> String
     #   resp.backup_plan_id #=> String
     #   resp.backup_plan_arn #=> String
     #   resp.version_id #=> String
@@ -1027,6 +1158,10 @@ module Aws::Backup
     #   resp.backup_plan.rules[0].recovery_point_tags #=> Hash
     #   resp.backup_plan.rules[0].recovery_point_tags["TagKey"] #=> String
     #   resp.backup_plan.rules[0].rule_id #=> String
+    #   resp.backup_plan.rules[0].copy_actions #=> Array
+    #   resp.backup_plan.rules[0].copy_actions[0].lifecycle.move_to_cold_storage_after_days #=> Integer
+    #   resp.backup_plan.rules[0].copy_actions[0].lifecycle.delete_after_days #=> Integer
+    #   resp.backup_plan.rules[0].copy_actions[0].destination_backup_vault_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/GetBackupPlanFromJSON AWS API Documentation
     #
@@ -1066,6 +1201,10 @@ module Aws::Backup
     #   resp.backup_plan_document.rules[0].recovery_point_tags #=> Hash
     #   resp.backup_plan_document.rules[0].recovery_point_tags["TagKey"] #=> String
     #   resp.backup_plan_document.rules[0].rule_id #=> String
+    #   resp.backup_plan_document.rules[0].copy_actions #=> Array
+    #   resp.backup_plan_document.rules[0].copy_actions[0].lifecycle.move_to_cold_storage_after_days #=> Integer
+    #   resp.backup_plan_document.rules[0].copy_actions[0].lifecycle.delete_after_days #=> Integer
+    #   resp.backup_plan_document.rules[0].copy_actions[0].destination_backup_vault_arn #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/GetBackupPlanFromTemplate AWS API Documentation
     #
@@ -1188,7 +1327,7 @@ module Aws::Backup
     #   resp.backup_vault_arn #=> String
     #   resp.sns_topic_arn #=> String
     #   resp.backup_vault_events #=> Array
-    #   resp.backup_vault_events[0] #=> String, one of "BACKUP_JOB_STARTED", "BACKUP_JOB_COMPLETED", "RESTORE_JOB_STARTED", "RESTORE_JOB_COMPLETED", "RECOVERY_POINT_MODIFIED", "BACKUP_PLAN_CREATED", "BACKUP_PLAN_MODIFIED"
+    #   resp.backup_vault_events[0] #=> String, one of "BACKUP_JOB_STARTED", "BACKUP_JOB_COMPLETED", "BACKUP_JOB_SUCCESSFUL", "BACKUP_JOB_FAILED", "BACKUP_JOB_EXPIRED", "RESTORE_JOB_STARTED", "RESTORE_JOB_COMPLETED", "RESTORE_JOB_SUCCESSFUL", "RESTORE_JOB_FAILED", "COPY_JOB_STARTED", "COPY_JOB_SUCCESSFUL", "COPY_JOB_FAILED", "RECOVERY_POINT_MODIFIED", "BACKUP_PLAN_CREATED", "BACKUP_PLAN_MODIFIED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/GetBackupVaultNotifications AWS API Documentation
     #
@@ -1199,15 +1338,8 @@ module Aws::Backup
       req.send_request(options)
     end
 
-    # Returns two sets of metadata key-value pairs. The first set lists the
-    # metadata that the recovery point was created with. The second set
-    # lists the metadata key-value pairs that are required to restore the
-    # recovery point.
-    #
-    # These sets can be the same, or the restore metadata set can contain
-    # different values if the target service to be restored has changed
-    # since the recovery point was created and now requires additional or
-    # different information in order to be restored.
+    # Returns a set of metadata key-value pairs that were used to create the
+    # backup.
     #
     # @option params [required, String] :backup_vault_name
     #   The name of a logical container where backups are stored. Backup
@@ -1302,21 +1434,23 @@ module Aws::Backup
     # @option params [String] :by_resource_type
     #   Returns only backup jobs for the specified resources:
     #
+    #   * `DynamoDB` for Amazon DynamoDB
+    #
     #   * `EBS` for Amazon Elastic Block Store
     #
-    #   * `SGW` for AWS Storage Gateway
+    #   * `EFS` for Amazon Elastic File System
     #
     #   * `RDS` for Amazon Relational Database Service
     #
-    #   * `DDB` for Amazon DynamoDB
-    #
-    #   * `EFS` for Amazon Elastic File System
+    #   * `Storage Gateway` for AWS Storage Gateway
     #
     # @return [Types::ListBackupJobsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListBackupJobsOutput#backup_jobs #backup_jobs} => Array&lt;Types::BackupJob&gt;
     #   * {Types::ListBackupJobsOutput#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_backup_jobs({
@@ -1381,6 +1515,8 @@ module Aws::Backup
     #   * {Types::ListBackupPlanTemplatesOutput#next_token #next_token} => String
     #   * {Types::ListBackupPlanTemplatesOutput#backup_plan_templates_list #backup_plan_templates_list} => Array&lt;Types::BackupPlanTemplatesListMember&gt;
     #
+    # 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_backup_plan_templates({
@@ -1425,6 +1561,8 @@ module Aws::Backup
     #   * {Types::ListBackupPlanVersionsOutput#next_token #next_token} => String
     #   * {Types::ListBackupPlanVersionsOutput#backup_plan_versions_list #backup_plan_versions_list} => Array&lt;Types::BackupPlansListMember&gt;
     #
+    # 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_backup_plan_versions({
@@ -1477,6 +1615,8 @@ module Aws::Backup
     #   * {Types::ListBackupPlansOutput#next_token #next_token} => String
     #   * {Types::ListBackupPlansOutput#backup_plans_list #backup_plans_list} => Array&lt;Types::BackupPlansListMember&gt;
     #
+    # 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_backup_plans({
@@ -1527,6 +1667,8 @@ module Aws::Backup
     #   * {Types::ListBackupSelectionsOutput#next_token #next_token} => String
     #   * {Types::ListBackupSelectionsOutput#backup_selections_list #backup_selections_list} => Array&lt;Types::BackupSelectionsListMember&gt;
     #
+    # 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_backup_selections({
@@ -1572,6 +1714,8 @@ module Aws::Backup
     #   * {Types::ListBackupVaultsOutput#backup_vault_list #backup_vault_list} => Array&lt;Types::BackupVaultListMember&gt;
     #   * {Types::ListBackupVaultsOutput#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_backup_vaults({
@@ -1599,6 +1743,97 @@ module Aws::Backup
       req.send_request(options)
     end
 
+    # Returns metadata about your copy jobs.
+    #
+    # @option params [String] :next_token
+    #   The next item following a partial list of returned items. For example,
+    #   if a request is made to return maxResults number of items, NextToken
+    #   allows you to return more items in your list starting at the location
+    #   pointed to by the next token.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of items to be returned.
+    #
+    # @option params [String] :by_resource_arn
+    #   Returns only copy jobs that match the specified resource Amazon
+    #   Resource Name (ARN).
+    #
+    # @option params [String] :by_state
+    #   Returns only copy jobs that are in the specified state.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :by_created_before
+    #   Returns only copy jobs that were created before the specified date.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :by_created_after
+    #   Returns only copy jobs that were created after the specified date.
+    #
+    # @option params [String] :by_resource_type
+    #   Returns only backup jobs for the specified resources:
+    #
+    #   * `EBS` for Amazon Elastic Block Store
+    #
+    #   * `EFS` for Amazon Elastic File System
+    #
+    #   * `RDS` for Amazon Relational Database Service
+    #
+    #   * `Storage Gateway` for AWS Storage Gateway
+    #
+    # @option params [String] :by_destination_vault_arn
+    #   An Amazon Resource Name (ARN) that uniquely identifies a source backup
+    #   vault to copy from; for example,
+    #   `arn:aws:backup:us-east-1:123456789012:vault:aBackupVault`.
+    #
+    # @return [Types::ListCopyJobsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListCopyJobsOutput#copy_jobs #copy_jobs} => Array&lt;Types::CopyJob&gt;
+    #   * {Types::ListCopyJobsOutput#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_copy_jobs({
+    #     next_token: "string",
+    #     max_results: 1,
+    #     by_resource_arn: "ARN",
+    #     by_state: "CREATED", # accepts CREATED, RUNNING, COMPLETED, FAILED
+    #     by_created_before: Time.now,
+    #     by_created_after: Time.now,
+    #     by_resource_type: "ResourceType",
+    #     by_destination_vault_arn: "string",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.copy_jobs #=> Array
+    #   resp.copy_jobs[0].copy_job_id #=> String
+    #   resp.copy_jobs[0].source_backup_vault_arn #=> String
+    #   resp.copy_jobs[0].source_recovery_point_arn #=> String
+    #   resp.copy_jobs[0].destination_backup_vault_arn #=> String
+    #   resp.copy_jobs[0].destination_recovery_point_arn #=> String
+    #   resp.copy_jobs[0].resource_arn #=> String
+    #   resp.copy_jobs[0].creation_date #=> Time
+    #   resp.copy_jobs[0].completion_date #=> Time
+    #   resp.copy_jobs[0].state #=> String, one of "CREATED", "RUNNING", "COMPLETED", "FAILED"
+    #   resp.copy_jobs[0].status_message #=> String
+    #   resp.copy_jobs[0].backup_size_in_bytes #=> Integer
+    #   resp.copy_jobs[0].iam_role_arn #=> String
+    #   resp.copy_jobs[0].created_by.backup_plan_id #=> String
+    #   resp.copy_jobs[0].created_by.backup_plan_arn #=> String
+    #   resp.copy_jobs[0].created_by.backup_plan_version #=> String
+    #   resp.copy_jobs[0].created_by.backup_rule_id #=> String
+    #   resp.copy_jobs[0].resource_type #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/ListCopyJobs AWS API Documentation
+    #
+    # @overload list_copy_jobs(params = {})
+    # @param [Hash] params ({})
+    def list_copy_jobs(params = {}, options = {})
+      req = build_request(:list_copy_jobs, params)
+      req.send_request(options)
+    end
+
     # Returns an array of resources successfully backed up by AWS Backup,
     # including the time the resource was saved, an Amazon Resource Name
     # (ARN) of the resource, and a resource type.
@@ -1617,6 +1852,8 @@ module Aws::Backup
     #   * {Types::ListProtectedResourcesOutput#results #results} => Array&lt;Types::ProtectedResource&gt;
     #   * {Types::ListProtectedResourcesOutput#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_protected_resources({
@@ -1682,6 +1919,8 @@ module Aws::Backup
     #   * {Types::ListRecoveryPointsByBackupVaultOutput#next_token #next_token} => String
     #   * {Types::ListRecoveryPointsByBackupVaultOutput#recovery_points #recovery_points} => Array&lt;Types::RecoveryPointByBackupVault&gt;
     #
+    # 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_recovery_points_by_backup_vault({
@@ -1751,6 +1990,8 @@ module Aws::Backup
     #   * {Types::ListRecoveryPointsByResourceOutput#next_token #next_token} => String
     #   * {Types::ListRecoveryPointsByResourceOutput#recovery_points #recovery_points} => Array&lt;Types::RecoveryPointByResource&gt;
     #
+    # 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_recovery_points_by_resource({
@@ -1796,6 +2037,8 @@ module Aws::Backup
     #   * {Types::ListRestoreJobsOutput#restore_jobs #restore_jobs} => Array&lt;Types::RestoreJobsListMember&gt;
     #   * {Types::ListRestoreJobsOutput#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_restore_jobs({
@@ -1831,6 +2074,10 @@ module Aws::Backup
     # Returns a list of key-value pairs assigned to a target recovery point,
     # backup plan, or backup vault.
     #
+    # <note markdown="1"> `ListTags` are currently only supported with Amazon EFS backups.
+    #
+    #  </note>
+    #
     # @option params [required, String] :resource_arn
     #   An Amazon Resource Name (ARN) that uniquely identifies a resource. The
     #   format of the ARN depends on the type of resource. Valid targets for
@@ -1850,6 +2097,8 @@ module Aws::Backup
     #   * {Types::ListTagsOutput#next_token #next_token} => String
     #   * {Types::ListTagsOutput#tags #tags} => Hash&lt;String,String&gt;
     #
+    # 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_tags({
@@ -1929,7 +2178,7 @@ module Aws::Backup
     #   resp = client.put_backup_vault_notifications({
     #     backup_vault_name: "BackupVaultName", # required
     #     sns_topic_arn: "ARN", # required
-    #     backup_vault_events: ["BACKUP_JOB_STARTED"], # required, accepts BACKUP_JOB_STARTED, BACKUP_JOB_COMPLETED, RESTORE_JOB_STARTED, RESTORE_JOB_COMPLETED, RECOVERY_POINT_MODIFIED, BACKUP_PLAN_CREATED, BACKUP_PLAN_MODIFIED
+    #     backup_vault_events: ["BACKUP_JOB_STARTED"], # required, accepts BACKUP_JOB_STARTED, BACKUP_JOB_COMPLETED, BACKUP_JOB_SUCCESSFUL, BACKUP_JOB_FAILED, BACKUP_JOB_EXPIRED, RESTORE_JOB_STARTED, RESTORE_JOB_COMPLETED, RESTORE_JOB_SUCCESSFUL, RESTORE_JOB_FAILED, COPY_JOB_STARTED, COPY_JOB_SUCCESSFUL, COPY_JOB_FAILED, RECOVERY_POINT_MODIFIED, BACKUP_PLAN_CREATED, BACKUP_PLAN_MODIFIED
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/PutBackupVaultNotifications AWS API Documentation
@@ -1959,19 +2208,16 @@ module Aws::Backup
     #
     # @option params [String] :idempotency_token
     #   A customer chosen string that can be used to distinguish between calls
-    #   to `StartBackupJob`. Idempotency tokens time out after one hour.
-    #   Therefore, if you call `StartBackupJob` multiple times with the same
-    #   idempotency token within one hour, AWS Backup recognizes that you are
-    #   requesting only one backup job and initiates only one. If you change
-    #   the idempotency token for each call, AWS Backup recognizes that you
-    #   are requesting to start multiple backups.
+    #   to `StartBackupJob`.
     #
     # @option params [Integer] :start_window_minutes
-    #   The amount of time in minutes before beginning a backup.
+    #   A value in minutes after a backup is scheduled before a job will be
+    #   canceled if it doesn't start successfully. This value is optional.
     #
     # @option params [Integer] :complete_window_minutes
-    #   The amount of time AWS Backup attempts a backup before canceling the
-    #   job and returning an error.
+    #   A value in minutes after a backup job is successfully started before
+    #   it must be completed or it will be canceled by AWS Backup. This value
+    #   is optional.
     #
     # @option params [Types::Lifecycle] :lifecycle
     #   The lifecycle defines when a protected resource is transitioned to
@@ -2028,6 +2274,75 @@ module Aws::Backup
       req.send_request(options)
     end
 
+    # Starts a job to create a one-time copy of the specified resource.
+    #
+    # @option params [required, String] :recovery_point_arn
+    #   An ARN that uniquely identifies a recovery point to use for the copy
+    #   job; for example,
+    #   arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.
+    #
+    # @option params [required, String] :source_backup_vault_name
+    #   The name of a logical source container where backups are stored.
+    #   Backup vaults are identified by names that are unique to the account
+    #   used to create them and the AWS Region where they are created. They
+    #   consist of lowercase letters, numbers, and hyphens.
+    #
+    # @option params [required, String] :destination_backup_vault_arn
+    #   An Amazon Resource Name (ARN) that uniquely identifies a destination
+    #   backup vault to copy to; for example,
+    #   `arn:aws:backup:us-east-1:123456789012:vault:aBackupVault`.
+    #
+    # @option params [required, String] :iam_role_arn
+    #   Specifies the IAM role ARN used to copy the target recovery point; for
+    #   example, `arn:aws:iam::123456789012:role/S3Access`.
+    #
+    # @option params [String] :idempotency_token
+    #   A customer chosen string that can be used to distinguish between calls
+    #   to `StartCopyJob`.
+    #
+    # @option params [Types::Lifecycle] :lifecycle
+    #   Contains an array of `Transition` objects specifying how long in days
+    #   before a recovery point transitions to cold storage or is deleted.
+    #
+    #   Backups transitioned to cold storage must be stored in cold storage
+    #   for a minimum of 90 days. Therefore, on the console, the “expire after
+    #   days” setting must be 90 days greater than the “transition to cold
+    #   after days” setting. The “transition to cold after days” setting
+    #   cannot be changed after a backup has been transitioned to cold.
+    #
+    # @return [Types::StartCopyJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartCopyJobOutput#copy_job_id #copy_job_id} => String
+    #   * {Types::StartCopyJobOutput#creation_date #creation_date} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_copy_job({
+    #     recovery_point_arn: "ARN", # required
+    #     source_backup_vault_name: "BackupVaultName", # required
+    #     destination_backup_vault_arn: "ARN", # required
+    #     iam_role_arn: "IAMRoleArn", # required
+    #     idempotency_token: "string",
+    #     lifecycle: {
+    #       move_to_cold_storage_after_days: 1,
+    #       delete_after_days: 1,
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.copy_job_id #=> String
+    #   resp.creation_date #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/StartCopyJob AWS API Documentation
+    #
+    # @overload start_copy_job(params = {})
+    # @param [Hash] params ({})
+    def start_copy_job(params = {}, options = {})
+      req = build_request(:start_copy_job, params)
+      req.send_request(options)
+    end
+
     # Recovers the saved resource identified by an Amazon Resource Name
     # (ARN).
     #
@@ -2040,8 +2355,37 @@ module Aws::Backup
     #   `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
     #
     # @option params [required, Hash<String,String>] :metadata
-    #   A set of metadata key-value pairs. Lists the metadata that the
-    #   recovery point was created with.
+    #   A set of metadata key-value pairs. Contains information, such as a
+    #   resource name, required to restore a recovery point.
+    #
+    #   You can get configuration metadata about a resource at the time it was
+    #   backed up by calling `GetRecoveryPointRestoreMetadata`. However,
+    #   values in addition to those provided by
+    #   `GetRecoveryPointRestoreMetadata` might be required to restore a
+    #   resource. For example, you might need to provide a new resource name
+    #   if the original already exists.
+    #
+    #   You need to specify specific metadata to restore an Amazon Elastic
+    #   File System (Amazon EFS) instance:
+    #
+    #   * `file-system-id`\: ID of the Amazon EFS file system that is backed
+    #     up by AWS Backup. Returned in `GetRecoveryPointRestoreMetadata`.
+    #
+    #   * `Encrypted`\: A Boolean value that, if true, specifies that the file
+    #     system is encrypted. If `KmsKeyId` is specified, `Encrypted` must be
+    #     set to `true`.
+    #
+    #   * `KmsKeyId`\: Specifies the AWS KMS key that is used to encrypt the
+    #     restored file system.
+    #
+    #   * `PerformanceMode`\: Specifies the throughput mode of the file
+    #     system.
+    #
+    #   * `CreationToken`\: A user-supplied value that ensures the uniqueness
+    #     (idempotency) of the request.
+    #
+    #   * `newFileSystem`\: A Boolean value that, if true, specifies that the
+    #     recovery point is restored to a new Amazon EFS file system.
     #
     # @option params [required, String] :iam_role_arn
     #   The Amazon Resource Name (ARN) of the IAM role that AWS Backup uses to
@@ -2050,12 +2394,7 @@ module Aws::Backup
     #
     # @option params [String] :idempotency_token
     #   A customer chosen string that can be used to distinguish between calls
-    #   to `StartRestoreJob`. Idempotency tokens time out after one hour.
-    #   Therefore, if you call `StartRestoreJob` multiple times with the same
-    #   idempotency token within one hour, AWS Backup recognizes that you are
-    #   requesting only one restore job and initiates only one. If you change
-    #   the idempotency token for each call, AWS Backup recognizes that you
-    #   are requesting to start multiple restores.
+    #   to `StartRestoreJob`.
     #
     # @option params [String] :resource_type
     #   Starts a job to restore a recovery point for one of the following
@@ -2063,7 +2402,7 @@ module Aws::Backup
     #
     #   * `EBS` for Amazon Elastic Block Store
     #
-    #   * `SGW` for AWS Storage Gateway
+    #   * `Storage Gateway` for AWS Storage Gateway
     #
     #   * `RDS` for Amazon Relational Database Service
     #
@@ -2220,6 +2559,15 @@ module Aws::Backup
     #           recovery_point_tags: {
     #             "TagKey" => "TagValue",
     #           },
+    #           copy_actions: [
+    #             {
+    #               lifecycle: {
+    #                 move_to_cold_storage_after_days: 1,
+    #                 delete_after_days: 1,
+    #               },
+    #               destination_backup_vault_arn: "ARN", # required
+    #             },
+    #           ],
     #         },
     #       ],
     #     },
@@ -2311,6 +2659,36 @@ module Aws::Backup
       req.send_request(options)
     end
 
+    # Updates the current service opt-in settings for the region. If the
+    # service has a value set to true, AWS Backup will attempt to protect
+    # that service's resources in this region, when included in an
+    # on-demand backup or scheduled backup plan. If the value is set to
+    # false for a service, AWS Backup will not attempt to protect that
+    # service's resources in this region.
+    #
+    # @option params [Hash<String,Boolean>] :resource_type_opt_in_preference
+    #   Updates the list of services along with the opt-in preferences for the
+    #   region.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_region_settings({
+    #     resource_type_opt_in_preference: {
+    #       "ResourceType" => false,
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/UpdateRegionSettings AWS API Documentation
+    #
+    # @overload update_region_settings(params = {})
+    # @param [Hash] params ({})
+    def update_region_settings(params = {}, options = {})
+      req = build_request(:update_region_settings, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -2324,7 +2702,7 @@ module Aws::Backup
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-backup'
-      context[:gem_version] = '1.10.0'
+      context[:gem_version] = '1.15.0'
       Seahorse::Client::Request.new(handlers, context)
     end