feat(client-eks): Add support for filtering ListInsights API calls on MISCONFIGURATION insight category

awstools · awstools · commit 88f2623229bd · 2025-06-02T18:10:39.000Z
diff --git a/clients/client-eks/src/commands/DescribeInsightCommand.ts b/clients/client-eks/src/commands/DescribeInsightCommand.ts
@@ -45,7 +45,7 @@ export interface DescribeInsightCommandOutput extends DescribeInsightResponse, _
  * //   insight: { // Insight
  * //     id: "STRING_VALUE",
  * //     name: "STRING_VALUE",
- * //     category: "UPGRADE_READINESS",
+ * //     category: "UPGRADE_READINESS" || "MISCONFIGURATION",
  * //     kubernetesVersion: "STRING_VALUE",
  * //     lastRefreshTime: new Date("TIMESTAMP"),
  * //     lastTransitionTime: new Date("TIMESTAMP"),
diff --git a/clients/client-eks/src/commands/ListInsightsCommand.ts b/clients/client-eks/src/commands/ListInsightsCommand.ts
@@ -30,7 +30,21 @@ export interface ListInsightsCommandOutput extends ListInsightsResponse, __Metad
 /**
  * <p>Returns a list of all insights checked for against the specified cluster. You can
  *             filter which insights are returned by category, associated Kubernetes version, and
- *             status.</p>
+ *             status. The default filter lists all categories and every status.</p>
+ *          <p>The following lists the available categories:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>UPGRADE_READINESS</code>: Amazon EKS identifies issues that could impact your
+ *                     ability to upgrade to new versions of Kubernetes. These are called upgrade insights.</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>MISCONFIGURATION</code>: Amazon EKS identifies misconfiguration in your EKS
+ *                     Hybrid Nodes setup that could impair functionality of your cluster or
+ *                     workloads. These are called configuration insights.</p>
+ *             </li>
+ *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -41,7 +55,7 @@ export interface ListInsightsCommandOutput extends ListInsightsResponse, __Metad
  *   clusterName: "STRING_VALUE", // required
  *   filter: { // InsightsFilter
  *     categories: [ // CategoryList
- *       "UPGRADE_READINESS",
+ *       "UPGRADE_READINESS" || "MISCONFIGURATION",
  *     ],
  *     kubernetesVersions: [ // StringList
  *       "STRING_VALUE",
@@ -60,7 +74,7 @@ export interface ListInsightsCommandOutput extends ListInsightsResponse, __Metad
  * //     { // InsightSummary
  * //       id: "STRING_VALUE",
  * //       name: "STRING_VALUE",
- * //       category: "UPGRADE_READINESS",
+ * //       category: "UPGRADE_READINESS" || "MISCONFIGURATION",
  * //       kubernetesVersion: "STRING_VALUE",
  * //       lastRefreshTime: new Date("TIMESTAMP"),
  * //       lastTransitionTime: new Date("TIMESTAMP"),
diff --git a/clients/client-eks/src/models/models_0.ts b/clients/client-eks/src/models/models_0.ts
@@ -5546,6 +5546,7 @@ export interface DescribeInsightRequest {
  * @enum
  */
 export const Category = {
+  MISCONFIGURATION: "MISCONFIGURATION",
   UPGRADE_READINESS: "UPGRADE_READINESS",
 } as const;
 
@@ -6466,7 +6467,20 @@ export interface ListIdentityProviderConfigsResponse {
  */
 export interface InsightsFilter {
   /**
-   * <p>The categories to use to filter insights.</p>
+   * <p>The categories to use to filter insights. The following lists the available categories:</p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>UPGRADE_READINESS</code>: Amazon EKS identifies issues that could impact your
+   *                     ability to upgrade to new versions of Kubernetes. These are called upgrade insights.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>MISCONFIGURATION</code>: Amazon EKS identifies misconfiguration in your EKS
+   *                     Hybrid Nodes setup that could impair functionality of your cluster or
+   *                     workloads. These are called configuration insights.</p>
+   *             </li>
+   *          </ul>
    * @public
    */
   categories?: Category[] | undefined;
diff --git a/codegen/sdk-codegen/aws-models/eks.json b/codegen/sdk-codegen/aws-models/eks.json
@@ -2414,6 +2414,12 @@
           "traits": {
             "smithy.api#enumValue": "UPGRADE_READINESS"
           }
+        },
+        "MISCONFIGURATION": {
+          "target": "smithy.api#Unit",
+          "traits": {
+            "smithy.api#enumValue": "MISCONFIGURATION"
+          }
         }
       }
     },
@@ -7077,7 +7083,7 @@
         "categories": {
           "target": "com.amazonaws.eks#CategoryList",
           "traits": {
-            "smithy.api#documentation": "<p>The categories to use to filter insights.</p>"
+            "smithy.api#documentation": "<p>The categories to use to filter insights. The following lists the available categories:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>UPGRADE_READINESS</code>: Amazon EKS identifies issues that could impact your\n                    ability to upgrade to new versions of Kubernetes. These are called upgrade insights.</p>\n            </li>\n            <li>\n               <p>\n                  <code>MISCONFIGURATION</code>: Amazon EKS identifies misconfiguration in your EKS\n                    Hybrid Nodes setup that could impair functionality of your cluster or\n                    workloads. These are called configuration insights.</p>\n            </li>\n         </ul>"
           }
         },
         "kubernetesVersions": {
@@ -8169,7 +8175,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Returns a list of all insights checked for against the specified cluster. You can\n            filter which insights are returned by category, associated Kubernetes version, and\n            status.</p>",
+        "smithy.api#documentation": "<p>Returns a list of all insights checked for against the specified cluster. You can\n            filter which insights are returned by category, associated Kubernetes version, and\n            status. The default filter lists all categories and every status.</p>\n         <p>The following lists the available categories:</p>\n         <ul>\n            <li>\n               <p>\n                  <code>UPGRADE_READINESS</code>: Amazon EKS identifies issues that could impact your\n                    ability to upgrade to new versions of Kubernetes. These are called upgrade insights.</p>\n            </li>\n            <li>\n               <p>\n                  <code>MISCONFIGURATION</code>: Amazon EKS identifies misconfiguration in your EKS\n                    Hybrid Nodes setup that could impair functionality of your cluster or\n                    workloads. These are called configuration insights.</p>\n            </li>\n         </ul>",
         "smithy.api#http": {
           "method": "POST",
           "uri": "/clusters/{clusterName}/insights",

Original file line number	Diff line number	Diff line change
`@@ -2414,6 +2414,12 @@`
`2414`	`2414`	`"traits": {`
`2415`	`2415`	`"smithy.api#enumValue": "UPGRADE_READINESS"`
`2416`	`2416`	`}`
	`2417`	`+ },`
	`2418`	`+ "MISCONFIGURATION": {`
	`2419`	`+ "target": "smithy.api#Unit",`
	`2420`	`+ "traits": {`
	`2421`	`+ "smithy.api#enumValue": "MISCONFIGURATION"`
	`2422`	`+ }`
`2417`	`2423`	`}`
`2418`	`2424`	`}`
`2419`	`2425`	`},`
`@@ -7077,7 +7083,7 @@`
`7077`	`7083`	`"categories": {`
`7078`	`7084`	`"target": "com.amazonaws.eks#CategoryList",`
`7079`	`7085`	`"traits": {`
`7080`		`- "smithy.api#documentation": "<p>The categories to use to filter insights.</p>"`
	`7086`	+ "smithy.api#documentation": "<p>The categories to use to filter insights. The following lists the available categories:</p>\n <ul>\n <li>\n <p>\n <code>UPGRADE_READINESS</code>: Amazon EKS identifies issues that could impact your\n ability to upgrade to new versions of Kubernetes. These are called upgrade insights.</p>\n </li>\n <li>\n <p>\n <code>MISCONFIGURATION</code>: Amazon EKS identifies misconfiguration in your EKS\n Hybrid Nodes setup that could impair functionality of your cluster or\n workloads. These are called configuration insights.</p>\n </li>\n </ul>"
`7081`	`7087`	`}`
`7082`	`7088`	`},`
`7083`	`7089`	`"kubernetesVersions": {`
`@@ -8169,7 +8175,7 @@`
`8169`	`8175`	`}`
`8170`	`8176`	`],`
`8171`	`8177`	`"traits": {`
`8172`		`- "smithy.api#documentation": "<p>Returns a list of all insights checked for against the specified cluster. You can\n filter which insights are returned by category, associated Kubernetes version, and\n status.</p>",`
	`8178`	+ "smithy.api#documentation": "<p>Returns a list of all insights checked for against the specified cluster. You can\n filter which insights are returned by category, associated Kubernetes version, and\n status. The default filter lists all categories and every status.</p>\n <p>The following lists the available categories:</p>\n <ul>\n <li>\n <p>\n <code>UPGRADE_READINESS</code>: Amazon EKS identifies issues that could impact your\n ability to upgrade to new versions of Kubernetes. These are called upgrade insights.</p>\n </li>\n <li>\n <p>\n <code>MISCONFIGURATION</code>: Amazon EKS identifies misconfiguration in your EKS\n Hybrid Nodes setup that could impair functionality of your cluster or\n workloads. These are called configuration insights.</p>\n </li>\n </ul>",
`8173`	`8179`	`"smithy.api#http": {`
`8174`	`8180`	`"method": "POST",`
`8175`	`8181`	`"uri": "/clusters/{clusterName}/insights",`