aws-sdk-computeoptimizer 1.34.0 → 1.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2718a575580c615691a5d00f12a9488453f78a13b1767d26c0eb9304f4df05b1
-  data.tar.gz: 7b35bde9b37994545e96aea0b87e937406629c46b17761711d9b0a25d72c5263
+  metadata.gz: b68204fd661f1889eba77a4701d4e5b588d63c0e82988461988dffa32019076f
+  data.tar.gz: a66797eab250ed6082d70cc6e9fdeb1669098f4cc6d56ff8cbaf4196b904c8b0
 SHA512:
-  metadata.gz: 6d3c82defe250d0850cb6550ef31d6952f2d3ca58f7fb54a352393299319903d4628273b1b3191909456c3a13da5711f7f7ea11439b14ba3b78783bc0655ee92
-  data.tar.gz: aa67ba9f612489ceedc93d0aaf600ea12381e9e3dcdaf98e35de3a244d760f8c4227b7dbfbda4dd60b5e63aefaf8186a5fdd650eb31317cc102747241fe8407e
+  metadata.gz: 26180c3484f669a9caed27c8387bc5eeac742f8e32340a68afe6913029369f239c943d26a8d4cb38599a6aa359c637665fe489d4dc763e7d461aad39f422d428
+  data.tar.gz: 5c92d70b55535c4401f7f60403ba10d357c5803a731839f9ebf10cfb11ee7507e4adef5ee0f4d8b78c22a4f38e658e8825a40f89d76d9bd52f5e99ce15c69a28

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.36.0 (2022-12-22)
+------------------
+
+* Feature - This release enables AWS Compute Optimizer to analyze and generate optimization recommendations for ecs services running on Fargate.
+
+1.35.0 (2022-11-29)
+------------------
+
+* Feature - Adds support for a new recommendation preference that makes it possible for customers to optimize their EC2 recommendations by utilizing an external metrics ingestion service to provide metrics.
+
 1.34.0 (2022-10-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.34.0
+1.36.0

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

@@ -418,21 +418,17 @@ module Aws::ComputeOptimizer
     # @option params [required, Array<String>] :recommendation_preference_names
     #   The name of the recommendation preference to delete.
     #
-    #   Enhanced infrastructure metrics (`EnhancedInfrastructureMetrics`) is
-    #   the only feature that can be activated through preferences. Therefore,
-    #   it is also the only recommendation preference that can be deleted.
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_recommendation_preferences({
-    #     resource_type: "Ec2Instance", # required, accepts Ec2Instance, AutoScalingGroup, EbsVolume, LambdaFunction, NotApplicable
+    #     resource_type: "Ec2Instance", # required, accepts Ec2Instance, AutoScalingGroup, EbsVolume, LambdaFunction, NotApplicable, EcsService
     #     scope: {
     #       name: "Organization", # accepts Organization, AccountId, ResourceArn
     #       value: "ScopeValue",
     #     },
-    #     recommendation_preference_names: ["EnhancedInfrastructureMetrics"], # required, accepts EnhancedInfrastructureMetrics, InferredWorkloadTypes
+    #     recommendation_preference_names: ["EnhancedInfrastructureMetrics"], # required, accepts EnhancedInfrastructureMetrics, InferredWorkloadTypes, ExternalMetricsPreference
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/compute-optimizer-2019-11-01/DeleteRecommendationPreferences AWS API Documentation
@@ -479,6 +475,8 @@ module Aws::ComputeOptimizer
     #   * {Types::DescribeRecommendationExportJobsResponse#recommendation_export_jobs #recommendation_export_jobs} => Array&lt;Types::RecommendationExportJob&gt;
     #   * {Types::DescribeRecommendationExportJobsResponse#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_recommendation_export_jobs({
@@ -500,7 +498,7 @@ module Aws::ComputeOptimizer
     #   resp.recommendation_export_jobs[0].destination.s3.bucket #=> String
     #   resp.recommendation_export_jobs[0].destination.s3.key #=> String
     #   resp.recommendation_export_jobs[0].destination.s3.metadata_key #=> String
-    #   resp.recommendation_export_jobs[0].resource_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction", "NotApplicable"
+    #   resp.recommendation_export_jobs[0].resource_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction", "NotApplicable", "EcsService"
     #   resp.recommendation_export_jobs[0].status #=> String, one of "Queued", "InProgress", "Complete", "Failed"
     #   resp.recommendation_export_jobs[0].creation_timestamp #=> Time
     #   resp.recommendation_export_jobs[0].last_updated_timestamp #=> Time
@@ -892,7 +890,7 @@ module Aws::ComputeOptimizer
     #         values: ["FilterValue"],
     #       },
     #     ],
-    #     fields_to_export: ["AccountId"], # accepts AccountId, InstanceArn, InstanceName, Finding, FindingReasonCodes, LookbackPeriodInDays, CurrentInstanceType, UtilizationMetricsCpuMaximum, UtilizationMetricsMemoryMaximum, UtilizationMetricsEbsReadOpsPerSecondMaximum, UtilizationMetricsEbsWriteOpsPerSecondMaximum, UtilizationMetricsEbsReadBytesPerSecondMaximum, UtilizationMetricsEbsWriteBytesPerSecondMaximum, UtilizationMetricsDiskReadOpsPerSecondMaximum, UtilizationMetricsDiskWriteOpsPerSecondMaximum, UtilizationMetricsDiskReadBytesPerSecondMaximum, UtilizationMetricsDiskWriteBytesPerSecondMaximum, UtilizationMetricsNetworkInBytesPerSecondMaximum, UtilizationMetricsNetworkOutBytesPerSecondMaximum, UtilizationMetricsNetworkPacketsInPerSecondMaximum, UtilizationMetricsNetworkPacketsOutPerSecondMaximum, CurrentOnDemandPrice, CurrentStandardOneYearNoUpfrontReservedPrice, CurrentStandardThreeYearNoUpfrontReservedPrice, CurrentVCpus, CurrentMemory, CurrentStorage, CurrentNetwork, RecommendationOptionsInstanceType, RecommendationOptionsProjectedUtilizationMetricsCpuMaximum, RecommendationOptionsProjectedUtilizationMetricsMemoryMaximum, RecommendationOptionsPlatformDifferences, RecommendationOptionsPerformanceRisk, RecommendationOptionsVcpus, RecommendationOptionsMemory, RecommendationOptionsStorage, RecommendationOptionsNetwork, RecommendationOptionsOnDemandPrice, RecommendationOptionsStandardOneYearNoUpfrontReservedPrice, RecommendationOptionsStandardThreeYearNoUpfrontReservedPrice, RecommendationsSourcesRecommendationSourceArn, RecommendationsSourcesRecommendationSourceType, LastRefreshTimestamp, CurrentPerformanceRisk, RecommendationOptionsSavingsOpportunityPercentage, RecommendationOptionsEstimatedMonthlySavingsCurrency, RecommendationOptionsEstimatedMonthlySavingsValue, EffectiveRecommendationPreferencesCpuVendorArchitectures, EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics, EffectiveRecommendationPreferencesInferredWorkloadTypes, InferredWorkloadTypes, RecommendationOptionsMigrationEffort
+    #     fields_to_export: ["AccountId"], # accepts AccountId, InstanceArn, InstanceName, Finding, FindingReasonCodes, LookbackPeriodInDays, CurrentInstanceType, UtilizationMetricsCpuMaximum, UtilizationMetricsMemoryMaximum, UtilizationMetricsEbsReadOpsPerSecondMaximum, UtilizationMetricsEbsWriteOpsPerSecondMaximum, UtilizationMetricsEbsReadBytesPerSecondMaximum, UtilizationMetricsEbsWriteBytesPerSecondMaximum, UtilizationMetricsDiskReadOpsPerSecondMaximum, UtilizationMetricsDiskWriteOpsPerSecondMaximum, UtilizationMetricsDiskReadBytesPerSecondMaximum, UtilizationMetricsDiskWriteBytesPerSecondMaximum, UtilizationMetricsNetworkInBytesPerSecondMaximum, UtilizationMetricsNetworkOutBytesPerSecondMaximum, UtilizationMetricsNetworkPacketsInPerSecondMaximum, UtilizationMetricsNetworkPacketsOutPerSecondMaximum, CurrentOnDemandPrice, CurrentStandardOneYearNoUpfrontReservedPrice, CurrentStandardThreeYearNoUpfrontReservedPrice, CurrentVCpus, CurrentMemory, CurrentStorage, CurrentNetwork, RecommendationOptionsInstanceType, RecommendationOptionsProjectedUtilizationMetricsCpuMaximum, RecommendationOptionsProjectedUtilizationMetricsMemoryMaximum, RecommendationOptionsPlatformDifferences, RecommendationOptionsPerformanceRisk, RecommendationOptionsVcpus, RecommendationOptionsMemory, RecommendationOptionsStorage, RecommendationOptionsNetwork, RecommendationOptionsOnDemandPrice, RecommendationOptionsStandardOneYearNoUpfrontReservedPrice, RecommendationOptionsStandardThreeYearNoUpfrontReservedPrice, RecommendationsSourcesRecommendationSourceArn, RecommendationsSourcesRecommendationSourceType, LastRefreshTimestamp, CurrentPerformanceRisk, RecommendationOptionsSavingsOpportunityPercentage, RecommendationOptionsEstimatedMonthlySavingsCurrency, RecommendationOptionsEstimatedMonthlySavingsValue, EffectiveRecommendationPreferencesCpuVendorArchitectures, EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics, EffectiveRecommendationPreferencesInferredWorkloadTypes, InferredWorkloadTypes, RecommendationOptionsMigrationEffort, EffectiveRecommendationPreferencesExternalMetricsSource
     #     s3_destination_config: { # required
     #       bucket: "DestinationBucket",
     #       key_prefix: "DestinationKeyPrefix",
@@ -920,6 +918,136 @@ module Aws::ComputeOptimizer
       req.send_request(options)
     end
 
+    # Exports optimization recommendations for Amazon ECS services on
+    # Fargate.
+    #
+    # Recommendations are exported in a CSV file, and its metadata in a JSON
+    # file, to an existing Amazon Simple Storage Service (Amazon S3) bucket
+    # that you specify. For more information, see [Exporting
+    # Recommendations][1] in the *Compute Optimizer User Guide*.
+    #
+    # You can only have one Amazon ECS service export job in progress per
+    # Amazon Web Services Region.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/compute-optimizer/latest/ug/exporting-recommendations.html
+    #
+    # @option params [Array<String>] :account_ids
+    #   The Amazon Web Services account IDs for the export ECS service
+    #   recommendations.
+    #
+    #   If your account is the management account or the delegated
+    #   administrator of an organization, use this parameter to specify the
+    #   member account you want to export recommendations to.
+    #
+    #   This parameter can't be specified together with the include member
+    #   accounts parameter. The parameters are mutually exclusive.
+    #
+    #   If this parameter or the include member accounts parameter is omitted,
+    #   the recommendations for member accounts aren't included in the
+    #   export.
+    #
+    #   You can specify multiple account IDs per request.
+    #
+    # @option params [Array<Types::ECSServiceRecommendationFilter>] :filters
+    #   An array of objects to specify a filter that exports a more specific
+    #   set of ECS service recommendations.
+    #
+    # @option params [Array<String>] :fields_to_export
+    #   The recommendations data to include in the export file. For more
+    #   information about the fields that can be exported, see [Exported
+    #   files][1] in the *Compute Optimizer User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/compute-optimizer/latest/ug/exporting-recommendations.html#exported-files
+    #
+    # @option params [required, Types::S3DestinationConfig] :s3_destination_config
+    #   Describes the destination Amazon Simple Storage Service (Amazon S3)
+    #   bucket name and key prefix for a recommendations export job.
+    #
+    #   You must create the destination Amazon S3 bucket for your
+    #   recommendations export before you create the export job. Compute
+    #   Optimizer does not create the S3 bucket for you. After you create the
+    #   S3 bucket, ensure that it has the required permission policy to allow
+    #   Compute Optimizer to write the export file to it. If you plan to
+    #   specify an object prefix when you create the export job, you must
+    #   include the object prefix in the policy that you add to the S3 bucket.
+    #   For more information, see [Amazon S3 Bucket Policy for Compute
+    #   Optimizer][1] in the *Compute Optimizer User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/compute-optimizer/latest/ug/create-s3-bucket-policy-for-compute-optimizer.html
+    #
+    # @option params [String] :file_format
+    #   The format of the export file.
+    #
+    #   The CSV file is the only export file format currently supported.
+    #
+    # @option params [Boolean] :include_member_accounts
+    #   If your account is the management account or the delegated
+    #   administrator of an organization, this parameter indicates whether to
+    #   include recommendations for resources in all member accounts of the
+    #   organization.
+    #
+    #   The member accounts must also be opted in to Compute Optimizer, and
+    #   trusted access for Compute Optimizer must be enabled in the
+    #   organization account. For more information, see [Compute Optimizer and
+    #   Amazon Web Services Organizations trusted access][1] in the *Compute
+    #   Optimizer User Guide*.
+    #
+    #   If this parameter is omitted, recommendations for member accounts of
+    #   the organization aren't included in the export file.
+    #
+    #   If this parameter or the account ID parameter is omitted,
+    #   recommendations for member accounts aren't included in the export.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/compute-optimizer/latest/ug/security-iam.html#trusted-service-access
+    #
+    # @return [Types::ExportECSServiceRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ExportECSServiceRecommendationsResponse#job_id #job_id} => String
+    #   * {Types::ExportECSServiceRecommendationsResponse#s3_destination #s3_destination} => Types::S3Destination
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.export_ecs_service_recommendations({
+    #     account_ids: ["AccountId"],
+    #     filters: [
+    #       {
+    #         name: "Finding", # accepts Finding, FindingReasonCode
+    #         values: ["FilterValue"],
+    #       },
+    #     ],
+    #     fields_to_export: ["AccountId"], # accepts AccountId, ServiceArn, LookbackPeriodInDays, LastRefreshTimestamp, LaunchType, CurrentPerformanceRisk, CurrentServiceConfigurationMemory, CurrentServiceConfigurationCpu, CurrentServiceConfigurationTaskDefinitionArn, CurrentServiceConfigurationAutoScalingConfiguration, CurrentServiceContainerConfigurations, UtilizationMetricsCpuMaximum, UtilizationMetricsMemoryMaximum, Finding, FindingReasonCodes, RecommendationOptionsMemory, RecommendationOptionsCpu, RecommendationOptionsSavingsOpportunityPercentage, RecommendationOptionsEstimatedMonthlySavingsCurrency, RecommendationOptionsEstimatedMonthlySavingsValue, RecommendationOptionsContainerRecommendations, RecommendationOptionsProjectedUtilizationMetricsCpuMaximum, RecommendationOptionsProjectedUtilizationMetricsMemoryMaximum
+    #     s3_destination_config: { # required
+    #       bucket: "DestinationBucket",
+    #       key_prefix: "DestinationKeyPrefix",
+    #     },
+    #     file_format: "Csv", # accepts Csv
+    #     include_member_accounts: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.job_id #=> String
+    #   resp.s3_destination.bucket #=> String
+    #   resp.s3_destination.key #=> String
+    #   resp.s3_destination.metadata_key #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/compute-optimizer-2019-11-01/ExportECSServiceRecommendations AWS API Documentation
+    #
+    # @overload export_ecs_service_recommendations(params = {})
+    # @param [Hash] params ({})
+    def export_ecs_service_recommendations(params = {}, options = {})
+      req = build_request(:export_ecs_service_recommendations, params)
+      req.send_request(options)
+    end
+
     # Exports optimization recommendations for Lambda functions.
     #
     # Recommendations are exported in a comma-separated values (.csv) file,
@@ -1157,6 +1285,7 @@ module Aws::ComputeOptimizer
     #   resp.auto_scaling_group_recommendations[0].effective_recommendation_preferences.cpu_vendor_architectures[0] #=> String, one of "AWS_ARM64", "CURRENT"
     #   resp.auto_scaling_group_recommendations[0].effective_recommendation_preferences.enhanced_infrastructure_metrics #=> String, one of "Active", "Inactive"
     #   resp.auto_scaling_group_recommendations[0].effective_recommendation_preferences.inferred_workload_types #=> String, one of "Active", "Inactive"
+    #   resp.auto_scaling_group_recommendations[0].effective_recommendation_preferences.external_metrics_preference.source #=> String, one of "Datadog", "Dynatrace", "NewRelic", "Instana"
     #   resp.auto_scaling_group_recommendations[0].inferred_workload_types #=> Array
     #   resp.auto_scaling_group_recommendations[0].inferred_workload_types[0] #=> String, one of "AmazonEmr", "ApacheCassandra", "ApacheHadoop", "Memcached", "Nginx", "PostgreSql", "Redis"
     #   resp.errors #=> Array
@@ -1379,13 +1508,14 @@ module Aws::ComputeOptimizer
     #   resp.instance_recommendations[0].recommendation_options[0].migration_effort #=> String, one of "VeryLow", "Low", "Medium", "High"
     #   resp.instance_recommendations[0].recommendation_sources #=> Array
     #   resp.instance_recommendations[0].recommendation_sources[0].recommendation_source_arn #=> String
-    #   resp.instance_recommendations[0].recommendation_sources[0].recommendation_source_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction"
+    #   resp.instance_recommendations[0].recommendation_sources[0].recommendation_source_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction", "EcsService"
     #   resp.instance_recommendations[0].last_refresh_timestamp #=> Time
     #   resp.instance_recommendations[0].current_performance_risk #=> String, one of "VeryLow", "Low", "Medium", "High"
     #   resp.instance_recommendations[0].effective_recommendation_preferences.cpu_vendor_architectures #=> Array
     #   resp.instance_recommendations[0].effective_recommendation_preferences.cpu_vendor_architectures[0] #=> String, one of "AWS_ARM64", "CURRENT"
     #   resp.instance_recommendations[0].effective_recommendation_preferences.enhanced_infrastructure_metrics #=> String, one of "Active", "Inactive"
     #   resp.instance_recommendations[0].effective_recommendation_preferences.inferred_workload_types #=> String, one of "Active", "Inactive"
+    #   resp.instance_recommendations[0].effective_recommendation_preferences.external_metrics_preference.source #=> String, one of "Datadog", "Dynatrace", "NewRelic", "Instana"
     #   resp.instance_recommendations[0].inferred_workload_types #=> Array
     #   resp.instance_recommendations[0].inferred_workload_types[0] #=> String, one of "AmazonEmr", "ApacheCassandra", "ApacheHadoop", "Memcached", "Nginx", "PostgreSql", "Redis"
     #   resp.errors #=> Array
@@ -1475,6 +1605,183 @@ module Aws::ComputeOptimizer
       req.send_request(options)
     end
 
+    # Returns the projected metrics of Amazon ECS service recommendations.
+    #
+    # @option params [required, String] :service_arn
+    #   The ARN that identifies the ECS service.
+    #
+    #   The following is the format of the ARN:
+    #
+    #   `arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name`
+    #
+    # @option params [required, String] :stat
+    #   The statistic of the projected metrics.
+    #
+    # @option params [required, Integer] :period
+    #   The granularity, in seconds, of the projected metrics data points.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :start_time
+    #   The timestamp of the first projected metrics data point to return.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :end_time
+    #   The timestamp of the last projected metrics data point to return.
+    #
+    # @return [Types::GetECSServiceRecommendationProjectedMetricsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetECSServiceRecommendationProjectedMetricsResponse#recommended_option_projected_metrics #recommended_option_projected_metrics} => Array&lt;Types::ECSServiceRecommendedOptionProjectedMetric&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_ecs_service_recommendation_projected_metrics({
+    #     service_arn: "ServiceArn", # required
+    #     stat: "Maximum", # required, accepts Maximum, Average
+    #     period: 1, # required
+    #     start_time: Time.now, # required
+    #     end_time: Time.now, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.recommended_option_projected_metrics #=> Array
+    #   resp.recommended_option_projected_metrics[0].recommended_cpu_units #=> Integer
+    #   resp.recommended_option_projected_metrics[0].recommended_memory_size #=> Integer
+    #   resp.recommended_option_projected_metrics[0].projected_metrics #=> Array
+    #   resp.recommended_option_projected_metrics[0].projected_metrics[0].name #=> String, one of "Cpu", "Memory"
+    #   resp.recommended_option_projected_metrics[0].projected_metrics[0].timestamps #=> Array
+    #   resp.recommended_option_projected_metrics[0].projected_metrics[0].timestamps[0] #=> Time
+    #   resp.recommended_option_projected_metrics[0].projected_metrics[0].upper_bound_values #=> Array
+    #   resp.recommended_option_projected_metrics[0].projected_metrics[0].upper_bound_values[0] #=> Float
+    #   resp.recommended_option_projected_metrics[0].projected_metrics[0].lower_bound_values #=> Array
+    #   resp.recommended_option_projected_metrics[0].projected_metrics[0].lower_bound_values[0] #=> Float
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/compute-optimizer-2019-11-01/GetECSServiceRecommendationProjectedMetrics AWS API Documentation
+    #
+    # @overload get_ecs_service_recommendation_projected_metrics(params = {})
+    # @param [Hash] params ({})
+    def get_ecs_service_recommendation_projected_metrics(params = {}, options = {})
+      req = build_request(:get_ecs_service_recommendation_projected_metrics, params)
+      req.send_request(options)
+    end
+
+    # Returns Amazon ECS service recommendations.
+    #
+    # Compute Optimizer generates recommendations for Amazon ECS services on
+    # Fargate that meet a specific set of requirements. For more
+    # information, see the [Supported resources and requirements][1] in the
+    # *Compute Optimizer User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/compute-optimizer/latest/ug/requirements.html
+    #
+    # @option params [Array<String>] :service_arns
+    #   The ARN that identifies the ECS service.
+    #
+    #   The following is the format of the ARN:
+    #
+    #   `arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name`
+    #
+    # @option params [String] :next_token
+    #   The token to advance to the next page of ECS service recommendations.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of ECS service recommendations to return with a
+    #   single request.
+    #
+    #   To retrieve the remaining results, make another request with the
+    #   returned `nextToken` value.
+    #
+    # @option params [Array<Types::ECSServiceRecommendationFilter>] :filters
+    #   An array of objects to specify a filter that returns a more specific
+    #   list of ECS service recommendations.
+    #
+    # @option params [Array<String>] :account_ids
+    #   Return the ECS service recommendations to the specified Amazon Web
+    #   Services account IDs.
+    #
+    #   If your account is the management account or the delegated
+    #   administrator of an organization, use this parameter to return the ECS
+    #   service recommendations to specific member accounts.
+    #
+    #   You can only specify one account ID per request.
+    #
+    # @return [Types::GetECSServiceRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetECSServiceRecommendationsResponse#next_token #next_token} => String
+    #   * {Types::GetECSServiceRecommendationsResponse#ecs_service_recommendations #ecs_service_recommendations} => Array&lt;Types::ECSServiceRecommendation&gt;
+    #   * {Types::GetECSServiceRecommendationsResponse#errors #errors} => Array&lt;Types::GetRecommendationError&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_ecs_service_recommendations({
+    #     service_arns: ["ServiceArn"],
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #     filters: [
+    #       {
+    #         name: "Finding", # accepts Finding, FindingReasonCode
+    #         values: ["FilterValue"],
+    #       },
+    #     ],
+    #     account_ids: ["AccountId"],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.ecs_service_recommendations #=> Array
+    #   resp.ecs_service_recommendations[0].service_arn #=> String
+    #   resp.ecs_service_recommendations[0].account_id #=> String
+    #   resp.ecs_service_recommendations[0].current_service_configuration.memory #=> Integer
+    #   resp.ecs_service_recommendations[0].current_service_configuration.cpu #=> Integer
+    #   resp.ecs_service_recommendations[0].current_service_configuration.container_configurations #=> Array
+    #   resp.ecs_service_recommendations[0].current_service_configuration.container_configurations[0].container_name #=> String
+    #   resp.ecs_service_recommendations[0].current_service_configuration.container_configurations[0].memory_size_configuration.memory #=> Integer
+    #   resp.ecs_service_recommendations[0].current_service_configuration.container_configurations[0].memory_size_configuration.memory_reservation #=> Integer
+    #   resp.ecs_service_recommendations[0].current_service_configuration.container_configurations[0].cpu #=> Integer
+    #   resp.ecs_service_recommendations[0].current_service_configuration.auto_scaling_configuration #=> String, one of "TargetTrackingScalingCpu", "TargetTrackingScalingMemory"
+    #   resp.ecs_service_recommendations[0].current_service_configuration.task_definition_arn #=> String
+    #   resp.ecs_service_recommendations[0].utilization_metrics #=> Array
+    #   resp.ecs_service_recommendations[0].utilization_metrics[0].name #=> String, one of "Cpu", "Memory"
+    #   resp.ecs_service_recommendations[0].utilization_metrics[0].statistic #=> String, one of "Maximum", "Average"
+    #   resp.ecs_service_recommendations[0].utilization_metrics[0].value #=> Float
+    #   resp.ecs_service_recommendations[0].lookback_period_in_days #=> Float
+    #   resp.ecs_service_recommendations[0].launch_type #=> String, one of "EC2", "Fargate"
+    #   resp.ecs_service_recommendations[0].last_refresh_timestamp #=> Time
+    #   resp.ecs_service_recommendations[0].finding #=> String, one of "Optimized", "Underprovisioned", "Overprovisioned"
+    #   resp.ecs_service_recommendations[0].finding_reason_codes #=> Array
+    #   resp.ecs_service_recommendations[0].finding_reason_codes[0] #=> String, one of "MemoryOverprovisioned", "MemoryUnderprovisioned", "CPUOverprovisioned", "CPUUnderprovisioned"
+    #   resp.ecs_service_recommendations[0].service_recommendation_options #=> Array
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].memory #=> Integer
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].cpu #=> Integer
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].savings_opportunity.savings_opportunity_percentage #=> Float
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].savings_opportunity.estimated_monthly_savings.currency #=> String, one of "USD", "CNY"
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].savings_opportunity.estimated_monthly_savings.value #=> Float
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].projected_utilization_metrics #=> Array
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].projected_utilization_metrics[0].name #=> String, one of "Cpu", "Memory"
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].projected_utilization_metrics[0].statistic #=> String, one of "Maximum", "Average"
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].projected_utilization_metrics[0].lower_bound_value #=> Float
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].projected_utilization_metrics[0].upper_bound_value #=> Float
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].container_recommendations #=> Array
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].container_recommendations[0].container_name #=> String
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].container_recommendations[0].memory_size_configuration.memory #=> Integer
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].container_recommendations[0].memory_size_configuration.memory_reservation #=> Integer
+    #   resp.ecs_service_recommendations[0].service_recommendation_options[0].container_recommendations[0].cpu #=> Integer
+    #   resp.ecs_service_recommendations[0].current_performance_risk #=> String, one of "VeryLow", "Low", "Medium", "High"
+    #   resp.errors #=> Array
+    #   resp.errors[0].identifier #=> String
+    #   resp.errors[0].code #=> String
+    #   resp.errors[0].message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/compute-optimizer-2019-11-01/GetECSServiceRecommendations AWS API Documentation
+    #
+    # @overload get_ecs_service_recommendations(params = {})
+    # @param [Hash] params ({})
+    def get_ecs_service_recommendations(params = {}, options = {})
+      req = build_request(:get_ecs_service_recommendations, params)
+      req.send_request(options)
+    end
+
     # Returns the recommendation preferences that are in effect for a given
     # resource, such as enhanced infrastructure metrics. Considers all
     # applicable preferences that you might have set at the resource,
@@ -1492,6 +1799,7 @@ module Aws::ComputeOptimizer
     # @return [Types::GetEffectiveRecommendationPreferencesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetEffectiveRecommendationPreferencesResponse#enhanced_infrastructure_metrics #enhanced_infrastructure_metrics} => String
+    #   * {Types::GetEffectiveRecommendationPreferencesResponse#external_metrics_preference #external_metrics_preference} => Types::ExternalMetricsPreference
     #
     # @example Request syntax with placeholder values
     #
@@ -1502,6 +1810,7 @@ module Aws::ComputeOptimizer
     # @example Response structure
     #
     #   resp.enhanced_infrastructure_metrics #=> String, one of "Active", "Inactive"
+    #   resp.external_metrics_preference.source #=> String, one of "Datadog", "Dynatrace", "NewRelic", "Instana"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/compute-optimizer-2019-11-01/GetEffectiveRecommendationPreferences AWS API Documentation
     #
@@ -1573,6 +1882,8 @@ module Aws::ComputeOptimizer
     #   * {Types::GetEnrollmentStatusesForOrganizationResponse#account_enrollment_statuses #account_enrollment_statuses} => Array&lt;Types::AccountEnrollmentStatus&gt;
     #   * {Types::GetEnrollmentStatusesForOrganizationResponse#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_enrollment_statuses_for_organization({
@@ -1659,6 +1970,8 @@ module Aws::ComputeOptimizer
     #   * {Types::GetLambdaFunctionRecommendationsResponse#next_token #next_token} => String
     #   * {Types::GetLambdaFunctionRecommendationsResponse#lambda_function_recommendations #lambda_function_recommendations} => Array&lt;Types::LambdaFunctionRecommendation&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_lambda_function_recommendations({
@@ -1771,10 +2084,12 @@ module Aws::ComputeOptimizer
     #   * {Types::GetRecommendationPreferencesResponse#next_token #next_token} => String
     #   * {Types::GetRecommendationPreferencesResponse#recommendation_preferences_details #recommendation_preferences_details} => Array&lt;Types::RecommendationPreferencesDetail&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_recommendation_preferences({
-    #     resource_type: "Ec2Instance", # required, accepts Ec2Instance, AutoScalingGroup, EbsVolume, LambdaFunction, NotApplicable
+    #     resource_type: "Ec2Instance", # required, accepts Ec2Instance, AutoScalingGroup, EbsVolume, LambdaFunction, NotApplicable, EcsService
     #     scope: {
     #       name: "Organization", # accepts Organization, AccountId, ResourceArn
     #       value: "ScopeValue",
@@ -1789,9 +2104,10 @@ module Aws::ComputeOptimizer
     #   resp.recommendation_preferences_details #=> Array
     #   resp.recommendation_preferences_details[0].scope.name #=> String, one of "Organization", "AccountId", "ResourceArn"
     #   resp.recommendation_preferences_details[0].scope.value #=> String
-    #   resp.recommendation_preferences_details[0].resource_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction", "NotApplicable"
+    #   resp.recommendation_preferences_details[0].resource_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction", "NotApplicable", "EcsService"
     #   resp.recommendation_preferences_details[0].enhanced_infrastructure_metrics #=> String, one of "Active", "Inactive"
     #   resp.recommendation_preferences_details[0].inferred_workload_types #=> String, one of "Active", "Inactive"
+    #   resp.recommendation_preferences_details[0].external_metrics_preference.source #=> String, one of "Datadog", "Dynatrace", "NewRelic", "Instana"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/compute-optimizer-2019-11-01/GetRecommendationPreferences AWS API Documentation
     #
@@ -1818,6 +2134,9 @@ module Aws::ComputeOptimizer
     # * Lambda functions in an account that are `NotOptimized`, or
     #   `Optimized`.
     #
+    # * Amazon ECS services in an account that are `Underprovisioned`,
+    #   `Overprovisioned`, or `Optimized`.
+    #
     # @option params [Array<String>] :account_ids
     #   The ID of the Amazon Web Services account for which to return
     #   recommendation summaries.
@@ -1843,6 +2162,8 @@ module Aws::ComputeOptimizer
     #   * {Types::GetRecommendationSummariesResponse#next_token #next_token} => String
     #   * {Types::GetRecommendationSummariesResponse#recommendation_summaries #recommendation_summaries} => Array&lt;Types::RecommendationSummary&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_recommendation_summaries({
@@ -1861,7 +2182,7 @@ module Aws::ComputeOptimizer
     #   resp.recommendation_summaries[0].summaries[0].reason_code_summaries #=> Array
     #   resp.recommendation_summaries[0].summaries[0].reason_code_summaries[0].name #=> String, one of "MemoryOverprovisioned", "MemoryUnderprovisioned"
     #   resp.recommendation_summaries[0].summaries[0].reason_code_summaries[0].value #=> Float
-    #   resp.recommendation_summaries[0].recommendation_resource_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction"
+    #   resp.recommendation_summaries[0].recommendation_resource_type #=> String, one of "Ec2Instance", "AutoScalingGroup", "EbsVolume", "LambdaFunction", "EcsService"
     #   resp.recommendation_summaries[0].account_id #=> String
     #   resp.recommendation_summaries[0].savings_opportunity.savings_opportunity_percentage #=> Float
     #   resp.recommendation_summaries[0].savings_opportunity.estimated_monthly_savings.currency #=> String, one of "USD", "CNY"
@@ -1962,18 +2283,38 @@ module Aws::ComputeOptimizer
     #
     #   [1]: https://docs.aws.amazon.com/compute-optimizer/latest/ug/inferred-workload-types.html
     #
+    # @option params [Types::ExternalMetricsPreference] :external_metrics_preference
+    #   The provider of the external metrics recommendation preference to
+    #   create or update.
+    #
+    #   Specify a valid provider in the `source` field to activate the
+    #   preference. To delete this preference, see the
+    #   DeleteRecommendationPreferences action.
+    #
+    #   This preference can only be set for the `Ec2Instance` resource type.
+    #
+    #   For more information, see [External metrics ingestion][1] in the
+    #   *Compute Optimizer User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/compute-optimizer/latest/ug/external-metrics-ingestion.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.put_recommendation_preferences({
-    #     resource_type: "Ec2Instance", # required, accepts Ec2Instance, AutoScalingGroup, EbsVolume, LambdaFunction, NotApplicable
+    #     resource_type: "Ec2Instance", # required, accepts Ec2Instance, AutoScalingGroup, EbsVolume, LambdaFunction, NotApplicable, EcsService
     #     scope: {
     #       name: "Organization", # accepts Organization, AccountId, ResourceArn
     #       value: "ScopeValue",
     #     },
     #     enhanced_infrastructure_metrics: "Active", # accepts Active, Inactive
     #     inferred_workload_types: "Active", # accepts Active, Inactive
+    #     external_metrics_preference: {
+    #       source: "Datadog", # accepts Datadog, Dynatrace, NewRelic, Instana
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/compute-optimizer-2019-11-01/PutRecommendationPreferences AWS API Documentation
@@ -2074,7 +2415,7 @@ module Aws::ComputeOptimizer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-computeoptimizer'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.36.0'
       Seahorse::Client::Request.new(handlers, context)
     end