aws-sdk-redshift 1.82.0 → 1.83.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c42ee2c42afc0c9c9d9b8a091061102c79a6b02c4fe305715038cc94860f1902
-  data.tar.gz: df17f29b34fd27c78a5ce1651624dd90d174835b450054dffbb0cdbf2d511955
+  metadata.gz: 85047529a68b7d7236c95a180e4a2021b8242f7e0e84184a165ac94328059d1f
+  data.tar.gz: 60d42f3b1412ef01ce8f51f617cc143ef8888cc0692fb250acf5384a41a9ae14
 SHA512:
-  metadata.gz: 163bbd98c9dbbd841f0e59d27687d25222a4f6970702067ce7237e752af5d4dd9fab6211ba5ce91c210ebf590b9a8add1885ac3c5ad27855dc05e6a75bc0bd94
-  data.tar.gz: 12beb7595214b46950adab475c4836b4c759cb4a47ece2487612a76cf4089c8f432026af6b6d8919123427a2ba379fc511c84c91c13a974f03af431b72b27cfc
+  metadata.gz: 430520944de80e9bd4e65aaddff2db700873dffb2bcd0f571c57a527dc244bd99775a6f454353df7f8b2832368c8b1c978c047b4fde7a6cf240ecd2a9e630515
+  data.tar.gz: c9958792fd2d43ddc08475cc66ceec7fcca1db445905f7efbf5cbf04bcc9d45ead2af7253dfcb2c9478271ffbcf6b9f30605466ea8de363a726e0b10047b05d2

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.83.0 (2022-06-08)
+------------------
+
+* Feature - Adds new API GetClusterCredentialsWithIAM to return temporary credentials.
+
 1.82.0 (2022-05-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.82.0
+1.83.0

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

@@ -1223,8 +1223,8 @@ module Aws::Redshift
     #
     #   * Must contain one number.
     #
-    #   * Can be any printable ASCII character (ASCII code 33-126) except '
-    #     (single quote), " (double quote), \\, /, or @.
+    #   * Can be any printable ASCII character (ASCII code 33-126) except `'`
+    #     (single quote), `"` (double quote), ``, `/`, or `@`.
     #
     # @option params [Array<String>] :cluster_security_groups
     #   A list of security groups to be associated with this cluster.
@@ -7265,7 +7265,7 @@ module Aws::Redshift
     #
     # @option params [required, String] :cluster_identifier
     #   The unique identifier of the cluster that contains the database for
-    #   which your are requesting credentials. This parameter is case
+    #   which you are requesting credentials. This parameter is case
     #   sensitive.
     #
     # @option params [Integer] :duration_seconds
@@ -7335,6 +7335,70 @@ module Aws::Redshift
       req.send_request(options)
     end
 
+    # Returns a database user name and temporary password with temporary
+    # authorization to log in to an Amazon Redshift database. The database
+    # user is mapped 1:1 to the source Identity and Access Management (IAM)
+    # identity. For more information about IAM identities, see [IAM
+    # Identities (users, user groups, and roles)][1] in the Amazon Web
+    # Services Identity and Access Management User Guide.
+    #
+    # The Identity and Access Management (IAM) identity that runs this
+    # operation must have an IAM policy attached that allows access to all
+    # necessary actions and resources. For more information about
+    # permissions, see [Using identity-based policies (IAM policies)][2] in
+    # the Amazon Redshift Cluster Management Guide.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html
+    # [2]: https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-access-control-identity-based.html
+    #
+    # @option params [String] :db_name
+    #   The name of the database for which you are requesting credentials. If
+    #   the database name is specified, the IAM policy must allow access to
+    #   the resource `dbname` for the specified database name. If the database
+    #   name is not specified, access to all databases is allowed.
+    #
+    # @option params [required, String] :cluster_identifier
+    #   The unique identifier of the cluster that contains the database for
+    #   which you are requesting credentials.
+    #
+    # @option params [Integer] :duration_seconds
+    #   The number of seconds until the returned temporary password expires.
+    #
+    #   Range: 900-3600. Default: 900.
+    #
+    # @return [Types::ClusterExtendedCredentials] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ClusterExtendedCredentials#db_user #db_user} => String
+    #   * {Types::ClusterExtendedCredentials#db_password #db_password} => String
+    #   * {Types::ClusterExtendedCredentials#expiration #expiration} => Time
+    #   * {Types::ClusterExtendedCredentials#next_refresh_time #next_refresh_time} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_cluster_credentials_with_iam({
+    #     db_name: "String",
+    #     cluster_identifier: "String", # required
+    #     duration_seconds: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.db_user #=> String
+    #   resp.db_password #=> String
+    #   resp.expiration #=> Time
+    #   resp.next_refresh_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/GetClusterCredentialsWithIAM AWS API Documentation
+    #
+    # @overload get_cluster_credentials_with_iam(params = {})
+    # @param [Hash] params ({})
+    def get_cluster_credentials_with_iam(params = {}, options = {})
+      req = build_request(:get_cluster_credentials_with_iam, params)
+      req.send_request(options)
+    end
+
     # Gets the configuration options for the reserved-node exchange. These
     # options include information about the source reserved node and target
     # reserved node offering. Details include the node type, the price, the
@@ -7669,8 +7733,8 @@ module Aws::Redshift
     #
     #   * Must contain one number.
     #
-    #   * Can be any printable ASCII character (ASCII code 33-126) except '
-    #     (single quote), " (double quote), \\, /, or @.
+    #   * Can be any printable ASCII character (ASCII code 33-126) except `'`
+    #     (single quote), `"` (double quote), ``, `/`, or `@`.
     #
     # @option params [String] :cluster_parameter_group_name
     #   The name of the cluster parameter group to apply to this cluster. This
@@ -11073,7 +11137,7 @@ module Aws::Redshift
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-redshift'
-      context[:gem_version] = '1.82.0'
+      context[:gem_version] = '1.83.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -68,6 +68,7 @@ module Aws::Redshift
     ClusterDbRevision = Shapes::StructureShape.new(name: 'ClusterDbRevision')
     ClusterDbRevisionsList = Shapes::ListShape.new(name: 'ClusterDbRevisionsList')
     ClusterDbRevisionsMessage = Shapes::StructureShape.new(name: 'ClusterDbRevisionsMessage')
+    ClusterExtendedCredentials = Shapes::StructureShape.new(name: 'ClusterExtendedCredentials')
     ClusterIamRole = Shapes::StructureShape.new(name: 'ClusterIamRole')
     ClusterIamRoleList = Shapes::ListShape.new(name: 'ClusterIamRoleList')
     ClusterList = Shapes::ListShape.new(name: 'ClusterList')
@@ -259,6 +260,7 @@ module Aws::Redshift
     EventSubscriptionsMessage = Shapes::StructureShape.new(name: 'EventSubscriptionsMessage')
     EventsMessage = Shapes::StructureShape.new(name: 'EventsMessage')
     GetClusterCredentialsMessage = Shapes::StructureShape.new(name: 'GetClusterCredentialsMessage')
+    GetClusterCredentialsWithIAMMessage = Shapes::StructureShape.new(name: 'GetClusterCredentialsWithIAMMessage')
     GetReservedNodeExchangeConfigurationOptionsInputMessage = Shapes::StructureShape.new(name: 'GetReservedNodeExchangeConfigurationOptionsInputMessage')
     GetReservedNodeExchangeConfigurationOptionsOutputMessage = Shapes::StructureShape.new(name: 'GetReservedNodeExchangeConfigurationOptionsOutputMessage')
     GetReservedNodeExchangeOfferingsInputMessage = Shapes::StructureShape.new(name: 'GetReservedNodeExchangeOfferingsInputMessage')
@@ -740,6 +742,12 @@ module Aws::Redshift
     ClusterDbRevisionsMessage.add_member(:cluster_db_revisions, Shapes::ShapeRef.new(shape: ClusterDbRevisionsList, location_name: "ClusterDbRevisions"))
     ClusterDbRevisionsMessage.struct_class = Types::ClusterDbRevisionsMessage
 
+    ClusterExtendedCredentials.add_member(:db_user, Shapes::ShapeRef.new(shape: String, location_name: "DbUser"))
+    ClusterExtendedCredentials.add_member(:db_password, Shapes::ShapeRef.new(shape: SensitiveString, location_name: "DbPassword"))
+    ClusterExtendedCredentials.add_member(:expiration, Shapes::ShapeRef.new(shape: TStamp, location_name: "Expiration"))
+    ClusterExtendedCredentials.add_member(:next_refresh_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "NextRefreshTime"))
+    ClusterExtendedCredentials.struct_class = Types::ClusterExtendedCredentials
+
     ClusterIamRole.add_member(:iam_role_arn, Shapes::ShapeRef.new(shape: String, location_name: "IamRoleArn"))
     ClusterIamRole.add_member(:apply_status, Shapes::ShapeRef.new(shape: String, location_name: "ApplyStatus"))
     ClusterIamRole.struct_class = Types::ClusterIamRole
@@ -1582,6 +1590,11 @@ module Aws::Redshift
     GetClusterCredentialsMessage.add_member(:db_groups, Shapes::ShapeRef.new(shape: DbGroupList, location_name: "DbGroups"))
     GetClusterCredentialsMessage.struct_class = Types::GetClusterCredentialsMessage
 
+    GetClusterCredentialsWithIAMMessage.add_member(:db_name, Shapes::ShapeRef.new(shape: String, location_name: "DbName"))
+    GetClusterCredentialsWithIAMMessage.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "ClusterIdentifier"))
+    GetClusterCredentialsWithIAMMessage.add_member(:duration_seconds, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "DurationSeconds"))
+    GetClusterCredentialsWithIAMMessage.struct_class = Types::GetClusterCredentialsWithIAMMessage
+
     GetReservedNodeExchangeConfigurationOptionsInputMessage.add_member(:action_type, Shapes::ShapeRef.new(shape: ReservedNodeExchangeActionType, required: true, location_name: "ActionType"))
     GetReservedNodeExchangeConfigurationOptionsInputMessage.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "ClusterIdentifier"))
     GetReservedNodeExchangeConfigurationOptionsInputMessage.add_member(:snapshot_identifier, Shapes::ShapeRef.new(shape: String, location_name: "SnapshotIdentifier"))
@@ -3683,6 +3696,16 @@ module Aws::Redshift
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationFault)
       end)
 
+      api.add_operation(:get_cluster_credentials_with_iam, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetClusterCredentialsWithIAM"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetClusterCredentialsWithIAMMessage)
+        o.output = Shapes::ShapeRef.new(shape: ClusterExtendedCredentials)
+        o.errors << Shapes::ShapeRef.new(shape: ClusterNotFoundFault)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationFault)
+      end)
+
       api.add_operation(:get_reserved_node_exchange_configuration_options, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetReservedNodeExchangeConfigurationOptions"
         o.http_method = "POST"

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

@@ -1077,6 +1077,37 @@ module Aws::Redshift
       include Aws::Structure
     end
 
+    # @!attribute [rw] db_user
+    #   A database user name that you provide when you connect to a
+    #   database. The database user is mapped 1:1 to the source IAM
+    #   identity.
+    #   @return [String]
+    #
+    # @!attribute [rw] db_password
+    #   A temporary password that you provide when you connect to a
+    #   database.
+    #   @return [String]
+    #
+    # @!attribute [rw] expiration
+    #   The time (UTC) when the temporary password expires. After this
+    #   timestamp, a log in with the temporary password fails.
+    #   @return [Time]
+    #
+    # @!attribute [rw] next_refresh_time
+    #   Reserved for future use.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/ClusterExtendedCredentials AWS API Documentation
+    #
+    class ClusterExtendedCredentials < Struct.new(
+      :db_user,
+      :db_password,
+      :expiration,
+      :next_refresh_time)
+      SENSITIVE = [:db_password]
+      include Aws::Structure
+    end
+
     # An Identity and Access Management (IAM) role that can be used by the
     # associated Amazon Redshift cluster to access other Amazon Web Services
     # services.
@@ -1992,8 +2023,8 @@ module Aws::Redshift
     #
     #   * Must contain one number.
     #
-    #   * Can be any printable ASCII character (ASCII code 33-126) except '
-    #     (single quote), " (double quote), \\, /, or @.
+    #   * Can be any printable ASCII character (ASCII code 33-126) except
+    #     `'` (single quote), `"` (double quote), ``, `/`, or `@`.
     #   @return [String]
     #
     # @!attribute [rw] cluster_security_groups
@@ -7038,7 +7069,7 @@ module Aws::Redshift
     #
     # @!attribute [rw] cluster_identifier
     #   The unique identifier of the cluster that contains the database for
-    #   which your are requesting credentials. This parameter is case
+    #   which you are requesting credentials. This parameter is case
     #   sensitive.
     #   @return [String]
     #
@@ -7094,6 +7125,43 @@ module Aws::Redshift
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetClusterCredentialsWithIAMMessage
+    #   data as a hash:
+    #
+    #       {
+    #         db_name: "String",
+    #         cluster_identifier: "String", # required
+    #         duration_seconds: 1,
+    #       }
+    #
+    # @!attribute [rw] db_name
+    #   The name of the database for which you are requesting credentials.
+    #   If the database name is specified, the IAM policy must allow access
+    #   to the resource `dbname` for the specified database name. If the
+    #   database name is not specified, access to all databases is allowed.
+    #   @return [String]
+    #
+    # @!attribute [rw] cluster_identifier
+    #   The unique identifier of the cluster that contains the database for
+    #   which you are requesting credentials.
+    #   @return [String]
+    #
+    # @!attribute [rw] duration_seconds
+    #   The number of seconds until the returned temporary password expires.
+    #
+    #   Range: 900-3600. Default: 900.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/GetClusterCredentialsWithIAMMessage AWS API Documentation
+    #
+    class GetClusterCredentialsWithIAMMessage < Struct.new(
+      :db_name,
+      :cluster_identifier,
+      :duration_seconds)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetReservedNodeExchangeConfigurationOptionsInputMessage
     #   data as a hash:
     #
@@ -8145,8 +8213,8 @@ module Aws::Redshift
     #
     #   * Must contain one number.
     #
-    #   * Can be any printable ASCII character (ASCII code 33-126) except '
-    #     (single quote), " (double quote), \\, /, or @.
+    #   * Can be any printable ASCII character (ASCII code 33-126) except
+    #     `'` (single quote), `"` (double quote), ``, `/`, or `@`.
     #   @return [String]
     #
     # @!attribute [rw] cluster_parameter_group_name

data/lib/aws-sdk-redshift.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-redshift/customizations'
 # @!group service
 module Aws::Redshift
 
-  GEM_VERSION = '1.82.0'
+  GEM_VERSION = '1.83.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-redshift
 version: !ruby/object:Gem::Version
-  version: 1.82.0
+  version: 1.83.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-06 00:00:00.000000000 Z
+date: 2022-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core