aws-sdk-datasync 1.74.0 → 1.76.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2024713ee4a25b366f65c94c1e4106b5a9d9a844104c7fcfcb9bf34e0ef91ef0
-  data.tar.gz: 29fac01e0271649b8d64bea745b513e455cc1a3e4e9f23d8b3ba4e7dd22ad09c
+  metadata.gz: 6c4dfa76783b34f5495768bc4ab658b1eee836d058d48771ea039e258b305154
+  data.tar.gz: 3def60dcb53d8be382b2f14d559f8355b2e0b2758a5e969f32dcd5063c992c3d
 SHA512:
-  metadata.gz: f251dee6793f5cb82d90453b32016e6d5fff40960919c338e7767d22c1eaa180529db68960d02db99f9e94d6c54f829766311d077795958f7af0dd6217ad3820
-  data.tar.gz: c68e77485eca1adc84eceb9521427b7c2aacf277aec2aed1ef64e61e614501315e7e452dd87b2b1a013506543b4cf8c2d582cae816c86c8008a136bfffef9e0a
+  metadata.gz: b5dbb23d2c97f670b6bfd770c9fb24c8c843837623c72b0106d18ba10e89d0d9da98ce728f2b190606406afd255e6fe77773d9e80e3adbcbc3bd1a5cc5495b89
+  data.tar.gz: 671f569b9f5569bc28011111b65d92bc5701383fb1afe0abbf11f1e99ac49159e8b4444ef617439ade0931fcf64fb5bedff4f546719962e7dd2242f6821ba986

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.76.0 (2024-05-03)
+------------------
+
+* Feature - Updated guidance on using private or self-signed certificate authorities (CAs) with AWS DataSync object storage locations.
+
+1.75.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.74.0 (2024-04-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.74.0
+1.76.0

data/lib/aws-sdk-datasync/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::DataSync
     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::DataSync
     #     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
@@ -347,50 +356,65 @@ module Aws::DataSync
     #   @option options [Aws::DataSync::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::DataSync::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 [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] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @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.
     #
     def initialize(*args)
       super
@@ -1441,20 +1465,27 @@ module Aws::DataSync
     #   your resources. We recommend creating a name tag for your location.
     #
     # @option params [String, StringIO, File] :server_certificate
-    #   Specifies a file with the certificates that are used to sign the
-    #   object storage server's certificate (for example,
-    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The file you
-    #   specify must include the following:
+    #   Specifies a certificate chain for DataSync to authenticate with your
+    #   object storage system if the system uses a private or self-signed
+    #   certificate authority (CA). You must specify a single `.pem` file with
+    #   a full certificate chain (for example,
+    #   `file:///home/user/.ssh/object_storage_certificates.pem`).
     #
-    #   * The certificate of the signing certificate authority (CA)
+    #   The certificate chain might include:
     #
-    #   * Any intermediate certificates
+    #   * The object storage system's certificate
     #
-    #   * base64 encoding
+    #   * All intermediate certificates (if there are any)
     #
-    #   * A `.pem` extension
+    #   * The root certificate of the signing CA
     #
-    #   The file can be up to 32768 bytes (before base64 encoding).
+    #   You can concatenate your certificates into a `.pem` file (which can be
+    #   up to 32768 bytes before base64 encoding). The following example `cat`
+    #   command creates an `object_storage_certificates.pem` file that
+    #   includes three certificates:
+    #
+    #   `cat object_server_certificate.pem intermediate_certificate.pem
+    #   ca_root_certificate.pem > object_storage_certificates.pem`
     #
     #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
     #
@@ -4133,14 +4164,8 @@ module Aws::DataSync
       req.send_request(options)
     end
 
-    # Updates some parameters of an existing object storage location that
-    # DataSync accesses for a transfer. For information about creating a
-    # self-managed object storage location, see [Creating a location for
-    # object storage][1].
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html
+    # Updates some parameters of an existing DataSync location for an object
+    # storage system.
     #
     # @option params [required, String] :location_arn
     #   Specifies the ARN of the object storage system location that you're
@@ -4173,16 +4198,32 @@ module Aws::DataSync
     #   can securely connect with your location.
     #
     # @option params [String, StringIO, File] :server_certificate
-    #   Specifies a certificate to authenticate with an object storage system
-    #   that uses a private or self-signed certificate authority (CA). You
-    #   must specify a Base64-encoded `.pem` file (for example,
-    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The certificate
-    #   can be up to 32768 bytes (before Base64 encoding).
+    #   Specifies a certificate chain for DataSync to authenticate with your
+    #   object storage system if the system uses a private or self-signed
+    #   certificate authority (CA). You must specify a single `.pem` file with
+    #   a full certificate chain (for example,
+    #   `file:///home/user/.ssh/object_storage_certificates.pem`).
+    #
+    #   The certificate chain might include:
+    #
+    #   * The object storage system's certificate
+    #
+    #   * All intermediate certificates (if there are any)
+    #
+    #   * The root certificate of the signing CA
+    #
+    #   You can concatenate your certificates into a `.pem` file (which can be
+    #   up to 32768 bytes before base64 encoding). The following example `cat`
+    #   command creates an `object_storage_certificates.pem` file that
+    #   includes three certificates:
+    #
+    #   `cat object_server_certificate.pem intermediate_certificate.pem
+    #   ca_root_certificate.pem > object_storage_certificates.pem`
     #
     #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
     #
-    #   Updating the certificate doesn't interfere with tasks that you have
-    #   in progress.
+    #   Updating this parameter doesn't interfere with tasks that you have in
+    #   progress.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4611,7 +4652,7 @@ module Aws::DataSync
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-datasync'
-      context[:gem_version] = '1.74.0'
+      context[:gem_version] = '1.76.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1365,6 +1365,7 @@ module Aws::DataSync
         "endpointPrefix" => "datasync",
         "jsonVersion" => "1.1",
         "protocol" => "json",
+        "protocols" => ["json"],
         "serviceAbbreviation" => "DataSync",
         "serviceFullName" => "AWS DataSync",
         "serviceId" => "DataSync",

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

@@ -983,20 +983,27 @@ module Aws::DataSync
     #   @return [Array<Types::TagListEntry>]
     #
     # @!attribute [rw] server_certificate
-    #   Specifies a file with the certificates that are used to sign the
-    #   object storage server's certificate (for example,
-    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The file you
-    #   specify must include the following:
+    #   Specifies a certificate chain for DataSync to authenticate with your
+    #   object storage system if the system uses a private or self-signed
+    #   certificate authority (CA). You must specify a single `.pem` file
+    #   with a full certificate chain (for example,
+    #   `file:///home/user/.ssh/object_storage_certificates.pem`).
     #
-    #   * The certificate of the signing certificate authority (CA)
+    #   The certificate chain might include:
     #
-    #   * Any intermediate certificates
+    #   * The object storage system's certificate
     #
-    #   * base64 encoding
+    #   * All intermediate certificates (if there are any)
     #
-    #   * A `.pem` extension
+    #   * The root certificate of the signing CA
     #
-    #   The file can be up to 32768 bytes (before base64 encoding).
+    #   You can concatenate your certificates into a `.pem` file (which can
+    #   be up to 32768 bytes before base64 encoding). The following example
+    #   `cat` command creates an `object_storage_certificates.pem` file that
+    #   includes three certificates:
+    #
+    #   `cat object_server_certificate.pem intermediate_certificate.pem
+    #   ca_root_certificate.pem > object_storage_certificates.pem`
     #
     #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
     #   @return [String]
@@ -2139,8 +2146,9 @@ module Aws::DataSync
     #   @return [Time]
     #
     # @!attribute [rw] server_certificate
-    #   The self-signed certificate that DataSync uses to securely
-    #   authenticate with your object storage system.
+    #   The certificate chain for DataSync to authenticate with your object
+    #   storage system if the system uses a private or self-signed
+    #   certificate authority (CA).
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationObjectStorageResponse AWS API Documentation
@@ -5516,7 +5524,7 @@ module Aws::DataSync
     #   Specifies whether to enable or disable your task schedule. Your
     #   schedule is enabled by default, but there can be situations where
     #   you need to disable it. For example, you might need to pause a
-    #   recurring transfer or fix an issue with your task or perform
+    #   recurring transfer to fix an issue with your task or perform
     #   maintenance on your storage system.
     #
     #   DataSync might disable your schedule automatically if your task
@@ -5938,15 +5946,31 @@ module Aws::DataSync
     #   @return [Array<String>]
     #
     # @!attribute [rw] server_certificate
-    #   Specifies a certificate to authenticate with an object storage
-    #   system that uses a private or self-signed certificate authority
-    #   (CA). You must specify a Base64-encoded `.pem` file (for example,
-    #   `file:///home/user/.ssh/storage_sys_certificate.pem`). The
-    #   certificate can be up to 32768 bytes (before Base64 encoding).
+    #   Specifies a certificate chain for DataSync to authenticate with your
+    #   object storage system if the system uses a private or self-signed
+    #   certificate authority (CA). You must specify a single `.pem` file
+    #   with a full certificate chain (for example,
+    #   `file:///home/user/.ssh/object_storage_certificates.pem`).
+    #
+    #   The certificate chain might include:
+    #
+    #   * The object storage system's certificate
+    #
+    #   * All intermediate certificates (if there are any)
+    #
+    #   * The root certificate of the signing CA
+    #
+    #   You can concatenate your certificates into a `.pem` file (which can
+    #   be up to 32768 bytes before base64 encoding). The following example
+    #   `cat` command creates an `object_storage_certificates.pem` file that
+    #   includes three certificates:
+    #
+    #   `cat object_server_certificate.pem intermediate_certificate.pem
+    #   ca_root_certificate.pem > object_storage_certificates.pem`
     #
     #   To use this parameter, configure `ServerProtocol` to `HTTPS`.
     #
-    #   Updating the certificate doesn't interfere with tasks that you have
+    #   Updating this parameter doesn't interfere with tasks that you have
     #   in progress.
     #   @return [String]
     #

data/lib/aws-sdk-datasync.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-datasync/customizations'
 # @!group service
 module Aws::DataSync
 
-  GEM_VERSION = '1.74.0'
+  GEM_VERSION = '1.76.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-datasync
 version: !ruby/object:Gem::Version
-  version: 1.74.0
+  version: 1.76.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-24 00:00:00.000000000 Z
+date: 2024-05-03 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