aws-sdk-backup 1.38.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fcc1060a1ec0c99a9fcda32215909a52674546bae65d5aebe751e21bccc52457
-  data.tar.gz: 20a2f3ed9891b6e23a2b91289412920d116d0b7faa8926520f94e6dfc66da3d5
+  metadata.gz: 4d16c44fc21d12f4c43e9a2760f07374c31f9f33088890749196ca21f5bd751a
+  data.tar.gz: 14d96ed703250ef16b7b24e1dcb5d4ef74284ac07b8b68543bf4f3dd1ffc948f
 SHA512:
-  metadata.gz: 0b3a700db416a2afba1ffd0fa64668d7aa6c8ca71fab6f24ddd2b7e3251ece39e3a4318cc2484f4b29a0d0026ed644d99456a51904fcd6a624c30f5b9e478b7a
-  data.tar.gz: c55e9381182edb5edd567227385ea2a229906368ab837e13ab329abfaa4d6523f456d4166e51695fdf4903479aa83fb241eb0f83113ccbe92cfd26459d2e7779
+  metadata.gz: c3287fa6493e11761a61f6995cf12074f65584d75ba5aa8b143d067bf9d2797dc56a8dab996dfb3688cb917c76b938ba289a237470b03782138d75cd45916435
+  data.tar.gz: 840e80fcb39be2b535d0ce0b7f5dc37d133b2ee50509f009db9a633031b35b79368ce73017a7fa43fb4fd03631228613d2bbfd5eb921733a7eeb64900653e440

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.42.0 (2022-02-17)
+------------------
+
+* Feature - AWS Backup add new S3_BACKUP_OBJECT_FAILED and S3_RESTORE_OBJECT_FAILED event types in BackupVaultNotifications events list.
+
+1.41.0 (2022-02-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.40.0 (2021-12-21)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.39.0 (2021-11-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.38.0 (2021-11-23)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.38.0
+1.42.0

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

@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -73,6 +75,8 @@ module Aws::Backup
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -119,7 +123,9 @@ module Aws::Backup
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -173,6 +179,10 @@ module Aws::Backup
     #     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 [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -295,7 +305,7 @@ module Aws::Backup
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :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.
     #
@@ -311,6 +321,9 @@ module Aws::Backup
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -441,7 +454,7 @@ module Aws::Backup
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/assigning-resources.html#assigning-resources-json
+    # [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html#assigning-resources-json
     #
     # @option params [required, String] :backup_plan_id
     #   Uniquely identifies the backup plan to be associated with the
@@ -1886,7 +1899,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", "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"
+    #   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", "S3_BACKUP_OBJECT_FAILED", "S3_RESTORE_OBJECT_FAILED"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/GetBackupVaultNotifications AWS API Documentation
     #
@@ -2000,6 +2013,10 @@ module Aws::Backup
     # @option params [String] :by_resource_type
     #   Returns only backup jobs for the specified resources:
     #
+    #   * `Aurora` for Amazon Aurora
+    #
+    #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -2008,12 +2025,18 @@ module Aws::Backup
     #
     #   * `EFS` for Amazon Elastic File System
     #
-    #   * `RDS` for Amazon Relational Database Service
+    #   * `FSx` for Amazon FSx
     #
-    #   * `Aurora` for Amazon Aurora
+    #   * `Neptune` for Amazon Neptune
+    #
+    #   * `RDS` for Amazon Relational Database Service
     #
     #   * `Storage Gateway` for Storage Gateway
     #
+    #   * `S3` for Amazon S3
+    #
+    #   * `VirtualMachine` for virtual machines
+    #
     # @option params [String] :by_account_id
     #   The account ID to list the jobs from. Returns only backup jobs
     #   associated with the specified account ID.
@@ -2365,6 +2388,10 @@ module Aws::Backup
     # @option params [String] :by_resource_type
     #   Returns only backup jobs for the specified resources:
     #
+    #   * `Aurora` for Amazon Aurora
+    #
+    #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -2373,12 +2400,18 @@ module Aws::Backup
     #
     #   * `EFS` for Amazon Elastic File System
     #
-    #   * `RDS` for Amazon Relational Database Service
+    #   * `FSx` for Amazon FSx
     #
-    #   * `Aurora` for Amazon Aurora
+    #   * `Neptune` for Amazon Neptune
+    #
+    #   * `RDS` for Amazon Relational Database Service
     #
     #   * `Storage Gateway` for Storage Gateway
     #
+    #   * `S3` for Amazon S3
+    #
+    #   * `VirtualMachine` for virtual machines
+    #
     # @option params [String] :by_destination_vault_arn
     #   An Amazon Resource Name (ARN) that uniquely identifies a source backup
     #   vault to copy from; for example,
@@ -2892,9 +2925,14 @@ 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.
+    # `ListTags` only works for resource types that support full Backup
+    # management of their backups. Those resource types are listed in the
+    # "Full Backup management" section of the [ Feature availability by
+    # resource][1] table.
+    #
     #
-    #  </note>
+    #
+    # [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #
     # @option params [required, String] :resource_arn
     #   An Amazon Resource Name (ARN) that uniquely identifies a resource. The
@@ -3003,7 +3041,8 @@ module Aws::Backup
     #   longer than the minimum retention period. If the job's retention
     #   period is shorter than that minimum retention period, then the vault
     #   fails that backup or copy job, and you should either modify your
-    #   lifecycle settings or use a different vault. Recovery points already
+    #   lifecycle settings or use a different vault. The shortest minimum
+    #   retention period you can specify is 1 day. Recovery points already
     #   saved in the vault prior to Vault Lock are not affected.
     #
     # @option params [Integer] :max_retention_days
@@ -3023,8 +3062,10 @@ module Aws::Backup
     #   shorter than the maximum retention period. If the job's retention
     #   period is longer than that maximum retention period, then the vault
     #   fails the backup or copy job, and you should either modify your
-    #   lifecycle settings or use a different vault. Recovery points already
-    #   saved in the vault prior to Vault Lock are not affected.
+    #   lifecycle settings or use a different vault. The longest maximum
+    #   retention period you can specify is 36500 days (approximately 100
+    #   years). Recovery points already saved in the vault prior to Vault Lock
+    #   are not affected.
     #
     # @option params [Integer] :changeable_for_days
     #   The Backup Vault Lock configuration that specifies the number of days
@@ -3097,6 +3138,8 @@ module Aws::Backup
     #   * `RESTORE_JOB_STARTED` \| `RESTORE_JOB_COMPLETED` \|
     #     `RECOVERY_POINT_MODIFIED`
     #
+    #   * `S3_BACKUP_OBJECT_FAILED` \| `S3_RESTORE_OBJECT_FAILED`
+    #
     #   <note markdown="1"> Ignore the list below because it includes deprecated events. Refer to
     #   the list above.
     #
@@ -3113,7 +3156,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, 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
+    #     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, S3_BACKUP_OBJECT_FAILED, S3_RESTORE_OBJECT_FAILED
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/PutBackupVaultNotifications AWS API Documentation
@@ -3154,10 +3197,10 @@ module Aws::Backup
     #
     # @option params [Integer] :complete_window_minutes
     #   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.
+    #   complete, or else 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
@@ -3165,13 +3208,20 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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 resource types that support full Backup management can transition
+    #   their backups to cold storage. Those resource types are listed in the
+    #   "Full Backup management" section of the [ Feature availability by
+    #   resource][1] table. Backup ignores this expression for other resource
+    #   types.
+    #
+    #
     #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #
     # @option params [Hash<String,String>] :recovery_point_tags
     #   To help organize your resources, you can assign your own metadata to
@@ -3264,13 +3314,20 @@ module Aws::Backup
     #   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.
+    #   for a minimum of 90 days. Therefore, on the console, the “retention”
+    #   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.
+    #   Only resource types that support full Backup management can transition
+    #   their backups to cold storage. Those resource types are listed in the
+    #   "Full Backup management" section of the [ Feature availability by
+    #   resource][1] table. Backup ignores this expression for other resource
+    #   types.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #
     # @return [Types::StartCopyJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3405,6 +3462,10 @@ module Aws::Backup
     #   Starts a job to restore a recovery point for one of the following
     #   resources:
     #
+    #   * `Aurora` for Amazon Aurora
+    #
+    #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -3413,12 +3474,18 @@ module Aws::Backup
     #
     #   * `EFS` for Amazon Elastic File System
     #
-    #   * `RDS` for Amazon Relational Database Service
+    #   * `FSx` for Amazon FSx
     #
-    #   * `Aurora` for Amazon Aurora
+    #   * `Neptune` for Amazon Neptune
+    #
+    #   * `RDS` for Amazon Relational Database Service
     #
     #   * `Storage Gateway` for Storage Gateway
     #
+    #   * `S3` for Amazon S3
+    #
+    #   * `VirtualMachine` for virtual machines
+    #
     # @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
@@ -3722,15 +3789,22 @@ module Aws::Backup
     # backups automatically according to the lifecycle that you define.
     #
     # Backups transitioned to cold storage must be stored in cold storage
-    # for a minimum of 90 days. Therefore, 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.
+    # for a minimum of 90 days. Therefore, the “retention” 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.
+    # Only resource types that support full Backup management can transition
+    # their backups to cold storage. Those resource types are listed in the
+    # "Full Backup management" section of the [ Feature availability by
+    # resource][1] table. Backup ignores this expression for other resource
+    # types.
     #
-    # Does not support continuous backups.
+    # This operation does not support continuous backups.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #
     # @option params [required, String] :backup_vault_name
     #   The name of a logical container where backups are stored. Backup
@@ -3749,10 +3823,10 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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::UpdateRecoveryPointLifecycleOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3803,12 +3877,15 @@ module Aws::Backup
     #   Region.
     #
     # @option params [Hash<String,Boolean>] :resource_type_management_preference
-    #   Enables or disables [ Backup's advanced DynamoDB backup features][1]
-    #   for the Region.
+    #   Enables or disables full Backup management of backups for a resource
+    #   type. To enable full Backup management for DynamoDB along with [
+    #   Backup's advanced DynamoDB backup features][1], follow the procedure
+    #   to [ enable advanced DynamoDB backup programmatically][2].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html
+    #   [2]: https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3921,7 +3998,7 @@ module Aws::Backup
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-backup'
-      context[:gem_version] = '1.38.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -492,13 +492,20 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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 resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
     #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] recovery_point_tags
@@ -604,13 +611,20 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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 resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
     #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] recovery_point_tags
@@ -841,9 +855,20 @@ module Aws::Backup
     #   @return [Time]
     #
     # @!attribute [rw] encryption_key_arn
-    #   The server-side encryption key that is used to protect your backups;
-    #   for example,
+    #   A server-side encryption key you can specify to encrypt your backups
+    #   from services that support full Backup management; for example,
     #   `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+    #   If you specify a key, you must specify its ARN, not its alias. If
+    #   you do not specify a key, Backup creates a KMS key for you by
+    #   default.
+    #
+    #   To learn which Backup services support full Backup management and
+    #   how Backup handles encryption for backups from services that do not
+    #   yet support full Backup, see [ Encryption for backups in Backup][1]
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/encryption.html
     #   @return [String]
     #
     # @!attribute [rw] creator_request_id
@@ -934,13 +959,20 @@ module Aws::Backup
     # backups automatically according to the lifecycle that you define.
     #
     # Backups transitioned to cold storage must be stored in cold storage
-    # for a minimum of 90 days. Therefore, 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.
+    # for a minimum of 90 days. Therefore, the “retention” 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 resource types that support full Backup management can transition
+    # their backups to cold storage. Those resource types are listed in the
+    # "Full Backup management" section of the [ Feature availability by
+    # resource][1] table. Backup ignores this expression for other resource
+    # types.
+    #
     #
-    # Only Amazon EFS file system backups can be transitioned to cold
-    # storage.
+    #
+    # [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #
     # @!attribute [rw] move_to_cold_storage_at
     #   A timestamp that specifies when to transition a recovery point to
@@ -976,7 +1008,7 @@ module Aws::Backup
     # @!attribute [rw] condition_type
     #   An operation applied to a key-value pair used to assign resources to
     #   your backup plan. Condition only supports `StringEquals`. For more
-    #   flexible assignment options, incluidng `StringLike` and the ability
+    #   flexible assignment options, including `StringLike` and the ability
     #   to exclude resources from your backup plan, use `Conditions` (with
     #   an "s" on the end) for your [ `BackupSelection` ][1].
     #
@@ -1231,14 +1263,20 @@ module Aws::Backup
     #   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.
-    #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #   for a minimum of 90 days. Therefore, on the console, the “retention”
+    #   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 resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] destination_backup_vault_arn
@@ -2736,13 +2774,20 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups that are transitioned to cold storage must be stored in cold
-    #   storage for a minimum of 90 days. Therefore, 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
+    #   storage for a minimum of 90 days. Therefore, the “retention” 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.
+    #   Only resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] encryption_key_arn
@@ -2808,12 +2853,24 @@ module Aws::Backup
     #   @return [Hash<String,Boolean>]
     #
     # @!attribute [rw] resource_type_management_preference
-    #   Returns whether a DynamoDB recovery point was taken using [
-    #   Backup's advanced DynamoDB backup features][1].
+    #   Returns whether Backup fully manages the backups for a resource
+    #   type.
     #
+    #   For the benefits of full Backup management, see [ Full Backup
+    #   management][1].
     #
+    #   For a list of resource types and whether each supports full Backup
+    #   management, see the [ Feature availability by resource][2] table.
     #
-    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html
+    #   If `"DynamoDB":false`, you can enable full Backup management for
+    #   DynamoDB backup by enabling [ Backup's advanced DynamoDB backup
+    #   features][3].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#full-management
+    #   [2]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
+    #   [3]: https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli
     #   @return [Hash<String,Boolean>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/DescribeRegionSettingsOutput AWS API Documentation
@@ -3566,6 +3623,10 @@ module Aws::Backup
     #   * `RDS` for Amazon Relational Database Service
     #
     #   * `Storage Gateway` for Storage Gateway
+    #
+    #   * `DocDB` for Amazon DocumentDB (with MongoDB compatibility)
+    #
+    #   * `Neptune` for Amazon Neptune
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/GetSupportedResourceTypesOutput AWS API Documentation
@@ -3659,13 +3720,20 @@ module Aws::Backup
     # 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.
+    # for a minimum of 90 days. Therefore, on the console, the “retention”
+    # 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 resource types that support full Backup management can transition
+    # their backups to cold storage. Those resource types are listed in the
+    # "Full Backup management" section of the [ Feature availability by
+    # resource][1] table. Backup ignores this expression for other resource
+    # types.
+    #
+    #
     #
-    # Only Amazon EFS file system backups can be transitioned to cold
-    # storage.
+    # [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #
     # @note When making an API call, you may pass Lifecycle
     #   data as a hash:
@@ -3776,6 +3844,10 @@ module Aws::Backup
     # @!attribute [rw] by_resource_type
     #   Returns only backup jobs for the specified resources:
     #
+    #   * `Aurora` for Amazon Aurora
+    #
+    #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -3784,11 +3856,17 @@ module Aws::Backup
     #
     #   * `EFS` for Amazon Elastic File System
     #
-    #   * `RDS` for Amazon Relational Database Service
+    #   * `FSx` for Amazon FSx
     #
-    #   * `Aurora` for Amazon Aurora
+    #   * `Neptune` for Amazon Neptune
+    #
+    #   * `RDS` for Amazon Relational Database Service
     #
     #   * `Storage Gateway` for Storage Gateway
+    #
+    #   * `S3` for Amazon S3
+    #
+    #   * `VirtualMachine` for virtual machines
     #   @return [String]
     #
     # @!attribute [rw] by_account_id
@@ -4148,6 +4226,10 @@ module Aws::Backup
     # @!attribute [rw] by_resource_type
     #   Returns only backup jobs for the specified resources:
     #
+    #   * `Aurora` for Amazon Aurora
+    #
+    #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -4156,11 +4238,17 @@ module Aws::Backup
     #
     #   * `EFS` for Amazon Elastic File System
     #
-    #   * `RDS` for Amazon Relational Database Service
+    #   * `FSx` for Amazon FSx
     #
-    #   * `Aurora` for Amazon Aurora
+    #   * `Neptune` for Amazon Neptune
+    #
+    #   * `RDS` for Amazon Relational Database Service
     #
     #   * `Storage Gateway` for Storage Gateway
+    #
+    #   * `S3` for Amazon S3
+    #
+    #   * `VirtualMachine` for virtual machines
     #   @return [String]
     #
     # @!attribute [rw] by_destination_vault_arn
@@ -4851,7 +4939,8 @@ module Aws::Backup
     #   longer than the minimum retention period. If the job's retention
     #   period is shorter than that minimum retention period, then the vault
     #   fails that backup or copy job, and you should either modify your
-    #   lifecycle settings or use a different vault. Recovery points already
+    #   lifecycle settings or use a different vault. The shortest minimum
+    #   retention period you can specify is 1 day. Recovery points already
     #   saved in the vault prior to Vault Lock are not affected.
     #   @return [Integer]
     #
@@ -4872,8 +4961,10 @@ module Aws::Backup
     #   shorter than the maximum retention period. If the job's retention
     #   period is longer than that maximum retention period, then the vault
     #   fails the backup or copy job, and you should either modify your
-    #   lifecycle settings or use a different vault. Recovery points already
-    #   saved in the vault prior to Vault Lock are not affected.
+    #   lifecycle settings or use a different vault. The longest maximum
+    #   retention period you can specify is 36500 days (approximately 100
+    #   years). Recovery points already saved in the vault prior to Vault
+    #   Lock are not affected.
     #   @return [Integer]
     #
     # @!attribute [rw] changeable_for_days
@@ -4915,7 +5006,7 @@ module Aws::Backup
     #       {
     #         backup_vault_name: "BackupVaultName", # required
     #         sns_topic_arn: "ARN", # required
-    #         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
+    #         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, S3_BACKUP_OBJECT_FAILED, S3_RESTORE_OBJECT_FAILED
     #       }
     #
     # @!attribute [rw] backup_vault_name
@@ -4947,6 +5038,8 @@ module Aws::Backup
     #   * `RESTORE_JOB_STARTED` \| `RESTORE_JOB_COMPLETED` \|
     #     `RECOVERY_POINT_MODIFIED`
     #
+    #   * `S3_BACKUP_OBJECT_FAILED` \| `S3_RESTORE_OBJECT_FAILED`
+    #
     #   <note markdown="1"> Ignore the list below because it includes deprecated events. Refer
     #   to the list above.
     #
@@ -5057,13 +5150,20 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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 resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
+    #
+    #
     #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] encryption_key_arn
@@ -5644,7 +5744,7 @@ module Aws::Backup
     #
     # @!attribute [rw] complete_window_minutes
     #   A value in minutes during which a successfully started backup must
-    #   complete, or else AWS Backup will cancel the job. This value is
+    #   complete, or else 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.
@@ -5656,13 +5756,20 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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 resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
+    #
+    #
     #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] recovery_point_tags
@@ -5776,14 +5883,20 @@ module Aws::Backup
     #   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.
-    #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #   for a minimum of 90 days. Therefore, on the console, the “retention”
+    #   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 resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/StartCopyJobInput AWS API Documentation
@@ -5942,6 +6055,10 @@ module Aws::Backup
     #   Starts a job to restore a recovery point for one of the following
     #   resources:
     #
+    #   * `Aurora` for Amazon Aurora
+    #
+    #   * `DocumentDB` for Amazon DocumentDB (with MongoDB compatibility)
+    #
     #   * `DynamoDB` for Amazon DynamoDB
     #
     #   * `EBS` for Amazon Elastic Block Store
@@ -5950,11 +6067,17 @@ module Aws::Backup
     #
     #   * `EFS` for Amazon Elastic File System
     #
-    #   * `RDS` for Amazon Relational Database Service
+    #   * `FSx` for Amazon FSx
     #
-    #   * `Aurora` for Amazon Aurora
+    #   * `Neptune` for Amazon Neptune
+    #
+    #   * `RDS` for Amazon Relational Database Service
     #
     #   * `Storage Gateway` for Storage Gateway
+    #
+    #   * `S3` for Amazon S3
+    #
+    #   * `VirtualMachine` for virtual machines
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/StartRestoreJobInput AWS API Documentation
@@ -6304,10 +6427,10 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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::Lifecycle]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/UpdateRecoveryPointLifecycleInput AWS API Documentation
@@ -6337,13 +6460,20 @@ module Aws::Backup
     #   backups automatically according to the lifecycle that you define.
     #
     #   Backups transitioned to cold storage must be stored in cold storage
-    #   for a minimum of 90 days. Therefore, 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.
+    #   for a minimum of 90 days. Therefore, the “retention” 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 resource types that support full Backup management can
+    #   transition their backups to cold storage. Those resource types are
+    #   listed in the "Full Backup management" section of the [ Feature
+    #   availability by resource][1] table. Backup ignores this expression
+    #   for other resource types.
+    #
+    #
     #
-    #   Only Amazon EFS file system backups can be transitioned to cold
-    #   storage.
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#features-by-resource
     #   @return [Types::Lifecycle]
     #
     # @!attribute [rw] calculated_lifecycle
@@ -6380,12 +6510,15 @@ module Aws::Backup
     #   @return [Hash<String,Boolean>]
     #
     # @!attribute [rw] resource_type_management_preference
-    #   Enables or disables [ Backup's advanced DynamoDB backup
-    #   features][1] for the Region.
+    #   Enables or disables full Backup management of backups for a resource
+    #   type. To enable full Backup management for DynamoDB along with [
+    #   Backup's advanced DynamoDB backup features][1], follow the
+    #   procedure to [ enable advanced DynamoDB backup programmatically][2].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html
+    #   [2]: https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli
     #   @return [Hash<String,Boolean>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/UpdateRegionSettingsInput AWS API Documentation

data/lib/aws-sdk-backup.rb

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

metadata

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