@aws-sdk/client-controlcatalog 3.782.0 → 3.786.0

package/dist-cjs/models/models_0.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceNotFoundException = exports.ControlScope = exports.ControlBehavior = exports.ValidationException = exports.ThrottlingException = exports.InternalServerException = exports.AccessDeniedException = void 0;
+exports.ResourceNotFoundException = exports.ControlSeverity = exports.ControlScope = exports.ControlBehavior = exports.ValidationException = exports.ThrottlingException = exports.InternalServerException = exports.AccessDeniedException = void 0;
 const ControlCatalogServiceException_1 = require("./ControlCatalogServiceException");
 class AccessDeniedException extends ControlCatalogServiceException_1.ControlCatalogServiceException {
     name = "AccessDeniedException";
@@ -75,6 +75,12 @@ exports.ControlScope = {
     GLOBAL: "GLOBAL",
     REGIONAL: "REGIONAL",
 };
+exports.ControlSeverity = {
+    CRITICAL: "CRITICAL",
+    HIGH: "HIGH",
+    LOW: "LOW",
+    MEDIUM: "MEDIUM",
+};
 class ResourceNotFoundException extends ControlCatalogServiceException_1.ControlCatalogServiceException {
     name = "ResourceNotFoundException";
     $fault = "client";

package/dist-cjs/protocols/Aws_restJson1.js

@@ -93,11 +93,13 @@ const de_GetControlCommand = async (output, context) => {
     const doc = (0, smithy_client_1.take)(data, {
         Arn: smithy_client_1.expectString,
         Behavior: smithy_client_1.expectString,
+        CreateTime: (_) => (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(_))),
         Description: smithy_client_1.expectString,
         Implementation: smithy_client_1._json,
         Name: smithy_client_1.expectString,
         Parameters: smithy_client_1._json,
         RegionConfiguration: smithy_client_1._json,
+        Severity: smithy_client_1.expectString,
     });
     Object.assign(contents, doc);
     return contents;
@@ -128,7 +130,7 @@ const de_ListControlsCommand = async (output, context) => {
     });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await (0, core_1.parseJsonBody)(output.body, context)), "body");
     const doc = (0, smithy_client_1.take)(data, {
-        Controls: smithy_client_1._json,
+        Controls: (_) => de_Controls(_, context),
         NextToken: smithy_client_1.expectString,
     });
     Object.assign(contents, doc);
@@ -283,6 +285,25 @@ const de_CommonControlSummaryList = (output, context) => {
     });
     return retVal;
 };
+const de_Controls = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_ControlSummary(entry, context);
+    });
+    return retVal;
+};
+const de_ControlSummary = (output, context) => {
+    return (0, smithy_client_1.take)(output, {
+        Arn: smithy_client_1.expectString,
+        Behavior: smithy_client_1.expectString,
+        CreateTime: (_) => (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(_))),
+        Description: smithy_client_1.expectString,
+        Implementation: smithy_client_1._json,
+        Name: smithy_client_1.expectString,
+        Severity: smithy_client_1.expectString,
+    });
+};
 const de_DomainSummary = (output, context) => {
     return (0, smithy_client_1.take)(output, {
         Arn: smithy_client_1.expectString,

package/dist-es/models/models_0.js

@@ -68,6 +68,12 @@ export const ControlScope = {
     GLOBAL: "GLOBAL",
     REGIONAL: "REGIONAL",
 };
+export const ControlSeverity = {
+    CRITICAL: "CRITICAL",
+    HIGH: "HIGH",
+    LOW: "LOW",
+    MEDIUM: "MEDIUM",
+};
 export class ResourceNotFoundException extends __BaseException {
     name = "ResourceNotFoundException";
     $fault = "client";

package/dist-es/protocols/Aws_restJson1.js

@@ -85,11 +85,13 @@ export const de_GetControlCommand = async (output, context) => {
     const doc = take(data, {
         Arn: __expectString,
         Behavior: __expectString,
+        CreateTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         Description: __expectString,
         Implementation: _json,
         Name: __expectString,
         Parameters: _json,
         RegionConfiguration: _json,
+        Severity: __expectString,
     });
     Object.assign(contents, doc);
     return contents;
@@ -118,7 +120,7 @@ export const de_ListControlsCommand = async (output, context) => {
     });
     const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
     const doc = take(data, {
-        Controls: _json,
+        Controls: (_) => de_Controls(_, context),
         NextToken: __expectString,
     });
     Object.assign(contents, doc);
@@ -270,6 +272,25 @@ const de_CommonControlSummaryList = (output, context) => {
     });
     return retVal;
 };
+const de_Controls = (output, context) => {
+    const retVal = (output || [])
+        .filter((e) => e != null)
+        .map((entry) => {
+        return de_ControlSummary(entry, context);
+    });
+    return retVal;
+};
+const de_ControlSummary = (output, context) => {
+    return take(output, {
+        Arn: __expectString,
+        Behavior: __expectString,
+        CreateTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
+        Description: __expectString,
+        Implementation: _json,
+        Name: __expectString,
+        Severity: __expectString,
+    });
+};
 const de_DomainSummary = (output, context) => {
     return take(output, {
         Arn: __expectString,

package/dist-types/commands/GetControlCommand.d.ts

@@ -45,6 +45,7 @@ declare const GetControlCommand_base: {
  * //   Name: "STRING_VALUE", // required
  * //   Description: "STRING_VALUE", // required
  * //   Behavior: "PREVENTIVE" || "PROACTIVE" || "DETECTIVE", // required
+ * //   Severity: "LOW" || "MEDIUM" || "HIGH" || "CRITICAL",
  * //   RegionConfiguration: { // RegionConfiguration
  * //     Scope: "GLOBAL" || "REGIONAL", // required
  * //     DeployableRegions: [ // DeployableRegions
@@ -53,12 +54,14 @@ declare const GetControlCommand_base: {
  * //   },
  * //   Implementation: { // ImplementationDetails
  * //     Type: "STRING_VALUE", // required
+ * //     Identifier: "STRING_VALUE",
  * //   },
  * //   Parameters: [ // ControlParameters
  * //     { // ControlParameter
  * //       Name: "STRING_VALUE", // required
  * //     },
  * //   ],
+ * //   CreateTime: new Date("TIMESTAMP"),
  * // };
  *
  * ```

package/dist-types/commands/ListControlsCommand.d.ts

@@ -46,6 +46,13 @@ declare const ListControlsCommand_base: {
  * //       Arn: "STRING_VALUE", // required
  * //       Name: "STRING_VALUE", // required
  * //       Description: "STRING_VALUE", // required
+ * //       Behavior: "PREVENTIVE" || "PROACTIVE" || "DETECTIVE",
+ * //       Severity: "LOW" || "MEDIUM" || "HIGH" || "CRITICAL",
+ * //       Implementation: { // ImplementationSummary
+ * //         Type: "STRING_VALUE", // required
+ * //         Identifier: "STRING_VALUE",
+ * //       },
+ * //       CreateTime: new Date("TIMESTAMP"),
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",

package/dist-types/models/models_0.d.ts

@@ -265,6 +265,11 @@ export interface ImplementationDetails {
      * @public
      */
     Type: string | undefined;
+    /**
+     * <p>A service-specific identifier for the control, assigned by the service that implemented the control. For example, this identifier could be an Amazon Web Services Config Rule ID or a Security Hub Control ID.</p>
+     * @public
+     */
+    Identifier?: string | undefined;
 }
 /**
  * <p>Five types of control parameters are supported.</p>
@@ -371,6 +376,20 @@ export interface RegionConfiguration {
      */
     DeployableRegions?: string[] | undefined;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const ControlSeverity: {
+    readonly CRITICAL: "CRITICAL";
+    readonly HIGH: "HIGH";
+    readonly LOW: "LOW";
+    readonly MEDIUM: "MEDIUM";
+};
+/**
+ * @public
+ */
+export type ControlSeverity = (typeof ControlSeverity)[keyof typeof ControlSeverity];
 /**
  * @public
  */
@@ -396,6 +415,11 @@ export interface GetControlResponse {
      * @public
      */
     Behavior: ControlBehavior | undefined;
+    /**
+     * <p>An enumerated type, with the following possible values:</p>
+     * @public
+     */
+    Severity?: ControlSeverity | undefined;
     /**
      * <p>Returns information about the control, including the scope of the control, if enabled, and the Regions in which the control currently is available for deployment. For more information about scope, see <a href="https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/global-services.html">Global services</a>.</p>
      *          <p>If you are applying controls through an Amazon Web Services Control Tower landing zone environment, remember that the values returned in the <code>RegionConfiguration</code> API operation are not related to the governed Regions in your landing zone. For example, if you are governing Regions <code>A</code>,<code>B</code>,and <code>C</code> while the control is available in Regions <code>A</code>, <code>B</code>, C<code>,</code> and <code>D</code>, you'd see a response with <code>DeployableRegions</code> of <code>A</code>, <code>B</code>, <code>C</code>, and <code>D</code> for a control with <code>REGIONAL</code> scope, even though you may not intend to deploy the control in Region <code>D</code>, because you do not govern it through your landing zone.</p>
@@ -413,6 +437,11 @@ export interface GetControlResponse {
      * @public
      */
     Parameters?: ControlParameter[] | undefined;
+    /**
+     * <p>A timestamp that notes the time when the control was released (start of its life) as a governance capability in Amazon Web Services.</p>
+     * @public
+     */
+    CreateTime?: Date | undefined;
 }
 /**
  * <p>The requested resource does not exist.</p>
@@ -442,6 +471,22 @@ export interface ListControlsRequest {
      */
     MaxResults?: number | undefined;
 }
+/**
+ * <p>A summary of how the control is implemented, including the Amazon Web Services service that enforces the control and its service-specific identifier. For example, the value of this field could indicate that the control is implemented as an Amazon Web Services Config Rule or an Amazon Web Services Security Hub control.</p>
+ * @public
+ */
+export interface ImplementationSummary {
+    /**
+     * <p>A string that represents the Amazon Web Services service that implements this control. For example, a value of <code>AWS::Config::ConfigRule</code> indicates that the control is implemented by Amazon Web Services Config, and <code>AWS::SecurityHub::SecurityControl</code> indicates implementation by Amazon Web Services Security Hub.</p>
+     * @public
+     */
+    Type: string | undefined;
+    /**
+     * <p>The identifier originally assigned by the Amazon Web Services service that implements the control. For example, <code>CODEPIPELINE_DEPLOYMENT_COUNT_CHECK</code>.</p>
+     * @public
+     */
+    Identifier?: string | undefined;
+}
 /**
  * <p>Overview of information about a control.</p>
  * @public
@@ -462,6 +507,26 @@ export interface ControlSummary {
      * @public
      */
     Description: string | undefined;
+    /**
+     * <p>An enumerated type, with the following possible values:</p>
+     * @public
+     */
+    Behavior?: ControlBehavior | undefined;
+    /**
+     * <p>An enumerated type, with the following possible values:</p>
+     * @public
+     */
+    Severity?: ControlSeverity | undefined;
+    /**
+     * <p>An object of type <code>ImplementationSummary</code> that describes how the control is implemented.</p>
+     * @public
+     */
+    Implementation?: ImplementationSummary | undefined;
+    /**
+     * <p>A timestamp that notes the time when the control was released (start of its life) as a governance capability in Amazon Web Services.</p>
+     * @public
+     */
+    CreateTime?: Date | undefined;
 }
 /**
  * @public

package/dist-types/ts3.4/models/models_0.d.ts

@@ -80,6 +80,7 @@ export interface GetControlRequest {
 }
 export interface ImplementationDetails {
   Type: string | undefined;
+  Identifier?: string | undefined;
 }
 export interface ControlParameter {
   Name: string | undefined;
@@ -93,14 +94,24 @@ export interface RegionConfiguration {
   Scope: ControlScope | undefined;
   DeployableRegions?: string[] | undefined;
 }
+export declare const ControlSeverity: {
+  readonly CRITICAL: "CRITICAL";
+  readonly HIGH: "HIGH";
+  readonly LOW: "LOW";
+  readonly MEDIUM: "MEDIUM";
+};
+export type ControlSeverity =
+  (typeof ControlSeverity)[keyof typeof ControlSeverity];
 export interface GetControlResponse {
   Arn: string | undefined;
   Name: string | undefined;
   Description: string | undefined;
   Behavior: ControlBehavior | undefined;
+  Severity?: ControlSeverity | undefined;
   RegionConfiguration: RegionConfiguration | undefined;
   Implementation?: ImplementationDetails | undefined;
   Parameters?: ControlParameter[] | undefined;
+  CreateTime?: Date | undefined;
 }
 export declare class ResourceNotFoundException extends __BaseException {
   readonly name: "ResourceNotFoundException";
@@ -114,10 +125,18 @@ export interface ListControlsRequest {
   NextToken?: string | undefined;
   MaxResults?: number | undefined;
 }
+export interface ImplementationSummary {
+  Type: string | undefined;
+  Identifier?: string | undefined;
+}
 export interface ControlSummary {
   Arn: string | undefined;
   Name: string | undefined;
   Description: string | undefined;
+  Behavior?: ControlBehavior | undefined;
+  Severity?: ControlSeverity | undefined;
+  Implementation?: ImplementationSummary | undefined;
+  CreateTime?: Date | undefined;
 }
 export interface ListControlsResponse {
   Controls: ControlSummary[] | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-controlcatalog",
   "description": "AWS SDK for JavaScript Controlcatalog Client for Node.js, Browser and React Native",
-  "version": "3.782.0",
+  "version": "3.786.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",