aws-sdk-redshiftdataapiservice 1.25.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 407a8551dba3493cc7c1c0b87ea941f9b753e113b3c7ca50b437a16722f00802
-  data.tar.gz: 99cff936cfcbb2859fd0c0b94b673ae20e786241e7f023ef53688215cbc12c78
+  metadata.gz: 2511d81f16aea06121226a62ba408c3109b19b5da82bc24d398fd3903c01c5bd
+  data.tar.gz: b49d61473f55e558bf096d1312b7a002ec15fb591005642914a78bb18442477e
 SHA512:
-  metadata.gz: 44474a4cb727c2e21067cd7d4680417ec6ac4f6468f1de536547c61aa8b23304f3c1d6ba46c363630468a524ee67bc7abd29709995df277d8558d0b0b407ab82
-  data.tar.gz: 85986998c5a1dbaab77edf5a848d79e2cacee795e49d913cb6dfed1a32464b70bc80b741812bad4db1bb22a4c5698894607869b30e508061c9e93a6be691661e
+  metadata.gz: 13a8fbc408a936391f8122abbf91728e47a01673337aa039c5f06576f5347e4ebcf8051ac742ad581b4ba1cbcac10e1468e3f84cf2f2989fd7185aa33caa8fb5
+  data.tar.gz: 3db7db5aeb6bff724712103f45b41a3a2bd4eb9af9070817faa49063e20ea4109e8a2a6c0a4e5ec5cc122d8e3ca7d6ec96ed98d44a6b0c432a32a5e38b331d87

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.27.0 (2023-05-31)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.26.0 (2023-04-07)
+------------------
+
+* Feature - Update documentation of API descriptions as needed in support of temporary credentials with IAM identity.
+
 1.25.0 (2023-03-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.25.0
+1.27.0

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

@@ -275,6 +275,11 @@ module Aws::RedshiftDataAPIService
     #       in the future.
     #
     #
+    #   @option options [String] :sdk_ua_app_id
+    #     A unique and opaque application ID that is appended to the
+    #     User-Agent header as app/<sdk_ua_app_id>. It should have a
+    #     maximum length of 50.
+    #
     #   @option options [String] :secret_access_key
     #
     #   @option options [String] :session_token
@@ -383,18 +388,35 @@ module Aws::RedshiftDataAPIService
     # authorization method, use one of the following combinations of request
     # parameters:
     #
-    # * Secrets Manager - when connecting to a cluster, specify the Amazon
-    #   Resource Name (ARN) of the secret, the database name, and the
-    #   cluster identifier that matches the cluster in the secret. When
-    #   connecting to a serverless workgroup, specify the Amazon Resource
-    #   Name (ARN) of the secret and the database name.
-    #
-    # * Temporary credentials - when connecting to a cluster, specify the
-    #   cluster identifier, the database name, and the database user name.
-    #   Also, permission to call the `redshift:GetClusterCredentials`
-    #   operation is required. When connecting to a serverless workgroup,
-    #   specify the workgroup name and database name. Also, permission to
-    #   call the `redshift-serverless:GetCredentials` operation is required.
+    # * Secrets Manager - when connecting to a cluster, provide the
+    #   `secret-arn` of a secret stored in Secrets Manager which has
+    #   `username` and `password`. The specified secret contains credentials
+    #   to connect to the `database` you specify. When you are connecting to
+    #   a cluster, you also supply the database name, If you provide a
+    #   cluster identifier (`dbClusterIdentifier`), it must match the
+    #   cluster identifier stored in the secret. When you are connecting to
+    #   a serverless workgroup, you also supply the database name.
+    #
+    # * Temporary credentials - when connecting to your data warehouse,
+    #   choose one of the following options:
+    #
+    #   * When connecting to a serverless workgroup, specify the workgroup
+    #     name and database name. The database user name is derived from the
+    #     IAM identity. For example, `arn:iam::123456789012:user:foo` has
+    #     the database user name `IAM:foo`. Also, permission to call the
+    #     `redshift-serverless:GetCredentials` operation is required.
+    #
+    #   * When connecting to a cluster as an IAM identity, specify the
+    #     cluster identifier and the database name. The database user name
+    #     is derived from the IAM identity. For example,
+    #     `arn:iam::123456789012:user:foo` has the database user name
+    #     `IAM:foo`. Also, permission to call the
+    #     `redshift:GetClusterCredentialsWithIAM` operation is required.
+    #
+    #   * When connecting to a cluster as a database user, specify the
+    #     cluster identifier, the database name, and the database user name.
+    #     Also, permission to call the `redshift:GetClusterCredentials`
+    #     operation is required.
     #
     # For more information about the Amazon Redshift Data API and CLI usage
     # examples, see [Using the Amazon Redshift Data API][1] in the *Amazon
@@ -422,7 +444,8 @@ module Aws::RedshiftDataAPIService
     #
     # @option params [String] :db_user
     #   The database user name. This parameter is required when connecting to
-    #   a cluster and authenticating using temporary credentials.
+    #   a cluster as a database user and authenticating using temporary
+    #   credentials.
     #
     # @option params [String] :secret_arn
     #   The name or ARN of the secret that enables access to the database.
@@ -629,18 +652,35 @@ module Aws::RedshiftDataAPIService
     # page through the column list. Depending on the authorization method,
     # use one of the following combinations of request parameters:
     #
-    # * Secrets Manager - when connecting to a cluster, specify the Amazon
-    #   Resource Name (ARN) of the secret, the database name, and the
-    #   cluster identifier that matches the cluster in the secret. When
-    #   connecting to a serverless workgroup, specify the Amazon Resource
-    #   Name (ARN) of the secret and the database name.
-    #
-    # * Temporary credentials - when connecting to a cluster, specify the
-    #   cluster identifier, the database name, and the database user name.
-    #   Also, permission to call the `redshift:GetClusterCredentials`
-    #   operation is required. When connecting to a serverless workgroup,
-    #   specify the workgroup name and database name. Also, permission to
-    #   call the `redshift-serverless:GetCredentials` operation is required.
+    # * Secrets Manager - when connecting to a cluster, provide the
+    #   `secret-arn` of a secret stored in Secrets Manager which has
+    #   `username` and `password`. The specified secret contains credentials
+    #   to connect to the `database` you specify. When you are connecting to
+    #   a cluster, you also supply the database name, If you provide a
+    #   cluster identifier (`dbClusterIdentifier`), it must match the
+    #   cluster identifier stored in the secret. When you are connecting to
+    #   a serverless workgroup, you also supply the database name.
+    #
+    # * Temporary credentials - when connecting to your data warehouse,
+    #   choose one of the following options:
+    #
+    #   * When connecting to a serverless workgroup, specify the workgroup
+    #     name and database name. The database user name is derived from the
+    #     IAM identity. For example, `arn:iam::123456789012:user:foo` has
+    #     the database user name `IAM:foo`. Also, permission to call the
+    #     `redshift-serverless:GetCredentials` operation is required.
+    #
+    #   * When connecting to a cluster as an IAM identity, specify the
+    #     cluster identifier and the database name. The database user name
+    #     is derived from the IAM identity. For example,
+    #     `arn:iam::123456789012:user:foo` has the database user name
+    #     `IAM:foo`. Also, permission to call the
+    #     `redshift:GetClusterCredentialsWithIAM` operation is required.
+    #
+    #   * When connecting to a cluster as a database user, specify the
+    #     cluster identifier, the database name, and the database user name.
+    #     Also, permission to call the `redshift:GetClusterCredentials`
+    #     operation is required.
     #
     # For more information about the Amazon Redshift Data API and CLI usage
     # examples, see [Using the Amazon Redshift Data API][1] in the *Amazon
@@ -666,7 +706,8 @@ module Aws::RedshiftDataAPIService
     #
     # @option params [String] :db_user
     #   The database user name. This parameter is required when connecting to
-    #   a cluster and authenticating using temporary credentials.
+    #   a cluster as a database user and authenticating using temporary
+    #   credentials.
     #
     # @option params [Integer] :max_results
     #   The maximum number of tables to return in the response. If more tables
@@ -755,18 +796,35 @@ module Aws::RedshiftDataAPIService
     # statement. Depending on the authorization method, use one of the
     # following combinations of request parameters:
     #
-    # * Secrets Manager - when connecting to a cluster, specify the Amazon
-    #   Resource Name (ARN) of the secret, the database name, and the
-    #   cluster identifier that matches the cluster in the secret. When
-    #   connecting to a serverless workgroup, specify the Amazon Resource
-    #   Name (ARN) of the secret and the database name.
-    #
-    # * Temporary credentials - when connecting to a cluster, specify the
-    #   cluster identifier, the database name, and the database user name.
-    #   Also, permission to call the `redshift:GetClusterCredentials`
-    #   operation is required. When connecting to a serverless workgroup,
-    #   specify the workgroup name and database name. Also, permission to
-    #   call the `redshift-serverless:GetCredentials` operation is required.
+    # * Secrets Manager - when connecting to a cluster, provide the
+    #   `secret-arn` of a secret stored in Secrets Manager which has
+    #   `username` and `password`. The specified secret contains credentials
+    #   to connect to the `database` you specify. When you are connecting to
+    #   a cluster, you also supply the database name, If you provide a
+    #   cluster identifier (`dbClusterIdentifier`), it must match the
+    #   cluster identifier stored in the secret. When you are connecting to
+    #   a serverless workgroup, you also supply the database name.
+    #
+    # * Temporary credentials - when connecting to your data warehouse,
+    #   choose one of the following options:
+    #
+    #   * When connecting to a serverless workgroup, specify the workgroup
+    #     name and database name. The database user name is derived from the
+    #     IAM identity. For example, `arn:iam::123456789012:user:foo` has
+    #     the database user name `IAM:foo`. Also, permission to call the
+    #     `redshift-serverless:GetCredentials` operation is required.
+    #
+    #   * When connecting to a cluster as an IAM identity, specify the
+    #     cluster identifier and the database name. The database user name
+    #     is derived from the IAM identity. For example,
+    #     `arn:iam::123456789012:user:foo` has the database user name
+    #     `IAM:foo`. Also, permission to call the
+    #     `redshift:GetClusterCredentialsWithIAM` operation is required.
+    #
+    #   * When connecting to a cluster as a database user, specify the
+    #     cluster identifier, the database name, and the database user name.
+    #     Also, permission to call the `redshift:GetClusterCredentials`
+    #     operation is required.
     #
     # For more information about the Amazon Redshift Data API and CLI usage
     # examples, see [Using the Amazon Redshift Data API][1] in the *Amazon
@@ -794,7 +852,8 @@ module Aws::RedshiftDataAPIService
     #
     # @option params [String] :db_user
     #   The database user name. This parameter is required when connecting to
-    #   a cluster and authenticating using temporary credentials.
+    #   a cluster as a database user and authenticating using temporary
+    #   credentials.
     #
     # @option params [Array<Types::SqlParameter>] :parameters
     #   The parameters for the SQL statement.
@@ -952,18 +1011,35 @@ module Aws::RedshiftDataAPIService
     # the database list. Depending on the authorization method, use one of
     # the following combinations of request parameters:
     #
-    # * Secrets Manager - when connecting to a cluster, specify the Amazon
-    #   Resource Name (ARN) of the secret, the database name, and the
-    #   cluster identifier that matches the cluster in the secret. When
-    #   connecting to a serverless workgroup, specify the Amazon Resource
-    #   Name (ARN) of the secret and the database name.
-    #
-    # * Temporary credentials - when connecting to a cluster, specify the
-    #   cluster identifier, the database name, and the database user name.
-    #   Also, permission to call the `redshift:GetClusterCredentials`
-    #   operation is required. When connecting to a serverless workgroup,
-    #   specify the workgroup name and database name. Also, permission to
-    #   call the `redshift-serverless:GetCredentials` operation is required.
+    # * Secrets Manager - when connecting to a cluster, provide the
+    #   `secret-arn` of a secret stored in Secrets Manager which has
+    #   `username` and `password`. The specified secret contains credentials
+    #   to connect to the `database` you specify. When you are connecting to
+    #   a cluster, you also supply the database name, If you provide a
+    #   cluster identifier (`dbClusterIdentifier`), it must match the
+    #   cluster identifier stored in the secret. When you are connecting to
+    #   a serverless workgroup, you also supply the database name.
+    #
+    # * Temporary credentials - when connecting to your data warehouse,
+    #   choose one of the following options:
+    #
+    #   * When connecting to a serverless workgroup, specify the workgroup
+    #     name and database name. The database user name is derived from the
+    #     IAM identity. For example, `arn:iam::123456789012:user:foo` has
+    #     the database user name `IAM:foo`. Also, permission to call the
+    #     `redshift-serverless:GetCredentials` operation is required.
+    #
+    #   * When connecting to a cluster as an IAM identity, specify the
+    #     cluster identifier and the database name. The database user name
+    #     is derived from the IAM identity. For example,
+    #     `arn:iam::123456789012:user:foo` has the database user name
+    #     `IAM:foo`. Also, permission to call the
+    #     `redshift:GetClusterCredentialsWithIAM` operation is required.
+    #
+    #   * When connecting to a cluster as a database user, specify the
+    #     cluster identifier, the database name, and the database user name.
+    #     Also, permission to call the `redshift:GetClusterCredentials`
+    #     operation is required.
     #
     # For more information about the Amazon Redshift Data API and CLI usage
     # examples, see [Using the Amazon Redshift Data API][1] in the *Amazon
@@ -984,7 +1060,8 @@ module Aws::RedshiftDataAPIService
     #
     # @option params [String] :db_user
     #   The database user name. This parameter is required when connecting to
-    #   a cluster and authenticating using temporary credentials.
+    #   a cluster as a database user and authenticating using temporary
+    #   credentials.
     #
     # @option params [Integer] :max_results
     #   The maximum number of databases to return in the response. If more
@@ -1046,18 +1123,35 @@ module Aws::RedshiftDataAPIService
     # the schema list. Depending on the authorization method, use one of the
     # following combinations of request parameters:
     #
-    # * Secrets Manager - when connecting to a cluster, specify the Amazon
-    #   Resource Name (ARN) of the secret, the database name, and the
-    #   cluster identifier that matches the cluster in the secret. When
-    #   connecting to a serverless workgroup, specify the Amazon Resource
-    #   Name (ARN) of the secret and the database name.
-    #
-    # * Temporary credentials - when connecting to a cluster, specify the
-    #   cluster identifier, the database name, and the database user name.
-    #   Also, permission to call the `redshift:GetClusterCredentials`
-    #   operation is required. When connecting to a serverless workgroup,
-    #   specify the workgroup name and database name. Also, permission to
-    #   call the `redshift-serverless:GetCredentials` operation is required.
+    # * Secrets Manager - when connecting to a cluster, provide the
+    #   `secret-arn` of a secret stored in Secrets Manager which has
+    #   `username` and `password`. The specified secret contains credentials
+    #   to connect to the `database` you specify. When you are connecting to
+    #   a cluster, you also supply the database name, If you provide a
+    #   cluster identifier (`dbClusterIdentifier`), it must match the
+    #   cluster identifier stored in the secret. When you are connecting to
+    #   a serverless workgroup, you also supply the database name.
+    #
+    # * Temporary credentials - when connecting to your data warehouse,
+    #   choose one of the following options:
+    #
+    #   * When connecting to a serverless workgroup, specify the workgroup
+    #     name and database name. The database user name is derived from the
+    #     IAM identity. For example, `arn:iam::123456789012:user:foo` has
+    #     the database user name `IAM:foo`. Also, permission to call the
+    #     `redshift-serverless:GetCredentials` operation is required.
+    #
+    #   * When connecting to a cluster as an IAM identity, specify the
+    #     cluster identifier and the database name. The database user name
+    #     is derived from the IAM identity. For example,
+    #     `arn:iam::123456789012:user:foo` has the database user name
+    #     `IAM:foo`. Also, permission to call the
+    #     `redshift:GetClusterCredentialsWithIAM` operation is required.
+    #
+    #   * When connecting to a cluster as a database user, specify the
+    #     cluster identifier, the database name, and the database user name.
+    #     Also, permission to call the `redshift:GetClusterCredentials`
+    #     operation is required.
     #
     # For more information about the Amazon Redshift Data API and CLI usage
     # examples, see [Using the Amazon Redshift Data API][1] in the *Amazon
@@ -1083,7 +1177,8 @@ module Aws::RedshiftDataAPIService
     #
     # @option params [String] :db_user
     #   The database user name. This parameter is required when connecting to
-    #   a cluster and authenticating using temporary credentials.
+    #   a cluster as a database user and authenticating using temporary
+    #   credentials.
     #
     # @option params [Integer] :max_results
     #   The maximum number of schemas to return in the response. If more
@@ -1257,18 +1352,35 @@ module Aws::RedshiftDataAPIService
     # Depending on the authorization method, use one of the following
     # combinations of request parameters:
     #
-    # * Secrets Manager - when connecting to a cluster, specify the Amazon
-    #   Resource Name (ARN) of the secret, the database name, and the
-    #   cluster identifier that matches the cluster in the secret. When
-    #   connecting to a serverless workgroup, specify the Amazon Resource
-    #   Name (ARN) of the secret and the database name.
-    #
-    # * Temporary credentials - when connecting to a cluster, specify the
-    #   cluster identifier, the database name, and the database user name.
-    #   Also, permission to call the `redshift:GetClusterCredentials`
-    #   operation is required. When connecting to a serverless workgroup,
-    #   specify the workgroup name and database name. Also, permission to
-    #   call the `redshift-serverless:GetCredentials` operation is required.
+    # * Secrets Manager - when connecting to a cluster, provide the
+    #   `secret-arn` of a secret stored in Secrets Manager which has
+    #   `username` and `password`. The specified secret contains credentials
+    #   to connect to the `database` you specify. When you are connecting to
+    #   a cluster, you also supply the database name, If you provide a
+    #   cluster identifier (`dbClusterIdentifier`), it must match the
+    #   cluster identifier stored in the secret. When you are connecting to
+    #   a serverless workgroup, you also supply the database name.
+    #
+    # * Temporary credentials - when connecting to your data warehouse,
+    #   choose one of the following options:
+    #
+    #   * When connecting to a serverless workgroup, specify the workgroup
+    #     name and database name. The database user name is derived from the
+    #     IAM identity. For example, `arn:iam::123456789012:user:foo` has
+    #     the database user name `IAM:foo`. Also, permission to call the
+    #     `redshift-serverless:GetCredentials` operation is required.
+    #
+    #   * When connecting to a cluster as an IAM identity, specify the
+    #     cluster identifier and the database name. The database user name
+    #     is derived from the IAM identity. For example,
+    #     `arn:iam::123456789012:user:foo` has the database user name
+    #     `IAM:foo`. Also, permission to call the
+    #     `redshift:GetClusterCredentialsWithIAM` operation is required.
+    #
+    #   * When connecting to a cluster as a database user, specify the
+    #     cluster identifier, the database name, and the database user name.
+    #     Also, permission to call the `redshift:GetClusterCredentials`
+    #     operation is required.
     #
     # For more information about the Amazon Redshift Data API and CLI usage
     # examples, see [Using the Amazon Redshift Data API][1] in the *Amazon
@@ -1294,7 +1406,8 @@ module Aws::RedshiftDataAPIService
     #
     # @option params [String] :db_user
     #   The database user name. This parameter is required when connecting to
-    #   a cluster and authenticating using temporary credentials.
+    #   a cluster as a database user and authenticating using temporary
+    #   credentials.
     #
     # @option params [Integer] :max_results
     #   The maximum number of tables to return in the response. If more tables
@@ -1388,7 +1501,7 @@ module Aws::RedshiftDataAPIService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-redshiftdataapiservice'
-      context[:gem_version] = '1.25.0'
+      context[:gem_version] = '1.27.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -63,7 +63,8 @@ module Aws::RedshiftDataAPIService
     #
     # @!attribute [rw] db_user
     #   The database user name. This parameter is required when connecting
-    #   to a cluster and authenticating using temporary credentials.
+    #   to a cluster as a database user and authenticating using temporary
+    #   credentials.
     #   @return [String]
     #
     # @!attribute [rw] secret_arn
@@ -446,7 +447,8 @@ module Aws::RedshiftDataAPIService
     #
     # @!attribute [rw] db_user
     #   The database user name. This parameter is required when connecting
-    #   to a cluster and authenticating using temporary credentials.
+    #   to a cluster as a database user and authenticating using temporary
+    #   credentials.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -574,7 +576,8 @@ module Aws::RedshiftDataAPIService
     #
     # @!attribute [rw] db_user
     #   The database user name. This parameter is required when connecting
-    #   to a cluster and authenticating using temporary credentials.
+    #   to a cluster as a database user and authenticating using temporary
+    #   credentials.
     #   @return [String]
     #
     # @!attribute [rw] parameters
@@ -812,7 +815,8 @@ module Aws::RedshiftDataAPIService
     #
     # @!attribute [rw] db_user
     #   The database user name. This parameter is required when connecting
-    #   to a cluster and authenticating using temporary credentials.
+    #   to a cluster as a database user and authenticating using temporary
+    #   credentials.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -898,7 +902,8 @@ module Aws::RedshiftDataAPIService
     #
     # @!attribute [rw] db_user
     #   The database user name. This parameter is required when connecting
-    #   to a cluster and authenticating using temporary credentials.
+    #   to a cluster as a database user and authenticating using temporary
+    #   credentials.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -1079,7 +1084,8 @@ module Aws::RedshiftDataAPIService
     #
     # @!attribute [rw] db_user
     #   The database user name. This parameter is required when connecting
-    #   to a cluster and authenticating using temporary credentials.
+    #   to a cluster as a database user and authenticating using temporary
+    #   credentials.
     #   @return [String]
     #
     # @!attribute [rw] max_results

data/lib/aws-sdk-redshiftdataapiservice.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-redshiftdataapiservice/customizations'
 # @!group service
 module Aws::RedshiftDataAPIService
 
-  GEM_VERSION = '1.25.0'
+  GEM_VERSION = '1.27.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-redshiftdataapiservice
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.27.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-09 00:00:00.000000000 Z
+date: 2023-05-31 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.165.0
+        version: 3.174.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.165.0
+        version: 3.174.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement