AWS Compute Optimizer Update: This release enables AWS Compute Optimizer to analyze EC2 instance-level EBS read and write operations, and throughput when generating recommendations for your EC2 instances and Auto Scaling groups.

AWS · AWS · commit 91a7d32f2863 · 2020-10-07T18:03:44.000Z
diff --git a/.changes/next-release/feature-AWSComputeOptimizer-874d632.json b/.changes/next-release/feature-AWSComputeOptimizer-874d632.json
@@ -0,0 +1,5 @@
+{
+    "type": "feature",
+    "category": "AWS Compute Optimizer",
+    "description": "This release enables AWS Compute Optimizer to analyze EC2 instance-level EBS read and write operations, and throughput when generating recommendations for your EC2 instances and Auto Scaling groups."
+}
diff --git a/services/computeoptimizer/src/main/resources/codegen-resources/service-2.json b/services/computeoptimizer/src/main/resources/codegen-resources/service-2.json
@@ -91,7 +91,7 @@
         {"shape":"MissingAuthenticationToken"},
         {"shape":"ThrottlingException"}
       ],
-      "documentation":"<p>Returns Auto Scaling group recommendations.</p> <p>AWS Compute Optimizer currently generates recommendations for Auto Scaling groups that are configured to run instances of the M, C, R, T, and X instance families. The service does not generate recommendations for Auto Scaling groups that have a scaling policy attached to them, or that do not have the same values for desired, minimum, and maximum capacity. In order for Compute Optimizer to analyze your Auto Scaling groups, they must be of a fixed size. For more information, see the <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/what-is.html\">AWS Compute Optimizer User Guide</a>.</p>"
+      "documentation":"<p>Returns Auto Scaling group recommendations.</p> <p>AWS Compute Optimizer generates recommendations for Amazon EC2 Auto Scaling groups that meet a specific set of requirements. For more information, see the <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/requirements.html\">Supported resources and requirements</a> in the <i>AWS Compute Optimizer User Guide</i>.</p>"
     },
     "GetEC2InstanceRecommendations":{
       "name":"GetEC2InstanceRecommendations",
@@ -111,7 +111,7 @@
         {"shape":"MissingAuthenticationToken"},
         {"shape":"ThrottlingException"}
       ],
-      "documentation":"<p>Returns Amazon EC2 instance recommendations.</p> <p>AWS Compute Optimizer currently generates recommendations for Amazon Elastic Compute Cloud (Amazon EC2) and Amazon EC2 Auto Scaling. It generates recommendations for M, C, R, T, and X instance families. For more information, see the <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/what-is.html\">AWS Compute Optimizer User Guide</a>.</p>"
+      "documentation":"<p>Returns Amazon EC2 instance recommendations.</p> <p>AWS Compute Optimizer generates recommendations for Amazon Elastic Compute Cloud (Amazon EC2) instances that meet a specific set of requirements. For more information, see the <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/requirements.html\">Supported resources and requirements</a> in the <i>AWS Compute Optimizer User Guide</i>.</p>"
     },
     "GetEC2RecommendationProjectedMetrics":{
       "name":"GetEC2RecommendationProjectedMetrics",
@@ -131,7 +131,7 @@
         {"shape":"MissingAuthenticationToken"},
         {"shape":"ThrottlingException"}
       ],
-      "documentation":"<p>Returns the projected utilization metrics of Amazon EC2 instance recommendations.</p>"
+      "documentation":"<p>Returns the projected utilization metrics of Amazon EC2 instance recommendations.</p> <note> <p>The <code>Cpu</code> and <code>Memory</code> metrics are the only projected utilization metrics returned when you run this action. Additionally, the <code>Memory</code> metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/metrics.html#cw-agent\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
     },
     "GetEnrollmentStatus":{
       "name":"GetEnrollmentStatus",
@@ -283,7 +283,7 @@
         },
         "projectedUtilizationMetrics":{
           "shape":"ProjectedUtilizationMetrics",
-          "documentation":"<p>An array of objects that describe the projected utilization metrics of the Auto Scaling group recommendation option.</p>"
+          "documentation":"<p>An array of objects that describe the projected utilization metrics of the Auto Scaling group recommendation option.</p> <note> <p>The <code>Cpu</code> and <code>Memory</code> metrics are the only projected utilization metrics returned. Additionally, the <code>Memory</code> metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/metrics.html#cw-agent\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
         },
         "performanceRisk":{
           "shape":"PerformanceRisk",
@@ -360,7 +360,7 @@
         },
         "fieldsToExport":{
           "shape":"ExportableAutoScalingGroupFields",
-          "documentation":"<p>The recommendations data to include in the export file.</p>"
+          "documentation":"<p>The recommendations data to include in the export file. For more information about the fields that can be exported, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/exporting-recommendations.html#exported-files\">Exported files</a> in the <i>Compute Optimizer User Guide</i>.</p>"
         },
         "s3DestinationConfig":{
           "shape":"S3DestinationConfig",
@@ -413,7 +413,7 @@
         },
         "fieldsToExport":{
           "shape":"ExportableInstanceFields",
-          "documentation":"<p>The recommendations data to include in the export file.</p>"
+          "documentation":"<p>The recommendations data to include in the export file. For more information about the fields that can be exported, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/exporting-recommendations.html#exported-files\">Exported files</a> in the <i>Compute Optimizer User Guide</i>.</p>"
         },
         "s3DestinationConfig":{
           "shape":"S3DestinationConfig",
@@ -451,6 +451,10 @@
         "Finding",
         "UtilizationMetricsCpuMaximum",
         "UtilizationMetricsMemoryMaximum",
+        "UtilizationMetricsEbsReadOpsPerSecondMaximum",
+        "UtilizationMetricsEbsWriteOpsPerSecondMaximum",
+        "UtilizationMetricsEbsReadBytesPerSecondMaximum",
+        "UtilizationMetricsEbsWriteBytesPerSecondMaximum",
         "LookbackPeriodInDays",
         "CurrentConfigurationInstanceType",
         "CurrentConfigurationDesiredCapacity",
@@ -495,6 +499,10 @@
         "CurrentInstanceType",
         "UtilizationMetricsCpuMaximum",
         "UtilizationMetricsMemoryMaximum",
+        "UtilizationMetricsEbsReadOpsPerSecondMaximum",
+        "UtilizationMetricsEbsWriteOpsPerSecondMaximum",
+        "UtilizationMetricsEbsReadBytesPerSecondMaximum",
+        "UtilizationMetricsEbsWriteBytesPerSecondMaximum",
         "CurrentOnDemandPrice",
         "CurrentStandardOneYearNoUpfrontReservedPrice",
         "CurrentStandardThreeYearNoUpfrontReservedPrice",
@@ -828,7 +836,7 @@
         },
         "projectedUtilizationMetrics":{
           "shape":"ProjectedUtilizationMetrics",
-          "documentation":"<p>An array of objects that describe the projected utilization metrics of the instance recommendation option.</p>"
+          "documentation":"<p>An array of objects that describe the projected utilization metrics of the instance recommendation option.</p> <note> <p>The <code>Cpu</code> and <code>Memory</code> metrics are the only projected utilization metrics returned. Additionally, the <code>Memory</code> metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/metrics.html#cw-agent\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
         },
         "performanceRisk":{
           "shape":"PerformanceRisk",
@@ -927,7 +935,11 @@
       "type":"string",
       "enum":[
         "Cpu",
-        "Memory"
+        "Memory",
+        "EBS_READ_OPS_PER_SECOND",
+        "EBS_WRITE_OPS_PER_SECOND",
+        "EBS_READ_BYTES_PER_SECOND",
+        "EBS_WRITE_BYTES_PER_SECOND"
       ]
     },
     "MetricStatistic":{
@@ -973,7 +985,7 @@
       "members":{
         "name":{
           "shape":"MetricName",
-          "documentation":"<p>The name of the projected utilization metric.</p> <note> <p>Memory metrics are only returned for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
+          "documentation":"<p>The name of the projected utilization metric.</p>"
         },
         "timestamps":{
           "shape":"Timestamps",
@@ -984,7 +996,7 @@
           "documentation":"<p>The values of the projected utilization metrics.</p>"
         }
       },
-      "documentation":"<p>Describes a projected utilization metric of a recommendation option, such as an Amazon EC2 instance.</p>"
+      "documentation":"<p>Describes a projected utilization metric of a recommendation option, such as an Amazon EC2 instance.</p> <note> <p>The <code>Cpu</code> and <code>Memory</code> metrics are the only projected utilization metrics returned when you run the <code>GetEC2RecommendationProjectedMetrics</code> action. Additionally, the <code>Memory</code> metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/metrics.html#cw-agent\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
     },
     "ProjectedMetrics":{
       "type":"list",
@@ -1102,7 +1114,7 @@
           "documentation":"<p>An array of objects that describe a projected utilization metric.</p>"
         }
       },
-      "documentation":"<p>Describes a projected utilization metric of a recommendation option.</p>"
+      "documentation":"<p>Describes a projected utilization metric of a recommendation option.</p> <note> <p>The <code>Cpu</code> and <code>Memory</code> metrics are the only projected utilization metrics returned when you run the <code>GetEC2RecommendationProjectedMetrics</code> action. Additionally, the <code>Memory</code> metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/metrics.html#cw-agent\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
     },
     "RecommendedOptionProjectedMetrics":{
       "type":"list",
@@ -1241,7 +1253,7 @@
       "members":{
         "name":{
           "shape":"MetricName",
-          "documentation":"<p>The name of the utilization metric.</p> <note> <p>Memory metrics are only returned for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
+          "documentation":"<p>The name of the utilization metric.</p> <note> <p>The <code>Memory</code> metric is returned only for resources that have the unified CloudWatch agent installed on them. For more information, see <a href=\"https://docs.aws.amazon.com/compute-optimizer/latest/ug/metrics.html#cw-agent\">Enabling Memory Utilization with the CloudWatch Agent</a>.</p> </note>"
         },
         "statistic":{
           "shape":"MetricStatistic",
