aws-sdk-pi 1.35.0 → 1.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9573ecce16a0e206aff0e9ab5b1dca6d254e23786cb2cee4aa6c2413d78e9e77
-  data.tar.gz: f904eb04a29a62622636aebb11ae98d2239216043a232ccbb4cd942e89645ea3
+  metadata.gz: 4416004eafc05fb5fc789b176493e9c2a5e9d9731449e574b4004634cd255d47
+  data.tar.gz: 2eb9e832146adee0784edccfa67460f8ba0922ecef7f8f38288a4a488d4d051b
 SHA512:
-  metadata.gz: f2fba31f68e24be0252b6a6f08a9e369615dc975abf301d66bc31bbd5dc3cb9819c036467373e02e06b6b91a2a8ecacb830b11e3f145cbb901220247bb19f182
-  data.tar.gz: d7e5f4b50b050f6b832213d05b7d54f95bc2747cc7c075363a7c7afa0756d59462b3487224d91857be54ab06678c5cac3cca9481c69edf87ce0963ee42a372fc
+  metadata.gz: 74f1718a960b67323c1ee667864c4b53a44618028268bccb983da1226392147757dadbb4bcba140a7dfafc56fa138ffae21c077e5d2fa3ecca3eb415deb7a606
+  data.tar.gz: 03740cf2f8b61731d39bcf627d6d45b5d9a73eaa60ccfbb2c7a905a3e985ca9d00cfbc4c6376ded968ce10efc79f61b17d07fa57d856b8ee6f8933d190dc5af4

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.38.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.37.0 (2022-02-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.36.0 (2022-01-12)
+------------------
+
+* Feature - This release adds three Performance Insights APIs. Use ListAvailableResourceMetrics to get available metrics, GetResourceMetadata to get feature metadata, and ListAvailableResourceDimensions to list available dimensions. The AdditionalMetrics field in DescribeDimensionKeys retrieves per-SQL metrics.
+
 1.35.0 (2021-12-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.35.0
+1.38.0

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

@@ -27,7 +27,9 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -74,7 +76,9 @@ module Aws::PI
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -367,16 +371,16 @@ module Aws::PI
     #  </note>
     #
     # @option params [required, String] :service_type
-    #   The AWS service for which Performance Insights will return metrics.
-    #   The only valid value for *ServiceType* is `RDS`.
+    #   The Amazon Web Services service for which Performance Insights will
+    #   return metrics. The only valid value for *ServiceType* is `RDS`.
     #
     # @option params [required, String] :identifier
-    #   An immutable, AWS Region-unique identifier for a data source.
-    #   Performance Insights gathers metrics from this data source.
+    #   An immutable, Amazon Web Services Region-unique identifier for a data
+    #   source. Performance Insights gathers metrics from this data source.
     #
     #   To use an Amazon RDS instance as a data source, you specify its
     #   `DbiResourceId` value. For example, specify
-    #   `db-FAIHNTYBKTGAUSUZQYPDS2GW4A`
+    #   `db-FAIHNTYBKTGAUSUZQYPDS2GW4A`.
     #
     # @option params [required, Time,DateTime,Date,Integer,String] :start_time
     #   The date and time specifying the beginning of the requested time
@@ -440,6 +444,13 @@ module Aws::PI
     #   Performance Insights return a limited number of values for a
     #   dimension.
     #
+    # @option params [Array<String>] :additional_metrics
+    #   Additional metrics for the top `N` dimension keys. If the specified
+    #   dimension group in the `GroupBy` parameter is `db.sql_tokenized`, you
+    #   can specify per-SQL metrics to get the values for the top `N` SQL
+    #   digests. The response syntax is `"AdditionalMetrics" : \{ "string" :
+    #   "string" \}`.
+    #
     # @option params [Types::DimensionGroup] :partition_by
     #   For each dimension specified in `GroupBy`, specify a secondary
     #   dimension to further subdivide the partition keys in the response.
@@ -471,10 +482,12 @@ module Aws::PI
     #   * {Types::DescribeDimensionKeysResponse#keys #keys} => Array&lt;Types::DimensionKeyDescription&gt;
     #   * {Types::DescribeDimensionKeysResponse#next_token #next_token} => 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.describe_dimension_keys({
-    #     service_type: "RDS", # required, accepts RDS
+    #     service_type: "RDS", # required, accepts RDS, DOCDB
     #     identifier: "RequestString", # required
     #     start_time: Time.now, # required
     #     end_time: Time.now, # required
@@ -485,6 +498,7 @@ module Aws::PI
     #       dimensions: ["RequestString"],
     #       limit: 1,
     #     },
+    #     additional_metrics: ["RequestString"],
     #     partition_by: {
     #       group: "RequestString", # required
     #       dimensions: ["RequestString"],
@@ -508,6 +522,8 @@ module Aws::PI
     #   resp.keys[0].dimensions #=> Hash
     #   resp.keys[0].dimensions["RequestString"] #=> String
     #   resp.keys[0].total #=> Float
+    #   resp.keys[0].additional_metrics #=> Hash
+    #   resp.keys[0].additional_metrics["RequestString"] #=> Float
     #   resp.keys[0].partitions #=> Array
     #   resp.keys[0].partitions[0] #=> Float
     #   resp.next_token #=> String
@@ -524,19 +540,19 @@ module Aws::PI
     # Get the attributes of the specified dimension group for a DB instance
     # or data source. For example, if you specify a SQL ID,
     # `GetDimensionKeyDetails` retrieves the full text of the dimension
-    # `db.sql.statement` associated with this ID. This operation is useful
+    # `db.sql.statement`cassociated with this ID. This operation is useful
     # because `GetResourceMetrics` and `DescribeDimensionKeys` don't
     # support retrieval of large SQL statement text.
     #
     # @option params [required, String] :service_type
-    #   The AWS service for which Performance Insights returns data. The only
-    #   valid value is `RDS`.
+    #   The Amazon Web Services service for which Performance Insights returns
+    #   data. The only valid value is `RDS`.
     #
     # @option params [required, String] :identifier
     #   The ID for a data source from which to gather dimension data. This ID
-    #   must be immutable and unique within an AWS Region. When a DB instance
-    #   is the data source, specify its `DbiResourceId` value. For example,
-    #   specify `db-ABCDEFGHIJKLMNOPQRSTU1VW2X`.
+    #   must be immutable and unique within an Amazon Web Services Region.
+    #   When a DB instance is the data source, specify its `DbiResourceId`
+    #   value. For example, specify `db-ABCDEFGHIJKLMNOPQRSTU1VW2X`.
     #
     # @option params [required, String] :group
     #   The name of the dimension group. The only valid value is `db.sql`.
@@ -562,7 +578,7 @@ module Aws::PI
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_dimension_key_details({
-    #     service_type: "RDS", # required, accepts RDS
+    #     service_type: "RDS", # required, accepts RDS, DOCDB
     #     identifier: "IdentifierString", # required
     #     group: "RequestString", # required
     #     group_identifier: "RequestString", # required
@@ -585,6 +601,48 @@ module Aws::PI
       req.send_request(options)
     end
 
+    # Retrieve the metadata for different features. For example, the
+    # metadata might indicate that a feature is turned on or off on a
+    # specific DB instance.
+    #
+    # @option params [required, String] :service_type
+    #   The Amazon Web Services service for which Performance Insights returns
+    #   metrics.
+    #
+    # @option params [required, String] :identifier
+    #   An immutable identifier for a data source that is unique for an Amazon
+    #   Web Services Region. Performance Insights gathers metrics from this
+    #   data source. To use a DB instance as a data source, specify its
+    #   `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VW2X`.
+    #
+    # @return [Types::GetResourceMetadataResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetResourceMetadataResponse#identifier #identifier} => String
+    #   * {Types::GetResourceMetadataResponse#features #features} => Hash&lt;String,Types::FeatureMetadata&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_resource_metadata({
+    #     service_type: "RDS", # required, accepts RDS, DOCDB
+    #     identifier: "RequestString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.identifier #=> String
+    #   resp.features #=> Hash
+    #   resp.features["String"].status #=> String, one of "ENABLED", "DISABLED", "UNSUPPORTED", "ENABLED_PENDING_REBOOT", "DISABLED_PENDING_REBOOT", "UNKNOWN"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetResourceMetadata AWS API Documentation
+    #
+    # @overload get_resource_metadata(params = {})
+    # @param [Hash] params ({})
+    def get_resource_metadata(params = {}, options = {})
+      req = build_request(:get_resource_metadata, params)
+      req.send_request(options)
+    end
+
     # Retrieve Performance Insights metrics for a set of data sources, over
     # a time period. You can provide specific dimension groups and
     # dimensions, and provide aggregation and filtering criteria for each
@@ -597,12 +655,12 @@ module Aws::PI
     #  </note>
     #
     # @option params [required, String] :service_type
-    #   The AWS service for which Performance Insights returns metrics. The
-    #   only valid value for *ServiceType* is `RDS`.
+    #   The Amazon Web Services service for which Performance Insights returns
+    #   metrics. The only valid value for *ServiceType* is `RDS`.
     #
     # @option params [required, String] :identifier
-    #   An immutable, AWS Region-unique identifier for a data source.
-    #   Performance Insights gathers metrics from this data source.
+    #   An immutable, Amazon Web Services Region-unique identifier for a data
+    #   source. Performance Insights gathers metrics from this data source.
     #
     #   To use a DB instance as a data source, specify its `DbiResourceId`
     #   value. For example, specify `db-FAIHNTYBKTGAUSUZQYPDS2GW4A`.
@@ -666,10 +724,12 @@ module Aws::PI
     #   * {Types::GetResourceMetricsResponse#metric_list #metric_list} => Array&lt;Types::MetricKeyDataPoints&gt;
     #   * {Types::GetResourceMetricsResponse#next_token #next_token} => 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.get_resource_metrics({
-    #     service_type: "RDS", # required, accepts RDS
+    #     service_type: "RDS", # required, accepts RDS, DOCDB
     #     identifier: "RequestString", # required
     #     metric_queries: [ # required
     #       {
@@ -714,6 +774,141 @@ module Aws::PI
       req.send_request(options)
     end
 
+    # Retrieve the dimensions that can be queried for each specified metric
+    # type on a specified DB instance.
+    #
+    # @option params [required, String] :service_type
+    #   The Amazon Web Services service for which Performance Insights returns
+    #   metrics.
+    #
+    # @option params [required, String] :identifier
+    #   An immutable identifier for a data source that is unique within an
+    #   Amazon Web Services Region. Performance Insights gathers metrics from
+    #   this data source. To use an Amazon RDS DB instance as a data source,
+    #   specify its `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VWZ`.
+    #
+    # @option params [required, Array<String>] :metrics
+    #   The types of metrics for which to retrieve dimensions. Valid values
+    #   include `db.load`.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of items to return in the response. If more items
+    #   exist than the specified `MaxRecords` value, a pagination token is
+    #   included in the response so that the remaining results can be
+    #   retrieved.
+    #
+    # @option params [String] :next_token
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond the
+    #   token, up to the value specified by `MaxRecords`.
+    #
+    # @return [Types::ListAvailableResourceDimensionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListAvailableResourceDimensionsResponse#metric_dimensions #metric_dimensions} => Array&lt;Types::MetricDimensionGroups&gt;
+    #   * {Types::ListAvailableResourceDimensionsResponse#next_token #next_token} => 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_available_resource_dimensions({
+    #     service_type: "RDS", # required, accepts RDS, DOCDB
+    #     identifier: "RequestString", # required
+    #     metrics: ["RequestString"], # required
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metric_dimensions #=> Array
+    #   resp.metric_dimensions[0].metric #=> String
+    #   resp.metric_dimensions[0].groups #=> Array
+    #   resp.metric_dimensions[0].groups[0].group #=> String
+    #   resp.metric_dimensions[0].groups[0].dimensions #=> Array
+    #   resp.metric_dimensions[0].groups[0].dimensions[0].identifier #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListAvailableResourceDimensions AWS API Documentation
+    #
+    # @overload list_available_resource_dimensions(params = {})
+    # @param [Hash] params ({})
+    def list_available_resource_dimensions(params = {}, options = {})
+      req = build_request(:list_available_resource_dimensions, params)
+      req.send_request(options)
+    end
+
+    # Retrieve metrics of the specified types that can be queried for a
+    # specified DB instance.
+    #
+    # @option params [required, String] :service_type
+    #   The Amazon Web Services service for which Performance Insights returns
+    #   metrics.
+    #
+    # @option params [required, String] :identifier
+    #   An immutable identifier for a data source that is unique within an
+    #   Amazon Web Services Region. Performance Insights gathers metrics from
+    #   this data source. To use an Amazon RDS DB instance as a data source,
+    #   specify its `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VWZ`.
+    #
+    # @option params [required, Array<String>] :metric_types
+    #   The types of metrics to return in the response. Valid values in the
+    #   array include the following:
+    #
+    #   * `os` (OS counter metrics)
+    #
+    #   * `db` (DB load metrics)
+    #
+    #   * `db.sql.stats` (per-SQL metrics)
+    #
+    #   * `db.sql_tokenized.stats` (per-SQL digest metrics)
+    #
+    # @option params [String] :next_token
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond the
+    #   token, up to the value specified by `MaxRecords`.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of items to return. If the `MaxRecords` value is
+    #   less than the number of existing items, the response includes a
+    #   pagination token.
+    #
+    # @return [Types::ListAvailableResourceMetricsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListAvailableResourceMetricsResponse#metrics #metrics} => Array&lt;Types::ResponseResourceMetric&gt;
+    #   * {Types::ListAvailableResourceMetricsResponse#next_token #next_token} => 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_available_resource_metrics({
+    #     service_type: "RDS", # required, accepts RDS, DOCDB
+    #     identifier: "RequestString", # required
+    #     metric_types: ["RequestString"], # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metrics #=> Array
+    #   resp.metrics[0].metric #=> String
+    #   resp.metrics[0].description #=> String
+    #   resp.metrics[0].unit #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListAvailableResourceMetrics AWS API Documentation
+    #
+    # @overload list_available_resource_metrics(params = {})
+    # @param [Hash] params ({})
+    def list_available_resource_metrics(params = {}, options = {})
+      req = build_request(:list_available_resource_metrics, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -727,7 +922,7 @@ module Aws::PI
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-pi'
-      context[:gem_version] = '1.35.0'
+      context[:gem_version] = '1.38.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -13,21 +13,34 @@ module Aws::PI
 
     include Seahorse::Model
 
+    AdditionalMetricsList = Shapes::ListShape.new(name: 'AdditionalMetricsList')
+    AdditionalMetricsMap = Shapes::MapShape.new(name: 'AdditionalMetricsMap')
     DataPoint = Shapes::StructureShape.new(name: 'DataPoint')
     DataPointsList = Shapes::ListShape.new(name: 'DataPointsList')
     DescribeDimensionKeysRequest = Shapes::StructureShape.new(name: 'DescribeDimensionKeysRequest')
     DescribeDimensionKeysResponse = Shapes::StructureShape.new(name: 'DescribeDimensionKeysResponse')
+    Description = Shapes::StringShape.new(name: 'Description')
     DetailStatus = Shapes::StringShape.new(name: 'DetailStatus')
+    DimensionDetail = Shapes::StructureShape.new(name: 'DimensionDetail')
+    DimensionDetailList = Shapes::ListShape.new(name: 'DimensionDetailList')
     DimensionGroup = Shapes::StructureShape.new(name: 'DimensionGroup')
+    DimensionGroupDetail = Shapes::StructureShape.new(name: 'DimensionGroupDetail')
+    DimensionGroupDetailList = Shapes::ListShape.new(name: 'DimensionGroupDetailList')
     DimensionKeyDescription = Shapes::StructureShape.new(name: 'DimensionKeyDescription')
     DimensionKeyDescriptionList = Shapes::ListShape.new(name: 'DimensionKeyDescriptionList')
     DimensionKeyDetail = Shapes::StructureShape.new(name: 'DimensionKeyDetail')
     DimensionKeyDetailList = Shapes::ListShape.new(name: 'DimensionKeyDetailList')
     DimensionMap = Shapes::MapShape.new(name: 'DimensionMap')
+    DimensionsMetricList = Shapes::ListShape.new(name: 'DimensionsMetricList')
     Double = Shapes::FloatShape.new(name: 'Double')
     ErrorString = Shapes::StringShape.new(name: 'ErrorString')
+    FeatureMetadata = Shapes::StructureShape.new(name: 'FeatureMetadata')
+    FeatureMetadataMap = Shapes::MapShape.new(name: 'FeatureMetadataMap')
+    FeatureStatus = Shapes::StringShape.new(name: 'FeatureStatus')
     GetDimensionKeyDetailsRequest = Shapes::StructureShape.new(name: 'GetDimensionKeyDetailsRequest')
     GetDimensionKeyDetailsResponse = Shapes::StructureShape.new(name: 'GetDimensionKeyDetailsResponse')
+    GetResourceMetadataRequest = Shapes::StructureShape.new(name: 'GetResourceMetadataRequest')
+    GetResourceMetadataResponse = Shapes::StructureShape.new(name: 'GetResourceMetadataResponse')
     GetResourceMetricsRequest = Shapes::StructureShape.new(name: 'GetResourceMetricsRequest')
     GetResourceMetricsResponse = Shapes::StructureShape.new(name: 'GetResourceMetricsResponse')
     ISOTimestamp = Shapes::TimestampShape.new(name: 'ISOTimestamp')
@@ -36,12 +49,19 @@ module Aws::PI
     InternalServiceError = Shapes::StructureShape.new(name: 'InternalServiceError')
     InvalidArgumentException = Shapes::StructureShape.new(name: 'InvalidArgumentException')
     Limit = Shapes::IntegerShape.new(name: 'Limit')
+    ListAvailableResourceDimensionsRequest = Shapes::StructureShape.new(name: 'ListAvailableResourceDimensionsRequest')
+    ListAvailableResourceDimensionsResponse = Shapes::StructureShape.new(name: 'ListAvailableResourceDimensionsResponse')
+    ListAvailableResourceMetricsRequest = Shapes::StructureShape.new(name: 'ListAvailableResourceMetricsRequest')
+    ListAvailableResourceMetricsResponse = Shapes::StructureShape.new(name: 'ListAvailableResourceMetricsResponse')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
+    MetricDimensionGroups = Shapes::StructureShape.new(name: 'MetricDimensionGroups')
+    MetricDimensionsList = Shapes::ListShape.new(name: 'MetricDimensionsList')
     MetricKeyDataPoints = Shapes::StructureShape.new(name: 'MetricKeyDataPoints')
     MetricKeyDataPointsList = Shapes::ListShape.new(name: 'MetricKeyDataPointsList')
     MetricQuery = Shapes::StructureShape.new(name: 'MetricQuery')
     MetricQueryFilterMap = Shapes::MapShape.new(name: 'MetricQueryFilterMap')
     MetricQueryList = Shapes::ListShape.new(name: 'MetricQueryList')
+    MetricTypeList = Shapes::ListShape.new(name: 'MetricTypeList')
     MetricValuesList = Shapes::ListShape.new(name: 'MetricValuesList')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
     NotAuthorizedException = Shapes::StructureShape.new(name: 'NotAuthorizedException')
@@ -50,10 +70,17 @@ module Aws::PI
     RequestedDimensionList = Shapes::ListShape.new(name: 'RequestedDimensionList')
     ResponsePartitionKey = Shapes::StructureShape.new(name: 'ResponsePartitionKey')
     ResponsePartitionKeyList = Shapes::ListShape.new(name: 'ResponsePartitionKeyList')
+    ResponseResourceMetric = Shapes::StructureShape.new(name: 'ResponseResourceMetric')
     ResponseResourceMetricKey = Shapes::StructureShape.new(name: 'ResponseResourceMetricKey')
+    ResponseResourceMetricList = Shapes::ListShape.new(name: 'ResponseResourceMetricList')
     ServiceType = Shapes::StringShape.new(name: 'ServiceType')
     String = Shapes::StringShape.new(name: 'String')
 
+    AdditionalMetricsList.member = Shapes::ShapeRef.new(shape: RequestString)
+
+    AdditionalMetricsMap.key = Shapes::ShapeRef.new(shape: RequestString)
+    AdditionalMetricsMap.value = Shapes::ShapeRef.new(shape: Double)
+
     DataPoint.add_member(:timestamp, Shapes::ShapeRef.new(shape: ISOTimestamp, required: true, location_name: "Timestamp"))
     DataPoint.add_member(:value, Shapes::ShapeRef.new(shape: Double, required: true, location_name: "Value"))
     DataPoint.struct_class = Types::DataPoint
@@ -67,6 +94,7 @@ module Aws::PI
     DescribeDimensionKeysRequest.add_member(:metric, Shapes::ShapeRef.new(shape: RequestString, required: true, location_name: "Metric"))
     DescribeDimensionKeysRequest.add_member(:period_in_seconds, Shapes::ShapeRef.new(shape: Integer, location_name: "PeriodInSeconds"))
     DescribeDimensionKeysRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: DimensionGroup, required: true, location_name: "GroupBy"))
+    DescribeDimensionKeysRequest.add_member(:additional_metrics, Shapes::ShapeRef.new(shape: AdditionalMetricsList, location_name: "AdditionalMetrics"))
     DescribeDimensionKeysRequest.add_member(:partition_by, Shapes::ShapeRef.new(shape: DimensionGroup, location_name: "PartitionBy"))
     DescribeDimensionKeysRequest.add_member(:filter, Shapes::ShapeRef.new(shape: MetricQueryFilterMap, location_name: "Filter"))
     DescribeDimensionKeysRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
@@ -80,13 +108,25 @@ module Aws::PI
     DescribeDimensionKeysResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     DescribeDimensionKeysResponse.struct_class = Types::DescribeDimensionKeysResponse
 
+    DimensionDetail.add_member(:identifier, Shapes::ShapeRef.new(shape: String, location_name: "Identifier"))
+    DimensionDetail.struct_class = Types::DimensionDetail
+
+    DimensionDetailList.member = Shapes::ShapeRef.new(shape: DimensionDetail)
+
     DimensionGroup.add_member(:group, Shapes::ShapeRef.new(shape: RequestString, required: true, location_name: "Group"))
     DimensionGroup.add_member(:dimensions, Shapes::ShapeRef.new(shape: RequestStringList, location_name: "Dimensions"))
     DimensionGroup.add_member(:limit, Shapes::ShapeRef.new(shape: Limit, location_name: "Limit"))
     DimensionGroup.struct_class = Types::DimensionGroup
 
+    DimensionGroupDetail.add_member(:group, Shapes::ShapeRef.new(shape: String, location_name: "Group"))
+    DimensionGroupDetail.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionDetailList, location_name: "Dimensions"))
+    DimensionGroupDetail.struct_class = Types::DimensionGroupDetail
+
+    DimensionGroupDetailList.member = Shapes::ShapeRef.new(shape: DimensionGroupDetail)
+
     DimensionKeyDescription.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionMap, location_name: "Dimensions"))
     DimensionKeyDescription.add_member(:total, Shapes::ShapeRef.new(shape: Double, location_name: "Total"))
+    DimensionKeyDescription.add_member(:additional_metrics, Shapes::ShapeRef.new(shape: AdditionalMetricsMap, location_name: "AdditionalMetrics"))
     DimensionKeyDescription.add_member(:partitions, Shapes::ShapeRef.new(shape: MetricValuesList, location_name: "Partitions"))
     DimensionKeyDescription.struct_class = Types::DimensionKeyDescription
 
@@ -102,6 +142,14 @@ module Aws::PI
     DimensionMap.key = Shapes::ShapeRef.new(shape: RequestString)
     DimensionMap.value = Shapes::ShapeRef.new(shape: RequestString)
 
+    DimensionsMetricList.member = Shapes::ShapeRef.new(shape: RequestString)
+
+    FeatureMetadata.add_member(:status, Shapes::ShapeRef.new(shape: FeatureStatus, location_name: "Status"))
+    FeatureMetadata.struct_class = Types::FeatureMetadata
+
+    FeatureMetadataMap.key = Shapes::ShapeRef.new(shape: String)
+    FeatureMetadataMap.value = Shapes::ShapeRef.new(shape: FeatureMetadata)
+
     GetDimensionKeyDetailsRequest.add_member(:service_type, Shapes::ShapeRef.new(shape: ServiceType, required: true, location_name: "ServiceType"))
     GetDimensionKeyDetailsRequest.add_member(:identifier, Shapes::ShapeRef.new(shape: IdentifierString, required: true, location_name: "Identifier"))
     GetDimensionKeyDetailsRequest.add_member(:group, Shapes::ShapeRef.new(shape: RequestString, required: true, location_name: "Group"))
@@ -112,6 +160,14 @@ module Aws::PI
     GetDimensionKeyDetailsResponse.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionKeyDetailList, location_name: "Dimensions"))
     GetDimensionKeyDetailsResponse.struct_class = Types::GetDimensionKeyDetailsResponse
 
+    GetResourceMetadataRequest.add_member(:service_type, Shapes::ShapeRef.new(shape: ServiceType, required: true, location_name: "ServiceType"))
+    GetResourceMetadataRequest.add_member(:identifier, Shapes::ShapeRef.new(shape: RequestString, required: true, location_name: "Identifier"))
+    GetResourceMetadataRequest.struct_class = Types::GetResourceMetadataRequest
+
+    GetResourceMetadataResponse.add_member(:identifier, Shapes::ShapeRef.new(shape: String, location_name: "Identifier"))
+    GetResourceMetadataResponse.add_member(:features, Shapes::ShapeRef.new(shape: FeatureMetadataMap, location_name: "Features"))
+    GetResourceMetadataResponse.struct_class = Types::GetResourceMetadataResponse
+
     GetResourceMetricsRequest.add_member(:service_type, Shapes::ShapeRef.new(shape: ServiceType, required: true, location_name: "ServiceType"))
     GetResourceMetricsRequest.add_member(:identifier, Shapes::ShapeRef.new(shape: RequestString, required: true, location_name: "Identifier"))
     GetResourceMetricsRequest.add_member(:metric_queries, Shapes::ShapeRef.new(shape: MetricQueryList, required: true, location_name: "MetricQueries"))
@@ -135,6 +191,34 @@ module Aws::PI
     InvalidArgumentException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorString, location_name: "Message"))
     InvalidArgumentException.struct_class = Types::InvalidArgumentException
 
+    ListAvailableResourceDimensionsRequest.add_member(:service_type, Shapes::ShapeRef.new(shape: ServiceType, required: true, location_name: "ServiceType"))
+    ListAvailableResourceDimensionsRequest.add_member(:identifier, Shapes::ShapeRef.new(shape: RequestString, required: true, location_name: "Identifier"))
+    ListAvailableResourceDimensionsRequest.add_member(:metrics, Shapes::ShapeRef.new(shape: DimensionsMetricList, required: true, location_name: "Metrics"))
+    ListAvailableResourceDimensionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
+    ListAvailableResourceDimensionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListAvailableResourceDimensionsRequest.struct_class = Types::ListAvailableResourceDimensionsRequest
+
+    ListAvailableResourceDimensionsResponse.add_member(:metric_dimensions, Shapes::ShapeRef.new(shape: MetricDimensionsList, location_name: "MetricDimensions"))
+    ListAvailableResourceDimensionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListAvailableResourceDimensionsResponse.struct_class = Types::ListAvailableResourceDimensionsResponse
+
+    ListAvailableResourceMetricsRequest.add_member(:service_type, Shapes::ShapeRef.new(shape: ServiceType, required: true, location_name: "ServiceType"))
+    ListAvailableResourceMetricsRequest.add_member(:identifier, Shapes::ShapeRef.new(shape: RequestString, required: true, location_name: "Identifier"))
+    ListAvailableResourceMetricsRequest.add_member(:metric_types, Shapes::ShapeRef.new(shape: MetricTypeList, required: true, location_name: "MetricTypes"))
+    ListAvailableResourceMetricsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListAvailableResourceMetricsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
+    ListAvailableResourceMetricsRequest.struct_class = Types::ListAvailableResourceMetricsRequest
+
+    ListAvailableResourceMetricsResponse.add_member(:metrics, Shapes::ShapeRef.new(shape: ResponseResourceMetricList, location_name: "Metrics"))
+    ListAvailableResourceMetricsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListAvailableResourceMetricsResponse.struct_class = Types::ListAvailableResourceMetricsResponse
+
+    MetricDimensionGroups.add_member(:metric, Shapes::ShapeRef.new(shape: String, location_name: "Metric"))
+    MetricDimensionGroups.add_member(:groups, Shapes::ShapeRef.new(shape: DimensionGroupDetailList, location_name: "Groups"))
+    MetricDimensionGroups.struct_class = Types::MetricDimensionGroups
+
+    MetricDimensionsList.member = Shapes::ShapeRef.new(shape: MetricDimensionGroups)
+
     MetricKeyDataPoints.add_member(:key, Shapes::ShapeRef.new(shape: ResponseResourceMetricKey, location_name: "Key"))
     MetricKeyDataPoints.add_member(:data_points, Shapes::ShapeRef.new(shape: DataPointsList, location_name: "DataPoints"))
     MetricKeyDataPoints.struct_class = Types::MetricKeyDataPoints
@@ -151,6 +235,8 @@ module Aws::PI
 
     MetricQueryList.member = Shapes::ShapeRef.new(shape: MetricQuery)
 
+    MetricTypeList.member = Shapes::ShapeRef.new(shape: RequestString)
+
     MetricValuesList.member = Shapes::ShapeRef.new(shape: Double)
 
     NotAuthorizedException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorString, location_name: "Message"))
@@ -165,10 +251,17 @@ module Aws::PI
 
     ResponsePartitionKeyList.member = Shapes::ShapeRef.new(shape: ResponsePartitionKey)
 
+    ResponseResourceMetric.add_member(:metric, Shapes::ShapeRef.new(shape: String, location_name: "Metric"))
+    ResponseResourceMetric.add_member(:description, Shapes::ShapeRef.new(shape: Description, location_name: "Description"))
+    ResponseResourceMetric.add_member(:unit, Shapes::ShapeRef.new(shape: String, location_name: "Unit"))
+    ResponseResourceMetric.struct_class = Types::ResponseResourceMetric
+
     ResponseResourceMetricKey.add_member(:metric, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Metric"))
     ResponseResourceMetricKey.add_member(:dimensions, Shapes::ShapeRef.new(shape: DimensionMap, location_name: "Dimensions"))
     ResponseResourceMetricKey.struct_class = Types::ResponseResourceMetricKey
 
+    ResponseResourceMetricList.member = Shapes::ShapeRef.new(shape: ResponseResourceMetric)
+
 
     # @api private
     API = Seahorse::Model::Api.new.tap do |api|
@@ -198,6 +291,12 @@ module Aws::PI
         o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:get_dimension_key_details, Seahorse::Model::Operation.new.tap do |o|
@@ -211,6 +310,17 @@ module Aws::PI
         o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
       end)
 
+      api.add_operation(:get_resource_metadata, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetResourceMetadata"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetResourceMetadataRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetResourceMetadataResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
+        o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
+      end)
+
       api.add_operation(:get_resource_metrics, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetResourceMetrics"
         o.http_method = "POST"
@@ -220,6 +330,46 @@ module Aws::PI
         o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
+      api.add_operation(:list_available_resource_dimensions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListAvailableResourceDimensions"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListAvailableResourceDimensionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListAvailableResourceDimensionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
+        o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
+      api.add_operation(:list_available_resource_metrics, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListAvailableResourceMetrics"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListAvailableResourceMetricsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListAvailableResourceMetricsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
+        o.errors << Shapes::ShapeRef.new(shape: NotAuthorizedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
     end
 

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

@@ -34,7 +34,7 @@ module Aws::PI
     #   data as a hash:
     #
     #       {
-    #         service_type: "RDS", # required, accepts RDS
+    #         service_type: "RDS", # required, accepts RDS, DOCDB
     #         identifier: "RequestString", # required
     #         start_time: Time.now, # required
     #         end_time: Time.now, # required
@@ -45,6 +45,7 @@ module Aws::PI
     #           dimensions: ["RequestString"],
     #           limit: 1,
     #         },
+    #         additional_metrics: ["RequestString"],
     #         partition_by: {
     #           group: "RequestString", # required
     #           dimensions: ["RequestString"],
@@ -58,17 +59,18 @@ module Aws::PI
     #       }
     #
     # @!attribute [rw] service_type
-    #   The AWS service for which Performance Insights will return metrics.
-    #   The only valid value for *ServiceType* is `RDS`.
+    #   The Amazon Web Services service for which Performance Insights will
+    #   return metrics. The only valid value for *ServiceType* is `RDS`.
     #   @return [String]
     #
     # @!attribute [rw] identifier
-    #   An immutable, AWS Region-unique identifier for a data source.
-    #   Performance Insights gathers metrics from this data source.
+    #   An immutable, Amazon Web Services Region-unique identifier for a
+    #   data source. Performance Insights gathers metrics from this data
+    #   source.
     #
     #   To use an Amazon RDS instance as a data source, you specify its
     #   `DbiResourceId` value. For example, specify
-    #   `db-FAIHNTYBKTGAUSUZQYPDS2GW4A`
+    #   `db-FAIHNTYBKTGAUSUZQYPDS2GW4A`.
     #   @return [String]
     #
     # @!attribute [rw] start_time
@@ -140,6 +142,14 @@ module Aws::PI
     #   values for a dimension.
     #   @return [Types::DimensionGroup]
     #
+    # @!attribute [rw] additional_metrics
+    #   Additional metrics for the top `N` dimension keys. If the specified
+    #   dimension group in the `GroupBy` parameter is `db.sql_tokenized`,
+    #   you can specify per-SQL metrics to get the values for the top `N`
+    #   SQL digests. The response syntax is `"AdditionalMetrics" : \{
+    #   "string" : "string" \}`.
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] partition_by
     #   For each dimension specified in `GroupBy`, specify a secondary
     #   dimension to further subdivide the partition keys in the response.
@@ -177,6 +187,7 @@ module Aws::PI
       :metric,
       :period_in_seconds,
       :group_by,
+      :additional_metrics,
       :partition_by,
       :filter,
       :max_results,
@@ -210,9 +221,10 @@ module Aws::PI
     #   @return [Array<Types::DimensionKeyDescription>]
     #
     # @!attribute [rw] next_token
-    #   An optional pagination token provided by a previous request. If this
-    #   parameter is specified, the response includes only records beyond
-    #   the token, up to the value specified by `MaxRecords`.
+    #   A pagination token that indicates the response didn’t return all
+    #   available records because `MaxRecords` was specified in the previous
+    #   request. To get the remaining records, specify `NextToken` in a
+    #   separate request with this value.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/DescribeDimensionKeysResponse AWS API Documentation
@@ -227,6 +239,20 @@ module Aws::PI
       include Aws::Structure
     end
 
+    # The information about a dimension.
+    #
+    # @!attribute [rw] identifier
+    #   The identifier of a dimension.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/DimensionDetail AWS API Documentation
+    #
+    class DimensionDetail < Struct.new(
+      :identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A logical grouping of Performance Insights metrics for a related
     # subject area. For example, the `db.sql` dimension group consists of
     # the following dimensions: `db.sql.id`, `db.sql.db_id`,
@@ -251,8 +277,8 @@ module Aws::PI
     #   The name of the dimension group. Valid values are:
     #
     #   * `db` - The name of the database to which the client is connected
-    #     (only Aurora PostgreSQL, RDS PostgreSQL, Aurora MySQL, RDS MySQL,
-    #     and MariaDB)
+    #     (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora MySQL,
+    #     Amazon RDS MySQL, and MariaDB)
     #
     #   * `db.application` - The name of the application that is connected
     #     to the database (only Aurora PostgreSQL and RDS PostgreSQL)
@@ -293,8 +319,8 @@ module Aws::PI
     #     engines)
     #
     #   * `db.name` - The name of the database to which the client is
-    #     connected (only Aurora PostgreSQL, RDS PostgreSQL, Aurora MySQL,
-    #     RDS MySQL, and MariaDB)
+    #     connected (only Aurora PostgreSQL, Amazon RDS PostgreSQL, Aurora
+    #     MySQL, Amazon RDS MySQL, and MariaDB)
     #
     #   * `db.session_type.name` - The type of the current session (only
     #     Aurora PostgreSQL and RDS PostgreSQL)
@@ -348,18 +374,41 @@ module Aws::PI
       include Aws::Structure
     end
 
-    # An array of descriptions and aggregated values for each dimension
-    # within a dimension group.
+    # Information about dimensions within a dimension group.
+    #
+    # @!attribute [rw] group
+    #   The name of the dimension group.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimensions
+    #   The dimensions within a dimension group.
+    #   @return [Array<Types::DimensionDetail>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/DimensionGroupDetail AWS API Documentation
+    #
+    class DimensionGroupDetail < Struct.new(
+      :group,
+      :dimensions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # An object that includes the requested dimension key values and
+    # aggregated metric values within a dimension group.
     #
     # @!attribute [rw] dimensions
     #   A map of name-value pairs for the dimensions in the group.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] total
-    #   The aggregated metric value for the dimension(s), over the requested
+    #   The aggregated metric value for the dimensions, over the requested
     #   time range.
     #   @return [Float]
     #
+    # @!attribute [rw] additional_metrics
+    #   A map that contains the value for each additional metric.
+    #   @return [Hash<String,Float>]
+    #
     # @!attribute [rw] partitions
     #   If `PartitionBy` was specified, `PartitionKeys` contains the
     #   dimensions that were.
@@ -370,6 +419,7 @@ module Aws::PI
     class DimensionKeyDescription < Struct.new(
       :dimensions,
       :total,
+      :additional_metrics,
       :partitions)
       SENSITIVE = []
       include Aws::Structure
@@ -413,11 +463,41 @@ module Aws::PI
       include Aws::Structure
     end
 
+    # The metadata for a feature. For example, the metadata might indicate
+    # that a feature is turned on or off on a specific DB instance.
+    #
+    # @!attribute [rw] status
+    #   The status of the feature on the DB instance. Possible values
+    #   include the following:
+    #
+    #   * `ENABLED`\: the feature is enabled on the instance.
+    #
+    #   * `DISABLED`\: the feature is disabled on the instance.
+    #
+    #   * `UNSUPPORTED`\: the feature isn't supported on the instance.
+    #
+    #   * `ENABLED_PENDING_REBOOT`\: the feature is enabled on the instance
+    #     but requires a reboot to take effect.
+    #
+    #   * `DISABLED_PENDING_REBOOT`\: the feature is disabled on the
+    #     instance but requires a reboot to take effect.
+    #
+    #   * `UNKNOWN`\: the feature status couldn't be determined.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/FeatureMetadata AWS API Documentation
+    #
+    class FeatureMetadata < Struct.new(
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetDimensionKeyDetailsRequest
     #   data as a hash:
     #
     #       {
-    #         service_type: "RDS", # required, accepts RDS
+    #         service_type: "RDS", # required, accepts RDS, DOCDB
     #         identifier: "IdentifierString", # required
     #         group: "RequestString", # required
     #         group_identifier: "RequestString", # required
@@ -425,15 +505,16 @@ module Aws::PI
     #       }
     #
     # @!attribute [rw] service_type
-    #   The AWS service for which Performance Insights returns data. The
-    #   only valid value is `RDS`.
+    #   The Amazon Web Services service for which Performance Insights
+    #   returns data. The only valid value is `RDS`.
     #   @return [String]
     #
     # @!attribute [rw] identifier
     #   The ID for a data source from which to gather dimension data. This
-    #   ID must be immutable and unique within an AWS Region. When a DB
-    #   instance is the data source, specify its `DbiResourceId` value. For
-    #   example, specify `db-ABCDEFGHIJKLMNOPQRSTU1VW2X`.
+    #   ID must be immutable and unique within an Amazon Web Services
+    #   Region. When a DB instance is the data source, specify its
+    #   `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VW2X`.
     #   @return [String]
     #
     # @!attribute [rw] group
@@ -480,11 +561,64 @@ module Aws::PI
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetResourceMetadataRequest
+    #   data as a hash:
+    #
+    #       {
+    #         service_type: "RDS", # required, accepts RDS, DOCDB
+    #         identifier: "RequestString", # required
+    #       }
+    #
+    # @!attribute [rw] service_type
+    #   The Amazon Web Services service for which Performance Insights
+    #   returns metrics.
+    #   @return [String]
+    #
+    # @!attribute [rw] identifier
+    #   An immutable identifier for a data source that is unique for an
+    #   Amazon Web Services Region. Performance Insights gathers metrics
+    #   from this data source. To use a DB instance as a data source,
+    #   specify its `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VW2X`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetResourceMetadataRequest AWS API Documentation
+    #
+    class GetResourceMetadataRequest < Struct.new(
+      :service_type,
+      :identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] identifier
+    #   An immutable identifier for a data source that is unique for an
+    #   Amazon Web Services Region. Performance Insights gathers metrics
+    #   from this data source. To use a DB instance as a data source,
+    #   specify its `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VW2X`.
+    #   @return [String]
+    #
+    # @!attribute [rw] features
+    #   The metadata for different features. For example, the metadata might
+    #   indicate that a feature is turned on or off on a specific DB
+    #   instance.
+    #   @return [Hash<String,Types::FeatureMetadata>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/GetResourceMetadataResponse AWS API Documentation
+    #
+    class GetResourceMetadataResponse < Struct.new(
+      :identifier,
+      :features)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetResourceMetricsRequest
     #   data as a hash:
     #
     #       {
-    #         service_type: "RDS", # required, accepts RDS
+    #         service_type: "RDS", # required, accepts RDS, DOCDB
     #         identifier: "RequestString", # required
     #         metric_queries: [ # required
     #           {
@@ -507,13 +641,14 @@ module Aws::PI
     #       }
     #
     # @!attribute [rw] service_type
-    #   The AWS service for which Performance Insights returns metrics. The
-    #   only valid value for *ServiceType* is `RDS`.
+    #   The Amazon Web Services service for which Performance Insights
+    #   returns metrics. The only valid value for *ServiceType* is `RDS`.
     #   @return [String]
     #
     # @!attribute [rw] identifier
-    #   An immutable, AWS Region-unique identifier for a data source.
-    #   Performance Insights gathers metrics from this data source.
+    #   An immutable, Amazon Web Services Region-unique identifier for a
+    #   data source. Performance Insights gathers metrics from this data
+    #   source.
     #
     #   To use a DB instance as a data source, specify its `DbiResourceId`
     #   value. For example, specify `db-FAIHNTYBKTGAUSUZQYPDS2GW4A`.
@@ -607,8 +742,9 @@ module Aws::PI
     #   @return [Time]
     #
     # @!attribute [rw] identifier
-    #   An immutable, AWS Region-unique identifier for a data source.
-    #   Performance Insights gathers metrics from this data source.
+    #   An immutable, Amazon Web Services Region-unique identifier for a
+    #   data source. Performance Insights gathers metrics from this data
+    #   source.
     #
     #   To use a DB instance as a data source, you specify its
     #   `DbiResourceId` value - for example: `db-FAIHNTYBKTGAUSUZQYPDS2GW4A`
@@ -663,11 +799,185 @@ module Aws::PI
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListAvailableResourceDimensionsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         service_type: "RDS", # required, accepts RDS, DOCDB
+    #         identifier: "RequestString", # required
+    #         metrics: ["RequestString"], # required
+    #         max_results: 1,
+    #         next_token: "NextToken",
+    #       }
+    #
+    # @!attribute [rw] service_type
+    #   The Amazon Web Services service for which Performance Insights
+    #   returns metrics.
+    #   @return [String]
+    #
+    # @!attribute [rw] identifier
+    #   An immutable identifier for a data source that is unique within an
+    #   Amazon Web Services Region. Performance Insights gathers metrics
+    #   from this data source. To use an Amazon RDS DB instance as a data
+    #   source, specify its `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VWZ`.
+    #   @return [String]
+    #
+    # @!attribute [rw] metrics
+    #   The types of metrics for which to retrieve dimensions. Valid values
+    #   include `db.load`.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of items to return in the response. If more items
+    #   exist than the specified `MaxRecords` value, a pagination token is
+    #   included in the response so that the remaining results can be
+    #   retrieved.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond
+    #   the token, up to the value specified by `MaxRecords`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListAvailableResourceDimensionsRequest AWS API Documentation
+    #
+    class ListAvailableResourceDimensionsRequest < Struct.new(
+      :service_type,
+      :identifier,
+      :metrics,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] metric_dimensions
+    #   The dimension information returned for requested metric types.
+    #   @return [Array<Types::MetricDimensionGroups>]
+    #
+    # @!attribute [rw] next_token
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond
+    #   the token, up to the value specified by `MaxRecords`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListAvailableResourceDimensionsResponse AWS API Documentation
+    #
+    class ListAvailableResourceDimensionsResponse < Struct.new(
+      :metric_dimensions,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass ListAvailableResourceMetricsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         service_type: "RDS", # required, accepts RDS, DOCDB
+    #         identifier: "RequestString", # required
+    #         metric_types: ["RequestString"], # required
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] service_type
+    #   The Amazon Web Services service for which Performance Insights
+    #   returns metrics.
+    #   @return [String]
+    #
+    # @!attribute [rw] identifier
+    #   An immutable identifier for a data source that is unique within an
+    #   Amazon Web Services Region. Performance Insights gathers metrics
+    #   from this data source. To use an Amazon RDS DB instance as a data
+    #   source, specify its `DbiResourceId` value. For example, specify
+    #   `db-ABCDEFGHIJKLMNOPQRSTU1VWZ`.
+    #   @return [String]
+    #
+    # @!attribute [rw] metric_types
+    #   The types of metrics to return in the response. Valid values in the
+    #   array include the following:
+    #
+    #   * `os` (OS counter metrics)
+    #
+    #   * `db` (DB load metrics)
+    #
+    #   * `db.sql.stats` (per-SQL metrics)
+    #
+    #   * `db.sql_tokenized.stats` (per-SQL digest metrics)
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] next_token
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond
+    #   the token, up to the value specified by `MaxRecords`.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of items to return. If the `MaxRecords` value is
+    #   less than the number of existing items, the response includes a
+    #   pagination token.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListAvailableResourceMetricsRequest AWS API Documentation
+    #
+    class ListAvailableResourceMetricsRequest < Struct.new(
+      :service_type,
+      :identifier,
+      :metric_types,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] metrics
+    #   An array of metrics available to query. Each array element contains
+    #   the full name, description, and unit of the metric.
+    #   @return [Array<Types::ResponseResourceMetric>]
+    #
+    # @!attribute [rw] next_token
+    #   A pagination token that indicates the response didn’t return all
+    #   available records because `MaxRecords` was specified in the previous
+    #   request. To get the remaining records, specify `NextToken` in a
+    #   separate request with this value.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ListAvailableResourceMetricsResponse AWS API Documentation
+    #
+    class ListAvailableResourceMetricsResponse < Struct.new(
+      :metrics,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The available dimension information for a metric type.
+    #
+    # @!attribute [rw] metric
+    #   The metric type to which the dimension information belongs.
+    #   @return [String]
+    #
+    # @!attribute [rw] groups
+    #   The available dimension groups for a metric type.
+    #   @return [Array<Types::DimensionGroupDetail>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/MetricDimensionGroups AWS API Documentation
+    #
+    class MetricDimensionGroups < Struct.new(
+      :metric,
+      :groups)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A time-ordered series of data points, corresponding to a dimension of
     # a Performance Insights metric.
     #
     # @!attribute [rw] key
-    #   The dimension(s) to which the data points apply.
+    #   The dimensions to which the data points apply.
     #   @return [Types::ResponseResourceMetricKey]
     #
     # @!attribute [rw] data_points
@@ -686,8 +996,8 @@ module Aws::PI
 
     # A single query to be processed. You must provide the metric to query.
     # If no other parameters are specified, Performance Insights returns all
-    # of the data points for that metric. You can optionally request that
-    # the data points be aggregated by dimension group ( `GroupBy`), and
+    # data points for the specified metric. Optionally, you can request that
+    # the data points be aggregated by dimension group (`GroupBy`), and
     # return only those data points that match your criteria (`Filter`).
     #
     # @note When making an API call, you may pass MetricQuery
@@ -772,7 +1082,7 @@ module Aws::PI
     # specifies one dimension.
     #
     # @!attribute [rw] dimensions
-    #   A dimension map that contains the dimension(s) for this partition.
+    #   A dimension map that contains the dimensions for this partition.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ResponsePartitionKey AWS API Documentation
@@ -783,6 +1093,31 @@ module Aws::PI
       include Aws::Structure
     end
 
+    # An object that contains the full name, description, and unit of a
+    # metric.
+    #
+    # @!attribute [rw] metric
+    #   The full name of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The description of the metric.
+    #   @return [String]
+    #
+    # @!attribute [rw] unit
+    #   The unit of the metric.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/pi-2018-02-27/ResponseResourceMetric AWS API Documentation
+    #
+    class ResponseResourceMetric < Struct.new(
+      :metric,
+      :description,
+      :unit)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # An object describing a Performance Insights metric and one or more
     # dimensions for that metric.
     #

data/lib/aws-sdk-pi.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-pi/customizations'
 # @!group service
 module Aws::PI
 
-  GEM_VERSION = '1.35.0'
+  GEM_VERSION = '1.38.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-pi
 version: !ruby/object:Gem::Version
-  version: 1.35.0
+  version: 1.38.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.125.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.125.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement