aws-sdk-backup 1.49.0 → 1.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 696eb1a3b9d692dc50a1b4a3c074f21c7a49957f4e514eb5651a589bb5f40b01
-  data.tar.gz: 907b7d3f06b5dc0a8ec62a520fc1f8cf08334f6c5066057c2cfd75a731b9eefc
+  metadata.gz: 6aa4a8ddab2952dbc2522a474d1bc5ee56122e4c3452c4d8d6bf7674fbf45679
+  data.tar.gz: 622a8f48c1502303454dfad9fc5fac9c9b5bba444090d05e8c6932ebf67ac63c
 SHA512:
-  metadata.gz: c9cfc60bd7e340ee1743d68d5f52c9a92c662452d2d413ba2014368783db51a1e8fe546eb79e0f010eb23fa33e81d0b517f2773d30380345298ac1fc15b8c0ef
-  data.tar.gz: 95611be52588af2fec8d3b68fcdcf8238fda9d8ec8016dd661124ea91ac1706db7c7c3648c0664d12b07ef0505797b836d25f8178555c85442da41c02ca54c20
+  metadata.gz: cecc06d735832e49c2af21a2b930b5de8d9ef783c7bc518db8322de8751ce1224962e469446c3ed787d781352bfbe32be0cf470543dedc436ad4cdc9caeb1246
+  data.tar.gz: 60306315ea7c1f10946536795a5a924d37910279f45e2c04778dbefbbf0f34230117e36e307ec483ac1ef6d6cd3893a68a5eb28577a42dfab09dedd205135992

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.51.0 (2023-05-22)
+------------------
+
+* Feature - Added support for tags on restore.
+
+1.50.0 (2023-05-19)
+------------------
+
+* Feature - Add  ResourceArn, ResourceType, and BackupVaultName to ListRecoveryPointsByLegalHold API response.
+
 1.49.0 (2023-02-08)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.49.0
+1.51.0

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

@@ -3063,6 +3063,9 @@ module Aws::Backup
     #
     #   resp.recovery_points #=> Array
     #   resp.recovery_points[0].recovery_point_arn #=> String
+    #   resp.recovery_points[0].resource_arn #=> String
+    #   resp.recovery_points[0].resource_type #=> String
+    #   resp.recovery_points[0].backup_vault_name #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/ListRecoveryPointsByLegalHold AWS API Documentation
@@ -3632,6 +3635,15 @@ module Aws::Backup
     #   and the default is 8 hours. If this value is included, it must be at
     #   least 60 minutes to avoid errors.
     #
+    #   During the start window, the backup job status remains in `CREATED`
+    #   status until it has successfully begun or until the start window time
+    #   has run out. If within the start window time Backup receives an error
+    #   that allows the job to be retried, Backup will automatically retry to
+    #   begin the job at least every 10 minutes until the backup successfully
+    #   begins (the job status changes to `RUNNING`) or until the job status
+    #   changes to `EXPIRED` (which is expected to occur when the start window
+    #   time is over).
+    #
     # @option params [Integer] :complete_window_minutes
     #   A value in minutes during which a successfully started backup must
     #   complete, or else Backup will cancel the job. This value is optional.
@@ -3860,28 +3872,27 @@ module Aws::Backup
     #   You need to specify specific metadata to restore an Amazon Elastic
     #   File System (Amazon EFS) instance:
     #
-    #   * `file-system-id`\: The ID of the Amazon EFS file system that is
+    #   * `file-system-id`: The ID of the Amazon EFS file system that is
     #     backed up by Backup. Returned in `GetRecoveryPointRestoreMetadata`.
     #
-    #   * `Encrypted`\: A Boolean value that, if true, specifies that the file
+    #   * `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 Amazon Web Services KMS key that is used
+    #   * `KmsKeyId`: Specifies the Amazon Web Services KMS key that is used
     #     to encrypt the restored file system. You can specify a key from
     #     another Amazon Web Services account provided that key it is properly
     #     shared with your account via Amazon Web Services KMS.
     #
-    #   * `PerformanceMode`\: Specifies the throughput mode of the file
-    #     system.
+    #   * `PerformanceMode`: Specifies the throughput mode of the file system.
     #
-    #   * `CreationToken`\: A user-supplied value that ensures the uniqueness
+    #   * `CreationToken`: A user-supplied value that ensures the uniqueness
     #     (idempotency) of the request.
     #
-    #   * `newFileSystem`\: A Boolean value that, if true, specifies that the
+    #   * `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
+    #   * `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"]"`.
@@ -3905,6 +3916,8 @@ module Aws::Backup
     #
     #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
     #
+    #   * `CloudFormation` for CloudFormation
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -3919,12 +3932,22 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Redshift` for Amazon Redshift
+    #
     #   * `Storage Gateway` for Storage Gateway
     #
     #   * `S3` for Amazon S3
     #
+    #   * `Timestream` for Amazon Timestream
+    #
     #   * `VirtualMachine` for virtual machines
     #
+    # @option params [Boolean] :copy_source_tags_to_restored_resource
+    #   This is an optional parameter. If this equals `True`, tags included in
+    #   the backup will be copied to the restored resource.
+    #
+    #   This can only be applied to backups created through Backup.
+    #
     # @return [Types::StartRestoreJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartRestoreJobOutput#restore_job_id #restore_job_id} => String
@@ -3939,6 +3962,7 @@ module Aws::Backup
     #     iam_role_arn: "IAMRoleArn",
     #     idempotency_token: "string",
     #     resource_type: "ResourceType",
+    #     copy_source_tags_to_restored_resource: false,
     #   })
     #
     # @example Response structure
@@ -4444,7 +4468,7 @@ module Aws::Backup
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-backup'
-      context[:gem_version] = '1.49.0'
+      context[:gem_version] = '1.51.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1175,6 +1175,9 @@ module Aws::Backup
     RecoveryPointCreator.struct_class = Types::RecoveryPointCreator
 
     RecoveryPointMember.add_member(:recovery_point_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "RecoveryPointArn"))
+    RecoveryPointMember.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "ResourceArn"))
+    RecoveryPointMember.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, location_name: "ResourceType"))
+    RecoveryPointMember.add_member(:backup_vault_name, Shapes::ShapeRef.new(shape: BackupVaultName, location_name: "BackupVaultName"))
     RecoveryPointMember.struct_class = Types::RecoveryPointMember
 
     RecoveryPointSelection.add_member(:vault_names, Shapes::ShapeRef.new(shape: VaultNames, location_name: "VaultNames"))
@@ -1311,6 +1314,7 @@ module Aws::Backup
     StartRestoreJobInput.add_member(:iam_role_arn, Shapes::ShapeRef.new(shape: IAMRoleArn, location_name: "IamRoleArn"))
     StartRestoreJobInput.add_member(:idempotency_token, Shapes::ShapeRef.new(shape: string, location_name: "IdempotencyToken"))
     StartRestoreJobInput.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, location_name: "ResourceType"))
+    StartRestoreJobInput.add_member(:copy_source_tags_to_restored_resource, Shapes::ShapeRef.new(shape: boolean, location_name: "CopySourceTagsToRestoredResource"))
     StartRestoreJobInput.struct_class = Types::StartRestoreJobInput
 
     StartRestoreJobOutput.add_member(:restore_job_id, Shapes::ShapeRef.new(shape: RestoreJobId, location_name: "RestoreJobId"))
@@ -2265,6 +2269,7 @@ module Aws::Backup
         o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
         o.errors << Shapes::ShapeRef.new(shape: MissingParameterValueException)
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
       end)
 
       api.add_operation(:stop_backup_job, Seahorse::Model::Operation.new.tap do |o|

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

@@ -50,9 +50,6 @@ module Aws::Backup
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

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

@@ -14,36 +14,39 @@ module Aws::Backup
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint)
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://backup-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://backup-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://backup.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://backup-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://backup-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://backup.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://backup.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://backup.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

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

@@ -447,6 +447,15 @@ module Aws::Backup
     #   canceled if it doesn't start successfully. This value is optional.
     #   If this value is included, it must be at least 60 minutes to avoid
     #   errors.
+    #
+    #   During the start window, the backup job status remains in `CREATED`
+    #   status until it has successfully begun or until the start window
+    #   time has run out. If within the start window time Backup receives an
+    #   error that allows the job to be retried, Backup will automatically
+    #   retry to begin the job at least every 10 minutes until the backup
+    #   successfully begins (the job status changes to `RUNNING`) or until
+    #   the job status changes to `EXPIRED` (which is expected to occur when
+    #   the start window time is over).
     #   @return [Integer]
     #
     # @!attribute [rw] completion_window_minutes
@@ -539,6 +548,15 @@ module Aws::Backup
     #   canceled if it doesn't start successfully. This value is optional.
     #   If this value is included, it must be at least 60 minutes to avoid
     #   errors.
+    #
+    #   During the start window, the backup job status remains in `CREATED`
+    #   status until it has successfully begun or until the start window
+    #   time has run out. If within the start window time Backup receives an
+    #   error that allows the job to be retried, Backup will automatically
+    #   retry to begin the job at least every 10 minutes until the backup
+    #   successfully begins (the job status changes to `RUNNING`) or until
+    #   the job status changes to `EXPIRED` (which is expected to occur when
+    #   the start window time is over).
     #   @return [Integer]
     #
     # @!attribute [rw] completion_window_minutes
@@ -2525,6 +2543,11 @@ module Aws::Backup
     #   will result in a new continuous recovery point being created. The
     #   recovery points with STOPPED status do not need to be deleted.
     #
+    #   For SAP HANA on Amazon EC2 `STOPPED` status occurs due to user
+    #   action, application misconfiguration, or backup failure. To ensure
+    #   that future continuous backups succeed, refer to the recovery point
+    #   status and check SAP HANA for details.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/API_UpdateBackupPlan.html
@@ -2532,8 +2555,7 @@ module Aws::Backup
     #   @return [String]
     #
     # @!attribute [rw] status_message
-    #   A status message explaining the reason for the recovery point
-    #   deletion failure.
+    #   A status message explaining the status of the recovery point.
     #   @return [String]
     #
     # @!attribute [rw] creation_date
@@ -5178,10 +5200,28 @@ module Aws::Backup
     #   recovery point.
     #   @return [String]
     #
+    # @!attribute [rw] resource_arn
+    #   This is the Amazon Resource Name (ARN) that uniquely identifies a
+    #   saved resource.
+    #   @return [String]
+    #
+    # @!attribute [rw] resource_type
+    #   This is the Amazon Web Services resource type that is saved as a
+    #   recovery point.
+    #   @return [String]
+    #
+    # @!attribute [rw] backup_vault_name
+    #   This is the name of the backup vault (the logical container in which
+    #   backups are stored).
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/RecoveryPointMember AWS API Documentation
     #
     class RecoveryPointMember < Struct.new(
-      :recovery_point_arn)
+      :recovery_point_arn,
+      :resource_arn,
+      :resource_type,
+      :backup_vault_name)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5637,6 +5677,15 @@ module Aws::Backup
     #   canceled if it doesn't start successfully. This value is optional,
     #   and the default is 8 hours. If this value is included, it must be at
     #   least 60 minutes to avoid errors.
+    #
+    #   During the start window, the backup job status remains in `CREATED`
+    #   status until it has successfully begun or until the start window
+    #   time has run out. If within the start window time Backup receives an
+    #   error that allows the job to be retried, Backup will automatically
+    #   retry to begin the job at least every 10 minutes until the backup
+    #   successfully begins (the job status changes to `RUNNING`) or until
+    #   the job status changes to `EXPIRED` (which is expected to occur when
+    #   the start window time is over).
     #   @return [Integer]
     #
     # @!attribute [rw] complete_window_minutes
@@ -5883,29 +5932,29 @@ module Aws::Backup
     #   You need to specify specific metadata to restore an Amazon Elastic
     #   File System (Amazon EFS) instance:
     #
-    #   * `file-system-id`\: The ID of the Amazon EFS file system that is
+    #   * `file-system-id`: The ID of the Amazon EFS file system that is
     #     backed up by Backup. Returned in
     #     `GetRecoveryPointRestoreMetadata`.
     #
-    #   * `Encrypted`\: A Boolean value that, if true, specifies that the
+    #   * `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 Amazon Web Services KMS key that is
-    #     used to encrypt the restored file system. You can specify a key
-    #     from another Amazon Web Services account provided that key it is
+    #   * `KmsKeyId`: Specifies the Amazon Web Services KMS key that is used
+    #     to encrypt the restored file system. You can specify a key from
+    #     another Amazon Web Services account provided that key it is
     #     properly shared with your account via Amazon Web Services KMS.
     #
-    #   * `PerformanceMode`\: Specifies the throughput mode of the file
+    #   * `PerformanceMode`: Specifies the throughput mode of the file
     #     system.
     #
-    #   * `CreationToken`\: A user-supplied value that ensures the
-    #     uniqueness (idempotency) of the request.
+    #   * `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.
+    #   * `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
+    #   * `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,
@@ -5933,6 +5982,8 @@ module Aws::Backup
     #
     #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
     #
+    #   * `CloudFormation` for CloudFormation
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -5947,13 +5998,24 @@ module Aws::Backup
     #
     #   * `RDS` for Amazon Relational Database Service
     #
+    #   * `Redshift` for Amazon Redshift
+    #
     #   * `Storage Gateway` for Storage Gateway
     #
     #   * `S3` for Amazon S3
     #
+    #   * `Timestream` for Amazon Timestream
+    #
     #   * `VirtualMachine` for virtual machines
     #   @return [String]
     #
+    # @!attribute [rw] copy_source_tags_to_restored_resource
+    #   This is an optional parameter. If this equals `True`, tags included
+    #   in the backup will be copied to the restored resource.
+    #
+    #   This can only be applied to backups created through Backup.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/StartRestoreJobInput AWS API Documentation
     #
     class StartRestoreJobInput < Struct.new(
@@ -5961,7 +6023,8 @@ module Aws::Backup
       :metadata,
       :iam_role_arn,
       :idempotency_token,
-      :resource_type)
+      :resource_type,
+      :copy_source_tags_to_restored_resource)
       SENSITIVE = [:metadata]
       include Aws::Structure
     end

data/lib/aws-sdk-backup.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-backup/customizations'
 # @!group service
 module Aws::Backup
 
-  GEM_VERSION = '1.49.0'
+  GEM_VERSION = '1.51.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-backup
 version: !ruby/object:Gem::Version
-  version: 1.49.0
+  version: 1.51.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-08 00:00:00.000000000 Z
+date: 2023-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core