aws-sdk-backup 1.65.0 → 1.67.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6e2dcae78f88e19ccff8fa12447c90f51f8c8d49c05f213b90d2345d8cfd42b
-  data.tar.gz: 890c7980a942fde12dd99f1810e0f4267c498b12ac1f4b666627a37d7671fe95
+  metadata.gz: 20180b3427a7f986677135ecf996fa6b4bd248fefe68863569aa5c5058e75055
+  data.tar.gz: 86c974456aab7d08120fcc6c6f9b62faaa60a9b79cd04c52f661de8a1eb1cc90
 SHA512:
-  metadata.gz: 4d79d5978e7df737d4bfd6ebd487313ceb3a1d0c0e89a743cf55f27f8cc929e7680b23f5720106d8d4714abf8001bc95ff9ea9b312ef5daba870518a47d86024
-  data.tar.gz: 76df14aa9eb7be8c1b17572e8a71b02cd7d845225e3b4e190a0909c18f8c1490b318d45d4a8879c0eca99321a4bbf5dee464eccd1e6ed1c362e5ff1b3a39d8bc
+  metadata.gz: e727032ab1a91ea97779c8df8c087e66c2fe638a4fc042791dc02ea2e65bd66ed9b4de60054ff3f1ea227d8d401759412ac51b712cdf639268cf3ac3680fff85
+  data.tar.gz: 49e7e54abf68670448df0afefbbb80db4aec16a4e6ae4eb51a9ed6d3327c439231b06368fa2a0a105edafcfafc2850631a41ba88b0c0aede6e08440df4ac2277

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.67.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.66.0 (2024-03-15)
+------------------
+
+* Feature - This release introduces a boolean attribute ManagedByAWSBackupOnly as part of ListRecoveryPointsByResource api to filter the recovery points based on ownership. This attribute can be used to filter out the recovery points protected by AWSBackup.
+
 1.65.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.65.0
+1.67.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::Backup
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::Backup
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -337,50 +346,65 @@ module Aws::Backup
     #   @option options [Aws::Backup::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::Backup::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @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.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @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`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @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.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -2839,6 +2863,19 @@ module Aws::Backup
     #   `AGGREGATE_ALL` aggregates job counts for all states and returns the
     #   sum.
     #
+    #   `Completed with issues` is a status found only in the Backup console.
+    #   For API, this status refers to jobs with a state of `COMPLETED` and a
+    #   `MessageCategory` with a value other than `SUCCESS`; that is, the
+    #   status is completed but comes with a status message. To obtain the job
+    #   count for `Completed with issues`, run two GET requests, and subtract
+    #   the second, smaller number:
+    #
+    #   GET
+    #   /audit/backup-job-summaries?AggregationPeriod=FOURTEEN\_DAYS&State=COMPLETED
+    #
+    #   GET
+    #   /audit/backup-job-summaries?AggregationPeriod=FOURTEEN\_DAYS&MessageCategory=SUCCESS&State=COMPLETED
+    #
     # @option params [String] :resource_type
     #   Returns the job count for the specified resource type. Use request
     #   `GetSupportedResourceTypes` to obtain strings for supported resource
@@ -2959,6 +2996,18 @@ module Aws::Backup
     # @option params [String] :by_state
     #   Returns only backup jobs that are in the specified state.
     #
+    #   `Completed with issues` is a status found only in the Backup console.
+    #   For API, this status refers to jobs with a state of `COMPLETED` and a
+    #   `MessageCategory` with a value other than `SUCCESS`; that is, the
+    #   status is completed but comes with a status message.
+    #
+    #   To obtain the job count for `Completed with issues`, run two GET
+    #   requests, and subtract the second, smaller number:
+    #
+    #   GET /backup-jobs/?state=COMPLETED
+    #
+    #   GET /backup-jobs/?messageCategory=SUCCESS&state=COMPLETED
+    #
     # @option params [String] :by_backup_vault_name
     #   Returns only backup jobs that will be stored in the specified backup
     #   vault. Backup vaults are identified by names that are unique to the
@@ -4078,6 +4127,17 @@ module Aws::Backup
     #
     #    </note>
     #
+    # @option params [Boolean] :managed_by_aws_backup_only
+    #   This attribute filters recovery points based on ownership.
+    #
+    #   If this is set to `TRUE`, the response will contain recovery points
+    #   associated with the selected resources that are managed by Backup.
+    #
+    #   If this is set to `FALSE`, the response will contain all recovery
+    #   points associated with the selected resource.
+    #
+    #   Type: Boolean
+    #
     # @return [Types::ListRecoveryPointsByResourceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListRecoveryPointsByResourceOutput#next_token #next_token} => String
@@ -4091,6 +4151,7 @@ module Aws::Backup
     #     resource_arn: "ARN", # required
     #     next_token: "string",
     #     max_results: 1,
+    #     managed_by_aws_backup_only: false,
     #   })
     #
     # @example Response structure
@@ -4107,6 +4168,7 @@ module Aws::Backup
     #   resp.recovery_points[0].is_parent #=> Boolean
     #   resp.recovery_points[0].parent_recovery_point_arn #=> String
     #   resp.recovery_points[0].resource_name #=> String
+    #   resp.recovery_points[0].vault_type #=> String, one of "BACKUP_VAULT", "LOGICALLY_AIR_GAPPED_BACKUP_VAULT"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/ListRecoveryPointsByResource AWS API Documentation
     #
@@ -5336,9 +5398,9 @@ module Aws::Backup
     # Attempts to cancel a job to create a one-time backup of a resource.
     #
     # This action is not supported for the following services: Amazon FSx
-    # for Windows File Server, Amazon FSx for Lustre, FSx for ONTAP , Amazon
-    # FSx for OpenZFS, Amazon DocumentDB (with MongoDB compatibility),
-    # Amazon RDS, Amazon Aurora, and Amazon Neptune.
+    # for Windows File Server, Amazon FSx for Lustre, Amazon FSx for NetApp
+    # ONTAP , Amazon FSx for OpenZFS, Amazon DocumentDB (with MongoDB
+    # compatibility), Amazon RDS, Amazon Aurora, and Amazon Neptune.
     #
     # @option params [required, String] :backup_job_id
     #   Uniquely identifies a request to Backup to back up a resource.
@@ -5972,7 +6034,7 @@ module Aws::Backup
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-backup'
-      context[:gem_version] = '1.65.0'
+      context[:gem_version] = '1.67.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1289,6 +1289,7 @@ module Aws::Backup
     ListRecoveryPointsByResourceInput.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ARN, required: true, location: "uri", location_name: "resourceArn"))
     ListRecoveryPointsByResourceInput.add_member(:next_token, Shapes::ShapeRef.new(shape: string, location: "querystring", location_name: "nextToken"))
     ListRecoveryPointsByResourceInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location: "querystring", location_name: "maxResults"))
+    ListRecoveryPointsByResourceInput.add_member(:managed_by_aws_backup_only, Shapes::ShapeRef.new(shape: boolean, location: "querystring", location_name: "managedByAWSBackupOnly"))
     ListRecoveryPointsByResourceInput.struct_class = Types::ListRecoveryPointsByResourceInput
 
     ListRecoveryPointsByResourceOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: string, location_name: "NextToken"))
@@ -1462,6 +1463,7 @@ module Aws::Backup
     RecoveryPointByResource.add_member(:is_parent, Shapes::ShapeRef.new(shape: boolean, location_name: "IsParent"))
     RecoveryPointByResource.add_member(:parent_recovery_point_arn, Shapes::ShapeRef.new(shape: ARN, location_name: "ParentRecoveryPointArn"))
     RecoveryPointByResource.add_member(:resource_name, Shapes::ShapeRef.new(shape: string, location_name: "ResourceName"))
+    RecoveryPointByResource.add_member(:vault_type, Shapes::ShapeRef.new(shape: VaultType, location_name: "VaultType"))
     RecoveryPointByResource.struct_class = Types::RecoveryPointByResource
 
     RecoveryPointByResourceList.member = Shapes::ShapeRef.new(shape: RecoveryPointByResource)

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

@@ -3587,6 +3587,12 @@ module Aws::Backup
     #   will evaluate. Three examples of control scopes are: a specific
     #   backup plan, all backup plans with a specific tag, or all backup
     #   plans.
+    #
+    #   For more information, see [ `ControlScope`.][1]
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ControlScope.html
     #   @return [Types::ControlScope]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/FrameworkControl AWS API Documentation
@@ -4429,6 +4435,19 @@ module Aws::Backup
     #
     #   `AGGREGATE_ALL` aggregates job counts for all states and returns the
     #   sum.
+    #
+    #   `Completed with issues` is a status found only in the Backup
+    #   console. For API, this status refers to jobs with a state of
+    #   `COMPLETED` and a `MessageCategory` with a value other than
+    #   `SUCCESS`; that is, the status is completed but comes with a status
+    #   message. To obtain the job count for `Completed with issues`, run
+    #   two GET requests, and subtract the second, smaller number:
+    #
+    #   GET
+    #   /audit/backup-job-summaries?AggregationPeriod=FOURTEEN\_DAYS&State=COMPLETED
+    #
+    #   GET
+    #   /audit/backup-job-summaries?AggregationPeriod=FOURTEEN\_DAYS&MessageCategory=SUCCESS&State=COMPLETED
     #   @return [String]
     #
     # @!attribute [rw] resource_type
@@ -4554,6 +4573,19 @@ module Aws::Backup
     #
     # @!attribute [rw] by_state
     #   Returns only backup jobs that are in the specified state.
+    #
+    #   `Completed with issues` is a status found only in the Backup
+    #   console. For API, this status refers to jobs with a state of
+    #   `COMPLETED` and a `MessageCategory` with a value other than
+    #   `SUCCESS`; that is, the status is completed but comes with a status
+    #   message.
+    #
+    #   To obtain the job count for `Completed with issues`, run two GET
+    #   requests, and subtract the second, smaller number:
+    #
+    #   GET /backup-jobs/?state=COMPLETED
+    #
+    #   GET /backup-jobs/?messageCategory=SUCCESS&state=COMPLETED
     #   @return [String]
     #
     # @!attribute [rw] by_backup_vault_name
@@ -5567,12 +5599,25 @@ module Aws::Backup
     #    </note>
     #   @return [Integer]
     #
+    # @!attribute [rw] managed_by_aws_backup_only
+    #   This attribute filters recovery points based on ownership.
+    #
+    #   If this is set to `TRUE`, the response will contain recovery points
+    #   associated with the selected resources that are managed by Backup.
+    #
+    #   If this is set to `FALSE`, the response will contain all recovery
+    #   points associated with the selected resource.
+    #
+    #   Type: Boolean
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/ListRecoveryPointsByResourceInput AWS API Documentation
     #
     class ListRecoveryPointsByResourceInput < Struct.new(
       :resource_arn,
       :next_token,
-      :max_results)
+      :max_results,
+      :managed_by_aws_backup_only)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6663,6 +6708,11 @@ module Aws::Backup
     #   specified backup.
     #   @return [String]
     #
+    # @!attribute [rw] vault_type
+    #   This is the type of vault in which the described recovery point is
+    #   stored.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/backup-2018-11-15/RecoveryPointByResource AWS API Documentation
     #
     class RecoveryPointByResource < Struct.new(
@@ -6675,7 +6725,8 @@ module Aws::Backup
       :backup_vault_name,
       :is_parent,
       :parent_recovery_point_arn,
-      :resource_name)
+      :resource_name,
+      :vault_type)
       SENSITIVE = []
       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.65.0'
+  GEM_VERSION = '1.67.0'
 
 end

data/sig/client.rbs

@@ -1074,7 +1074,8 @@ module Aws
       def list_recovery_points_by_resource: (
                                               resource_arn: ::String,
                                               ?next_token: ::String,
-                                              ?max_results: ::Integer
+                                              ?max_results: ::Integer,
+                                              ?managed_by_aws_backup_only: bool
                                             ) -> _ListRecoveryPointsByResourceResponseSuccess
                                           | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListRecoveryPointsByResourceResponseSuccess
 

data/sig/types.rbs

@@ -1180,6 +1180,7 @@ module Aws::Backup
       attr_accessor resource_arn: ::String
       attr_accessor next_token: ::String
       attr_accessor max_results: ::Integer
+      attr_accessor managed_by_aws_backup_only: bool
       SENSITIVE: []
     end
 
@@ -1398,6 +1399,7 @@ module Aws::Backup
       attr_accessor is_parent: bool
       attr_accessor parent_recovery_point_arn: ::String
       attr_accessor resource_name: ::String
+      attr_accessor vault_type: ("BACKUP_VAULT" | "LOGICALLY_AIR_GAPPED_BACKUP_VAULT")
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-backup
 version: !ruby/object:Gem::Version
-  version: 1.65.0
+  version: 1.67.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-04-25 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.191.0
+        version: 3.193.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement