aws-sdk-rds 1.209.0 → 1.211.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1112,6 +1112,25 @@ module Aws::RDS
1112
1112
  include Aws::Structure
1113
1113
  end
1114
1114
 
1115
+ # The additional attributes of `RecommendedAction` data type.
1116
+ #
1117
+ # @!attribute [rw] key
1118
+ # The key of `ContextAttribute`.
1119
+ # @return [String]
1120
+ #
1121
+ # @!attribute [rw] value
1122
+ # The value of `ContextAttribute`.
1123
+ # @return [String]
1124
+ #
1125
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ContextAttribute AWS API Documentation
1126
+ #
1127
+ class ContextAttribute < Struct.new(
1128
+ :key,
1129
+ :value)
1130
+ SENSITIVE = []
1131
+ include Aws::Structure
1132
+ end
1133
+
1115
1134
  # @!attribute [rw] source_db_cluster_parameter_group_identifier
1116
1135
  # The identifier or Amazon Resource Name (ARN) for the source DB
1117
1136
  # cluster parameter group. For information about creating an ARN, see
@@ -2488,16 +2507,22 @@ module Aws::RDS
2488
2507
  # @return [String]
2489
2508
  #
2490
2509
  # @!attribute [rw] enable_http_endpoint
2491
- # Specifies whether to enable the HTTP endpoint for an Aurora
2492
- # Serverless v1 DB cluster. By default, the HTTP endpoint is disabled.
2510
+ # Specifies whether to enable the HTTP endpoint for the DB cluster. By
2511
+ # default, the HTTP endpoint isn't enabled.
2493
2512
  #
2494
2513
  # When enabled, the HTTP endpoint provides a connectionless web
2495
- # service API for running SQL queries on the Aurora Serverless v1 DB
2514
+ # service API (RDS Data API) for running SQL queries on the DB
2496
2515
  # cluster. You can also query your database from inside the RDS
2497
- # console with the query editor.
2516
+ # console with the RDS query editor.
2517
+ #
2518
+ # RDS Data API is supported with the following DB clusters:
2519
+ #
2520
+ # * Aurora PostgreSQL Serverless v2 and provisioned
2521
+ #
2522
+ # * Aurora PostgreSQL and Aurora MySQL Serverless v1
2498
2523
  #
2499
- # For more information, see [Using the Data API for Aurora Serverless
2500
- # v1][1] in the *Amazon Aurora User Guide*.
2524
+ # For more information, see [Using RDS Data API][1] in the *Amazon
2525
+ # Aurora User Guide*.
2501
2526
  #
2502
2527
  # Valid for Cluster Type: Aurora DB clusters only
2503
2528
  #
@@ -6495,16 +6520,16 @@ module Aws::RDS
6495
6520
  # @return [Boolean]
6496
6521
  #
6497
6522
  # @!attribute [rw] http_endpoint_enabled
6498
- # Indicates whether the HTTP endpoint for an Aurora Serverless v1 DB
6499
- # cluster is enabled.
6523
+ # Indicates whether the HTTP endpoint is enabled for an Aurora DB
6524
+ # cluster.
6500
6525
  #
6501
6526
  # When enabled, the HTTP endpoint provides a connectionless web
6502
- # service API for running SQL queries on the Aurora Serverless v1 DB
6527
+ # service API (RDS Data API) for running SQL queries on the DB
6503
6528
  # cluster. You can also query your database from inside the RDS
6504
- # console with the query editor.
6529
+ # console with the RDS query editor.
6505
6530
  #
6506
- # For more information, see [Using the Data API for Aurora Serverless
6507
- # v1][1] in the *Amazon Aurora User Guide*.
6531
+ # For more information, see [Using RDS Data API][1] in the *Amazon
6532
+ # Aurora User Guide*.
6508
6533
  #
6509
6534
  #
6510
6535
  #
@@ -9699,6 +9724,198 @@ module Aws::RDS
9699
9724
  #
9700
9725
  class DBProxyTargetNotFoundFault < Aws::EmptyStructure; end
9701
9726
 
9727
+ # The recommendation for your DB instances, DB clusters, and DB
9728
+ # parameter groups.
9729
+ #
9730
+ # @!attribute [rw] recommendation_id
9731
+ # The unique identifier of the recommendation.
9732
+ # @return [String]
9733
+ #
9734
+ # @!attribute [rw] type_id
9735
+ # A value that indicates the type of recommendation. This value
9736
+ # determines how the description is rendered.
9737
+ # @return [String]
9738
+ #
9739
+ # @!attribute [rw] severity
9740
+ # The severity level of the recommendation. The severity level can
9741
+ # help you decide the urgency with which to address the
9742
+ # recommendation.
9743
+ #
9744
+ # Valid values:
9745
+ #
9746
+ # * `high`
9747
+ #
9748
+ # * `medium`
9749
+ #
9750
+ # * `low`
9751
+ #
9752
+ # * `informational`
9753
+ # @return [String]
9754
+ #
9755
+ # @!attribute [rw] resource_arn
9756
+ # The Amazon Resource Name (ARN) of the RDS resource associated with
9757
+ # the recommendation.
9758
+ # @return [String]
9759
+ #
9760
+ # @!attribute [rw] status
9761
+ # The current status of the recommendation.
9762
+ #
9763
+ # Valid values:
9764
+ #
9765
+ # * `active` - The recommendations which are ready for you to apply.
9766
+ #
9767
+ # * `pending` - The applied or scheduled recommendations which are in
9768
+ # progress.
9769
+ #
9770
+ # * `resolved` - The recommendations which are completed.
9771
+ #
9772
+ # * `dismissed` - The recommendations that you dismissed.
9773
+ # @return [String]
9774
+ #
9775
+ # @!attribute [rw] created_time
9776
+ # The time when the recommendation was created. For example,
9777
+ # `2023-09-28T01:13:53.931000+00:00`.
9778
+ # @return [Time]
9779
+ #
9780
+ # @!attribute [rw] updated_time
9781
+ # The time when the recommendation was last updated.
9782
+ # @return [Time]
9783
+ #
9784
+ # @!attribute [rw] detection
9785
+ # A short description of the issue identified for this recommendation.
9786
+ # The description might contain markdown.
9787
+ # @return [String]
9788
+ #
9789
+ # @!attribute [rw] recommendation
9790
+ # A short description of the recommendation to resolve an issue. The
9791
+ # description might contain markdown.
9792
+ # @return [String]
9793
+ #
9794
+ # @!attribute [rw] description
9795
+ # A detailed description of the recommendation. The description might
9796
+ # contain markdown.
9797
+ # @return [String]
9798
+ #
9799
+ # @!attribute [rw] reason
9800
+ # The reason why this recommendation was created. The information
9801
+ # might contain markdown.
9802
+ # @return [String]
9803
+ #
9804
+ # @!attribute [rw] recommended_actions
9805
+ # A list of recommended actions.
9806
+ # @return [Array<Types::RecommendedAction>]
9807
+ #
9808
+ # @!attribute [rw] category
9809
+ # The category of the recommendation.
9810
+ #
9811
+ # Valid values:
9812
+ #
9813
+ # * `performance efficiency`
9814
+ #
9815
+ # * `security`
9816
+ #
9817
+ # * `reliability`
9818
+ #
9819
+ # * `cost optimization`
9820
+ #
9821
+ # * `operational excellence`
9822
+ #
9823
+ # * `sustainability`
9824
+ # @return [String]
9825
+ #
9826
+ # @!attribute [rw] source
9827
+ # The Amazon Web Services service that generated the recommendations.
9828
+ # @return [String]
9829
+ #
9830
+ # @!attribute [rw] type_detection
9831
+ # A short description of the recommendation type. The description
9832
+ # might contain markdown.
9833
+ # @return [String]
9834
+ #
9835
+ # @!attribute [rw] type_recommendation
9836
+ # A short description that summarizes the recommendation to fix all
9837
+ # the issues of the recommendation type. The description might contain
9838
+ # markdown.
9839
+ # @return [String]
9840
+ #
9841
+ # @!attribute [rw] impact
9842
+ # A short description that explains the possible impact of an issue.
9843
+ # @return [String]
9844
+ #
9845
+ # @!attribute [rw] additional_info
9846
+ # Additional information about the recommendation. The information
9847
+ # might contain markdown.
9848
+ # @return [String]
9849
+ #
9850
+ # @!attribute [rw] links
9851
+ # A link to documentation that provides additional information about
9852
+ # the recommendation.
9853
+ # @return [Array<Types::DocLink>]
9854
+ #
9855
+ # @!attribute [rw] issue_details
9856
+ # Details of the issue that caused the recommendation.
9857
+ # @return [Types::IssueDetails]
9858
+ #
9859
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBRecommendation AWS API Documentation
9860
+ #
9861
+ class DBRecommendation < Struct.new(
9862
+ :recommendation_id,
9863
+ :type_id,
9864
+ :severity,
9865
+ :resource_arn,
9866
+ :status,
9867
+ :created_time,
9868
+ :updated_time,
9869
+ :detection,
9870
+ :recommendation,
9871
+ :description,
9872
+ :reason,
9873
+ :recommended_actions,
9874
+ :category,
9875
+ :source,
9876
+ :type_detection,
9877
+ :type_recommendation,
9878
+ :impact,
9879
+ :additional_info,
9880
+ :links,
9881
+ :issue_details)
9882
+ SENSITIVE = []
9883
+ include Aws::Structure
9884
+ end
9885
+
9886
+ # @!attribute [rw] db_recommendation
9887
+ # The recommendation for your DB instances, DB clusters, and DB
9888
+ # parameter groups.
9889
+ # @return [Types::DBRecommendation]
9890
+ #
9891
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBRecommendationMessage AWS API Documentation
9892
+ #
9893
+ class DBRecommendationMessage < Struct.new(
9894
+ :db_recommendation)
9895
+ SENSITIVE = []
9896
+ include Aws::Structure
9897
+ end
9898
+
9899
+ # @!attribute [rw] db_recommendations
9900
+ # A list of recommendations which is returned from
9901
+ # `DescribeDBRecommendations` API request.
9902
+ # @return [Array<Types::DBRecommendation>]
9903
+ #
9904
+ # @!attribute [rw] marker
9905
+ # An optional pagination token provided by a previous
9906
+ # `DBRecommendationsMessage` request. This token can be used later in
9907
+ # a `DescribeDBRecomendations` request.
9908
+ # @return [String]
9909
+ #
9910
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBRecommendationsMessage AWS API Documentation
9911
+ #
9912
+ class DBRecommendationsMessage < Struct.new(
9913
+ :db_recommendations,
9914
+ :marker)
9915
+ SENSITIVE = []
9916
+ include Aws::Structure
9917
+ end
9918
+
9702
9919
  # Contains the details for an Amazon RDS DB security group.
9703
9920
  #
9704
9921
  # This data type is used as a response element in the
@@ -12528,6 +12745,133 @@ module Aws::RDS
12528
12745
  include Aws::Structure
12529
12746
  end
12530
12747
 
12748
+ # @!attribute [rw] last_updated_after
12749
+ # A filter to include only the recommendations that were updated after
12750
+ # this specified time.
12751
+ # @return [Time]
12752
+ #
12753
+ # @!attribute [rw] last_updated_before
12754
+ # A filter to include only the recommendations that were updated
12755
+ # before this specified time.
12756
+ # @return [Time]
12757
+ #
12758
+ # @!attribute [rw] locale
12759
+ # The language that you choose to return the list of recommendations.
12760
+ #
12761
+ # Valid values:
12762
+ #
12763
+ # * `en`
12764
+ #
12765
+ # * `en_UK`
12766
+ #
12767
+ # * `de`
12768
+ #
12769
+ # * `es`
12770
+ #
12771
+ # * `fr`
12772
+ #
12773
+ # * `id`
12774
+ #
12775
+ # * `it`
12776
+ #
12777
+ # * `ja`
12778
+ #
12779
+ # * `ko`
12780
+ #
12781
+ # * `pt_BR`
12782
+ #
12783
+ # * `zh_TW`
12784
+ #
12785
+ # * `zh_CN`
12786
+ # @return [String]
12787
+ #
12788
+ # @!attribute [rw] filters
12789
+ # A filter that specifies one or more recommendations to describe.
12790
+ #
12791
+ # Supported Filters:
12792
+ #
12793
+ # * `recommendation-id` - Accepts a list of recommendation
12794
+ # identifiers. The results list only includes the recommendations
12795
+ # whose identifier is one of the specified filter values.
12796
+ #
12797
+ # * `status` - Accepts a list of recommendation statuses.
12798
+ #
12799
+ # Valid values:
12800
+ #
12801
+ # * `active` - The recommendations which are ready for you to apply.
12802
+ #
12803
+ # * `pending` - The applied or scheduled recommendations which are
12804
+ # in progress.
12805
+ #
12806
+ # * `resolved` - The recommendations which are completed.
12807
+ #
12808
+ # * `dismissed` - The recommendations that you dismissed.
12809
+ #
12810
+ # The results list only includes the recommendations whose status is
12811
+ # one of the specified filter values.
12812
+ #
12813
+ # * `severity` - Accepts a list of recommendation severities. The
12814
+ # results list only includes the recommendations whose severity is
12815
+ # one of the specified filter values.
12816
+ #
12817
+ # Valid values:
12818
+ #
12819
+ # * `high`
12820
+ #
12821
+ # * `medium`
12822
+ #
12823
+ # * `low`
12824
+ #
12825
+ # * `informational`
12826
+ #
12827
+ # * `type-id` - Accepts a list of recommendation type identifiers. The
12828
+ # results list only includes the recommendations whose type is one
12829
+ # of the specified filter values.
12830
+ #
12831
+ # * `dbi-resource-id` - Accepts a list of database resource
12832
+ # identifiers. The results list only includes the recommendations
12833
+ # that generated for the specified databases.
12834
+ #
12835
+ # * `cluster-resource-id` - Accepts a list of cluster resource
12836
+ # identifiers. The results list only includes the recommendations
12837
+ # that generated for the specified clusters.
12838
+ #
12839
+ # * `pg-arn` - Accepts a list of parameter group ARNs. The results
12840
+ # list only includes the recommendations that generated for the
12841
+ # specified parameter groups.
12842
+ #
12843
+ # * `cluster-pg-arn` - Accepts a list of cluster parameter group ARNs.
12844
+ # The results list only includes the recommendations that generated
12845
+ # for the specified cluster parameter groups.
12846
+ # @return [Array<Types::Filter>]
12847
+ #
12848
+ # @!attribute [rw] max_records
12849
+ # The maximum number of recommendations to include in the response. If
12850
+ # more records exist than the specified `MaxRecords` value, a
12851
+ # pagination token called a marker is included in the response so that
12852
+ # you can retrieve the remaining results.
12853
+ # @return [Integer]
12854
+ #
12855
+ # @!attribute [rw] marker
12856
+ # An optional pagination token provided by a previous
12857
+ # `DescribeDBRecommendations` request. If this parameter is specified,
12858
+ # the response includes only records beyond the marker, up to the
12859
+ # value specified by `MaxRecords`.
12860
+ # @return [String]
12861
+ #
12862
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBRecommendationsMessage AWS API Documentation
12863
+ #
12864
+ class DescribeDBRecommendationsMessage < Struct.new(
12865
+ :last_updated_after,
12866
+ :last_updated_before,
12867
+ :locale,
12868
+ :filters,
12869
+ :max_records,
12870
+ :marker)
12871
+ SENSITIVE = []
12872
+ include Aws::Structure
12873
+ end
12874
+
12531
12875
  # @!attribute [rw] db_security_group_name
12532
12876
  # The name of the DB security group to return details for.
12533
12877
  # @return [String]
@@ -14031,6 +14375,56 @@ module Aws::RDS
14031
14375
  include Aws::Structure
14032
14376
  end
14033
14377
 
14378
+ # @!attribute [rw] resource_arn
14379
+ # The Amazon Resource Name (ARN) of the DB cluster.
14380
+ # @return [String]
14381
+ #
14382
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DisableHttpEndpointRequest AWS API Documentation
14383
+ #
14384
+ class DisableHttpEndpointRequest < Struct.new(
14385
+ :resource_arn)
14386
+ SENSITIVE = []
14387
+ include Aws::Structure
14388
+ end
14389
+
14390
+ # @!attribute [rw] resource_arn
14391
+ # The ARN of the DB cluster.
14392
+ # @return [String]
14393
+ #
14394
+ # @!attribute [rw] http_endpoint_enabled
14395
+ # Indicates whether the HTTP endpoint is enabled or disabled for the
14396
+ # DB cluster.
14397
+ # @return [Boolean]
14398
+ #
14399
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DisableHttpEndpointResponse AWS API Documentation
14400
+ #
14401
+ class DisableHttpEndpointResponse < Struct.new(
14402
+ :resource_arn,
14403
+ :http_endpoint_enabled)
14404
+ SENSITIVE = []
14405
+ include Aws::Structure
14406
+ end
14407
+
14408
+ # A link to documentation that provides additional information for a
14409
+ # recommendation.
14410
+ #
14411
+ # @!attribute [rw] text
14412
+ # The text with the link to documentation for the recommendation.
14413
+ # @return [String]
14414
+ #
14415
+ # @!attribute [rw] url
14416
+ # The URL for the documentation for the recommendation.
14417
+ # @return [String]
14418
+ #
14419
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DocLink AWS API Documentation
14420
+ #
14421
+ class DocLink < Struct.new(
14422
+ :text,
14423
+ :url)
14424
+ SENSITIVE = []
14425
+ include Aws::Structure
14426
+ end
14427
+
14034
14428
  # An Active Directory Domain membership record associated with the DB
14035
14429
  # instance or cluster.
14036
14430
  #
@@ -14237,6 +14631,36 @@ module Aws::RDS
14237
14631
  #
14238
14632
  class Ec2ImagePropertiesNotSupportedFault < Aws::EmptyStructure; end
14239
14633
 
14634
+ # @!attribute [rw] resource_arn
14635
+ # The Amazon Resource Name (ARN) of the DB cluster.
14636
+ # @return [String]
14637
+ #
14638
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/EnableHttpEndpointRequest AWS API Documentation
14639
+ #
14640
+ class EnableHttpEndpointRequest < Struct.new(
14641
+ :resource_arn)
14642
+ SENSITIVE = []
14643
+ include Aws::Structure
14644
+ end
14645
+
14646
+ # @!attribute [rw] resource_arn
14647
+ # The ARN of the DB cluster.
14648
+ # @return [String]
14649
+ #
14650
+ # @!attribute [rw] http_endpoint_enabled
14651
+ # Indicates whether the HTTP endpoint is enabled or disabled for the
14652
+ # DB cluster.
14653
+ # @return [Boolean]
14654
+ #
14655
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/EnableHttpEndpointResponse AWS API Documentation
14656
+ #
14657
+ class EnableHttpEndpointResponse < Struct.new(
14658
+ :resource_arn,
14659
+ :http_endpoint_enabled)
14660
+ SENSITIVE = []
14661
+ include Aws::Structure
14662
+ end
14663
+
14240
14664
  # This data type represents the information you need to connect to an
14241
14665
  # Amazon RDS DB instance. This data type is used as a response element
14242
14666
  # in the following actions:
@@ -14883,6 +15307,8 @@ module Aws::RDS
14883
15307
  #
14884
15308
  # * `DescribeDBInstances`
14885
15309
  #
15310
+ # * `DescribeDBRecommendations`
15311
+ #
14886
15312
  # * `DescribePendingMaintenanceActions`
14887
15313
  #
14888
15314
  # @!attribute [rw] name
@@ -15411,6 +15837,13 @@ module Aws::RDS
15411
15837
  #
15412
15838
  class InvalidOptionGroupStateFault < Aws::EmptyStructure; end
15413
15839
 
15840
+ # The operation can't be performed because another operation is in
15841
+ # progress.
15842
+ #
15843
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/InvalidResourceStateFault AWS API Documentation
15844
+ #
15845
+ class InvalidResourceStateFault < Aws::EmptyStructure; end
15846
+
15414
15847
  # Cannot restore from VPC backup to non-VPC DB instance.
15415
15848
  #
15416
15849
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/InvalidRestoreFault AWS API Documentation
@@ -15440,6 +15873,22 @@ module Aws::RDS
15440
15873
  #
15441
15874
  class InvalidVPCNetworkStateFault < Aws::EmptyStructure; end
15442
15875
 
15876
+ # The details of an issue with your DB instances, DB clusters, and DB
15877
+ # parameter groups.
15878
+ #
15879
+ # @!attribute [rw] performance_issue_details
15880
+ # A detailed description of the issue when the recommendation category
15881
+ # is `performance`.
15882
+ # @return [Types::PerformanceIssueDetails]
15883
+ #
15884
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/IssueDetails AWS API Documentation
15885
+ #
15886
+ class IssueDetails < Struct.new(
15887
+ :performance_issue_details)
15888
+ SENSITIVE = []
15889
+ include Aws::Structure
15890
+ end
15891
+
15443
15892
  # An error occurred accessing an Amazon Web Services KMS key.
15444
15893
  #
15445
15894
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/KMSKeyNotAccessibleFault AWS API Documentation
@@ -15525,6 +15974,70 @@ module Aws::RDS
15525
15974
  include Aws::Structure
15526
15975
  end
15527
15976
 
15977
+ # The representation of a metric.
15978
+ #
15979
+ # @!attribute [rw] name
15980
+ # The name of a metric.
15981
+ # @return [String]
15982
+ #
15983
+ # @!attribute [rw] references
15984
+ # A list of metric references (thresholds).
15985
+ # @return [Array<Types::MetricReference>]
15986
+ #
15987
+ # @!attribute [rw] statistics_details
15988
+ # The details of different statistics for a metric. The description
15989
+ # might contain markdown.
15990
+ # @return [String]
15991
+ #
15992
+ # @!attribute [rw] metric_query
15993
+ # The query to retrieve metric data points.
15994
+ # @return [Types::MetricQuery]
15995
+ #
15996
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/Metric AWS API Documentation
15997
+ #
15998
+ class Metric < Struct.new(
15999
+ :name,
16000
+ :references,
16001
+ :statistics_details,
16002
+ :metric_query)
16003
+ SENSITIVE = []
16004
+ include Aws::Structure
16005
+ end
16006
+
16007
+ # The query to retrieve metric data points.
16008
+ #
16009
+ # @!attribute [rw] performance_insights_metric_query
16010
+ # The Performance Insights query that you can use to retrieve
16011
+ # Performance Insights metric data points.
16012
+ # @return [Types::PerformanceInsightsMetricQuery]
16013
+ #
16014
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/MetricQuery AWS API Documentation
16015
+ #
16016
+ class MetricQuery < Struct.new(
16017
+ :performance_insights_metric_query)
16018
+ SENSITIVE = []
16019
+ include Aws::Structure
16020
+ end
16021
+
16022
+ # The reference (threshold) for a metric.
16023
+ #
16024
+ # @!attribute [rw] name
16025
+ # The name of the metric reference.
16026
+ # @return [String]
16027
+ #
16028
+ # @!attribute [rw] reference_details
16029
+ # The details of a performance issue.
16030
+ # @return [Types::ReferenceDetails]
16031
+ #
16032
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/MetricReference AWS API Documentation
16033
+ #
16034
+ class MetricReference < Struct.new(
16035
+ :name,
16036
+ :reference_details)
16037
+ SENSITIVE = []
16038
+ include Aws::Structure
16039
+ end
16040
+
15528
16041
  # The minimum DB engine version required for each corresponding allowed
15529
16042
  # value for an option setting.
15530
16043
  #
@@ -16127,15 +16640,23 @@ module Aws::RDS
16127
16640
  #
16128
16641
  # @!attribute [rw] enable_http_endpoint
16129
16642
  # Specifies whether to enable the HTTP endpoint for an Aurora
16130
- # Serverless v1 DB cluster. By default, the HTTP endpoint is disabled.
16643
+ # Serverless v1 DB cluster. By default, the HTTP endpoint isn't
16644
+ # enabled.
16131
16645
  #
16132
16646
  # When enabled, the HTTP endpoint provides a connectionless web
16133
- # service API for running SQL queries on the Aurora Serverless v1 DB
16134
- # cluster. You can also query your database from inside the RDS
16135
- # console with the query editor.
16647
+ # service API (RDS Data API) for running SQL queries on the Aurora
16648
+ # Serverless v1 DB cluster. You can also query your database from
16649
+ # inside the RDS console with the RDS query editor.
16650
+ #
16651
+ # For more information, see [Using RDS Data API][1] in the *Amazon
16652
+ # Aurora User Guide*.
16136
16653
  #
16137
- # For more information, see [Using the Data API for Aurora Serverless
16138
- # v1][1] in the *Amazon Aurora User Guide*.
16654
+ # <note markdown="1"> This parameter applies only to Aurora Serverless v1 DB clusters. To
16655
+ # enable or disable the HTTP endpoint for an Aurora PostgreSQL
16656
+ # Serverless v2 or provisioned DB cluster, use the
16657
+ # `EnableHttpEndpoint` and `DisableHttpEndpoint` operations.
16658
+ #
16659
+ # </note>
16139
16660
  #
16140
16661
  # Valid for Cluster Type: Aurora DB clusters only
16141
16662
  #
@@ -18137,6 +18658,40 @@ module Aws::RDS
18137
18658
  include Aws::Structure
18138
18659
  end
18139
18660
 
18661
+ # @!attribute [rw] recommendation_id
18662
+ # The identifier of the recommendation to update.
18663
+ # @return [String]
18664
+ #
18665
+ # @!attribute [rw] locale
18666
+ # The language of the modified recommendation.
18667
+ # @return [String]
18668
+ #
18669
+ # @!attribute [rw] status
18670
+ # The recommendation status to update.
18671
+ #
18672
+ # Valid values:
18673
+ #
18674
+ # * active
18675
+ #
18676
+ # * dismissed
18677
+ # @return [String]
18678
+ #
18679
+ # @!attribute [rw] recommended_action_updates
18680
+ # The list of recommended action status to update. You can update
18681
+ # multiple recommended actions at one time.
18682
+ # @return [Array<Types::RecommendedActionUpdate>]
18683
+ #
18684
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBRecommendationMessage AWS API Documentation
18685
+ #
18686
+ class ModifyDBRecommendationMessage < Struct.new(
18687
+ :recommendation_id,
18688
+ :locale,
18689
+ :status,
18690
+ :recommended_action_updates)
18691
+ SENSITIVE = []
18692
+ include Aws::Structure
18693
+ end
18694
+
18140
18695
  # @!attribute [rw] db_snapshot_identifier
18141
18696
  # The identifier for the DB snapshot to modify the attributes for.
18142
18697
  # @return [String]
@@ -19701,6 +20256,141 @@ module Aws::RDS
19701
20256
  include Aws::Structure
19702
20257
  end
19703
20258
 
20259
+ # A logical grouping of Performance Insights metrics for a related
20260
+ # subject area. For example, the `db.sql` dimension group consists of
20261
+ # the following dimensions:
20262
+ #
20263
+ # * `db.sql.id` - The hash of a running SQL statement, generated by
20264
+ # Performance Insights.
20265
+ #
20266
+ # * `db.sql.db_id` - Either the SQL ID generated by the database engine,
20267
+ # or a value generated by Performance Insights that begins with `pi-`.
20268
+ #
20269
+ # * `db.sql.statement` - The full text of the SQL statement that is
20270
+ # running, for example, `SELECT * FROM employees`.
20271
+ #
20272
+ # * `db.sql_tokenized.id` - The hash of the SQL digest generated by
20273
+ # Performance Insights.
20274
+ #
20275
+ # <note markdown="1"> Each response element returns a maximum of 500 bytes. For larger
20276
+ # elements, such as SQL statements, only the first 500 bytes are
20277
+ # returned.
20278
+ #
20279
+ # </note>
20280
+ #
20281
+ # @!attribute [rw] dimensions
20282
+ # A list of specific dimensions from a dimension group. If this list
20283
+ # isn't included, then all of the dimensions in the group were
20284
+ # requested, or are present in the response.
20285
+ # @return [Array<String>]
20286
+ #
20287
+ # @!attribute [rw] group
20288
+ # The available dimension groups for Performance Insights metric type.
20289
+ # @return [String]
20290
+ #
20291
+ # @!attribute [rw] limit
20292
+ # The maximum number of items to fetch for this dimension group.
20293
+ # @return [Integer]
20294
+ #
20295
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PerformanceInsightsMetricDimensionGroup AWS API Documentation
20296
+ #
20297
+ class PerformanceInsightsMetricDimensionGroup < Struct.new(
20298
+ :dimensions,
20299
+ :group,
20300
+ :limit)
20301
+ SENSITIVE = []
20302
+ include Aws::Structure
20303
+ end
20304
+
20305
+ # A single Performance Insights metric query to process. You must
20306
+ # provide the metric to the query. If other parameters aren't
20307
+ # specified, Performance Insights returns all data points for the
20308
+ # specified metric. Optionally, you can request the data points to be
20309
+ # aggregated by dimension group (`GroupBy`) and return only those data
20310
+ # points that match your criteria (`Filter`).
20311
+ #
20312
+ # Constraints:
20313
+ #
20314
+ # * Must be a valid Performance Insights query.
20315
+ #
20316
+ # ^
20317
+ #
20318
+ # @!attribute [rw] group_by
20319
+ # A specification for how to aggregate the data points from a query
20320
+ # result. You must specify a valid dimension group. Performance
20321
+ # Insights will return all of the dimensions within that group, unless
20322
+ # you provide the names of specific dimensions within that group. You
20323
+ # can also request that Performance Insights return a limited number
20324
+ # of values for a dimension.
20325
+ # @return [Types::PerformanceInsightsMetricDimensionGroup]
20326
+ #
20327
+ # @!attribute [rw] metric
20328
+ # The name of a Performance Insights metric to be measured.
20329
+ #
20330
+ # Valid Values:
20331
+ #
20332
+ # * `db.load.avg` - A scaled representation of the number of active
20333
+ # sessions for the database engine.
20334
+ #
20335
+ # * `db.sampledload.avg` - The raw number of active sessions for the
20336
+ # database engine.
20337
+ #
20338
+ # * The counter metrics listed in [Performance Insights operating
20339
+ # system counters][1] in the *Amazon Aurora User Guide*.
20340
+ #
20341
+ # If the number of active sessions is less than an internal
20342
+ # Performance Insights threshold, `db.load.avg` and
20343
+ # `db.sampledload.avg` are the same value. If the number of active
20344
+ # sessions is greater than the internal threshold, Performance
20345
+ # Insights samples the active sessions, with `db.load.avg` showing the
20346
+ # scaled values, `db.sampledload.avg` showing the raw values, and
20347
+ # `db.sampledload.avg` less than `db.load.avg`. For most use cases,
20348
+ # you can query `db.load.avg` only.
20349
+ #
20350
+ #
20351
+ #
20352
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights_Counters.html#USER_PerfInsights_Counters.OS
20353
+ # @return [String]
20354
+ #
20355
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PerformanceInsightsMetricQuery AWS API Documentation
20356
+ #
20357
+ class PerformanceInsightsMetricQuery < Struct.new(
20358
+ :group_by,
20359
+ :metric)
20360
+ SENSITIVE = []
20361
+ include Aws::Structure
20362
+ end
20363
+
20364
+ # Details of the performance issue.
20365
+ #
20366
+ # @!attribute [rw] start_time
20367
+ # The time when the performance issue started.
20368
+ # @return [Time]
20369
+ #
20370
+ # @!attribute [rw] end_time
20371
+ # The time when the performance issue stopped.
20372
+ # @return [Time]
20373
+ #
20374
+ # @!attribute [rw] metrics
20375
+ # The metrics that are relevant to the performance issue.
20376
+ # @return [Array<Types::Metric>]
20377
+ #
20378
+ # @!attribute [rw] analysis
20379
+ # The analysis of the performance issue. The information might contain
20380
+ # markdown.
20381
+ # @return [String]
20382
+ #
20383
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PerformanceIssueDetails AWS API Documentation
20384
+ #
20385
+ class PerformanceIssueDetails < Struct.new(
20386
+ :start_time,
20387
+ :end_time,
20388
+ :metrics,
20389
+ :analysis)
20390
+ SENSITIVE = []
20391
+ include Aws::Structure
20392
+ end
20393
+
19704
20394
  # `SourceDBInstanceIdentifier` refers to a DB instance with
19705
20395
  # `BackupRetentionPeriod` equal to 0.
19706
20396
  #
@@ -20135,6 +20825,127 @@ module Aws::RDS
20135
20825
  include Aws::Structure
20136
20826
  end
20137
20827
 
20828
+ # The recommended actions to apply to resolve the issues associated with
20829
+ # your DB instances, DB clusters, and DB parameter groups.
20830
+ #
20831
+ # @!attribute [rw] action_id
20832
+ # The unique identifier of the recommended action.
20833
+ # @return [String]
20834
+ #
20835
+ # @!attribute [rw] title
20836
+ # A short description to summarize the action. The description might
20837
+ # contain markdown.
20838
+ # @return [String]
20839
+ #
20840
+ # @!attribute [rw] description
20841
+ # A detailed description of the action. The description might contain
20842
+ # markdown.
20843
+ # @return [String]
20844
+ #
20845
+ # @!attribute [rw] operation
20846
+ # An API operation for the action.
20847
+ # @return [String]
20848
+ #
20849
+ # @!attribute [rw] parameters
20850
+ # The parameters for the API operation.
20851
+ # @return [Array<Types::RecommendedActionParameter>]
20852
+ #
20853
+ # @!attribute [rw] apply_modes
20854
+ # The methods to apply the recommended action.
20855
+ #
20856
+ # Valid values:
20857
+ #
20858
+ # * `manual` - The action requires you to resolve the recommendation
20859
+ # manually.
20860
+ #
20861
+ # * `immediately` - The action is applied immediately.
20862
+ #
20863
+ # * `next-maintainance-window` - The action is applied during the next
20864
+ # scheduled maintainance.
20865
+ # @return [Array<String>]
20866
+ #
20867
+ # @!attribute [rw] status
20868
+ # The status of the action.
20869
+ #
20870
+ # * `ready`
20871
+ #
20872
+ # * `applied`
20873
+ #
20874
+ # * `scheduled`
20875
+ #
20876
+ # * `resolved`
20877
+ # @return [String]
20878
+ #
20879
+ # @!attribute [rw] issue_details
20880
+ # The details of the issue.
20881
+ # @return [Types::IssueDetails]
20882
+ #
20883
+ # @!attribute [rw] context_attributes
20884
+ # The supporting attributes to explain the recommended action.
20885
+ # @return [Array<Types::ContextAttribute>]
20886
+ #
20887
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RecommendedAction AWS API Documentation
20888
+ #
20889
+ class RecommendedAction < Struct.new(
20890
+ :action_id,
20891
+ :title,
20892
+ :description,
20893
+ :operation,
20894
+ :parameters,
20895
+ :apply_modes,
20896
+ :status,
20897
+ :issue_details,
20898
+ :context_attributes)
20899
+ SENSITIVE = []
20900
+ include Aws::Structure
20901
+ end
20902
+
20903
+ # A single parameter to use with the `RecommendedAction` API operation
20904
+ # to apply the action.
20905
+ #
20906
+ # @!attribute [rw] key
20907
+ # The key of the parameter to use with the `RecommendedAction` API
20908
+ # operation.
20909
+ # @return [String]
20910
+ #
20911
+ # @!attribute [rw] value
20912
+ # The value of the parameter to use with the `RecommendedAction` API
20913
+ # operation.
20914
+ # @return [String]
20915
+ #
20916
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RecommendedActionParameter AWS API Documentation
20917
+ #
20918
+ class RecommendedActionParameter < Struct.new(
20919
+ :key,
20920
+ :value)
20921
+ SENSITIVE = []
20922
+ include Aws::Structure
20923
+ end
20924
+
20925
+ # The recommended status to update for the specified recommendation
20926
+ # action ID.
20927
+ #
20928
+ # @!attribute [rw] action_id
20929
+ # A unique identifier of the updated recommendation action.
20930
+ # @return [String]
20931
+ #
20932
+ # @!attribute [rw] status
20933
+ # The status of the updated recommendation action.
20934
+ #
20935
+ # * `applied`
20936
+ #
20937
+ # * `scheduled`
20938
+ # @return [String]
20939
+ #
20940
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RecommendedActionUpdate AWS API Documentation
20941
+ #
20942
+ class RecommendedActionUpdate < Struct.new(
20943
+ :action_id,
20944
+ :status)
20945
+ SENSITIVE = []
20946
+ include Aws::Structure
20947
+ end
20948
+
20138
20949
  # This data type is used as a response element in the
20139
20950
  # `DescribeReservedDBInstances` and
20140
20951
  # `DescribeReservedDBInstancesOfferings` actions.
@@ -20156,6 +20967,20 @@ module Aws::RDS
20156
20967
  include Aws::Structure
20157
20968
  end
20158
20969
 
20970
+ # The reference details of a metric.
20971
+ #
20972
+ # @!attribute [rw] scalar_reference_details
20973
+ # The metric reference details when the reference is a scalar.
20974
+ # @return [Types::ScalarReferenceDetails]
20975
+ #
20976
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ReferenceDetails AWS API Documentation
20977
+ #
20978
+ class ReferenceDetails < Struct.new(
20979
+ :scalar_reference_details)
20980
+ SENSITIVE = []
20981
+ include Aws::Structure
20982
+ end
20983
+
20159
20984
  # @!attribute [rw] db_proxy_name
20160
20985
  # The identifier of the `DBProxy` that is associated with the
20161
20986
  # `DBProxyTargetGroup`.
@@ -24168,6 +24993,20 @@ module Aws::RDS
24168
24993
  #
24169
24994
  class SNSTopicArnNotFoundFault < Aws::EmptyStructure; end
24170
24995
 
24996
+ # The metric reference details when the reference is a scalar.
24997
+ #
24998
+ # @!attribute [rw] value
24999
+ # The value of a scalar reference.
25000
+ # @return [Float]
25001
+ #
25002
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ScalarReferenceDetails AWS API Documentation
25003
+ #
25004
+ class ScalarReferenceDetails < Struct.new(
25005
+ :value)
25006
+ SENSITIVE = []
25007
+ include Aws::Structure
25008
+ end
25009
+
24171
25010
  # Contains the scaling configuration of an Aurora Serverless v1 DB
24172
25011
  # cluster.
24173
25012
  #