aws-sdk-qldb 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0ae019605845d5430d5539735cb3eadec0703c226e66e1e69a3a2a765965f6f
-  data.tar.gz: aa607479738b134125d416274d32e961639b04d1a572dfaabce51fed760a5283
+  metadata.gz: c86dfc91c9e13a2fcba5ed5ad728c90977431f0fe8c34cb6ab12ce94369b3420
+  data.tar.gz: '09fab663a44e6e3da2f449e793e3afbeb5f7d38bfa2dba4d735f5847e1212b39'
 SHA512:
-  metadata.gz: 8f6797ca4494f31fa65dca498d47649877ea84d2b17d2420768b083b3a96c28bfde7dc482d42b34f42dcce78da1f9dea1c357e43c110ddd102d0c6cbad164218
-  data.tar.gz: 15fbb7d6d9d2e39f2d004f2a57429db633500c8313575ca77542b3348fbf35cfd63dabe836e15b65755dec5e7cae11fd80af68023b7b38faa8e18e73de05680d
+  metadata.gz: a76efa1be04cd2d6e0ce18fc3b7752ae0f15d584531ac7a3fbb40731d551e8120237bca7d48d30734920a129ce77c9aa500963183097977ab6b27c7af30787d8
+  data.tar.gz: 6a7000dee82a21635f22857dedf3e119a208b5fb431eff08fdbbbcd7d2794cf6343121fb78b056e31c422a4f1c30499c38c452422523e6d9f6630f63085a5897

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.23.0 (2021-12-21)
+------------------
+
+* Feature - Amazon QLDB now supports journal exports in JSON and Ion Binary formats. This release adds an optional OutputFormat parameter to the ExportJournalToS3 API.
+
 1.22.0 (2021-11-30)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.22.0
+1.23.0

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

@@ -27,6 +27,7 @@ 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/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -73,6 +74,7 @@ module Aws::QLDB
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -175,6 +177,10 @@ module Aws::QLDB
     #     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.
@@ -297,7 +303,7 @@ module Aws::QLDB
     #     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.
     #
@@ -313,6 +319,9 @@ module Aws::QLDB
     #     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`.
     #
@@ -376,11 +385,13 @@ module Aws::QLDB
       req.send_request(options)
     end
 
-    # Creates a new ledger in your account in the current Region.
+    # Creates a new ledger in your Amazon Web Services account in the
+    # current Region.
     #
     # @option params [required, String] :name
     #   The name of the ledger that you want to create. The name must be
-    #   unique among all of the ledgers in your account in the current Region.
+    #   unique among all of the ledgers in your Amazon Web Services account in
+    #   the current Region.
     #
     #   Naming constraints for ledger names are defined in [Quotas in Amazon
     #   QLDB][1] in the *Amazon QLDB Developer Guide*.
@@ -460,7 +471,7 @@ module Aws::QLDB
     #   To specify a customer managed KMS key, you can use its key ID, Amazon
     #   Resource Name (ARN), alias name, or alias ARN. When using an alias
     #   name, prefix it with `"alias/"`. To specify a key in a different
-    #   account, you must use the key ARN or alias ARN.
+    #   Amazon Web Services account, you must use the key ARN or alias ARN.
     #
     #   For example:
     #
@@ -653,6 +664,7 @@ module Aws::QLDB
     #   resp.export_description.s3_export_configuration.encryption_configuration.object_encryption_type #=> String, one of "SSE_KMS", "SSE_S3", "NO_ENCRYPTION"
     #   resp.export_description.s3_export_configuration.encryption_configuration.kms_key_arn #=> String
     #   resp.export_description.role_arn #=> String
+    #   resp.export_description.output_format #=> String, one of "ION_BINARY", "ION_TEXT", "JSON"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/DescribeJournalS3Export AWS API Documentation
     #
@@ -707,8 +719,17 @@ module Aws::QLDB
     end
 
     # Exports journal contents within a date and time range from a ledger
-    # into a specified Amazon Simple Storage Service (Amazon S3) bucket. The
-    # data is written as files in Amazon Ion format.
+    # into a specified Amazon Simple Storage Service (Amazon S3) bucket. A
+    # journal export job can write the data objects in either the text or
+    # binary representation of Amazon Ion format, or in *JSON Lines* text
+    # format.
+    #
+    # In JSON Lines format, each journal block in the exported data object
+    # is a valid JSON object that is delimited by a newline. You can use
+    # this format to easily integrate JSON exports with analytics tools such
+    # as Glue and Amazon Athena because these services can parse
+    # newline-delimited JSON automatically. For more information about the
+    # format, see [JSON Lines][1].
     #
     # If the ledger with the given `Name` doesn't exist, then throws
     # `ResourceNotFoundException`.
@@ -720,6 +741,10 @@ module Aws::QLDB
     # ledger. Beyond this limit, journal export requests throw
     # `LimitExceededException`.
     #
+    #
+    #
+    # [1]: https://jsonlines.org/
+    #
     # @option params [required, String] :name
     #   The name of the ledger.
     #
@@ -759,8 +784,16 @@ module Aws::QLDB
     #   * Write objects into your Amazon Simple Storage Service (Amazon S3)
     #     bucket.
     #
-    #   * (Optional) Use your customer master key (CMK) in Key Management
-    #     Service (KMS) for server-side encryption of your exported data.
+    #   * (Optional) Use your customer managed key in Key Management Service
+    #     (KMS) for server-side encryption of your exported data.
+    #
+    #   To pass a role to QLDB when requesting a journal export, you must have
+    #   permissions to perform the `iam:PassRole` action on the IAM role
+    #   resource. This is required for all journal export requests.
+    #
+    # @option params [String] :output_format
+    #   The output format of your exported journal data. If this parameter is
+    #   not specified, the exported data defaults to `ION_TEXT` format.
     #
     # @return [Types::ExportJournalToS3Response] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -781,6 +814,7 @@ module Aws::QLDB
     #       },
     #     },
     #     role_arn: "Arn", # required
+    #     output_format: "ION_BINARY", # accepts ION_BINARY, ION_TEXT, JSON
     #   })
     #
     # @example Response structure
@@ -1024,7 +1058,8 @@ module Aws::QLDB
     end
 
     # Returns an array of journal export job descriptions for all ledgers
-    # that are associated with the current account and Region.
+    # that are associated with the current Amazon Web Services account and
+    # Region.
     #
     # This action returns a maximum of `MaxResults` items, and is paginated
     # so that you can retrieve all the items by calling
@@ -1077,6 +1112,7 @@ module Aws::QLDB
     #   resp.journal_s3_exports[0].s3_export_configuration.encryption_configuration.object_encryption_type #=> String, one of "SSE_KMS", "SSE_S3", "NO_ENCRYPTION"
     #   resp.journal_s3_exports[0].s3_export_configuration.encryption_configuration.kms_key_arn #=> String
     #   resp.journal_s3_exports[0].role_arn #=> String
+    #   resp.journal_s3_exports[0].output_format #=> String, one of "ION_BINARY", "ION_TEXT", "JSON"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/ListJournalS3Exports AWS API Documentation
@@ -1146,6 +1182,7 @@ module Aws::QLDB
     #   resp.journal_s3_exports[0].s3_export_configuration.encryption_configuration.object_encryption_type #=> String, one of "SSE_KMS", "SSE_S3", "NO_ENCRYPTION"
     #   resp.journal_s3_exports[0].s3_export_configuration.encryption_configuration.kms_key_arn #=> String
     #   resp.journal_s3_exports[0].role_arn #=> String
+    #   resp.journal_s3_exports[0].output_format #=> String, one of "ION_BINARY", "ION_TEXT", "JSON"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/ListJournalS3ExportsForLedger AWS API Documentation
@@ -1158,7 +1195,7 @@ module Aws::QLDB
     end
 
     # Returns an array of ledger summaries that are associated with the
-    # current account and Region.
+    # current Amazon Web Services account and Region.
     #
     # This action returns a maximum of 100 items and is paginated so that
     # you can retrieve all the items by calling `ListLedgers` multiple
@@ -1250,6 +1287,10 @@ module Aws::QLDB
     #   permissions for a journal stream to write data records to a Kinesis
     #   Data Streams resource.
     #
+    #   To pass a role to QLDB when requesting a journal stream, you must have
+    #   permissions to perform the `iam:PassRole` action on the IAM role
+    #   resource. This is required for all journal stream requests.
+    #
     # @option params [Hash<String,String>] :tags
     #   The key-value pairs to add as tags to the stream that you want to
     #   create. Tag keys are case sensitive. Tag values are case sensitive and
@@ -1432,7 +1473,7 @@ module Aws::QLDB
     #   To specify a customer managed KMS key, you can use its key ID, Amazon
     #   Resource Name (ARN), alias name, or alias ARN. When using an alias
     #   name, prefix it with `"alias/"`. To specify a key in a different
-    #   account, you must use the key ARN or alias ARN.
+    #   Amazon Web Services account, you must use the key ARN or alias ARN.
     #
     #   For example:
     #
@@ -1580,7 +1621,7 @@ module Aws::QLDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-qldb'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.23.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -66,6 +66,7 @@ module Aws::QLDB
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
+    OutputFormat = Shapes::StringShape.new(name: 'OutputFormat')
     ParameterName = Shapes::StringShape.new(name: 'ParameterName')
     PermissionsMode = Shapes::StringShape.new(name: 'PermissionsMode')
     ResourceAlreadyExistsException = Shapes::StructureShape.new(name: 'ResourceAlreadyExistsException')
@@ -156,6 +157,7 @@ module Aws::QLDB
     ExportJournalToS3Request.add_member(:exclusive_end_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "ExclusiveEndTime"))
     ExportJournalToS3Request.add_member(:s3_export_configuration, Shapes::ShapeRef.new(shape: S3ExportConfiguration, required: true, location_name: "S3ExportConfiguration"))
     ExportJournalToS3Request.add_member(:role_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "RoleArn"))
+    ExportJournalToS3Request.add_member(:output_format, Shapes::ShapeRef.new(shape: OutputFormat, location_name: "OutputFormat"))
     ExportJournalToS3Request.struct_class = Types::ExportJournalToS3Request
 
     ExportJournalToS3Response.add_member(:export_id, Shapes::ShapeRef.new(shape: UniqueId, required: true, location_name: "ExportId"))
@@ -214,6 +216,7 @@ module Aws::QLDB
     JournalS3ExportDescription.add_member(:exclusive_end_time, Shapes::ShapeRef.new(shape: Timestamp, required: true, location_name: "ExclusiveEndTime"))
     JournalS3ExportDescription.add_member(:s3_export_configuration, Shapes::ShapeRef.new(shape: S3ExportConfiguration, required: true, location_name: "S3ExportConfiguration"))
     JournalS3ExportDescription.add_member(:role_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "RoleArn"))
+    JournalS3ExportDescription.add_member(:output_format, Shapes::ShapeRef.new(shape: OutputFormat, location_name: "OutputFormat"))
     JournalS3ExportDescription.struct_class = Types::JournalS3ExportDescription
 
     JournalS3ExportList.member = Shapes::ShapeRef.new(shape: JournalS3ExportDescription)

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

@@ -63,8 +63,8 @@ module Aws::QLDB
     #
     # @!attribute [rw] name
     #   The name of the ledger that you want to create. The name must be
-    #   unique among all of the ledgers in your account in the current
-    #   Region.
+    #   unique among all of the ledgers in your Amazon Web Services account
+    #   in the current Region.
     #
     #   Naming constraints for ledger names are defined in [Quotas in Amazon
     #   QLDB][1] in the *Amazon QLDB Developer Guide*.
@@ -148,7 +148,8 @@ module Aws::QLDB
     #   To specify a customer managed KMS key, you can use its key ID,
     #   Amazon Resource Name (ARN), alias name, or alias ARN. When using an
     #   alias name, prefix it with `"alias/"`. To specify a key in a
-    #   different account, you must use the key ARN or alias ARN.
+    #   different Amazon Web Services account, you must use the key ARN or
+    #   alias ARN.
     #
     #   For example:
     #
@@ -419,6 +420,7 @@ module Aws::QLDB
     #           },
     #         },
     #         role_arn: "Arn", # required
+    #         output_format: "ION_BINARY", # accepts ION_BINARY, ION_TEXT, JSON
     #       }
     #
     # @!attribute [rw] name
@@ -464,8 +466,17 @@ module Aws::QLDB
     #   * Write objects into your Amazon Simple Storage Service (Amazon S3)
     #     bucket.
     #
-    #   * (Optional) Use your customer master key (CMK) in Key Management
-    #     Service (KMS) for server-side encryption of your exported data.
+    #   * (Optional) Use your customer managed key in Key Management Service
+    #     (KMS) for server-side encryption of your exported data.
+    #
+    #   To pass a role to QLDB when requesting a journal export, you must
+    #   have permissions to perform the `iam:PassRole` action on the IAM
+    #   role resource. This is required for all journal export requests.
+    #   @return [String]
+    #
+    # @!attribute [rw] output_format
+    #   The output format of your exported journal data. If this parameter
+    #   is not specified, the exported data defaults to `ION_TEXT` format.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/ExportJournalToS3Request AWS API Documentation
@@ -475,7 +486,8 @@ module Aws::QLDB
       :inclusive_start_time,
       :exclusive_end_time,
       :s3_export_configuration,
-      :role_arn)
+      :role_arn,
+      :output_format)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -788,12 +800,12 @@ module Aws::QLDB
     #
     # @!attribute [rw] inclusive_start_time
     #   The inclusive start date and time for the range of journal contents
-    #   that are specified in the original export request.
+    #   that was specified in the original export request.
     #   @return [Time]
     #
     # @!attribute [rw] exclusive_end_time
     #   The exclusive end date and time for the range of journal contents
-    #   that are specified in the original export request.
+    #   that was specified in the original export request.
     #   @return [Time]
     #
     # @!attribute [rw] s3_export_configuration
@@ -808,8 +820,12 @@ module Aws::QLDB
     #   * Write objects into your Amazon Simple Storage Service (Amazon S3)
     #     bucket.
     #
-    #   * (Optional) Use your customer master key (CMK) in Key Management
-    #     Service (KMS) for server-side encryption of your exported data.
+    #   * (Optional) Use your customer managed key in Key Management Service
+    #     (KMS) for server-side encryption of your exported data.
+    #   @return [String]
+    #
+    # @!attribute [rw] output_format
+    #   The output format of the exported journal data.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/qldb-2019-01-02/JournalS3ExportDescription AWS API Documentation
@@ -822,7 +838,8 @@ module Aws::QLDB
       :inclusive_start_time,
       :exclusive_end_time,
       :s3_export_configuration,
-      :role_arn)
+      :role_arn,
+      :output_format)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1129,7 +1146,8 @@ module Aws::QLDB
 
     # @!attribute [rw] journal_s3_exports
     #   The array of journal export job descriptions for all ledgers that
-    #   are associated with the current account and Region.
+    #   are associated with the current Amazon Web Services account and
+    #   Region.
     #   @return [Array<Types::JournalS3ExportDescription>]
     #
     # @!attribute [rw] next_token
@@ -1181,7 +1199,7 @@ module Aws::QLDB
 
     # @!attribute [rw] ledgers
     #   The array of ledger summaries that are associated with the current
-    #   account and Region.
+    #   Amazon Web Services account and Region.
     #   @return [Array<Types::LedgerSummary>]
     #
     # @!attribute [rw] next_token
@@ -1356,9 +1374,8 @@ module Aws::QLDB
     #   @return [String]
     #
     # @!attribute [rw] kms_key_arn
-    #   The Amazon Resource Name (ARN) of a symmetric customer master key
-    #   (CMK) in Key Management Service (KMS). Amazon S3 does not support
-    #   asymmetric CMKs.
+    #   The Amazon Resource Name (ARN) of a symmetric key in Key Management
+    #   Service (KMS). Amazon S3 does not support asymmetric KMS keys.
     #
     #   You must provide a `KmsKeyArn` if you specify `SSE_KMS` as the
     #   `ObjectEncryptionType`.
@@ -1466,6 +1483,10 @@ module Aws::QLDB
     #   The Amazon Resource Name (ARN) of the IAM role that grants QLDB
     #   permissions for a journal stream to write data records to a Kinesis
     #   Data Streams resource.
+    #
+    #   To pass a role to QLDB when requesting a journal stream, you must
+    #   have permissions to perform the `iam:PassRole` action on the IAM
+    #   role resource. This is required for all journal stream requests.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -1737,7 +1758,8 @@ module Aws::QLDB
     #   To specify a customer managed KMS key, you can use its key ID,
     #   Amazon Resource Name (ARN), alias name, or alias ARN. When using an
     #   alias name, prefix it with `"alias/"`. To specify a key in a
-    #   different account, you must use the key ARN or alias ARN.
+    #   different Amazon Web Services account, you must use the key ARN or
+    #   alias ARN.
     #
     #   For example:
     #

data/lib/aws-sdk-qldb.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-qldb/customizations'
 # @!group service
 module Aws::QLDB
 
-  GEM_VERSION = '1.22.0'
+  GEM_VERSION = '1.23.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-qldb
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.23.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-30 00:00:00.000000000 Z
+date: 2021-12-21 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.125.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.125.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement