aws-sdk-backup 1.41.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4acf0a1d08741a34324670f166a154a56323eb656b6383a6d3a558bb2ac5bafb
-  data.tar.gz: 0ae177c280deaa4bdfede6d39240e69bc5e6fa95f449ed077ffdf1db4bebf273
+  metadata.gz: 4d16c44fc21d12f4c43e9a2760f07374c31f9f33088890749196ca21f5bd751a
+  data.tar.gz: 14d96ed703250ef16b7b24e1dcb5d4ef74284ac07b8b68543bf4f3dd1ffc948f
 SHA512:
-  metadata.gz: 73c5bdd08265f02909f9fa0b179b1eaa1e3b405c0bb9d1dfe27b541a1bf15e0a4ee91772b8e9bb7a654815bee97291cc655173ff928acd2d501bf1bedad5fa84
-  data.tar.gz: 7411c34167673dff3c9f4444bc995e127f3554cc2d3b90602a312a531623c4f8d2097035d7a4bf3d69def56bc30eeeb56116fe767f76aefec465757fc0a287c6
+  metadata.gz: c3287fa6493e11761a61f6995cf12074f65584d75ba5aa8b143d067bf9d2797dc56a8dab996dfb3688cb917c76b938ba289a237470b03782138d75cd45916435
+  data.tar.gz: 840e80fcb39be2b535d0ce0b7f5dc37d133b2ee50509f009db9a633031b35b79368ce73017a7fa43fb4fd03631228613d2bbfd5eb921733a7eeb64900653e440

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.41.0
+1.42.0

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

@@ -454,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
@@ -1899,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
     #
@@ -2013,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
@@ -2021,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.
@@ -2378,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
@@ -2386,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,
@@ -2905,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
@@ -3016,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
@@ -3036,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
@@ -3110,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.
     #
@@ -3126,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
@@ -3167,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
@@ -3178,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
@@ -3277,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 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::StartCopyJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3418,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
@@ -3426,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
@@ -3735,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
@@ -3762,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:
     #
@@ -3816,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}.
     #
@@ -3934,7 +3998,7 @@ module Aws::Backup
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-backup'
-      context[:gem_version] = '1.41.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.41.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.41.0
+  version: 1.42.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-03 00:00:00.000000000 Z
+date: 2022-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core