aws-sdk-redshift 1.108.0 → 1.110.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3197ebcb900a8cc673ec0017e9211c9c91eb9cfeaa5cddaf4c33e42cf3dcdf8f
-  data.tar.gz: ed91efeb4e81fd6320bf5fd600423b69ce4c4820faa6e4bc7baf95694cbfee5a
+  metadata.gz: 12ff5641eca1cb59ba0daafe618acdd9bff0df739e3dcda9b641093dcb59e2e3
+  data.tar.gz: 9f0191b4796c662b88c864bd2dc8dde02d6b2b292af87847c47794774dc207ba
 SHA512:
-  metadata.gz: c5de85e8db7a8d9b0cf6d2208e276ee9106f6adfb3d1668fd5785c2dc44d8bbff9c1ca1d39d78be4fad4e22cbf755671618fb5e9e5fdfabe05158c037f15b244
-  data.tar.gz: 9c2b6b52a1887383bc9c230430ed5314c7f0215a821a3b71ff02ecde29e27fd2ecae3518fc97693a3df96ed0fe96841ea6fe0e5bba1a70c1183d0f65669abc61
+  metadata.gz: 7d45a1276a7d3910a41d50d84956562cf9a09e4f74104d26f8b528b12f9dfb74f95b739624a34a4d63fa09d3664a41f7b60022fa96406505f807a9a380baad82
+  data.tar.gz: 333248b0b27526876ee6190b6a9677134c9b83b3c3cc418f1fc867a4b1abccefe9830530c0a8d7afe2795a079c43f44d7715afc6c0f6018e398519bdf4a7dde6

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.110.0 (2024-03-06)
+------------------
+
+* Feature - Update for documentation only. Covers port ranges, definition updates for data sharing, and definition updates to cluster-snapshot documentation.
+
+1.109.0 (2024-02-07)
+------------------
+
+* Feature - LisRecommendations API to fetch Amazon Redshift Advisor recommendations.
+
 1.108.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.108.0
+1.110.0

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

@@ -492,15 +492,15 @@ module Aws::Redshift
     #
     # @option params [required, String] :data_share_arn
     #   The Amazon Resource Name (ARN) of the datashare that the consumer is
-    #   to use with the account or the namespace.
+    #   to use.
     #
     # @option params [Boolean] :associate_entire_account
     #   A value that specifies whether the datashare is associated with the
     #   entire account.
     #
     # @option params [String] :consumer_arn
-    #   The Amazon Resource Name (ARN) of the consumer that is associated with
-    #   the datashare.
+    #   The Amazon Resource Name (ARN) of the consumer namespace associated
+    #   with the datashare.
     #
     # @option params [String] :consumer_region
     #   From a datashare consumer account, associates a datashare with all
@@ -644,8 +644,8 @@ module Aws::Redshift
     # correct access permissions.
     #
     # @option params [required, String] :data_share_arn
-    #   The Amazon Resource Name (ARN) of the datashare that producers are to
-    #   authorize sharing for.
+    #   The Amazon Resource Name (ARN) of the datashare namespace that
+    #   producers are to authorize sharing for.
     #
     # @option params [required, String] :consumer_identifier
     #   The identifier of the data consumer that is authorized to access the
@@ -766,10 +766,16 @@ module Aws::Redshift
     #   The Amazon Resource Name (ARN) of the snapshot to authorize access to.
     #
     # @option params [String] :snapshot_cluster_identifier
-    #   The identifier of the cluster the snapshot was created from. This
-    #   parameter is required if your IAM user has a policy containing a
-    #   snapshot resource element that specifies anything other than * for
-    #   the cluster name.
+    #   The identifier of the cluster the snapshot was created from.
+    #
+    #   * *If the snapshot to access doesn't exist and the associated IAM
+    #     policy doesn't allow access to all (*) snapshots* - This parameter
+    #     is required. Otherwise, permissions aren't available to check if
+    #     the snapshot exists.
+    #
+    #   * *If the snapshot to access exists* - This parameter isn't required.
+    #     Redshift can retrieve the cluster identifier and use it to validate
+    #     snapshot authorization.
     #
     # @option params [required, String] :account_with_restore_access
     #   The identifier of the Amazon Web Services account authorized to
@@ -1391,7 +1397,15 @@ module Aws::Redshift
     #
     #   Default: `5439`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid Values:
+    #
+    #   * For clusters with ra3 nodes - Select a port within the ranges
+    #     `5431-5455` or `8191-8215`. (If you have an existing cluster with
+    #     ra3 nodes, it isn't required that you change the port to these
+    #     ranges.)
+    #
+    #   * For clusters with ds2 or dc2 nodes - Select a port within the range
+    #     `1150-65535`.
     #
     # @option params [String] :cluster_version
     #   The version of the Amazon Redshift engine software that you want to
@@ -2983,7 +2997,7 @@ module Aws::Redshift
     # specified datashare.
     #
     # @option params [required, String] :data_share_arn
-    #   The Amazon Resource Name (ARN) of the datashare to remove
+    #   The namespace Amazon Resource Name (ARN) of the datashare to remove
     #   authorization from.
     #
     # @option params [required, String] :consumer_identifier
@@ -5004,7 +5018,8 @@ module Aws::Redshift
     # the specified account.
     #
     # @option params [String] :data_share_arn
-    #   The identifier of the datashare to describe details of.
+    #   The Amazon resource name (ARN) of the datashare to describe details
+    #   of.
     #
     # @option params [Integer] :max_records
     #   The maximum number of response records to return in each call. If the
@@ -5067,8 +5082,8 @@ module Aws::Redshift
     # is a consumer account identifier.
     #
     # @option params [String] :consumer_arn
-    #   The Amazon Resource Name (ARN) of the consumer that returns in the
-    #   list of datashares.
+    #   The Amazon Resource Name (ARN) of the consumer namespace that returns
+    #   in the list of datashares.
     #
     # @option params [String] :status
     #   An identifier giving the status of a datashare in the consumer
@@ -5137,8 +5152,8 @@ module Aws::Redshift
     # is a producer account identifier.
     #
     # @option params [String] :producer_arn
-    #   The Amazon Resource Name (ARN) of the producer that returns in the
-    #   list of datashares.
+    #   The Amazon Resource Name (ARN) of the producer namespace that returns
+    #   in the list of datashares.
     #
     # @option params [String] :status
     #   An identifier giving the status of a datashare in the producer. If
@@ -7414,8 +7429,8 @@ module Aws::Redshift
     #   removed from the entire account.
     #
     # @option params [String] :consumer_arn
-    #   The Amazon Resource Name (ARN) of the consumer that association for
-    #   the datashare is removed from.
+    #   The Amazon Resource Name (ARN) of the consumer namespace that
+    #   association for the datashare is removed from.
     #
     # @option params [String] :consumer_region
     #   From a datashare consumer account, removes association of a datashare
@@ -8319,6 +8334,86 @@ module Aws::Redshift
       req.send_request(options)
     end
 
+    # List the Amazon Redshift Advisor recommendations for one or multiple
+    # Amazon Redshift clusters in an Amazon Web Services account.
+    #
+    # @option params [String] :cluster_identifier
+    #   The unique identifier of the Amazon Redshift cluster for which the
+    #   list of Advisor recommendations is returned. If the neither the
+    #   cluster identifier and the cluster namespace ARN parameters are
+    #   specified, then recommendations for all clusters in the account are
+    #   returned.
+    #
+    # @option params [String] :namespace_arn
+    #   The Amazon Redshift cluster namespace Amazon Resource Name (ARN) for
+    #   which the list of Advisor recommendations is returned. If the neither
+    #   the cluster identifier and the cluster namespace ARN parameters are
+    #   specified, then recommendations for all clusters in the account are
+    #   returned.
+    #
+    # @option params [Integer] :max_records
+    #   The maximum number of response records to return in each call. If the
+    #   number of remaining response records exceeds the specified MaxRecords
+    #   value, a value is returned in a marker field of the response. You can
+    #   retrieve the next set of records by retrying the command with the
+    #   returned marker value.
+    #
+    # @option params [String] :marker
+    #   A value that indicates the starting point for the next set of response
+    #   records in a subsequent request. If a value is returned in a response,
+    #   you can retrieve the next set of records by providing this returned
+    #   marker value in the Marker parameter and retrying the command. If the
+    #   Marker field is empty, all response records have been retrieved for
+    #   the request.
+    #
+    # @return [Types::ListRecommendationsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListRecommendationsResult#recommendations #recommendations} => Array<Types::Recommendation>
+    #   * {Types::ListRecommendationsResult#marker #marker} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_recommendations({
+    #     cluster_identifier: "String",
+    #     namespace_arn: "String",
+    #     max_records: 1,
+    #     marker: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recommendations #=> Array
+    #   resp.recommendations[0].id #=> String
+    #   resp.recommendations[0].cluster_identifier #=> String
+    #   resp.recommendations[0].namespace_arn #=> String
+    #   resp.recommendations[0].created_at #=> Time
+    #   resp.recommendations[0].recommendation_type #=> String
+    #   resp.recommendations[0].title #=> String
+    #   resp.recommendations[0].description #=> String
+    #   resp.recommendations[0].observation #=> String
+    #   resp.recommendations[0].impact_ranking #=> String, one of "HIGH", "MEDIUM", "LOW"
+    #   resp.recommendations[0].recommendation_text #=> String
+    #   resp.recommendations[0].recommended_actions #=> Array
+    #   resp.recommendations[0].recommended_actions[0].text #=> String
+    #   resp.recommendations[0].recommended_actions[0].database #=> String
+    #   resp.recommendations[0].recommended_actions[0].command #=> String
+    #   resp.recommendations[0].recommended_actions[0].type #=> String, one of "SQL", "CLI"
+    #   resp.recommendations[0].reference_links #=> Array
+    #   resp.recommendations[0].reference_links[0].text #=> String
+    #   resp.recommendations[0].reference_links[0].link #=> String
+    #   resp.marker #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/ListRecommendations AWS API Documentation
+    #
+    # @overload list_recommendations(params = {})
+    # @param [Hash] params ({})
+    def list_recommendations(params = {}, options = {})
+      req = build_request(:list_recommendations, params)
+      req.send_request(options)
+    end
+
     # This operation is retired. Calling this operation does not change AQUA
     # configuration. Amazon Redshift automatically determines whether to use
     # AQUA (Advanced Query Accelerator).
@@ -8676,6 +8771,16 @@ module Aws::Redshift
     # @option params [Integer] :port
     #   The option to change the port of an Amazon Redshift cluster.
     #
+    #   Valid Values:
+    #
+    #   * For clusters with ra3 nodes - Select a port within the ranges
+    #     `5431-5455` or `8191-8215`. (If you have an existing cluster with
+    #     ra3 nodes, it isn't required that you change the port to these
+    #     ranges.)
+    #
+    #   * For clusters with ds2 or dc2 nodes - Select a port within the range
+    #     `1150-65535`.
+    #
     # @option params [Boolean] :manage_master_password
     #   If `true`, Amazon Redshift uses Secrets Manager to manage this
     #   cluster's admin credentials. You can't use `MasterUserPassword` if
@@ -11140,7 +11245,9 @@ module Aws::Redshift
     #
     #   Default: The same port as the original cluster.
     #
-    #   Constraints: Must be between `1115` and `65535`.
+    #   Valid values: For clusters with ds2 or dc2 nodes, must be within the
+    #   range `1150`-`65535`. For clusters with ra3 nodes, must be within the
+    #   ranges `5431`-`5455` or `8191`-`8215`.
     #
     # @option params [String] :availability_zone
     #   The Amazon EC2 Availability Zone in which to restore the cluster.
@@ -12285,7 +12392,7 @@ module Aws::Redshift
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-redshift'
-      context[:gem_version] = '1.108.0'
+      context[:gem_version] = '1.110.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -312,6 +312,7 @@ module Aws::Redshift
     IamRoleArnList = Shapes::ListShape.new(name: 'IamRoleArnList')
     IdcDisplayNameString = Shapes::StringShape.new(name: 'IdcDisplayNameString')
     IdentityNamespaceString = Shapes::StringShape.new(name: 'IdentityNamespaceString')
+    ImpactRankingType = Shapes::StringShape.new(name: 'ImpactRankingType')
     ImportTablesCompleted = Shapes::ListShape.new(name: 'ImportTablesCompleted')
     ImportTablesInProgress = Shapes::ListShape.new(name: 'ImportTablesInProgress')
     ImportTablesNotStarted = Shapes::ListShape.new(name: 'ImportTablesNotStarted')
@@ -363,6 +364,8 @@ module Aws::Redshift
     LakeFormationScopeUnion = Shapes::UnionShape.new(name: 'LakeFormationScopeUnion')
     LakeFormationServiceIntegrations = Shapes::ListShape.new(name: 'LakeFormationServiceIntegrations')
     LimitExceededFault = Shapes::StructureShape.new(name: 'LimitExceededFault')
+    ListRecommendationsMessage = Shapes::StructureShape.new(name: 'ListRecommendationsMessage')
+    ListRecommendationsResult = Shapes::StructureShape.new(name: 'ListRecommendationsResult')
     LogDestinationType = Shapes::StringShape.new(name: 'LogDestinationType')
     LogTypeList = Shapes::ListShape.new(name: 'LogTypeList')
     LoggingStatus = Shapes::StructureShape.new(name: 'LoggingStatus')
@@ -439,6 +442,11 @@ module Aws::Redshift
     PutResourcePolicyResult = Shapes::StructureShape.new(name: 'PutResourcePolicyResult')
     RebootClusterMessage = Shapes::StructureShape.new(name: 'RebootClusterMessage')
     RebootClusterResult = Shapes::StructureShape.new(name: 'RebootClusterResult')
+    Recommendation = Shapes::StructureShape.new(name: 'Recommendation')
+    RecommendationList = Shapes::ListShape.new(name: 'RecommendationList')
+    RecommendedAction = Shapes::StructureShape.new(name: 'RecommendedAction')
+    RecommendedActionList = Shapes::ListShape.new(name: 'RecommendedActionList')
+    RecommendedActionType = Shapes::StringShape.new(name: 'RecommendedActionType')
     RecurringCharge = Shapes::StructureShape.new(name: 'RecurringCharge')
     RecurringChargeList = Shapes::ListShape.new(name: 'RecurringChargeList')
     RedshiftIdcApplication = Shapes::StructureShape.new(name: 'RedshiftIdcApplication')
@@ -447,6 +455,8 @@ module Aws::Redshift
     RedshiftIdcApplicationName = Shapes::StringShape.new(name: 'RedshiftIdcApplicationName')
     RedshiftIdcApplicationNotExistsFault = Shapes::StructureShape.new(name: 'RedshiftIdcApplicationNotExistsFault')
     RedshiftIdcApplicationQuotaExceededFault = Shapes::StructureShape.new(name: 'RedshiftIdcApplicationQuotaExceededFault')
+    ReferenceLink = Shapes::StructureShape.new(name: 'ReferenceLink')
+    ReferenceLinkList = Shapes::ListShape.new(name: 'ReferenceLinkList')
     RejectDataShareMessage = Shapes::StructureShape.new(name: 'RejectDataShareMessage')
     ReservedNode = Shapes::StructureShape.new(name: 'ReservedNode')
     ReservedNodeAlreadyExistsFault = Shapes::StructureShape.new(name: 'ReservedNodeAlreadyExistsFault')
@@ -1960,6 +1970,16 @@ module Aws::Redshift
 
     LimitExceededFault.struct_class = Types::LimitExceededFault
 
+    ListRecommendationsMessage.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "ClusterIdentifier"))
+    ListRecommendationsMessage.add_member(:namespace_arn, Shapes::ShapeRef.new(shape: String, location_name: "NamespaceArn"))
+    ListRecommendationsMessage.add_member(:max_records, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxRecords"))
+    ListRecommendationsMessage.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
+    ListRecommendationsMessage.struct_class = Types::ListRecommendationsMessage
+
+    ListRecommendationsResult.add_member(:recommendations, Shapes::ShapeRef.new(shape: RecommendationList, location_name: "Recommendations"))
+    ListRecommendationsResult.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
+    ListRecommendationsResult.struct_class = Types::ListRecommendationsResult
+
     LogTypeList.member = Shapes::ShapeRef.new(shape: String)
 
     LoggingStatus.add_member(:logging_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "LoggingEnabled"))
@@ -2265,6 +2285,30 @@ module Aws::Redshift
     RebootClusterResult.add_member(:cluster, Shapes::ShapeRef.new(shape: Cluster, location_name: "Cluster"))
     RebootClusterResult.struct_class = Types::RebootClusterResult
 
+    Recommendation.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "Id"))
+    Recommendation.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "ClusterIdentifier"))
+    Recommendation.add_member(:namespace_arn, Shapes::ShapeRef.new(shape: String, location_name: "NamespaceArn"))
+    Recommendation.add_member(:created_at, Shapes::ShapeRef.new(shape: TStamp, location_name: "CreatedAt"))
+    Recommendation.add_member(:recommendation_type, Shapes::ShapeRef.new(shape: String, location_name: "RecommendationType"))
+    Recommendation.add_member(:title, Shapes::ShapeRef.new(shape: String, location_name: "Title"))
+    Recommendation.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "Description"))
+    Recommendation.add_member(:observation, Shapes::ShapeRef.new(shape: String, location_name: "Observation"))
+    Recommendation.add_member(:impact_ranking, Shapes::ShapeRef.new(shape: ImpactRankingType, location_name: "ImpactRanking"))
+    Recommendation.add_member(:recommendation_text, Shapes::ShapeRef.new(shape: String, location_name: "RecommendationText"))
+    Recommendation.add_member(:recommended_actions, Shapes::ShapeRef.new(shape: RecommendedActionList, location_name: "RecommendedActions"))
+    Recommendation.add_member(:reference_links, Shapes::ShapeRef.new(shape: ReferenceLinkList, location_name: "ReferenceLinks"))
+    Recommendation.struct_class = Types::Recommendation
+
+    RecommendationList.member = Shapes::ShapeRef.new(shape: Recommendation, location_name: "Recommendation")
+
+    RecommendedAction.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "Text"))
+    RecommendedAction.add_member(:database, Shapes::ShapeRef.new(shape: String, location_name: "Database"))
+    RecommendedAction.add_member(:command, Shapes::ShapeRef.new(shape: String, location_name: "Command"))
+    RecommendedAction.add_member(:type, Shapes::ShapeRef.new(shape: RecommendedActionType, location_name: "Type"))
+    RecommendedAction.struct_class = Types::RecommendedAction
+
+    RecommendedActionList.member = Shapes::ShapeRef.new(shape: RecommendedAction, location_name: "RecommendedAction")
+
     RecurringCharge.add_member(:recurring_charge_amount, Shapes::ShapeRef.new(shape: Double, location_name: "RecurringChargeAmount"))
     RecurringCharge.add_member(:recurring_charge_frequency, Shapes::ShapeRef.new(shape: String, location_name: "RecurringChargeFrequency"))
     RecurringCharge.struct_class = Types::RecurringCharge
@@ -2291,6 +2335,12 @@ module Aws::Redshift
 
     RedshiftIdcApplicationQuotaExceededFault.struct_class = Types::RedshiftIdcApplicationQuotaExceededFault
 
+    ReferenceLink.add_member(:text, Shapes::ShapeRef.new(shape: String, location_name: "Text"))
+    ReferenceLink.add_member(:link, Shapes::ShapeRef.new(shape: String, location_name: "Link"))
+    ReferenceLink.struct_class = Types::ReferenceLink
+
+    ReferenceLinkList.member = Shapes::ShapeRef.new(shape: ReferenceLink, location_name: "ReferenceLink")
+
     RejectDataShareMessage.add_member(:data_share_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DataShareArn"))
     RejectDataShareMessage.struct_class = Types::RejectDataShareMessage
 
@@ -4194,6 +4244,22 @@ module Aws::Redshift
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationFault)
       end)
 
+      api.add_operation(:list_recommendations, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListRecommendations"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListRecommendationsMessage)
+        o.output = Shapes::ShapeRef.new(shape: ListRecommendationsResult)
+        o.errors << Shapes::ShapeRef.new(shape: ClusterNotFoundFault)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedOperationFault)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "marker" => "marker"
+          }
+        )
+      end)
+
       api.add_operation(:modify_aqua_configuration, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ModifyAquaConfiguration"
         o.http_method = "POST"

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

@@ -1398,6 +1398,20 @@ module Aws::Redshift
       end
     end
 
+    class ListRecommendations
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::Redshift::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class ModifyAquaConfiguration
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-redshift/plugins/endpoints.rb

@@ -256,6 +256,8 @@ module Aws::Redshift
             Aws::Redshift::Endpoints::GetReservedNodeExchangeOfferings.build(context)
           when :get_resource_policy
             Aws::Redshift::Endpoints::GetResourcePolicy.build(context)
+          when :list_recommendations
+            Aws::Redshift::Endpoints::ListRecommendations.build(context)
           when :modify_aqua_configuration
             Aws::Redshift::Endpoints::ModifyAquaConfiguration.build(context)
           when :modify_authentication_profile

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

@@ -133,7 +133,7 @@ module Aws::Redshift
 
     # @!attribute [rw] data_share_arn
     #   The Amazon Resource Name (ARN) of the datashare that the consumer is
-    #   to use with the account or the namespace.
+    #   to use.
     #   @return [String]
     #
     # @!attribute [rw] associate_entire_account
@@ -142,7 +142,7 @@ module Aws::Redshift
     #   @return [Boolean]
     #
     # @!attribute [rw] consumer_arn
-    #   The Amazon Resource Name (ARN) of the consumer that is associated
+    #   The Amazon Resource Name (ARN) of the consumer namespace associated
     #   with the datashare.
     #   @return [String]
     #
@@ -315,8 +315,8 @@ module Aws::Redshift
     end
 
     # @!attribute [rw] data_share_arn
-    #   The Amazon Resource Name (ARN) of the datashare that producers are
-    #   to authorize sharing for.
+    #   The Amazon Resource Name (ARN) of the datashare namespace that
+    #   producers are to authorize sharing for.
     #   @return [String]
     #
     # @!attribute [rw] consumer_identifier
@@ -371,10 +371,16 @@ module Aws::Redshift
     #   @return [String]
     #
     # @!attribute [rw] snapshot_cluster_identifier
-    #   The identifier of the cluster the snapshot was created from. This
-    #   parameter is required if your IAM user has a policy containing a
-    #   snapshot resource element that specifies anything other than * for
-    #   the cluster name.
+    #   The identifier of the cluster the snapshot was created from.
+    #
+    #   * *If the snapshot to access doesn't exist and the associated IAM
+    #     policy doesn't allow access to all (*) snapshots* - This
+    #     parameter is required. Otherwise, permissions aren't available to
+    #     check if the snapshot exists.
+    #
+    #   * *If the snapshot to access exists* - This parameter isn't
+    #     required. Redshift can retrieve the cluster identifier and use it
+    #     to validate snapshot authorization.
     #   @return [String]
     #
     # @!attribute [rw] account_with_restore_access
@@ -2132,7 +2138,15 @@ module Aws::Redshift
     #
     #   Default: `5439`
     #
-    #   Valid Values: `1150-65535`
+    #   Valid Values:
+    #
+    #   * For clusters with ra3 nodes - Select a port within the ranges
+    #     `5431-5455` or `8191-8215`. (If you have an existing cluster with
+    #     ra3 nodes, it isn't required that you change the port to these
+    #     ranges.)
+    #
+    #   * For clusters with ds2 or dc2 nodes - Select a port within the
+    #     range `1150-65535`.
     #   @return [Integer]
     #
     # @!attribute [rw] cluster_version
@@ -3229,15 +3243,12 @@ module Aws::Redshift
     end
 
     # @!attribute [rw] data_share_arn
-    #   An Amazon Resource Name (ARN) that references the datashare that is
-    #   owned by a specific namespace of the producer cluster. A datashare
-    #   ARN is in the
-    #   `arn:aws:redshift:\{region\}:\{account-id\}:\{datashare\}:\{namespace-guid\}/\{datashare-name\}`
-    #   format.
+    #   The Amazon Resource Name (ARN) of the datashare that the consumer is
+    #   to use.
     #   @return [String]
     #
     # @!attribute [rw] producer_arn
-    #   The Amazon Resource Name (ARN) of the producer.
+    #   The Amazon Resource Name (ARN) of the producer namespace.
     #   @return [String]
     #
     # @!attribute [rw] allow_publicly_accessible_consumers
@@ -3360,7 +3371,7 @@ module Aws::Redshift
     end
 
     # @!attribute [rw] data_share_arn
-    #   The Amazon Resource Name (ARN) of the datashare to remove
+    #   The namespace Amazon Resource Name (ARN) of the datashare to remove
     #   authorization from.
     #   @return [String]
     #
@@ -4425,8 +4436,8 @@ module Aws::Redshift
     end
 
     # @!attribute [rw] consumer_arn
-    #   The Amazon Resource Name (ARN) of the consumer that returns in the
-    #   list of datashares.
+    #   The Amazon Resource Name (ARN) of the consumer namespace that
+    #   returns in the list of datashares.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -4488,8 +4499,8 @@ module Aws::Redshift
     end
 
     # @!attribute [rw] producer_arn
-    #   The Amazon Resource Name (ARN) of the producer that returns in the
-    #   list of datashares.
+    #   The Amazon Resource Name (ARN) of the producer namespace that
+    #   returns in the list of datashares.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -4551,7 +4562,8 @@ module Aws::Redshift
     end
 
     # @!attribute [rw] data_share_arn
-    #   The identifier of the datashare to describe details of.
+    #   The Amazon resource name (ARN) of the datashare to describe details
+    #   of.
     #   @return [String]
     #
     # @!attribute [rw] max_records
@@ -5911,8 +5923,8 @@ module Aws::Redshift
     #   @return [Boolean]
     #
     # @!attribute [rw] consumer_arn
-    #   The Amazon Resource Name (ARN) of the consumer that association for
-    #   the datashare is removed from.
+    #   The Amazon Resource Name (ARN) of the consumer namespace that
+    #   association for the datashare is removed from.
     #   @return [String]
     #
     # @!attribute [rw] consumer_region
@@ -7513,6 +7525,73 @@ module Aws::Redshift
     #
     class LimitExceededFault < Aws::EmptyStructure; end
 
+    # @!attribute [rw] cluster_identifier
+    #   The unique identifier of the Amazon Redshift cluster for which the
+    #   list of Advisor recommendations is returned. If the neither the
+    #   cluster identifier and the cluster namespace ARN parameters are
+    #   specified, then recommendations for all clusters in the account are
+    #   returned.
+    #   @return [String]
+    #
+    # @!attribute [rw] namespace_arn
+    #   The Amazon Redshift cluster namespace Amazon Resource Name (ARN) for
+    #   which the list of Advisor recommendations is returned. If the
+    #   neither the cluster identifier and the cluster namespace ARN
+    #   parameters are specified, then recommendations for all clusters in
+    #   the account are returned.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_records
+    #   The maximum number of response records to return in each call. If
+    #   the number of remaining response records exceeds the specified
+    #   MaxRecords value, a value is returned in a marker field of the
+    #   response. You can retrieve the next set of records by retrying the
+    #   command with the returned marker value.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] marker
+    #   A value that indicates the starting point for the next set of
+    #   response records in a subsequent request. If a value is returned in
+    #   a response, you can retrieve the next set of records by providing
+    #   this returned marker value in the Marker parameter and retrying the
+    #   command. If the Marker field is empty, all response records have
+    #   been retrieved for the request.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/ListRecommendationsMessage AWS API Documentation
+    #
+    class ListRecommendationsMessage < Struct.new(
+      :cluster_identifier,
+      :namespace_arn,
+      :max_records,
+      :marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] recommendations
+    #   The Advisor recommendations for action on the Amazon Redshift
+    #   cluster.
+    #   @return [Array<Types::Recommendation>]
+    #
+    # @!attribute [rw] marker
+    #   A value that indicates the starting point for the next set of
+    #   response records in a subsequent request. If a value is returned in
+    #   a response, you can retrieve the next set of records by providing
+    #   this returned marker value in the Marker parameter and retrying the
+    #   command. If the Marker field is empty, all response records have
+    #   been retrieved for the request.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/ListRecommendationsResult AWS API Documentation
+    #
+    class ListRecommendationsResult < Struct.new(
+      :recommendations,
+      :marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes the status of logging for a cluster.
     #
     # @!attribute [rw] logging_enabled
@@ -8084,6 +8163,16 @@ module Aws::Redshift
     #
     # @!attribute [rw] port
     #   The option to change the port of an Amazon Redshift cluster.
+    #
+    #   Valid Values:
+    #
+    #   * For clusters with ra3 nodes - Select a port within the ranges
+    #     `5431-5455` or `8191-8215`. (If you have an existing cluster with
+    #     ra3 nodes, it isn't required that you change the port to these
+    #     ranges.)
+    #
+    #   * For clusters with ds2 or dc2 nodes - Select a port within the
+    #     range `1150-65535`.
     #   @return [Integer]
     #
     # @!attribute [rw] manage_master_password
@@ -9204,6 +9293,111 @@ module Aws::Redshift
       include Aws::Structure
     end
 
+    # An Amazon Redshift Advisor recommended action on the Amazon Redshift
+    # cluster.
+    #
+    # @!attribute [rw] id
+    #   A unique identifier of the Advisor recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] cluster_identifier
+    #   The unique identifier of the cluster for which the recommendation is
+    #   returned.
+    #   @return [String]
+    #
+    # @!attribute [rw] namespace_arn
+    #   The Amazon Redshift cluster namespace ARN for which the
+    #   recommendations is returned.
+    #   @return [String]
+    #
+    # @!attribute [rw] created_at
+    #   The date and time (UTC) that the recommendation was created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] recommendation_type
+    #   The type of Advisor recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] title
+    #   The title of the recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description of the recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] observation
+    #   The description of what was observed about your cluster.
+    #   @return [String]
+    #
+    # @!attribute [rw] impact_ranking
+    #   The scale of the impact that the Advisor recommendation has to the
+    #   performance and cost of the cluster.
+    #   @return [String]
+    #
+    # @!attribute [rw] recommendation_text
+    #   The description of the recommendation.
+    #   @return [String]
+    #
+    # @!attribute [rw] recommended_actions
+    #   List of Amazon Redshift recommended actions.
+    #   @return [Array<Types::RecommendedAction>]
+    #
+    # @!attribute [rw] reference_links
+    #   List of helpful links for more information about the Advisor
+    #   recommendation.
+    #   @return [Array<Types::ReferenceLink>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/Recommendation AWS API Documentation
+    #
+    class Recommendation < Struct.new(
+      :id,
+      :cluster_identifier,
+      :namespace_arn,
+      :created_at,
+      :recommendation_type,
+      :title,
+      :description,
+      :observation,
+      :impact_ranking,
+      :recommendation_text,
+      :recommended_actions,
+      :reference_links)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The recommended action from the Amazon Redshift Advisor
+    # recommendation.
+    #
+    # @!attribute [rw] text
+    #   The specific instruction about the command.
+    #   @return [String]
+    #
+    # @!attribute [rw] database
+    #   The database name to perform the action on. Only applicable if the
+    #   type of command is SQL.
+    #   @return [String]
+    #
+    # @!attribute [rw] command
+    #   The command to run.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The type of command.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/RecommendedAction AWS API Documentation
+    #
+    class RecommendedAction < Struct.new(
+      :text,
+      :database,
+      :command,
+      :type)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes a recurring charge.
     #
     # @!attribute [rw] recurring_charge_amount
@@ -9312,6 +9506,26 @@ module Aws::Redshift
     #
     class RedshiftIdcApplicationQuotaExceededFault < Aws::EmptyStructure; end
 
+    # A link to an Amazon Redshift Advisor reference for more information
+    # about a recommendation.
+    #
+    # @!attribute [rw] text
+    #   The hyperlink text that describes the link to more information.
+    #   @return [String]
+    #
+    # @!attribute [rw] link
+    #   The URL address to find more information.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-2012-12-01/ReferenceLink AWS API Documentation
+    #
+    class ReferenceLink < Struct.new(
+      :text,
+      :link)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] data_share_arn
     #   The Amazon Resource Name (ARN) of the datashare to reject.
     #   @return [String]
@@ -9954,7 +10168,9 @@ module Aws::Redshift
     #
     #   Default: The same port as the original cluster.
     #
-    #   Constraints: Must be between `1115` and `65535`.
+    #   Valid values: For clusters with ds2 or dc2 nodes, must be within the
+    #   range `1150`-`65535`. For clusters with ra3 nodes, must be within
+    #   the ranges `5431`-`5455` or `8191`-`8215`.
     #   @return [Integer]
     #
     # @!attribute [rw] availability_zone

data/lib/aws-sdk-redshift.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-redshift/customizations'
 # @!group service
 module Aws::Redshift
 
-  GEM_VERSION = '1.108.0'
+  GEM_VERSION = '1.110.0'
 
 end

data/sig/client.rbs

@@ -1563,6 +1563,20 @@ module Aws
                                ) -> _GetResourcePolicyResponseSuccess
                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetResourcePolicyResponseSuccess
 
+      interface _ListRecommendationsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListRecommendationsResult]
+        def recommendations: () -> ::Array[Types::Recommendation]
+        def marker: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Redshift/Client.html#list_recommendations-instance_method
+      def list_recommendations: (
+                                  ?cluster_identifier: ::String,
+                                  ?namespace_arn: ::String,
+                                  ?max_records: ::Integer,
+                                  ?marker: ::String
+                                ) -> _ListRecommendationsResponseSuccess
+                              | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListRecommendationsResponseSuccess
+
       interface _ModifyAquaConfigurationResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ModifyAquaOutputMessage]
         def aqua_configuration: () -> Types::AquaConfiguration

data/sig/types.rbs

@@ -1755,6 +1755,20 @@ module Aws::Redshift
     class LimitExceededFault < Aws::EmptyStructure
     end
 
+    class ListRecommendationsMessage
+      attr_accessor cluster_identifier: ::String
+      attr_accessor namespace_arn: ::String
+      attr_accessor max_records: ::Integer
+      attr_accessor marker: ::String
+      SENSITIVE: []
+    end
+
+    class ListRecommendationsResult
+      attr_accessor recommendations: ::Array[Types::Recommendation]
+      attr_accessor marker: ::String
+      SENSITIVE: []
+    end
+
     class LoggingStatus
       attr_accessor logging_enabled: bool
       attr_accessor bucket_name: ::String
@@ -2147,6 +2161,30 @@ module Aws::Redshift
       SENSITIVE: []
     end
 
+    class Recommendation
+      attr_accessor id: ::String
+      attr_accessor cluster_identifier: ::String
+      attr_accessor namespace_arn: ::String
+      attr_accessor created_at: ::Time
+      attr_accessor recommendation_type: ::String
+      attr_accessor title: ::String
+      attr_accessor description: ::String
+      attr_accessor observation: ::String
+      attr_accessor impact_ranking: ("HIGH" | "MEDIUM" | "LOW")
+      attr_accessor recommendation_text: ::String
+      attr_accessor recommended_actions: ::Array[Types::RecommendedAction]
+      attr_accessor reference_links: ::Array[Types::ReferenceLink]
+      SENSITIVE: []
+    end
+
+    class RecommendedAction
+      attr_accessor text: ::String
+      attr_accessor database: ::String
+      attr_accessor command: ::String
+      attr_accessor type: ("SQL" | "CLI")
+      SENSITIVE: []
+    end
+
     class RecurringCharge
       attr_accessor recurring_charge_amount: ::Float
       attr_accessor recurring_charge_frequency: ::String
@@ -2176,6 +2214,12 @@ module Aws::Redshift
     class RedshiftIdcApplicationQuotaExceededFault < Aws::EmptyStructure
     end
 
+    class ReferenceLink
+      attr_accessor text: ::String
+      attr_accessor link: ::String
+      SENSITIVE: []
+    end
+
     class RejectDataShareMessage
       attr_accessor data_share_arn: ::String
       SENSITIVE: []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-redshift
 version: !ruby/object:Gem::Version
-  version: 1.108.0
+  version: 1.110.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core