feat(client-compute-optimizer): Compute Optimizer now identifies idle NAT Gateway resources for cost optimization based on traffic patterns and backup configuration analysis. Access recommendations via the GetIdleRecommendations API.

Author: awstools

clients/client-compute-optimizer/src/commands/ExportAutoScalingGroupRecommendationsCommand.ts

@@ -33,12 +33,12 @@ export interface ExportAutoScalingGroupRecommendationsCommandOutput
     __MetadataBearer {}
 
 /**
- * <p>Exports optimization recommendations for Auto Scaling groups.</p>
+ * <p>Exports optimization recommendations for Amazon EC2 Auto Scaling groups.</p>
  *          <p>Recommendations are exported in a comma-separated values (.csv) file, and its metadata
  *             in a JavaScript Object Notation (JSON) (.json) file, to an existing Amazon Simple Storage Service (Amazon S3) bucket that you specify. For more information, see <a href="https://docs.aws.amazon.com/compute-optimizer/latest/ug/exporting-recommendations.html">Exporting
  *                 Recommendations</a> in the <i>Compute Optimizer User
  *             Guide</i>.</p>
- *          <p>You can have only one Auto Scaling group export job in progress per Amazon Web Services Region.</p>
+ *          <p>You can have only one Amazon EC2 Auto Scaling group export job in progress per Amazon Web Services Region.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-compute-optimizer/src/commands/ExportIdleRecommendationsCommand.ts

@@ -56,7 +56,7 @@ export interface ExportIdleRecommendationsCommandOutput extends ExportIdleRecomm
  *     },
  *   ],
  *   fieldsToExport: [ // ExportableIdleFields
- *     "AccountId" || "ResourceArn" || "ResourceId" || "ResourceType" || "LastRefreshTimestamp" || "LookbackPeriodInDays" || "SavingsOpportunity" || "SavingsOpportunityAfterDiscount" || "UtilizationMetricsCpuMaximum" || "UtilizationMetricsMemoryMaximum" || "UtilizationMetricsNetworkOutBytesPerSecondMaximum" || "UtilizationMetricsNetworkInBytesPerSecondMaximum" || "UtilizationMetricsDatabaseConnectionsMaximum" || "UtilizationMetricsEBSVolumeReadIOPSMaximum" || "UtilizationMetricsEBSVolumeWriteIOPSMaximum" || "UtilizationMetricsVolumeReadOpsPerSecondMaximum" || "UtilizationMetricsVolumeWriteOpsPerSecondMaximum" || "Finding" || "FindingDescription" || "Tags",
+ *     "AccountId" || "ResourceArn" || "ResourceId" || "ResourceType" || "LastRefreshTimestamp" || "LookbackPeriodInDays" || "SavingsOpportunity" || "SavingsOpportunityAfterDiscount" || "UtilizationMetricsCpuMaximum" || "UtilizationMetricsMemoryMaximum" || "UtilizationMetricsNetworkOutBytesPerSecondMaximum" || "UtilizationMetricsNetworkInBytesPerSecondMaximum" || "UtilizationMetricsDatabaseConnectionsMaximum" || "UtilizationMetricsEBSVolumeReadIOPSMaximum" || "UtilizationMetricsEBSVolumeWriteIOPSMaximum" || "UtilizationMetricsVolumeReadOpsPerSecondMaximum" || "UtilizationMetricsVolumeWriteOpsPerSecondMaximum" || "UtilizationMetricsActiveConnectionCountMaximum" || "UtilizationMetricsPacketsInFromSourceMaximum" || "UtilizationMetricsPacketsInFromDestinationMaximum" || "Finding" || "FindingDescription" || "Tags",
  *   ],
  *   s3DestinationConfig: { // S3DestinationConfig
  *     bucket: "STRING_VALUE",

clients/client-compute-optimizer/src/commands/GetAutoScalingGroupRecommendationsCommand.ts

@@ -32,7 +32,7 @@ export interface GetAutoScalingGroupRecommendationsCommandOutput
     __MetadataBearer {}
 
 /**
- * <p>Returns Auto Scaling group recommendations.</p>
+ * <p>Returns Amazon EC2 Auto Scaling group recommendations.</p>
  *          <p>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>Compute Optimizer User

clients/client-compute-optimizer/src/commands/GetEC2InstanceRecommendationsCommand.ts

@@ -130,7 +130,7 @@ export interface GetEC2InstanceRecommendationsCommandOutput
  * //       recommendationSources: [ // RecommendationSources
  * //         { // RecommendationSource
  * //           recommendationSourceArn: "STRING_VALUE",
- * //           recommendationSourceType: "Ec2Instance" || "AutoScalingGroup" || "EbsVolume" || "LambdaFunction" || "EcsService" || "License" || "RdsDBInstance" || "RdsDBInstanceStorage" || "AuroraDBClusterStorage",
+ * //           recommendationSourceType: "Ec2Instance" || "AutoScalingGroup" || "EbsVolume" || "LambdaFunction" || "EcsService" || "License" || "RdsDBInstance" || "RdsDBInstanceStorage" || "AuroraDBClusterStorage" || "NatGateway",
  * //         },
  * //       ],
  * //       lastRefreshTimestamp: new Date("TIMESTAMP"),

clients/client-compute-optimizer/src/commands/GetIdleRecommendationsCommand.ts

@@ -70,9 +70,9 @@ export interface GetIdleRecommendationsCommandOutput extends GetIdleRecommendati
  * //     { // IdleRecommendation
  * //       resourceArn: "STRING_VALUE",
  * //       resourceId: "STRING_VALUE",
- * //       resourceType: "EC2Instance" || "AutoScalingGroup" || "EBSVolume" || "ECSService" || "RDSDBInstance",
+ * //       resourceType: "EC2Instance" || "AutoScalingGroup" || "EBSVolume" || "ECSService" || "RDSDBInstance" || "NatGateway",
  * //       accountId: "STRING_VALUE",
- * //       finding: "Idle" || "Unattached",
+ * //       finding: "Idle" || "Unattached" || "Unused",
  * //       findingDescription: "STRING_VALUE",
  * //       savingsOpportunity: { // IdleSavingsOpportunity
  * //         savingsOpportunityPercentage: Number("double"),
@@ -90,7 +90,7 @@ export interface GetIdleRecommendationsCommandOutput extends GetIdleRecommendati
  * //       },
  * //       utilizationMetrics: [ // IdleUtilizationMetrics
  * //         { // IdleUtilizationMetric
- * //           name: "CPU" || "Memory" || "NetworkOutBytesPerSecond" || "NetworkInBytesPerSecond" || "DatabaseConnections" || "EBSVolumeReadIOPS" || "EBSVolumeWriteIOPS" || "VolumeReadOpsPerSecond" || "VolumeWriteOpsPerSecond",
+ * //           name: "CPU" || "Memory" || "NetworkOutBytesPerSecond" || "NetworkInBytesPerSecond" || "DatabaseConnections" || "EBSVolumeReadIOPS" || "EBSVolumeWriteIOPS" || "VolumeReadOpsPerSecond" || "VolumeWriteOpsPerSecond" || "ActiveConnectionCount" || "PacketsInFromSource" || "PacketsInFromDestination",
  * //           statistic: "Maximum" || "Average",
  * //           value: Number("double"),
  * //         },
@@ -110,7 +110,7 @@ export interface GetIdleRecommendationsCommandOutput extends GetIdleRecommendati
  * //       identifier: "STRING_VALUE",
  * //       code: "STRING_VALUE",
  * //       message: "STRING_VALUE",
- * //       resourceType: "EC2Instance" || "AutoScalingGroup" || "EBSVolume" || "ECSService" || "RDSDBInstance",
+ * //       resourceType: "EC2Instance" || "AutoScalingGroup" || "EBSVolume" || "ECSService" || "RDSDBInstance" || "NatGateway",
  * //     },
  * //   ],
  * // };

clients/client-compute-optimizer/src/commands/GetRecommendationPreferencesCommand.ts

@@ -33,7 +33,7 @@ export interface GetRecommendationPreferencesCommandOutput
  *             metrics.</p>
  *          <p>Use the <code>scope</code> parameter to specify which preferences to return. You can
  *             specify to return preferences for an organization, a specific account ID, or a specific
- *             EC2 instance or Auto Scaling group Amazon Resource Name (ARN).</p>
+ *             EC2 instance or Amazon EC2 Auto Scaling group Amazon Resource Name (ARN).</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/compute-optimizer/latest/ug/enhanced-infrastructure-metrics.html">Activating
  *                 enhanced infrastructure metrics</a> in the <i>Compute Optimizer User
  *                 Guide</i>.</p>

clients/client-compute-optimizer/src/commands/GetRecommendationSummariesCommand.ts

@@ -36,7 +36,7 @@ export interface GetRecommendationSummariesCommandOutput extends GetRecommendati
  *                         <code>Optimized</code>.</p>
  *             </li>
  *             <li>
- *                <p>EC2Auto Scaling groups in an account that are <code>NotOptimized</code>, or
+ *                <p>EC2Amazon EC2 Auto Scaling groups in an account that are <code>NotOptimized</code>, or
  *                         <code>Optimized</code>.</p>
  *             </li>
  *             <li>
@@ -95,11 +95,11 @@ export interface GetRecommendationSummariesCommandOutput extends GetRecommendati
  * //       ],
  * //       idleSummaries: [ // IdleSummaries
  * //         { // IdleSummary
- * //           name: "Idle" || "Unattached",
+ * //           name: "Idle" || "Unattached" || "Unused",
  * //           value: Number("double"),
  * //         },
  * //       ],
- * //       recommendationResourceType: "Ec2Instance" || "AutoScalingGroup" || "EbsVolume" || "LambdaFunction" || "EcsService" || "License" || "RdsDBInstance" || "RdsDBInstanceStorage" || "AuroraDBClusterStorage",
+ * //       recommendationResourceType: "Ec2Instance" || "AutoScalingGroup" || "EbsVolume" || "LambdaFunction" || "EcsService" || "License" || "RdsDBInstance" || "RdsDBInstanceStorage" || "AuroraDBClusterStorage" || "NatGateway",
  * //       accountId: "STRING_VALUE",
  * //       savingsOpportunity: { // SavingsOpportunity
  * //         savingsOpportunityPercentage: Number("double"),

clients/client-compute-optimizer/src/models/enums.ts

@@ -754,13 +754,16 @@ export const ExportableIdleField = {
   SAVINGS_OPPORTUNITY: "SavingsOpportunity",
   SAVINGS_OPPORTUNITY_AFTER_DISCOUNT: "SavingsOpportunityAfterDiscount",
   TAGS: "Tags",
+  UTILIZATION_METRICS_ACTIVE_CONNECTION_COUNT_MAXIMUM: "UtilizationMetricsActiveConnectionCountMaximum",
   UTILIZATION_METRICS_CPU_MAXIMUM: "UtilizationMetricsCpuMaximum",
   UTILIZATION_METRICS_DATABASE_CONNECTIONS_MAXIMUM: "UtilizationMetricsDatabaseConnectionsMaximum",
   UTILIZATION_METRICS_EBS_VOLUME_READ_IOPS_MAXIMUM: "UtilizationMetricsEBSVolumeReadIOPSMaximum",
   UTILIZATION_METRICS_EBS_VOLUME_WRITE_IOPS_MAXIMUM: "UtilizationMetricsEBSVolumeWriteIOPSMaximum",
   UTILIZATION_METRICS_MEMORY_MAXIMUM: "UtilizationMetricsMemoryMaximum",
   UTILIZATION_METRICS_NETWORK_IN_BYTES_PER_SECOND_MAXIMUM: "UtilizationMetricsNetworkInBytesPerSecondMaximum",
   UTILIZATION_METRICS_NETWORK_OUT_BYTES_PER_SECOND_MAXIMUM: "UtilizationMetricsNetworkOutBytesPerSecondMaximum",
+  UTILIZATION_METRICS_PACKETS_IN_FROM_DESTINATION_MAXIMUM: "UtilizationMetricsPacketsInFromDestinationMaximum",
+  UTILIZATION_METRICS_PACKETS_IN_FROM_SOURCE_MAXIMUM: "UtilizationMetricsPacketsInFromSourceMaximum",
   UTILIZATION_METRICS_VOLUME_READ_OPS_PER_SECOND_MAXIMUM: "UtilizationMetricsVolumeReadOpsPerSecondMaximum",
   UTILIZATION_METRICS_VOLUME_WRITE_OPS_PER_SECOND_MAXIMUM: "UtilizationMetricsVolumeWriteOpsPerSecondMaximum",
 } as const;
@@ -1189,6 +1192,7 @@ export const RecommendationSourceType = {
   ECS_SERVICE: "EcsService",
   LAMBDA_FUNCTION: "LambdaFunction",
   LICENSE: "License",
+  NAT_GATEWAY: "NatGateway",
   RDS_DB_INSTANCE: "RdsDBInstance",
   RDS_DB_INSTANCE_STORAGE: "RdsDBInstanceStorage",
 } as const;
@@ -1329,6 +1333,7 @@ export const IdleRecommendationResourceType = {
   EBS_VOLUME: "EBSVolume",
   EC2_INSTANCE: "EC2Instance",
   ECS_SERVICE: "ECSService",
+  NAT_GATEWAY: "NatGateway",
   RDS_DB_INSTANCE: "RDSDBInstance",
 } as const;
 /**
@@ -1344,6 +1349,7 @@ export type IdleRecommendationResourceType =
 export const IdleFinding = {
   IDLE: "Idle",
   UNATTACHED: "Unattached",
+  UNUSED: "Unused",
 } as const;
 /**
  * @public
@@ -1355,13 +1361,16 @@ export type IdleFinding = (typeof IdleFinding)[keyof typeof IdleFinding];
  * @enum
  */
 export const IdleMetricName = {
+  ACTIVE_CONNECTION_COUNT: "ActiveConnectionCount",
   CPU: "CPU",
   DATABASE_CONNECTIONS: "DatabaseConnections",
   EBS_VOLUME_READ_IOPS: "EBSVolumeReadIOPS",
   EBS_VOLUME_WRITE_IOPS: "EBSVolumeWriteIOPS",
   MEMORY: "Memory",
   NETWORK_IN_BYTES_PER_SECOND: "NetworkInBytesPerSecond",
   NETWORK_OUT_BYTES_PER_SECOND: "NetworkOutBytesPerSecond",
+  PACKETS_IN_FROM_DESTINATION: "PacketsInFromDestination",
+  PACKETS_IN_FROM_SOURCE: "PacketsInFromSource",
   VOLUME_READ_OPS_PER_SECOND: "VolumeReadOpsPerSecond",
   VOLUME_WRITE_OPS_PER_SECOND: "VolumeWriteOpsPerSecond",
 } as const;