aws-sdk-codeguruprofiler 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4373b7be67d682f57930a38ed64c3b0947c2da73a4f247ae711ae016d854eda9
-  data.tar.gz: 0a99b74a3fc259a8df183530fb513205fa05c4d5b69a2022e6141197fcf77ad6
+  metadata.gz: ecc67e63132a4a96f589839ebf1da8ca51b435ff422fc43d9c0770902bb7857b
+  data.tar.gz: 486364744d3a884b20893aaf7f52622eb3d948237721725287086236a4d3a9c8
 SHA512:
-  metadata.gz: 1fd02a3e4e842952413b3446e3212df20b50e5ad4583a9162bb38bcfdaaab9862ddb037409c0c95139d0f84039ae640b7dea32e744f22726e5d4d0febb0ed839
-  data.tar.gz: 3d74ec70a4447feaffe63fd48cb8b08f384c6b535a7180c8b37406e5e6de95049db3cfc95f7272d76590ae50bee5cd84605f75f9f53ce14a445f4b160411aba5
+  metadata.gz: bb2939f2b4286c1e72f122bde65c763ba8e09b4606d6ad1baff7f9d67148911f41216ad6e25e74e5d74350acbc42537e67ae0d13a2a54c8b5fd81ff5b7882353
+  data.tar.gz: fd4fb2a81d4e9257876ba5a7a740b406ac8b4369922942aefa96b25713b2d151193c7b308e6289fc9a5041a144dd42a17bfd014170606b095ef8b7fe5439f7ed

data/lib/aws-sdk-codeguruprofiler.rb

@@ -27,7 +27,7 @@ require_relative 'aws-sdk-codeguruprofiler/customizations'
 # structure.
 #
 #     code_guru_profiler = Aws::CodeGuruProfiler::Client.new
-#     resp = code_guru_profiler.configure_agent(params)
+#     resp = code_guru_profiler.add_notification_channels(params)
 #
 # See {Client} for more information.
 #
@@ -47,6 +47,6 @@ require_relative 'aws-sdk-codeguruprofiler/customizations'
 # @service
 module Aws::CodeGuruProfiler
 
-  GEM_VERSION = '1.7.0'
+  GEM_VERSION = '1.8.0'
 
 end

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

@@ -312,9 +312,189 @@ module Aws::CodeGuruProfiler
 
     # @!group API Operations
 
+    # Add up to 2 anomaly notifications channels for a profiling group.
+    #
+    # @option params [required, Array<Types::Channel>] :channels
+    #   One or 2 channels to report to when anomalies are detected.
+    #
+    # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group that we are setting up notifications
+    #   for.
+    #
+    # @return [Types::AddNotificationChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::AddNotificationChannelsResponse#notification_configuration #notification_configuration} => Types::NotificationConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.add_notification_channels({
+    #     channels: [ # required
+    #       {
+    #         event_publishers: ["AnomalyDetection"], # required, accepts AnomalyDetection
+    #         id: "ChannelId",
+    #         uri: "ChannelUri", # required
+    #       },
+    #     ],
+    #     profiling_group_name: "ProfilingGroupName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.notification_configuration.channels #=> Array
+    #   resp.notification_configuration.channels[0].event_publishers #=> Array
+    #   resp.notification_configuration.channels[0].event_publishers[0] #=> String, one of "AnomalyDetection"
+    #   resp.notification_configuration.channels[0].id #=> String
+    #   resp.notification_configuration.channels[0].uri #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/AddNotificationChannels AWS API Documentation
+    #
+    # @overload add_notification_channels(params = {})
+    # @param [Hash] params ({})
+    def add_notification_channels(params = {}, options = {})
+      req = build_request(:add_notification_channels, params)
+      req.send_request(options)
+    end
+
+    # Returns the time series of values for a requested list of frame
+    # metrics from a time period.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :end_time
+    #   The end time of the time period for the returned time series values.
+    #   This is specified using the ISO 8601 format. For example,
+    #   2020-06-01T13:15:02.001Z represents 1 millisecond past June 1, 2020
+    #   1:15:02 PM UTC.
+    #
+    # @option params [Array<Types::FrameMetric>] :frame_metrics
+    #   The details of the metrics that are used to request a time series of
+    #   values. The metric includes the name of the frame, the aggregation
+    #   type to calculate the metric value for the frame, and the thread
+    #   states to use to get the count for the metric value of the frame.
+    #
+    # @option params [String] :period
+    #   The duration of the frame metrics used to return the time series
+    #   values. Specify using the ISO 8601 format. The maximum period duration
+    #   is one day (`PT24H` or `P1D`).
+    #
+    # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group associated with the the frame metrics
+    #   used to return the time series values.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :start_time
+    #   The start time of the time period for the frame metrics used to return
+    #   the time series values. This is specified using the ISO 8601 format.
+    #   For example, 2020-06-01T13:15:02.001Z represents 1 millisecond past
+    #   June 1, 2020 1:15:02 PM UTC.
+    #
+    # @option params [String] :target_resolution
+    #   The requested resolution of time steps for the returned time series of
+    #   values. If the requested target resolution is not available due to
+    #   data not being retained we provide a best effort result by falling
+    #   back to the most granular available resolution after the target
+    #   resolution. There are 3 valid values.
+    #
+    #   * `P1D` — 1 day
+    #
+    #   * `PT1H` — 1 hour
+    #
+    #   * `PT5M` — 5 minutes
+    #
+    # @return [Types::BatchGetFrameMetricDataResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchGetFrameMetricDataResponse#end_time #end_time} => Time
+    #   * {Types::BatchGetFrameMetricDataResponse#end_times #end_times} => Array&lt;Types::TimestampStructure&gt;
+    #   * {Types::BatchGetFrameMetricDataResponse#frame_metric_data #frame_metric_data} => Array&lt;Types::FrameMetricDatum&gt;
+    #   * {Types::BatchGetFrameMetricDataResponse#resolution #resolution} => String
+    #   * {Types::BatchGetFrameMetricDataResponse#start_time #start_time} => Time
+    #   * {Types::BatchGetFrameMetricDataResponse#unprocessed_end_times #unprocessed_end_times} => Hash&lt;String,Array&lt;Types::TimestampStructure&gt;&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_get_frame_metric_data({
+    #     end_time: Time.now,
+    #     frame_metrics: [
+    #       {
+    #         frame_name: "String", # required
+    #         thread_states: ["String"], # required
+    #         type: "AggregatedRelativeTotalTime", # required, accepts AggregatedRelativeTotalTime
+    #       },
+    #     ],
+    #     period: "Period",
+    #     profiling_group_name: "ProfilingGroupName", # required
+    #     start_time: Time.now,
+    #     target_resolution: "P1D", # accepts P1D, PT1H, PT5M
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.end_time #=> Time
+    #   resp.end_times #=> Array
+    #   resp.end_times[0].value #=> Time
+    #   resp.frame_metric_data #=> Array
+    #   resp.frame_metric_data[0].frame_metric.frame_name #=> String
+    #   resp.frame_metric_data[0].frame_metric.thread_states #=> Array
+    #   resp.frame_metric_data[0].frame_metric.thread_states[0] #=> String
+    #   resp.frame_metric_data[0].frame_metric.type #=> String, one of "AggregatedRelativeTotalTime"
+    #   resp.frame_metric_data[0].values #=> Array
+    #   resp.frame_metric_data[0].values[0] #=> Float
+    #   resp.resolution #=> String, one of "P1D", "PT1H", "PT5M"
+    #   resp.start_time #=> Time
+    #   resp.unprocessed_end_times #=> Hash
+    #   resp.unprocessed_end_times["String"] #=> Array
+    #   resp.unprocessed_end_times["String"][0].value #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/BatchGetFrameMetricData AWS API Documentation
+    #
+    # @overload batch_get_frame_metric_data(params = {})
+    # @param [Hash] params ({})
+    def batch_get_frame_metric_data(params = {}, options = {})
+      req = build_request(:batch_get_frame_metric_data, params)
+      req.send_request(options)
+    end
+
+    # Used by profiler agents to report their current state and to receive
+    # remote configuration updates. For example, `ConfigureAgent` can be
+    # used to tell and agent whether to profile or not and for how long to
+    # return profiling data.
+    #
     # @option params [String] :fleet_instance_id
+    #   A universally unique identifier (UUID) for a profiling instance. For
+    #   example, if the profiling instance is an Amazon EC2 instance, it is
+    #   the instance ID. If it is an AWS Fargate container, it is the
+    #   container's task ID.
+    #
+    # @option params [Hash<String,String>] :metadata
+    #   Metadata captured about the compute platform the agent is running on.
+    #   It includes information about sampling and reporting. The valid fields
+    #   are:
+    #
+    #   * `COMPUTE_PLATFORM` - The compute platform on which the agent is
+    #     running
+    #
+    #   * `AGENT_ID` - The ID for an agent instance.
+    #
+    #   * `AWS_REQUEST_ID` - The AWS request ID of a Lambda invocation.
+    #
+    #   * `EXECUTION_ENVIRONMENT` - The execution environment a Lambda
+    #     function is running on.
+    #
+    #   * `LAMBDA_FUNCTION_ARN` - The Amazon Resource Name (ARN) that is used
+    #     to invoke a Lambda function.
+    #
+    #   * `LAMBDA_MEMORY_LIMIT_IN_MB` - The memory allocated to a Lambda
+    #     function.
+    #
+    #   * `LAMBDA_REMAINING_TIME_IN_MILLISECONDS` - The time in milliseconds
+    #     before execution of a Lambda function times out.
+    #
+    #   * `LAMBDA_TIME_GAP_BETWEEN_INVOKES_IN_MILLISECONDS` - The time in
+    #     milliseconds between two invocations of a Lambda function.
+    #
+    #   * `LAMBDA_PREVIOUS_EXECUTION_TIME_IN_MILLISECONDS` - The time in
+    #     milliseconds for the previous Lambda invocation.
     #
     # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group for which the configured agent is
+    #   collecting profiling data.
     #
     # @return [Types::ConfigureAgentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -324,11 +504,16 @@ module Aws::CodeGuruProfiler
     #
     #   resp = client.configure_agent({
     #     fleet_instance_id: "FleetInstanceId",
+    #     metadata: {
+    #       "AgentId" => "String",
+    #     },
     #     profiling_group_name: "ProfilingGroupName", # required
     #   })
     #
     # @example Response structure
     #
+    #   resp.configuration.agent_parameters #=> Hash
+    #   resp.configuration.agent_parameters["AgentParameterField"] #=> String
     #   resp.configuration.period_in_seconds #=> Integer
     #   resp.configuration.should_profile #=> Boolean
     #
@@ -344,20 +529,26 @@ module Aws::CodeGuruProfiler
     # Creates a profiling group.
     #
     # @option params [Types::AgentOrchestrationConfig] :agent_orchestration_config
-    #   The agent orchestration configuration.
+    #   Specifies whether profiling is enabled or disabled for the created
+    #   profiling group.
     #
     # @option params [required, String] :client_token
-    #   Unique, case-sensitive identifier that you provide to ensure the
-    #   idempotency of the request.
-    #
-    #   This parameter specifies a unique identifier for the new profiling
-    #   group that helps ensure idempotency.
+    #   Amazon CodeGuru Profiler uses this universally unique identifier
+    #   (UUID) to prevent the accidental creation of duplicate profiling
+    #   groups if there are failures and retries.
     #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [String] :compute_platform
+    #   The compute platform of the profiling group. Use `AWSLambda` if your
+    #   application runs on AWS Lambda. Use `Default` if your application runs
+    #   on a compute platform that is not AWS Lambda, such an Amazon EC2
+    #   instance, an on-premises server, or a different platform. If not
+    #   specified, `Default` is used.
+    #
     # @option params [required, String] :profiling_group_name
-    #   The name of the profiling group.
+    #   The name of the profiling group to create.
     #
     # @return [Types::CreateProfilingGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -370,6 +561,7 @@ module Aws::CodeGuruProfiler
     #       profiling_enabled: false, # required
     #     },
     #     client_token: "ClientToken", # required
+    #     compute_platform: "AWSLambda", # accepts AWSLambda, Default
     #     profiling_group_name: "ProfilingGroupName", # required
     #   })
     #
@@ -377,6 +569,7 @@ module Aws::CodeGuruProfiler
     #
     #   resp.profiling_group.agent_orchestration_config.profiling_enabled #=> Boolean
     #   resp.profiling_group.arn #=> String
+    #   resp.profiling_group.compute_platform #=> String, one of "AWSLambda", "Default"
     #   resp.profiling_group.created_at #=> Time
     #   resp.profiling_group.name #=> String
     #   resp.profiling_group.profiling_status.latest_agent_orchestrated_at #=> Time
@@ -397,7 +590,7 @@ module Aws::CodeGuruProfiler
     # Deletes a profiling group.
     #
     # @option params [required, String] :profiling_group_name
-    #   The profiling group name to delete.
+    #   The name of the profiling group to delete.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -416,10 +609,15 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
-    # Describes a profiling group.
+    # Returns a [ `ProfilingGroupDescription` ][1] object that contains
+    # information about the requested profiling group.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_ProfilingGroupDescription.html
     #
     # @option params [required, String] :profiling_group_name
-    #   The profiling group name.
+    #   The name of the profiling group to get information about.
     #
     # @return [Types::DescribeProfilingGroupResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -435,6 +633,7 @@ module Aws::CodeGuruProfiler
     #
     #   resp.profiling_group.agent_orchestration_config.profiling_enabled #=> Boolean
     #   resp.profiling_group.arn #=> String
+    #   resp.profiling_group.compute_platform #=> String, one of "AWSLambda", "Default"
     #   resp.profiling_group.created_at #=> Time
     #   resp.profiling_group.name #=> String
     #   resp.profiling_group.profiling_status.latest_agent_orchestrated_at #=> Time
@@ -452,7 +651,110 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
-    # Gets the profiling group policy.
+    # Returns a list of [ `FindingsReportSummary` ][1] objects that contain
+    # analysis results for all profiling groups in your AWS account.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_FindingsReportSummary.html
+    #
+    # @option params [Boolean] :daily_reports_only
+    #   A `Boolean` value indicating whether to only return reports from daily
+    #   profiles. If set to `True`, only analysis data from daily profiles is
+    #   returned. If set to `False`, analysis data is returned from smaller
+    #   time windows (for example, one hour).
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results returned by `
+    #   GetFindingsReportAccountSummary` in paginated output. When this
+    #   parameter is used, `GetFindingsReportAccountSummary` only returns
+    #   `maxResults` results in a single page along with a `nextToken`
+    #   response element. The remaining results of the initial request can be
+    #   seen by sending another `GetFindingsReportAccountSummary` request with
+    #   the returned `nextToken` value.
+    #
+    # @option params [String] :next_token
+    #   The `nextToken` value returned from a previous paginated
+    #   `GetFindingsReportAccountSummary` request where `maxResults` was used
+    #   and the results exceeded the value of that parameter. Pagination
+    #   continues from the end of the previous results that returned the
+    #   `nextToken` value.
+    #
+    #   <note markdown="1"> This token should be treated as an opaque identifier that is only used
+    #   to retrieve the next items in a list and not for other programmatic
+    #   purposes.
+    #
+    #    </note>
+    #
+    # @return [Types::GetFindingsReportAccountSummaryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetFindingsReportAccountSummaryResponse#next_token #next_token} => String
+    #   * {Types::GetFindingsReportAccountSummaryResponse#report_summaries #report_summaries} => Array&lt;Types::FindingsReportSummary&gt;
+    #
+    # 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_findings_report_account_summary({
+    #     daily_reports_only: false,
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.report_summaries #=> Array
+    #   resp.report_summaries[0].id #=> String
+    #   resp.report_summaries[0].profile_end_time #=> Time
+    #   resp.report_summaries[0].profile_start_time #=> Time
+    #   resp.report_summaries[0].profiling_group_name #=> String
+    #   resp.report_summaries[0].total_number_of_findings #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/GetFindingsReportAccountSummary AWS API Documentation
+    #
+    # @overload get_findings_report_account_summary(params = {})
+    # @param [Hash] params ({})
+    def get_findings_report_account_summary(params = {}, options = {})
+      req = build_request(:get_findings_report_account_summary, params)
+      req.send_request(options)
+    end
+
+    # Get the current configuration for anomaly notifications for a
+    # profiling group.
+    #
+    # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group we want to get the notification
+    #   configuration for.
+    #
+    # @return [Types::GetNotificationConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetNotificationConfigurationResponse#notification_configuration #notification_configuration} => Types::NotificationConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_notification_configuration({
+    #     profiling_group_name: "ProfilingGroupName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.notification_configuration.channels #=> Array
+    #   resp.notification_configuration.channels[0].event_publishers #=> Array
+    #   resp.notification_configuration.channels[0].event_publishers[0] #=> String, one of "AnomalyDetection"
+    #   resp.notification_configuration.channels[0].id #=> String
+    #   resp.notification_configuration.channels[0].uri #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/GetNotificationConfiguration AWS API Documentation
+    #
+    # @overload get_notification_configuration(params = {})
+    # @param [Hash] params ({})
+    def get_notification_configuration(params = {}, options = {})
+      req = build_request(:get_notification_configuration, params)
+      req.send_request(options)
+    end
+
+    # Returns the JSON-formatted resource-based policy on a profiling group.
     #
     # @option params [required, String] :profiling_group_name
     #   The name of the profiling group.
@@ -482,46 +784,51 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
-    # Gets the aggregated profile of a profiling group for the specified
-    # time range. If the requested time range does not align with the
-    # available aggregated profiles, it is expanded to attain alignment. If
-    # aggregated profiles are available only for part of the period
-    # requested, the profile is returned from the earliest available to the
-    # latest within the requested time range.
+    # Gets the aggregated profile of a profiling group for a specified time
+    # range. Amazon CodeGuru Profiler collects posted agent profiles for a
+    # profiling group into aggregated profiles.
     #
-    # For example, if the requested time range is from 00:00 to 00:20 and
-    # the available profiles are from 00:15 to 00:25, the returned profile
-    # will be from 00:15 to 00:20.
-    #
-    # You must specify exactly two of the following parameters: `startTime`,
-    # `period`, and `endTime`.
+    #      <note> <p> Because aggregated profiles expire over time <code>GetProfile</code> is not idempotent. </p> </note> <p> Specify the time range for the requested aggregated profile using 1 or 2 of the following parameters: <code>startTime</code>, <code>endTime</code>, <code>period</code>. The maximum time range allowed is 7 days. If you specify all 3 parameters, an exception is thrown. If you specify only <code>period</code>, the latest aggregated profile is returned. </p> <p> Aggregated profiles are available with aggregation periods of 5 minutes, 1 hour, and 1 day, aligned to UTC. The aggregation period of an aggregated profile determines how long it is retained. For more information, see <a href="https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_AggregatedProfileTime.html"> <code>AggregatedProfileTime</code> </a>. The aggregated profile's aggregation period determines how long it is retained by CodeGuru Profiler. </p> <ul> <li> <p> If the aggregation period is 5 minutes, the aggregated profile is retained for 15 days. </p> </li> <li> <p> If the aggregation period is 1 hour, the aggregated profile is retained for 60 days. </p> </li> <li> <p> If the aggregation period is 1 day, the aggregated profile is retained for 3 years. </p> </li> </ul> <p>There are two use cases for calling <code>GetProfile</code>.</p> <ol> <li> <p> If you want to return an aggregated profile that already exists, use <a href="https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_ListProfileTimes.html"> <code>ListProfileTimes</code> </a> to view the time ranges of existing aggregated profiles. Use them in a <code>GetProfile</code> request to return a specific, existing aggregated profile. </p> </li> <li> <p> If you want to return an aggregated profile for a time range that doesn't align with an existing aggregated profile, then CodeGuru Profiler makes a best effort to combine existing aggregated profiles from the requested time range and return them as one aggregated profile. </p> <p> If aggregated profiles do not exist for the full time range requested, then aggregated profiles for a smaller time range are returned. For example, if the requested time range is from 00:00 to 00:20, and the existing aggregated profiles are from 00:15 and 00:25, then the aggregated profiles from 00:15 to 00:20 are returned. </p> </li> </ol>
     #
     # @option params [String] :accept
-    #   The format of the profile to return. You can choose `application/json`
-    #   or the default `application/x-amzn-ion`.
+    #   The format of the returned profiling data. The format maps to the
+    #   `Accept` and `Content-Type` headers of the HTTP request. You can
+    #   specify one of the following: or the default .
+    #
+    #        <ul> <li> <p> <code>application/json</code> — standard JSON format </p> </li> <li> <p> <code>application/x-amzn-ion</code> — the Amazon Ion data format. For more information, see <a href="http://amzn.github.io/ion-docs/">Amazon Ion</a>. </p> </li> </ul>
     #
     # @option params [Time,DateTime,Date,Integer,String] :end_time
-    #   You must specify exactly two of the following parameters: `startTime`,
-    #   `period`, and `endTime`.
+    #   The end time of the requested profile. Specify using the ISO 8601
+    #   format. For example, 2020-06-01T13:15:02.001Z represents 1 millisecond
+    #   past June 1, 2020 1:15:02 PM UTC.
+    #
+    #   If you specify `endTime`, then you must also specify `period` or
+    #   `startTime`, but not both.
     #
     # @option params [Integer] :max_depth
-    #   The maximum depth of the graph.
+    #   The maximum depth of the stacks in the code that is represented in the
+    #   aggregated profile. For example, if CodeGuru Profiler finds a method
+    #   `A`, which calls method `B`, which calls method `C`, which calls
+    #   method `D`, then the depth is 4. If the `maxDepth` is set to 2, then
+    #   the aggregated profile contains representations of methods `A` and
+    #   `B`.
     #
     # @option params [String] :period
-    #   The period of the profile to get. The time range must be in the past
-    #   and not longer than one week.
+    #   Used with `startTime` or `endTime` to specify the time range for the
+    #   returned aggregated profile. Specify using the ISO 8601 format. For
+    #   example, `P1DT1H1M1S`.
     #
-    #   You must specify exactly two of the following parameters: `startTime`,
-    #   `period`, and `endTime`.
+    #        <p> To get the latest aggregated profile, specify only <code>period</code>. </p>
     #
     # @option params [required, String] :profiling_group_name
     #   The name of the profiling group to get.
     #
     # @option params [Time,DateTime,Date,Integer,String] :start_time
-    #   The start time of the profile to get.
+    #   The start time of the profile to get. Specify using the ISO 8601
+    #   format. For example, 2020-06-01T13:15:02.001Z represents 1 millisecond
+    #   past June 1, 2020 1:15:02 PM UTC.
     #
-    #   You must specify exactly two of the following parameters: `startTime`,
-    #   `period`, and `endTime`.
+    #        <p> If you specify <code>startTime</code>, then you must also specify <code>period</code> or <code>endTime</code>, but not both. </p>
     #
     # @return [Types::GetProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -555,7 +862,203 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
-    # List the start times of the available aggregated profiles of a
+    # Returns a list of [ `Recommendation` ][1] objects that contain
+    # recommendations for a profiling group for a given time period. A list
+    # of [ `Anomaly` ][2] objects that contains details about anomalies
+    # detected in the profiling group for the same time period is also
+    # returned.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_Recommendation.html
+    # [2]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_Anomaly.html
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :end_time
+    #   The start time of the profile to get analysis data about. You must
+    #   specify `startTime` and `endTime`. This is specified using the ISO
+    #   8601 format. For example, 2020-06-01T13:15:02.001Z represents 1
+    #   millisecond past June 1, 2020 1:15:02 PM UTC.
+    #
+    # @option params [String] :locale
+    #   The language used to provide analysis. Specify using a string that is
+    #   one of the following `BCP 47` language codes.
+    #
+    #   * `de-DE` - German, Germany
+    #
+    #   * `en-GB` - English, United Kingdom
+    #
+    #   * `en-US` - English, United States
+    #
+    #   * `es-ES` - Spanish, Spain
+    #
+    #   * `fr-FR` - French, France
+    #
+    #   * `it-IT` - Italian, Italy
+    #
+    #   * `ja-JP` - Japanese, Japan
+    #
+    #   * `ko-KR` - Korean, Republic of Korea
+    #
+    #   * `pt-BR` - Portugese, Brazil
+    #
+    #   * `zh-CN` - Chinese, China
+    #
+    #   * `zh-TW` - Chinese, Taiwan
+    #
+    # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group to get analysis data about.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :start_time
+    #   The end time of the profile to get analysis data about. You must
+    #   specify `startTime` and `endTime`. This is specified using the ISO
+    #   8601 format. For example, 2020-06-01T13:15:02.001Z represents 1
+    #   millisecond past June 1, 2020 1:15:02 PM UTC.
+    #
+    # @return [Types::GetRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetRecommendationsResponse#anomalies #anomalies} => Array&lt;Types::Anomaly&gt;
+    #   * {Types::GetRecommendationsResponse#profile_end_time #profile_end_time} => Time
+    #   * {Types::GetRecommendationsResponse#profile_start_time #profile_start_time} => Time
+    #   * {Types::GetRecommendationsResponse#profiling_group_name #profiling_group_name} => String
+    #   * {Types::GetRecommendationsResponse#recommendations #recommendations} => Array&lt;Types::Recommendation&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_recommendations({
+    #     end_time: Time.now, # required
+    #     locale: "Locale",
+    #     profiling_group_name: "ProfilingGroupName", # required
+    #     start_time: Time.now, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.anomalies #=> Array
+    #   resp.anomalies[0].instances #=> Array
+    #   resp.anomalies[0].instances[0].end_time #=> Time
+    #   resp.anomalies[0].instances[0].id #=> String
+    #   resp.anomalies[0].instances[0].start_time #=> Time
+    #   resp.anomalies[0].instances[0].user_feedback.type #=> String, one of "Negative", "Positive"
+    #   resp.anomalies[0].metric.frame_name #=> String
+    #   resp.anomalies[0].metric.thread_states #=> Array
+    #   resp.anomalies[0].metric.thread_states[0] #=> String
+    #   resp.anomalies[0].metric.type #=> String, one of "AggregatedRelativeTotalTime"
+    #   resp.anomalies[0].reason #=> String
+    #   resp.profile_end_time #=> Time
+    #   resp.profile_start_time #=> Time
+    #   resp.profiling_group_name #=> String
+    #   resp.recommendations #=> Array
+    #   resp.recommendations[0].all_matches_count #=> Integer
+    #   resp.recommendations[0].all_matches_sum #=> Float
+    #   resp.recommendations[0].end_time #=> Time
+    #   resp.recommendations[0].pattern.counters_to_aggregate #=> Array
+    #   resp.recommendations[0].pattern.counters_to_aggregate[0] #=> String
+    #   resp.recommendations[0].pattern.description #=> String
+    #   resp.recommendations[0].pattern.id #=> String
+    #   resp.recommendations[0].pattern.name #=> String
+    #   resp.recommendations[0].pattern.resolution_steps #=> String
+    #   resp.recommendations[0].pattern.target_frames #=> Array
+    #   resp.recommendations[0].pattern.target_frames[0] #=> Array
+    #   resp.recommendations[0].pattern.target_frames[0][0] #=> String
+    #   resp.recommendations[0].pattern.threshold_percent #=> Float
+    #   resp.recommendations[0].start_time #=> Time
+    #   resp.recommendations[0].top_matches #=> Array
+    #   resp.recommendations[0].top_matches[0].frame_address #=> String
+    #   resp.recommendations[0].top_matches[0].target_frames_index #=> Integer
+    #   resp.recommendations[0].top_matches[0].threshold_breach_value #=> Float
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/GetRecommendations AWS API Documentation
+    #
+    # @overload get_recommendations(params = {})
+    # @param [Hash] params ({})
+    def get_recommendations(params = {}, options = {})
+      req = build_request(:get_recommendations, params)
+      req.send_request(options)
+    end
+
+    # List the available reports for a given profiling group and time range.
+    #
+    # @option params [Boolean] :daily_reports_only
+    #   A `Boolean` value indicating whether to only return reports from daily
+    #   profiles. If set to `True`, only analysis data from daily profiles is
+    #   returned. If set to `False`, analysis data is returned from smaller
+    #   time windows (for example, one hour).
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :end_time
+    #   The end time of the profile to get analysis data about. You must
+    #   specify `startTime` and `endTime`. This is specified using the ISO
+    #   8601 format. For example, 2020-06-01T13:15:02.001Z represents 1
+    #   millisecond past June 1, 2020 1:15:02 PM UTC.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of report results returned by `ListFindingsReports`
+    #   in paginated output. When this parameter is used,
+    #   `ListFindingsReports` only returns `maxResults` results in a single
+    #   page along with a `nextToken` response element. The remaining results
+    #   of the initial request can be seen by sending another
+    #   `ListFindingsReports` request with the returned `nextToken` value.
+    #
+    # @option params [String] :next_token
+    #   The `nextToken` value returned from a previous paginated
+    #   `ListFindingsReportsRequest` request where `maxResults` was used and
+    #   the results exceeded the value of that parameter. Pagination continues
+    #   from the end of the previous results that returned the `nextToken`
+    #   value.
+    #
+    #   <note markdown="1"> This token should be treated as an opaque identifier that is only used
+    #   to retrieve the next items in a list and not for other programmatic
+    #   purposes.
+    #
+    #    </note>
+    #
+    # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group from which to search for analysis
+    #   data.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :start_time
+    #   The start time of the profile to get analysis data about. You must
+    #   specify `startTime` and `endTime`. This is specified using the ISO
+    #   8601 format. For example, 2020-06-01T13:15:02.001Z represents 1
+    #   millisecond past June 1, 2020 1:15:02 PM UTC.
+    #
+    # @return [Types::ListFindingsReportsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListFindingsReportsResponse#findings_report_summaries #findings_report_summaries} => Array&lt;Types::FindingsReportSummary&gt;
+    #   * {Types::ListFindingsReportsResponse#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_findings_reports({
+    #     daily_reports_only: false,
+    #     end_time: Time.now, # required
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #     profiling_group_name: "ProfilingGroupName", # required
+    #     start_time: Time.now, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.findings_report_summaries #=> Array
+    #   resp.findings_report_summaries[0].id #=> String
+    #   resp.findings_report_summaries[0].profile_end_time #=> Time
+    #   resp.findings_report_summaries[0].profile_start_time #=> Time
+    #   resp.findings_report_summaries[0].profiling_group_name #=> String
+    #   resp.findings_report_summaries[0].total_number_of_findings #=> Integer
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/ListFindingsReports AWS API Documentation
+    #
+    # @overload list_findings_reports(params = {})
+    # @param [Hash] params ({})
+    def list_findings_reports(params = {}, options = {})
+      req = build_request(:list_findings_reports, params)
+      req.send_request(options)
+    end
+
+    # Lists the start times of the available aggregated profiles of a
     # profiling group for an aggregation period within the specified time
     # range.
     #
@@ -587,7 +1090,15 @@ module Aws::CodeGuruProfiler
     #   use when listing profiles. Defaults to `TIMESTAMP_DESCENDING`.
     #
     # @option params [required, String] :period
-    #   The aggregation period.
+    #   The aggregation period. This specifies the period during which an
+    #   aggregation profile collects posted agent profiles for a profiling
+    #   group. There are 3 valid values.
+    #
+    #   * `P1D` — 1 day
+    #
+    #   * `PT1H` — 1 hour
+    #
+    #   * `PT5M` — 5 minutes
     #
     # @option params [required, String] :profiling_group_name
     #   The name of the profiling group.
@@ -629,10 +1140,22 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
-    # Lists profiling groups.
+    # Returns a list of profiling groups. The profiling groups are returned
+    # as [ `ProfilingGroupDescription` ][1] objects.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_ProfilingGroupDescription.html
     #
     # @option params [Boolean] :include_description
-    #   A Boolean value indicating whether to include a description.
+    #   A `Boolean` value indicating whether to include a description. If
+    #   `true`, then a list of [ `ProfilingGroupDescription` ][1] objects that
+    #   contain detailed information about profiling groups is returned. If
+    #   `false`, then a list of profiling group names is returned.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_ProfilingGroupDescription.html
     #
     # @option params [Integer] :max_results
     #   The maximum number of profiling groups results returned by
@@ -679,6 +1202,7 @@ module Aws::CodeGuruProfiler
     #   resp.profiling_groups #=> Array
     #   resp.profiling_groups[0].agent_orchestration_config.profiling_enabled #=> Boolean
     #   resp.profiling_groups[0].arn #=> String
+    #   resp.profiling_groups[0].compute_platform #=> String, one of "AWSLambda", "Default"
     #   resp.profiling_groups[0].created_at #=> Time
     #   resp.profiling_groups[0].name #=> String
     #   resp.profiling_groups[0].profiling_status.latest_agent_orchestrated_at #=> Time
@@ -696,15 +1220,35 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
+    # Submits profiling data to an aggregated profile of a profiling group.
+    # To get an aggregated profile that is created with this profiling data,
+    # use [ `GetProfile` ][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_GetProfile.html
+    #
     # @option params [required, String, IO] :agent_profile
+    #   The submitted profiling data.
     #
     # @option params [required, String] :content_type
+    #   The format of the submitted profiling data. The format maps to the
+    #   `Accept` and `Content-Type` headers of the HTTP request. You can
+    #   specify one of the following: or the default .
+    #
+    #        <ul> <li> <p> <code>application/json</code> — standard JSON format </p> </li> <li> <p> <code>application/x-amzn-ion</code> — the Amazon Ion data format. For more information, see <a href="http://amzn.github.io/ion-docs/">Amazon Ion</a>. </p> </li> </ul>
     #
     # @option params [String] :profile_token
+    #   Amazon CodeGuru Profiler uses this universally unique identifier
+    #   (UUID) to prevent the accidental submission of duplicate profiling
+    #   data if there are failures and retries.
+    #
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
     # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group with the aggregated profile that
+    #   receives the submitted profiling data.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -726,24 +1270,34 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
-    # Provides permission to the principals. This overwrites the existing
-    # permissions, and is not additive.
+    # Adds permissions to a profiling group's resource-based policy that
+    # are provided using an action group. If a profiling group doesn't have
+    # a resource-based policy, one is created for it using the permissions
+    # in the action group and the roles and users in the `principals`
+    # parameter.
+    #
+    #      <p> The one supported action group that can be added is <code>agentPermission</code> which grants <code>ConfigureAgent</code> and <code>PostAgent</code> permissions. For more information, see <a href="https://docs.aws.amazon.com/codeguru/latest/profiler-ug/resource-based-policies.html">Resource-based policies in CodeGuru Profiler</a> in the <i>Amazon CodeGuru Profiler User Guide</i>, <a href="https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_ConfigureAgent.html"> <code>ConfigureAgent</code> </a>, and <a href="https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_PostAgentProfile.html"> <code>PostAgentProfile</code> </a>. </p> <p> The first time you call <code>PutPermission</code> on a profiling group, do not specify a <code>revisionId</code> because it doesn't have a resource-based policy. Subsequent calls must provide a <code>revisionId</code> to specify which revision of the resource-based policy to add the permissions to. </p> <p> The response contains the profiling group's JSON-formatted resource policy. </p>
     #
     # @option params [required, String] :action_group
-    #   The list of actions that the users and roles can perform on the
-    #   profiling group.
+    #   Specifies an action group that contains permissions to add to a
+    #   profiling group resource. One action group is supported,
+    #   `agentPermissions`, which grants permission to perform actions
+    #   required by the profiling agent, `ConfigureAgent` and
+    #   `PostAgentProfile` permissions.
     #
     # @option params [required, Array<String>] :principals
-    #   The list of role and user ARNs or the accountId that needs access
-    #   (wildcards are not allowed).
+    #   A list ARNs for the roles and users you want to grant access to the
+    #   profiling group. Wildcards are not are supported in the ARNs.
     #
     # @option params [required, String] :profiling_group_name
-    #   The name of the profiling group.
+    #   The name of the profiling group to grant access to.
     #
     # @option params [String] :revision_id
-    #   A unique identifier for the current revision of the policy. This is
-    #   required, if a policy exists for the profiling group. This is not
-    #   required when creating the policy for the first time.
+    #   A universally unique identifier (UUID) for the revision of the policy
+    #   you are adding to the profiling group. Do not specify this when you
+    #   add permissions to a profiling group for the first time. If a policy
+    #   already exists on the profiling group, you must specify the
+    #   `revisionId`.
     #
     # @return [Types::PutPermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -773,17 +1327,69 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
-    # Removes statement for the provided action group from the policy.
+    # Remove one anomaly notifications channel for a profiling group.
+    #
+    # @option params [required, String] :channel_id
+    #   The id of the channel that we want to stop receiving notifications.
+    #
+    # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group we want to change notification
+    #   configuration for.
+    #
+    # @return [Types::RemoveNotificationChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::RemoveNotificationChannelResponse#notification_configuration #notification_configuration} => Types::NotificationConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.remove_notification_channel({
+    #     channel_id: "ChannelId", # required
+    #     profiling_group_name: "ProfilingGroupName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.notification_configuration.channels #=> Array
+    #   resp.notification_configuration.channels[0].event_publishers #=> Array
+    #   resp.notification_configuration.channels[0].event_publishers[0] #=> String, one of "AnomalyDetection"
+    #   resp.notification_configuration.channels[0].id #=> String
+    #   resp.notification_configuration.channels[0].uri #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/RemoveNotificationChannel AWS API Documentation
+    #
+    # @overload remove_notification_channel(params = {})
+    # @param [Hash] params ({})
+    def remove_notification_channel(params = {}, options = {})
+      req = build_request(:remove_notification_channel, params)
+      req.send_request(options)
+    end
+
+    # Removes permissions from a profiling group's resource-based policy
+    # that are provided using an action group. The one supported action
+    # group that can be removed is `agentPermission` which grants
+    # `ConfigureAgent` and `PostAgent` permissions. For more information,
+    # see [Resource-based policies in CodeGuru Profiler][1] in the *Amazon
+    # CodeGuru Profiler User Guide*, [ `ConfigureAgent` ][2], and [
+    # `PostAgentProfile` ][3].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-ug/resource-based-policies.html
+    # [2]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_ConfigureAgent.html
+    # [3]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_PostAgentProfile.html
     #
     # @option params [required, String] :action_group
-    #   The list of actions that the users and roles can perform on the
-    #   profiling group.
+    #   Specifies an action group that contains the permissions to remove from
+    #   a profiling group's resource-based policy. One action group is
+    #   supported, `agentPermissions`, which grants `ConfigureAgent` and
+    #   `PostAgentProfile` permissions.
     #
     # @option params [required, String] :profiling_group_name
     #   The name of the profiling group.
     #
     # @option params [required, String] :revision_id
-    #   A unique identifier for the current revision of the policy.
+    #   A universally unique identifier (UUID) for the revision of the
+    #   resource-based policy from which you want to remove permissions.
     #
     # @return [Types::RemovePermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -812,9 +1418,53 @@ module Aws::CodeGuruProfiler
       req.send_request(options)
     end
 
+    # Sends feedback to CodeGuru Profiler about whether the anomaly detected
+    # by the analysis is useful or not.
+    #
+    # @option params [required, String] :anomaly_instance_id
+    #   The universally unique identifier (UUID) of the [ `AnomalyInstance`
+    #   ][1] object that is included in the analysis data.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/codeguru/latest/profiler-api/API_AnomalyInstance.html
+    #
+    # @option params [String] :comment
+    #   Optional feedback about this anomaly.
+    #
+    # @option params [required, String] :profiling_group_name
+    #   The name of the profiling group that is associated with the analysis
+    #   data.
+    #
+    # @option params [required, String] :type
+    #   The feedback tpye. Thee are two valid values, `Positive` and
+    #   `Negative`.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.submit_feedback({
+    #     anomaly_instance_id: "AnomalyInstanceId", # required
+    #     comment: "String",
+    #     profiling_group_name: "ProfilingGroupName", # required
+    #     type: "Negative", # required, accepts Negative, Positive
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codeguruprofiler-2019-07-18/SubmitFeedback AWS API Documentation
+    #
+    # @overload submit_feedback(params = {})
+    # @param [Hash] params ({})
+    def submit_feedback(params = {}, options = {})
+      req = build_request(:submit_feedback, params)
+      req.send_request(options)
+    end
+
     # Updates a profiling group.
     #
     # @option params [required, Types::AgentOrchestrationConfig] :agent_orchestration_config
+    #   Specifies whether profiling is enabled or disabled for a profiling
+    #   group.
     #
     # @option params [required, String] :profiling_group_name
     #   The name of the profiling group to update.
@@ -836,6 +1486,7 @@ module Aws::CodeGuruProfiler
     #
     #   resp.profiling_group.agent_orchestration_config.profiling_enabled #=> Boolean
     #   resp.profiling_group.arn #=> String
+    #   resp.profiling_group.compute_platform #=> String, one of "AWSLambda", "Default"
     #   resp.profiling_group.created_at #=> Time
     #   resp.profiling_group.name #=> String
     #   resp.profiling_group.profiling_status.latest_agent_orchestrated_at #=> Time
@@ -866,7 +1517,7 @@ module Aws::CodeGuruProfiler
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-codeguruprofiler'
-      context[:gem_version] = '1.7.0'
+      context[:gem_version] = '1.8.0'
       Seahorse::Client::Request.new(handlers, context)
     end