aws-sdk-backup 1.22.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37a06a07c9745d2a3f44563afa9db98cc825c4520c93bae7d714bcbce31751dd
-  data.tar.gz: c951b78aa10d4f7524f5fbd2ee6bcbe44d3035fefd6418a7564d98f0d3501985
+  metadata.gz: 8a81883ce100b59f6c25765fac59149c642040b878702181c5f4b95ea0ccd944
+  data.tar.gz: 5a1a4df2aed384194699c8a39caeb203c33df188c2010e92dc165a46c69cd6ef
 SHA512:
-  metadata.gz: d3f6ecadeb81d63f8ce0b8d235c3b8637b7c16455992784c10a74e007d67591feeb5d80f83ee1bf7732a810d2303f88f9262cdd0302d99195f255da8f9086079
-  data.tar.gz: 1218ae1de7d70c49afc2b9a494d68ee77e4c136b2976238d4fa872fb2909b50db6c8415c468defd51c99e085a13090abd0a27cb7ebe3d940ccb8df3c673dfb14
+  metadata.gz: d2b651bcd5eb54c3b5c941004aff67236ff8ae408d195ae3b12c86e145886c1fd4d7cdfd3af534331fd133a23ae21741725a9c56a8f0d1f087cbf7c72125f3c0
+  data.tar.gz: 5318f53525d4b088411e3e90d8a512b8c491cbd19b13f66aad62b486a849e3b70b945e411724383d696941ab9aa2203d28561661aa9a93cde89953b25c79f1c4

data/lib/aws-sdk-backup.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-backup/customizations'
 # @!group service
 module Aws::Backup
 
-  GEM_VERSION = '1.22.0'
+  GEM_VERSION = '1.27.0'
 
 end

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

@@ -518,7 +518,7 @@ module Aws::Backup
     #   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 the AWS Region where they are created. They consist of
-    #   lowercase letters, numbers, and hyphens.
+    #   letters, numbers, and hyphens.
     #
     # @option params [Hash<String,String>] :backup_vault_tags
     #   Metadata that you can assign to help organize the resources that you
@@ -894,6 +894,29 @@ module Aws::Backup
       req.send_request(options)
     end
 
+    # Describes the global settings of the AWS account, including whether it
+    # is opted in to cross-account backup.
+    #
+    # @return [Types::DescribeGlobalSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeGlobalSettingsOutput#global_settings #global_settings} => Hash&lt;String,String&gt;
+    #   * {Types::DescribeGlobalSettingsOutput#last_update_time #last_update_time} => Time
+    #
+    # @example Response structure
+    #
+    #   resp.global_settings #=> Hash
+    #   resp.global_settings["GlobalSettingsName"] #=> String
+    #   resp.last_update_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/DescribeGlobalSettings AWS API Documentation
+    #
+    # @overload describe_global_settings(params = {})
+    # @param [Hash] params ({})
+    def describe_global_settings(params = {}, options = {})
+      req = build_request(:describe_global_settings, 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
     # type of the saved resource.
@@ -948,6 +971,7 @@ module Aws::Backup
     #   * {Types::DescribeRecoveryPointOutput#recovery_point_arn #recovery_point_arn} => String
     #   * {Types::DescribeRecoveryPointOutput#backup_vault_name #backup_vault_name} => String
     #   * {Types::DescribeRecoveryPointOutput#backup_vault_arn #backup_vault_arn} => String
+    #   * {Types::DescribeRecoveryPointOutput#source_backup_vault_arn #source_backup_vault_arn} => String
     #   * {Types::DescribeRecoveryPointOutput#resource_arn #resource_arn} => String
     #   * {Types::DescribeRecoveryPointOutput#resource_type #resource_type} => String
     #   * {Types::DescribeRecoveryPointOutput#created_by #created_by} => Types::RecoveryPointCreator
@@ -975,6 +999,7 @@ module Aws::Backup
     #   resp.recovery_point_arn #=> String
     #   resp.backup_vault_name #=> String
     #   resp.backup_vault_arn #=> String
+    #   resp.source_backup_vault_arn #=> String
     #   resp.resource_arn #=> String
     #   resp.resource_type #=> String
     #   resp.created_by.backup_plan_id #=> String
@@ -1004,11 +1029,12 @@ 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 tries 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 does not try to protect that service's resources
+    # Returns the current service opt-in settings for the Region. If
+    # service-opt-in is enabled for a service, AWS Backup tries to protect
+    # that service's resources in this Region, when the resource is
+    # included in an on-demand backup or scheduled backup plan. Otherwise,
+    # AWS Backup does not try to protect that service's resources in this
+    # Region, AWS Backup does not try 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:
@@ -1507,12 +1533,17 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Aurora` for Amazon Aurora
+    #
     #   * `Storage Gateway` for AWS Storage Gateway
     #
     # @option params [String] :by_account_id
     #   The account ID to list the jobs from. Returns only backup jobs
     #   associated with the specified account ID.
     #
+    #   If used from an AWS Organizations management account, passing `*`
+    #   returns all jobs across the organization.
+    #
     # @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;
@@ -1864,6 +1895,8 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Aurora` for Amazon Aurora
+    #
     #   * `Storage Gateway` for AWS Storage Gateway
     #
     # @option params [String] :by_destination_vault_arn
@@ -2035,6 +2068,7 @@ module Aws::Backup
     #   resp.recovery_points[0].recovery_point_arn #=> String
     #   resp.recovery_points[0].backup_vault_name #=> String
     #   resp.recovery_points[0].backup_vault_arn #=> String
+    #   resp.recovery_points[0].source_backup_vault_arn #=> String
     #   resp.recovery_points[0].resource_arn #=> String
     #   resp.recovery_points[0].resource_type #=> String
     #   resp.recovery_points[0].created_by.backup_plan_id #=> String
@@ -2325,12 +2359,15 @@ module Aws::Backup
     #
     # @option params [Integer] :start_window_minutes
     #   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.
+    #   canceled if it doesn't start successfully. This value is optional,
+    #   and the default is 8 hours.
     #
     # @option params [Integer] :complete_window_minutes
-    #   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.
+    #   A value in minutes during which a successfully started backup must
+    #   complete, or else AWS Backup will cancel the job. This value is
+    #   optional. This value begins counting down from when the backup was
+    #   scheduled. It does not add additional time for `StartWindowMinutes`,
+    #   or if the backup started later than scheduled.
     #
     # @option params [Types::Lifecycle] :lifecycle
     #   The lifecycle defines when a protected resource is transitioned to
@@ -2344,6 +2381,9 @@ module Aws::Backup
     #   setting. The “transition to cold after days” setting cannot be changed
     #   after a backup has been transitioned to cold.
     #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
+    #
     # @option params [Hash<String,String>] :recovery_point_tags
     #   To help organize your resources, you can assign your own metadata to
     #   the resources that you create. Each tag is a key-value pair.
@@ -2352,8 +2392,10 @@ module Aws::Backup
     #   Specifies the backup option for a selected resource. This option is
     #   only available for Windows VSS backup jobs.
     #
-    #   Valid value: `"WindowsVSS”:“enabled"`. If enabled, creates a VSS
-    #   Windows backup; otherwise, creates a regular backup.
+    #   Valid values: Set to `"WindowsVSS”:“enabled"` to enable WindowsVSS
+    #   backup option and create a VSS Windows backup. Set to
+    #   “WindowsVSS”:”disabled” to create a regular backup. The WindowsVSS
+    #   option is not enabled by default.
     #
     # @return [Types::StartBackupJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2433,6 +2475,9 @@ module Aws::Backup
     #   after days” setting. The “transition to cold after days” setting
     #   cannot be changed after a backup has been transitioned to cold.
     #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
+    #
     # @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
@@ -2469,10 +2514,6 @@ module Aws::Backup
     # Recovers the saved resource identified by an Amazon Resource Name
     # (ARN).
     #
-    # If the resource ARN is included in the request, then the last complete
-    # backup of that resource is recovered. If the ARN of a recovery point
-    # is supplied, then that recovery point is restored.
-    #
     # @option params [required, String] :recovery_point_arn
     #   An ARN that uniquely identifies a recovery point; for example,
     #   `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.
@@ -2500,7 +2541,9 @@ module Aws::Backup
     #     set to `true`.
     #
     #   * `KmsKeyId`\: Specifies the AWS KMS key that is used to encrypt the
-    #     restored file system.
+    #     restored file system. You can specify a key from another AWS account
+    #     provided that key it is properly shared with your account via AWS
+    #     KMS.
     #
     #   * `PerformanceMode`\: Specifies the throughput mode of the file
     #     system.
@@ -2511,6 +2554,12 @@ module Aws::Backup
     #   * `newFileSystem`\: A Boolean value that, if true, specifies that the
     #     recovery point is restored to a new Amazon EFS file system.
     #
+    #   * `ItemsToRestore `\: An array of one to five strings where each
+    #     string is a file path. Use `ItemsToRestore` to restore specific
+    #     files or directories rather than the entire file system. This
+    #     parameter is optional. For example,
+    #     `"itemsToRestore":"["/my.test"]"`.
+    #
     # @option params [required, String] :iam_role_arn
     #   The Amazon Resource Name (ARN) of the IAM role that AWS Backup uses to
     #   create the target recovery point; for example,
@@ -2534,6 +2583,8 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Aurora` for Amazon Aurora
+    #
     #   * `Storage Gateway` for AWS Storage Gateway
     #
     # @return [Types::StartRestoreJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2728,6 +2779,31 @@ module Aws::Backup
       req.send_request(options)
     end
 
+    # Updates the current global settings for the AWS account. Use the
+    # `DescribeGlobalSettings` API to determine the current settings.
+    #
+    # @option params [Hash<String,String>] :global_settings
+    #   A list of resources along with the opt-in preferences for the account.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_global_settings({
+    #     global_settings: {
+    #       "GlobalSettingsName" => "GlobalSettingsValue",
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/UpdateGlobalSettings AWS API Documentation
+    #
+    # @overload update_global_settings(params = {})
+    # @param [Hash] params ({})
+    def update_global_settings(params = {}, options = {})
+      req = build_request(:update_global_settings, params)
+      req.send_request(options)
+    end
+
     # Sets the transition lifecycle of a recovery point.
     #
     # The lifecycle defines when a protected resource is transitioned to
@@ -2740,6 +2816,9 @@ module Aws::Backup
     # setting. The “transition to cold after days” setting cannot be changed
     # after a backup has been transitioned to cold.
     #
+    # Only Amazon EFS file system backups can be transitioned to cold
+    # storage.
+    #
     # @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
@@ -2798,12 +2877,13 @@ 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 tries 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 does not try to protect that service's resources
-    # in this Region.
+    # Updates the current service opt-in settings for the Region. If
+    # service-opt-in is enabled for a service, AWS Backup tries to protect
+    # that service's resources in this Region, when the resource is
+    # included in an on-demand backup or scheduled backup plan. Otherwise,
+    # AWS Backup does not try to protect that service's resources in this
+    # Region. Use the `DescribeRegionSettings` API to determine the resource
+    # types that are supported.
     #
     # @option params [Hash<String,Boolean>] :resource_type_opt_in_preference
     #   Updates the list of services along with the opt-in preferences for the
@@ -2841,7 +2921,7 @@ module Aws::Backup
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-backup'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.27.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -78,6 +78,8 @@ module Aws::Backup
     DescribeBackupVaultOutput = Shapes::StructureShape.new(name: 'DescribeBackupVaultOutput')
     DescribeCopyJobInput = Shapes::StructureShape.new(name: 'DescribeCopyJobInput')
     DescribeCopyJobOutput = Shapes::StructureShape.new(name: 'DescribeCopyJobOutput')
+    DescribeGlobalSettingsInput = Shapes::StructureShape.new(name: 'DescribeGlobalSettingsInput')
+    DescribeGlobalSettingsOutput = Shapes::StructureShape.new(name: 'DescribeGlobalSettingsOutput')
     DescribeProtectedResourceInput = Shapes::StructureShape.new(name: 'DescribeProtectedResourceInput')
     DescribeProtectedResourceOutput = Shapes::StructureShape.new(name: 'DescribeProtectedResourceOutput')
     DescribeRecoveryPointInput = Shapes::StructureShape.new(name: 'DescribeRecoveryPointInput')
@@ -103,6 +105,9 @@ module Aws::Backup
     GetRecoveryPointRestoreMetadataInput = Shapes::StructureShape.new(name: 'GetRecoveryPointRestoreMetadataInput')
     GetRecoveryPointRestoreMetadataOutput = Shapes::StructureShape.new(name: 'GetRecoveryPointRestoreMetadataOutput')
     GetSupportedResourceTypesOutput = Shapes::StructureShape.new(name: 'GetSupportedResourceTypesOutput')
+    GlobalSettings = Shapes::MapShape.new(name: 'GlobalSettings')
+    GlobalSettingsName = Shapes::StringShape.new(name: 'GlobalSettingsName')
+    GlobalSettingsValue = Shapes::StringShape.new(name: 'GlobalSettingsValue')
     IAMPolicy = Shapes::StringShape.new(name: 'IAMPolicy')
     IAMRoleArn = Shapes::StringShape.new(name: 'IAMRoleArn')
     InvalidParameterValueException = Shapes::StructureShape.new(name: 'InvalidParameterValueException')
@@ -177,6 +182,7 @@ module Aws::Backup
     UntagResourceInput = Shapes::StructureShape.new(name: 'UntagResourceInput')
     UpdateBackupPlanInput = Shapes::StructureShape.new(name: 'UpdateBackupPlanInput')
     UpdateBackupPlanOutput = Shapes::StructureShape.new(name: 'UpdateBackupPlanOutput')
+    UpdateGlobalSettingsInput = Shapes::StructureShape.new(name: 'UpdateGlobalSettingsInput')
     UpdateRecoveryPointLifecycleInput = Shapes::StructureShape.new(name: 'UpdateRecoveryPointLifecycleInput')
     UpdateRecoveryPointLifecycleOutput = Shapes::StructureShape.new(name: 'UpdateRecoveryPointLifecycleOutput')
     UpdateRegionSettingsInput = Shapes::StructureShape.new(name: 'UpdateRegionSettingsInput')
@@ -452,6 +458,12 @@ module Aws::Backup
     DescribeCopyJobOutput.add_member(:copy_job, Shapes::ShapeRef.new(shape: CopyJob, location_name: "CopyJob"))
     DescribeCopyJobOutput.struct_class = Types::DescribeCopyJobOutput
 
+    DescribeGlobalSettingsInput.struct_class = Types::DescribeGlobalSettingsInput
+
+    DescribeGlobalSettingsOutput.add_member(:global_settings, Shapes::ShapeRef.new(shape: GlobalSettings, location_name: "GlobalSettings"))
+    DescribeGlobalSettingsOutput.add_member(:last_update_time, Shapes::ShapeRef.new(shape: timestamp, location_name: "LastUpdateTime"))
+    DescribeGlobalSettingsOutput.struct_class = Types::DescribeGlobalSettingsOutput
+
     DescribeProtectedResourceInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ARN, required: true, location: "uri", location_name: "resourceArn"))
     DescribeProtectedResourceInput.struct_class = Types::DescribeProtectedResourceInput
 
@@ -467,6 +479,7 @@ module Aws::Backup
     DescribeRecoveryPointOutput.add_member(:recovery_point_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "RecoveryPointArn"))
     DescribeRecoveryPointOutput.add_member(:backup_vault_name, Shapes::ShapeRef.new(shape: BackupVaultName, location_name: "BackupVaultName"))
     DescribeRecoveryPointOutput.add_member(:backup_vault_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "BackupVaultArn"))
+    DescribeRecoveryPointOutput.add_member(:source_backup_vault_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "SourceBackupVaultArn"))
     DescribeRecoveryPointOutput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "ResourceArn"))
     DescribeRecoveryPointOutput.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, location_name: "ResourceType"))
     DescribeRecoveryPointOutput.add_member(:created_by, Shapes::ShapeRef.new(shape: RecoveryPointCreator, location_name: "CreatedBy"))
@@ -579,6 +592,9 @@ module Aws::Backup
     GetSupportedResourceTypesOutput.add_member(:resource_types, Shapes::ShapeRef.new(shape: ResourceTypes, location_name: "ResourceTypes"))
     GetSupportedResourceTypesOutput.struct_class = Types::GetSupportedResourceTypesOutput
 
+    GlobalSettings.key = Shapes::ShapeRef.new(shape: GlobalSettingsName)
+    GlobalSettings.value = Shapes::ShapeRef.new(shape: GlobalSettingsValue)
+
     InvalidParameterValueException.add_member(:code, Shapes::ShapeRef.new(shape: string, location_name: "Code"))
     InvalidParameterValueException.add_member(:message, Shapes::ShapeRef.new(shape: string, location_name: "Message"))
     InvalidParameterValueException.add_member(:type, Shapes::ShapeRef.new(shape: string, location_name: "Type"))
@@ -756,6 +772,7 @@ module Aws::Backup
     RecoveryPointByBackupVault.add_member(:recovery_point_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "RecoveryPointArn"))
     RecoveryPointByBackupVault.add_member(:backup_vault_name, Shapes::ShapeRef.new(shape: BackupVaultName, location_name: "BackupVaultName"))
     RecoveryPointByBackupVault.add_member(:backup_vault_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "BackupVaultArn"))
+    RecoveryPointByBackupVault.add_member(:source_backup_vault_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "SourceBackupVaultArn"))
     RecoveryPointByBackupVault.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "ResourceArn"))
     RecoveryPointByBackupVault.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, location_name: "ResourceType"))
     RecoveryPointByBackupVault.add_member(:created_by, Shapes::ShapeRef.new(shape: RecoveryPointCreator, location_name: "CreatedBy"))
@@ -890,6 +907,9 @@ module Aws::Backup
     UpdateBackupPlanOutput.add_member(:advanced_backup_settings, Shapes::ShapeRef.new(shape: AdvancedBackupSettings, location_name: "AdvancedBackupSettings"))
     UpdateBackupPlanOutput.struct_class = Types::UpdateBackupPlanOutput
 
+    UpdateGlobalSettingsInput.add_member(:global_settings, Shapes::ShapeRef.new(shape: GlobalSettings, location_name: "GlobalSettings"))
+    UpdateGlobalSettingsInput.struct_class = Types::UpdateGlobalSettingsInput
+
     UpdateRecoveryPointLifecycleInput.add_member(:backup_vault_name, Shapes::ShapeRef.new(shape: BackupVaultName, required: true, location: "uri", location_name: "backupVaultName"))
     UpdateRecoveryPointLifecycleInput.add_member(:recovery_point_arn, Shapes::ShapeRef.new(shape: ARN, required: true, location: "uri", location_name: "recoveryPointArn"))
     UpdateRecoveryPointLifecycleInput.add_member(:lifecycle, Shapes::ShapeRef.new(shape: Lifecycle, location_name: "Lifecycle"))
@@ -1072,6 +1092,15 @@ module Aws::Backup
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:describe_global_settings, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeGlobalSettings"
+        o.http_method = "GET"
+        o.http_request_uri = "/global-settings"
+        o.input = Shapes::ShapeRef.new(shape: DescribeGlobalSettingsInput)
+        o.output = Shapes::ShapeRef.new(shape: DescribeGlobalSettingsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+      end)
+
       api.add_operation(:describe_protected_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeProtectedResource"
         o.http_method = "GET"
@@ -1467,6 +1496,7 @@ module Aws::Backup
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
         o.errors << Shapes::ShapeRef.new(shape: MissingParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
       end)
@@ -1546,6 +1576,18 @@ module Aws::Backup
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
       end)
 
+      api.add_operation(:update_global_settings, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateGlobalSettings"
+        o.http_method = "PUT"
+        o.http_request_uri = "/global-settings"
+        o.input = Shapes::ShapeRef.new(shape: UpdateGlobalSettingsInput)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: MissingParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+      end)
+
       api.add_operation(:update_recovery_point_lifecycle, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateRecoveryPointLifecycle"
         o.http_method = "POST"

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

@@ -23,18 +23,29 @@ module Aws::Backup
     #       }
     #
     # @!attribute [rw] resource_type
-    #   The type of AWS resource to be backed up. For VSS Windows backups,
-    #   the only supported resource type is Amazon EC2.
+    #   Specifies an object containing resource type and backup options. The
+    #   only supported resource type is Amazon EC2 instances with Windows
+    #   VSS. For an CloudFormation example, see the [sample CloudFormation
+    #   template to enable Windows VSS][1] in the *AWS Backup User Guide*.
     #
     #   Valid values: `EC2`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/integrate-cloudformation-with-aws-backup.html
     #   @return [String]
     #
     # @!attribute [rw] backup_options
     #   Specifies the backup option for a selected resource. This option is
     #   only available for Windows VSS backup jobs.
     #
-    #   Valid value: `"WindowsVSS”:“enabled"`. If enabled, creates a VSS
-    #   Windows backup; otherwise, creates a regular backup.
+    #   Valid values:
+    #
+    #   Set to `"WindowsVSS":"enabled"` to enable the WindowsVSS backup
+    #   option and create a VSS Windows backup.
+    #
+    #   Set to `"WindowsVSS":"disabled"` to create a regular backup. The
+    #   WindowsVSS option is not enabled by default.
     #
     #   If you specify an invalid option, you get an
     #   `InvalidParameterValueException` exception.
@@ -155,8 +166,11 @@ module Aws::Backup
     #   @return [Integer]
     #
     # @!attribute [rw] iam_role_arn
-    #   Specifies the IAM role ARN used to create the target recovery point;
-    #   for example, `arn:aws:iam::123456789012:role/S3Access`.
+    #   Specifies the IAM role ARN used to create the target recovery point.
+    #   IAM roles other than the default role must include either
+    #   `AWSBackup` or `AwsBackup` in the role name. For example,
+    #   `arn:aws:iam::123456789012:role/AWSBackupRDSAccess`. Role names
+    #   without those strings lack permissions to perform backup jobs.
     #   @return [String]
     #
     # @!attribute [rw] created_by
@@ -200,8 +214,9 @@ module Aws::Backup
     #   Specifies the backup option for a selected resource. This option is
     #   only available for Windows VSS backup jobs.
     #
-    #   Valid value: `"WindowsVSS”:“enabled"`. If enabled, creates a VSS
-    #   Windows backup; otherwise, creates a regular backup. If you specify
+    #   Valid values: Set to `"WindowsVSS”:“enabled"` to enable WindowsVSS
+    #   backup option and create a VSS Windows backup. Set to
+    #   “WindowsVSS”:”disabled” to create a regular backup. If you specify
     #   an invalid option, you get an `InvalidParameterValueException`
     #   exception.
     #   @return [Hash<String,String>]
@@ -437,6 +452,15 @@ module Aws::Backup
     #
     # @!attribute [rw] schedule_expression
     #   A CRON expression specifying when AWS Backup initiates a backup job.
+    #   For more information about cron expressions, see [Schedule
+    #   Expressions for Rules][1] in the *Amazon CloudWatch Events User
+    #   Guide.*. Prior to specifying a value for this parameter, we
+    #   recommend testing your cron expression using one of the many
+    #   available cron generator and testing tools.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/ScheduledEvents.html
     #   @return [String]
     #
     # @!attribute [rw] start_window_minutes
@@ -460,6 +484,9 @@ module Aws::Backup
     #   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.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] recovery_point_tags
@@ -559,6 +586,9 @@ module Aws::Backup
     #   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.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] recovery_point_tags
@@ -622,7 +652,8 @@ module Aws::Backup
     # @!attribute [rw] list_of_tags
     #   An array of conditions used to specify a set of resources to assign
     #   to a backup plan; for example, `"StringEquals":
-    #   \{"ec2:ResourceTag/Department": "accounting"`.
+    #   \{"ec2:ResourceTag/Department": "accounting"`. Assigns the backup
+    #   plan to every resource with at least one matching tag.
     #   @return [Array<Types::Condition>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/BackupSelection AWS API Documentation
@@ -747,6 +778,9 @@ module Aws::Backup
     # setting. The “transition to cold after days” setting cannot be changed
     # after a backup has been transitioned to cold.
     #
+    # Only Amazon EFS file system backups can be transitioned to cold
+    # storage.
+    #
     # @!attribute [rw] move_to_cold_storage_at
     #   A timestamp that specifies when to transition a recovery point to
     #   cold storage.
@@ -829,6 +863,9 @@ module Aws::Backup
     #   cold after days” setting. The “transition to cold after days”
     #   setting cannot be changed after a backup has been transitioned to
     #   cold.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] destination_backup_vault_arn
@@ -1152,7 +1189,7 @@ module Aws::Backup
     #   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 the AWS Region where they are created. They
-    #   consist of lowercase letters, numbers, and hyphens.
+    #   consist of letters, numbers, and hyphens.
     #   @return [String]
     #
     # @!attribute [rw] backup_vault_tags
@@ -1544,8 +1581,8 @@ module Aws::Backup
     # @!attribute [rw] backup_type
     #   Represents the actual backup type selected for a backup job. For
     #   example, if a successful WindowsVSS backup was taken, `BackupType`
-    #   returns “WindowsVSS”. If `BackupType` is empty, then it is a regular
-    #   backup.
+    #   returns "WindowsVSS". If `BackupType` is empty, then the backup
+    #   type that was is a regular backup.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/DescribeBackupJobOutput AWS API Documentation
@@ -1677,6 +1714,34 @@ module Aws::Backup
       include Aws::Structure
     end
 
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/DescribeGlobalSettingsInput AWS API Documentation
+    #
+    class DescribeGlobalSettingsInput < Aws::EmptyStructure; end
+
+    # @!attribute [rw] global_settings
+    #   A list of resources along with the opt-in preferences for the
+    #   account.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] last_update_time
+    #   The date and time that the global settings were last updated. This
+    #   update is in Unix format and Coordinated Universal Time (UTC). The
+    #   value of `LastUpdateTime` is accurate to milliseconds. For example,
+    #   the value 1516925490.087 represents Friday, January 26, 2018
+    #   12:11:30.087 AM.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/DescribeGlobalSettingsOutput AWS API Documentation
+    #
+    class DescribeGlobalSettingsOutput < Struct.new(
+      :global_settings,
+      :last_update_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeProtectedResourceInput
     #   data as a hash:
     #
@@ -1771,6 +1836,14 @@ module Aws::Backup
     #   `arn:aws:backup:us-east-1:123456789012:vault:aBackupVault`.
     #   @return [String]
     #
+    # @!attribute [rw] source_backup_vault_arn
+    #   An Amazon Resource Name (ARN) that uniquely identifies the source
+    #   vault where the resource was originally backed up in; for example,
+    #   `arn:aws:backup:us-east-1:123456789012:vault:BackupVault`. If the
+    #   recovery is restored to the same AWS account or Region, this value
+    #   will be `null`.
+    #   @return [String]
+    #
     # @!attribute [rw] resource_arn
     #   An ARN that uniquely identifies a saved resource. The format of the
     #   ARN depends on the resource type.
@@ -1837,6 +1910,9 @@ module Aws::Backup
     #   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.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] encryption_key_arn
@@ -1870,6 +1946,7 @@ module Aws::Backup
       :recovery_point_arn,
       :backup_vault_name,
       :backup_vault_arn,
+      :source_backup_vault_arn,
       :resource_arn,
       :resource_type,
       :created_by,
@@ -2448,6 +2525,8 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Aurora` for Amazon Aurora
+    #
     #   * `Storage Gateway` for AWS Storage Gateway
     #   @return [Array<String>]
     #
@@ -2520,6 +2599,9 @@ module Aws::Backup
     # after days” setting. The “transition to cold after days” setting
     # cannot be changed after a backup has been transitioned to cold.
     #
+    # Only Amazon EFS file system backups can be transitioned to cold
+    # storage.
+    #
     # @note When making an API call, you may pass Lifecycle
     #   data as a hash:
     #
@@ -2638,12 +2720,17 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Aurora` for Amazon Aurora
+    #
     #   * `Storage Gateway` for AWS Storage Gateway
     #   @return [String]
     #
     # @!attribute [rw] by_account_id
     #   The account ID to list the jobs from. Returns only backup jobs
     #   associated with the specified account ID.
+    #
+    #   If used from an AWS Organizations management account, passing `*`
+    #   returns all jobs across the organization.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/ListBackupJobsInput AWS API Documentation
@@ -3005,6 +3092,8 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Aurora` for Amazon Aurora
+    #
     #   * `Storage Gateway` for AWS Storage Gateway
     #   @return [String]
     #
@@ -3529,6 +3618,12 @@ module Aws::Backup
     #   `arn:aws:backup:us-east-1:123456789012:vault:aBackupVault`.
     #   @return [String]
     #
+    # @!attribute [rw] source_backup_vault_arn
+    #   The backup vault where the recovery point was originally copied
+    #   from. If the recovery point is restored to the same account this
+    #   value will be `null`.
+    #   @return [String]
+    #
     # @!attribute [rw] resource_arn
     #   An ARN that uniquely identifies a resource. The format of the ARN
     #   depends on the resource type.
@@ -3590,6 +3685,9 @@ module Aws::Backup
     #   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.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] encryption_key_arn
@@ -3617,6 +3715,7 @@ module Aws::Backup
       :recovery_point_arn,
       :backup_vault_name,
       :backup_vault_arn,
+      :source_backup_vault_arn,
       :resource_arn,
       :resource_type,
       :created_by,
@@ -3903,13 +4002,16 @@ module Aws::Backup
     #
     # @!attribute [rw] start_window_minutes
     #   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.
+    #   canceled if it doesn't start successfully. This value is optional,
+    #   and the default is 8 hours.
     #   @return [Integer]
     #
     # @!attribute [rw] complete_window_minutes
-    #   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.
+    #   A value in minutes during which a successfully started backup must
+    #   complete, or else AWS Backup will cancel the job. This value is
+    #   optional. This value begins counting down from when the backup was
+    #   scheduled. It does not add additional time for `StartWindowMinutes`,
+    #   or if the backup started later than scheduled.
     #   @return [Integer]
     #
     # @!attribute [rw] lifecycle
@@ -3923,6 +4025,9 @@ module Aws::Backup
     #   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.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] recovery_point_tags
@@ -3934,8 +4039,10 @@ module Aws::Backup
     #   Specifies the backup option for a selected resource. This option is
     #   only available for Windows VSS backup jobs.
     #
-    #   Valid value: `"WindowsVSS”:“enabled"`. If enabled, creates a VSS
-    #   Windows backup; otherwise, creates a regular backup.
+    #   Valid values: Set to `"WindowsVSS”:“enabled"` to enable WindowsVSS
+    #   backup option and create a VSS Windows backup. Set to
+    #   “WindowsVSS”:”disabled” to create a regular backup. The WindowsVSS
+    #   option is not enabled by default.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/StartBackupJobInput AWS API Documentation
@@ -3964,7 +4071,7 @@ module Aws::Backup
     #   @return [String]
     #
     # @!attribute [rw] creation_date
-    #   The date and time that a backup job is started, in Unix format and
+    #   The date and time that a backup job is created, in Unix format and
     #   Coordinated Universal Time (UTC). The value of `CreationDate` is
     #   accurate to milliseconds. For example, the value 1516925490.087
     #   represents Friday, January 26, 2018 12:11:30.087 AM.
@@ -4035,6 +4142,9 @@ module Aws::Backup
     #   cold after days” setting. The “transition to cold after days”
     #   setting cannot be changed after a backup has been transitioned to
     #   cold.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/StartCopyJobInput AWS API Documentation
@@ -4055,7 +4165,7 @@ module Aws::Backup
     #   @return [String]
     #
     # @!attribute [rw] creation_date
-    #   The date and time that a copy job is started, in Unix format and
+    #   The date and time that a copy job is created, in Unix format and
     #   Coordinated Universal Time (UTC). The value of `CreationDate` is
     #   accurate to milliseconds. For example, the value 1516925490.087
     #   represents Friday, January 26, 2018 12:11:30.087 AM.
@@ -4111,7 +4221,9 @@ module Aws::Backup
     #     must be set to `true`.
     #
     #   * `KmsKeyId`\: Specifies the AWS KMS key that is used to encrypt the
-    #     restored file system.
+    #     restored file system. You can specify a key from another AWS
+    #     account provided that key it is properly shared with your account
+    #     via AWS KMS.
     #
     #   * `PerformanceMode`\: Specifies the throughput mode of the file
     #     system.
@@ -4121,6 +4233,12 @@ module Aws::Backup
     #
     #   * `newFileSystem`\: A Boolean value that, if true, specifies that
     #     the recovery point is restored to a new Amazon EFS file system.
+    #
+    #   * `ItemsToRestore `\: An array of one to five strings where each
+    #     string is a file path. Use `ItemsToRestore` to restore specific
+    #     files or directories rather than the entire file system. This
+    #     parameter is optional. For example,
+    #     `"itemsToRestore":"["/my.test"]"`.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] iam_role_arn
@@ -4148,6 +4266,8 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Aurora` for Amazon Aurora
+    #
     #   * `Storage Gateway` for AWS Storage Gateway
     #   @return [String]
     #
@@ -4349,6 +4469,28 @@ module Aws::Backup
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass UpdateGlobalSettingsInput
+    #   data as a hash:
+    #
+    #       {
+    #         global_settings: {
+    #           "GlobalSettingsName" => "GlobalSettingsValue",
+    #         },
+    #       }
+    #
+    # @!attribute [rw] global_settings
+    #   A list of resources along with the opt-in preferences for the
+    #   account.
+    #   @return [Hash<String,String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/UpdateGlobalSettingsInput AWS API Documentation
+    #
+    class UpdateGlobalSettingsInput < Struct.new(
+      :global_settings)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass UpdateRecoveryPointLifecycleInput
     #   data as a hash:
     #
@@ -4417,6 +4559,9 @@ module Aws::Backup
     #   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.
+    #
+    #   Only Amazon EFS file system backups can be transitioned to cold
+    #   storage.
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] calculated_lifecycle

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-backup
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.27.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-23 00:00:00.000000000 Z
+date: 2021-02-02 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.99.0
+        version: 3.112.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.99.0
+        version: 3.112.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement