aws-sdk-rds 1.209.0 → 1.211.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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
  #