@aws-sdk/client-controltower 3.577.0 → 3.580.0

package/dist-types/ControlTowerClient.d.ts

@@ -21,6 +21,7 @@ import { GetEnabledControlCommandInput, GetEnabledControlCommandOutput } from ".
 import { GetLandingZoneCommandInput, GetLandingZoneCommandOutput } from "./commands/GetLandingZoneCommand";
 import { GetLandingZoneOperationCommandInput, GetLandingZoneOperationCommandOutput } from "./commands/GetLandingZoneOperationCommand";
 import { ListBaselinesCommandInput, ListBaselinesCommandOutput } from "./commands/ListBaselinesCommand";
+import { ListControlOperationsCommandInput, ListControlOperationsCommandOutput } from "./commands/ListControlOperationsCommand";
 import { ListEnabledBaselinesCommandInput, ListEnabledBaselinesCommandOutput } from "./commands/ListEnabledBaselinesCommand";
 import { ListEnabledControlsCommandInput, ListEnabledControlsCommandOutput } from "./commands/ListEnabledControlsCommand";
 import { ListLandingZonesCommandInput, ListLandingZonesCommandOutput } from "./commands/ListLandingZonesCommand";
@@ -38,11 +39,11 @@ export { __Client };
 /**
  * @public
  */
-export type ServiceInputTypes = CreateLandingZoneCommandInput | DeleteLandingZoneCommandInput | DisableBaselineCommandInput | DisableControlCommandInput | EnableBaselineCommandInput | EnableControlCommandInput | GetBaselineCommandInput | GetBaselineOperationCommandInput | GetControlOperationCommandInput | GetEnabledBaselineCommandInput | GetEnabledControlCommandInput | GetLandingZoneCommandInput | GetLandingZoneOperationCommandInput | ListBaselinesCommandInput | ListEnabledBaselinesCommandInput | ListEnabledControlsCommandInput | ListLandingZonesCommandInput | ListTagsForResourceCommandInput | ResetEnabledBaselineCommandInput | ResetLandingZoneCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateEnabledBaselineCommandInput | UpdateEnabledControlCommandInput | UpdateLandingZoneCommandInput;
+export type ServiceInputTypes = CreateLandingZoneCommandInput | DeleteLandingZoneCommandInput | DisableBaselineCommandInput | DisableControlCommandInput | EnableBaselineCommandInput | EnableControlCommandInput | GetBaselineCommandInput | GetBaselineOperationCommandInput | GetControlOperationCommandInput | GetEnabledBaselineCommandInput | GetEnabledControlCommandInput | GetLandingZoneCommandInput | GetLandingZoneOperationCommandInput | ListBaselinesCommandInput | ListControlOperationsCommandInput | ListEnabledBaselinesCommandInput | ListEnabledControlsCommandInput | ListLandingZonesCommandInput | ListTagsForResourceCommandInput | ResetEnabledBaselineCommandInput | ResetLandingZoneCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateEnabledBaselineCommandInput | UpdateEnabledControlCommandInput | UpdateLandingZoneCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = CreateLandingZoneCommandOutput | DeleteLandingZoneCommandOutput | DisableBaselineCommandOutput | DisableControlCommandOutput | EnableBaselineCommandOutput | EnableControlCommandOutput | GetBaselineCommandOutput | GetBaselineOperationCommandOutput | GetControlOperationCommandOutput | GetEnabledBaselineCommandOutput | GetEnabledControlCommandOutput | GetLandingZoneCommandOutput | GetLandingZoneOperationCommandOutput | ListBaselinesCommandOutput | ListEnabledBaselinesCommandOutput | ListEnabledControlsCommandOutput | ListLandingZonesCommandOutput | ListTagsForResourceCommandOutput | ResetEnabledBaselineCommandOutput | ResetLandingZoneCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateEnabledBaselineCommandOutput | UpdateEnabledControlCommandOutput | UpdateLandingZoneCommandOutput;
+export type ServiceOutputTypes = CreateLandingZoneCommandOutput | DeleteLandingZoneCommandOutput | DisableBaselineCommandOutput | DisableControlCommandOutput | EnableBaselineCommandOutput | EnableControlCommandOutput | GetBaselineCommandOutput | GetBaselineOperationCommandOutput | GetControlOperationCommandOutput | GetEnabledBaselineCommandOutput | GetEnabledControlCommandOutput | GetLandingZoneCommandOutput | GetLandingZoneOperationCommandOutput | ListBaselinesCommandOutput | ListControlOperationsCommandOutput | ListEnabledBaselinesCommandOutput | ListEnabledControlsCommandOutput | ListLandingZonesCommandOutput | ListTagsForResourceCommandOutput | ResetEnabledBaselineCommandOutput | ResetLandingZoneCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateEnabledBaselineCommandOutput | UpdateEnabledControlCommandOutput | UpdateLandingZoneCommandOutput;
 /**
  * @public
  */
@@ -176,7 +177,37 @@ export type ControlTowerClientResolvedConfigType = __SmithyResolvedConfiguration
 export interface ControlTowerClientResolvedConfig extends ControlTowerClientResolvedConfigType {
 }
 /**
- * <p>These interfaces allow you to apply the Amazon Web Services library of pre-defined
+ * <p>Amazon Web Services Control Tower offers application programming interface (API) operations that support programmatic interaction with these types of resources:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/controls.html">
+ *                      <i>controls</i>
+ *                   </a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/lz-api-launch.html">
+ *                      <i>landing zones</i>
+ *                   </a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/types-of-baselines.html">
+ *                      <i>baselines</i>
+ *                   </a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ *          <p>For more information about these types of resources, see the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/what-is-control-tower.html">
+ *                <i>Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
+ *          <p>
+ *             <b>About control APIs</b>
+ *          </p>
+ *          <p>These interfaces allow you to apply the Amazon Web Services library of pre-defined
  *          <i>controls</i> to your organizational units, programmatically. In Amazon Web Services Control Tower, the terms "control" and "guardrail" are synonyms.</p>
  *          <p>To call these APIs, you'll need to know:</p>
  *          <ul>
@@ -197,7 +228,7 @@ export interface ControlTowerClientResolvedConfig extends ControlTowerClientReso
  *          <p>The <code>controlIdentifier</code> is an ARN that is specified for each
  *          control. You can view the <code>controlIdentifier</code> in the console on the <b>Control details</b> page, as well as in the documentation.</p>
  *          <p>The <code>controlIdentifier</code> is unique in each Amazon Web Services Region for each control. You can
- *          find the <code>controlIdentifier</code> for each Region and control in the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Tables of control metadata</a> in the <i>Amazon Web Services Control Tower User Guide.</i>
+ *          find the <code>controlIdentifier</code> for each Region and control in the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Tables of control metadata</a> or the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-region-tables.html">Control availability by Region tables</a> in the <i>Amazon Web Services Control Tower User Guide.</i>
  *          </p>
  *          <p>A quick-reference list of control identifers for the Amazon Web Services Control Tower legacy <i>Strongly recommended</i> and
  *          <i>Elective</i> controls is given in <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-identifiers.html.html">Resource identifiers for
@@ -229,6 +260,17 @@ export interface ControlTowerClientResolvedConfig extends ControlTowerClientReso
  *                <code>arn:$\{Partition\}:organizations::$\{MasterAccountId\}:ou/o-$\{OrganizationId\}/ou-$\{OrganizationalUnitId\}</code>
  *             </p>
  *          </note>
+ *          <p>
+ *             <b> About landing zone APIs</b>
+ *          </p>
+ *          <p>You can configure and launch an Amazon Web Services Control Tower landing zone with APIs. For an introduction and steps, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/getting-started-apis.html">Getting started with Amazon Web Services Control Tower using APIs</a>.</p>
+ *          <p>For an overview of landing zone API operations, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/2023-all.html#landing-zone-apis"> Amazon Web Services Control Tower supports landing zone APIs</a>. The individual API operations for landing zones are detailed in this document, the <a href="https://docs.aws.amazon.com/controltower/latest/APIReference/API_Operations.html">API reference manual</a>, in the "Actions" section.</p>
+ *          <p>
+ *             <b>About baseline APIs</b>
+ *          </p>
+ *          <p>You can apply the <code>AWSControlTowerBaseline</code> baseline to an organizational unit (OU) as a way to register the OU with Amazon Web Services Control Tower, programmatically. For a general overview of this capability, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/2024-all.html#baseline-apis">Amazon Web Services Control Tower supports APIs for OU registration and configuration with baselines</a>.</p>
+ *          <p>You can call the baseline API operations to view the baselines that Amazon Web Services Control Tower enables for your landing zone, on your behalf, when setting up the landing zone. These baselines are read-only baselines.</p>
+ *          <p>The individual API operations for baselines are detailed in this document, the <a href="https://docs.aws.amazon.com/controltower/latest/APIReference/API_Operations.html">API reference manual</a>, in the "Actions" section. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">Baseline API input and output examples with CLI</a>.</p>
  *          <p class="title">
  *             <b>Details and examples</b>
  *          </p>
@@ -240,12 +282,27 @@ export interface ControlTowerClientResolvedConfig extends ControlTowerClientReso
  *             </li>
  *             <li>
  *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">Baseline API input and output examples with CLI</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
  *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/enable-controls.html">Enable controls with CloudFormation</a>
  *                </p>
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Control metadata tables</a>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/lz-apis-cfn-setup.html">Launch a landing zone with CloudFormation</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Control metadata tables (large page)</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-region-tables.html">Control availability by Region tables (large page)</a>
  *                </p>
  *             </li>
  *             <li>

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

@@ -26,7 +26,9 @@ declare const DisableBaselineCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Disable an <code>EnabledBaseline</code> resource on the specified Target. This API starts an asynchronous operation to remove all resources deployed as part of the baseline enablement. The resource will vary depending on the enabled baseline.</p>
+ * <p>Disable an <code>EnabledBaseline</code> resource on the specified Target. This API starts an asynchronous operation to remove all resources deployed as part of the baseline enablement. The resource will vary depending on the enabled baseline. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -26,7 +26,9 @@ declare const EnableBaselineCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Enable (apply) a <code>Baseline</code> to a Target. This API starts an asynchronous operation to deploy resources specified by the <code>Baseline</code> to the specified Target.</p>
+ * <p>Enable (apply) a <code>Baseline</code> to a Target. This API starts an asynchronous operation to deploy resources specified by the <code>Baseline</code> to the specified Target. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -26,7 +26,9 @@ declare const GetBaselineCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Retrieve details about an existing <code>Baseline</code> resource by specifying its identifier.</p>
+ * <p>Retrieve details about an existing <code>Baseline</code> resource by specifying its identifier. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -26,7 +26,9 @@ declare const GetBaselineOperationCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns the details of an asynchronous baseline operation, as initiated by any of these APIs: <code>EnableBaseline</code>, <code>DisableBaseline</code>, <code>UpdateEnabledBaseline</code>, <code>ResetEnabledBaseline</code>. A status message is displayed in case of operation failure.</p>
+ * <p>Returns the details of an asynchronous baseline operation, as initiated by any of these APIs: <code>EnableBaseline</code>, <code>DisableBaseline</code>, <code>UpdateEnabledBaseline</code>, <code>ResetEnabledBaseline</code>. A status message is displayed in case of operation failure. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -44,11 +44,15 @@ declare const GetControlOperationCommand_base: {
  * const response = await client.send(command);
  * // { // GetControlOperationOutput
  * //   controlOperation: { // ControlOperation
- * //     operationType: "STRING_VALUE",
+ * //     operationType: "ENABLE_CONTROL" || "DISABLE_CONTROL" || "UPDATE_ENABLED_CONTROL",
  * //     startTime: new Date("TIMESTAMP"),
  * //     endTime: new Date("TIMESTAMP"),
- * //     status: "STRING_VALUE",
+ * //     status: "SUCCEEDED" || "FAILED" || "IN_PROGRESS",
  * //     statusMessage: "STRING_VALUE",
+ * //     operationIdentifier: "STRING_VALUE",
+ * //     controlIdentifier: "STRING_VALUE",
+ * //     targetIdentifier: "STRING_VALUE",
+ * //     enabledControlIdentifier: "STRING_VALUE",
  * //   },
  * // };
  *

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

@@ -27,7 +27,7 @@ declare const GetLandingZoneOperationCommand_base: {
 };
 /**
  * <p>Returns the status of the specified landing zone operation. Details for an operation are available for
- *          60 days.</p>
+ *          90 days.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -26,7 +26,9 @@ declare const ListBaselinesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a summary list of all available baselines.</p>
+ * <p>Returns a summary list of all available baselines. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -0,0 +1,102 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ControlTowerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ControlTowerClient";
+import { ListControlOperationsInput, ListControlOperationsOutput } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListControlOperationsCommand}.
+ */
+export interface ListControlOperationsCommandInput extends ListControlOperationsInput {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListControlOperationsCommand}.
+ */
+export interface ListControlOperationsCommandOutput extends ListControlOperationsOutput, __MetadataBearer {
+}
+declare const ListControlOperationsCommand_base: {
+    new (input: ListControlOperationsCommandInput): import("@smithy/smithy-client").CommandImpl<ListControlOperationsCommandInput, ListControlOperationsCommandOutput, ControlTowerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [ListControlOperationsCommandInput]): import("@smithy/smithy-client").CommandImpl<ListControlOperationsCommandInput, ListControlOperationsCommandOutput, ControlTowerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Provides a list of operations in progress or queued.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { ControlTowerClient, ListControlOperationsCommand } from "@aws-sdk/client-controltower"; // ES Modules import
+ * // const { ControlTowerClient, ListControlOperationsCommand } = require("@aws-sdk/client-controltower"); // CommonJS import
+ * const client = new ControlTowerClient(config);
+ * const input = { // ListControlOperationsInput
+ *   filter: { // ControlOperationFilter
+ *     controlIdentifiers: [ // ControlIdentifiers
+ *       "STRING_VALUE",
+ *     ],
+ *     targetIdentifiers: [ // TargetIdentifiers
+ *       "STRING_VALUE",
+ *     ],
+ *     enabledControlIdentifiers: [ // EnabledControlIdentifiers
+ *       "STRING_VALUE",
+ *     ],
+ *     statuses: [ // ControlOperationStatuses
+ *       "SUCCEEDED" || "FAILED" || "IN_PROGRESS",
+ *     ],
+ *     controlOperationTypes: [ // ControlOperationTypes
+ *       "ENABLE_CONTROL" || "DISABLE_CONTROL" || "UPDATE_ENABLED_CONTROL",
+ *     ],
+ *   },
+ *   nextToken: "STRING_VALUE",
+ *   maxResults: Number("int"),
+ * };
+ * const command = new ListControlOperationsCommand(input);
+ * const response = await client.send(command);
+ * // { // ListControlOperationsOutput
+ * //   controlOperations: [ // ControlOperations // required
+ * //     { // ControlOperationSummary
+ * //       operationType: "ENABLE_CONTROL" || "DISABLE_CONTROL" || "UPDATE_ENABLED_CONTROL",
+ * //       startTime: new Date("TIMESTAMP"),
+ * //       endTime: new Date("TIMESTAMP"),
+ * //       status: "SUCCEEDED" || "FAILED" || "IN_PROGRESS",
+ * //       statusMessage: "STRING_VALUE",
+ * //       operationIdentifier: "STRING_VALUE",
+ * //       controlIdentifier: "STRING_VALUE",
+ * //       targetIdentifier: "STRING_VALUE",
+ * //       enabledControlIdentifier: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * //   nextToken: "STRING_VALUE",
+ * // };
+ *
+ * ```
+ *
+ * @param ListControlOperationsCommandInput - {@link ListControlOperationsCommandInput}
+ * @returns {@link ListControlOperationsCommandOutput}
+ * @see {@link ListControlOperationsCommandInput} for command's `input` shape.
+ * @see {@link ListControlOperationsCommandOutput} for command's `response` shape.
+ * @see {@link ControlTowerClientResolvedConfig | config} for ControlTowerClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p>You do not have sufficient access to perform this action.</p>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p>An unexpected error occurred during processing of a request.</p>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p>The request was denied due to request throttling.</p>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
+ *
+ * @throws {@link ControlTowerServiceException}
+ * <p>Base exception class for all service exceptions from ControlTower service.</p>
+ *
+ * @public
+ */
+export declare class ListControlOperationsCommand extends ListControlOperationsCommand_base {
+}

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

@@ -26,7 +26,9 @@ declare const ListEnabledBaselinesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a list of summaries describing <code>EnabledBaseline</code> resources. You can filter the list by the corresponding <code>Baseline</code> or <code>Target</code> of the <code>EnabledBaseline</code> resources.</p>
+ * <p>Returns a list of summaries describing <code>EnabledBaseline</code> resources. You can filter the list by the corresponding <code>Baseline</code> or <code>Target</code> of the <code>EnabledBaseline</code> resources. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -22,7 +22,7 @@ export interface ListEnabledControlsCommandOutput extends ListEnabledControlsOut
 }
 declare const ListEnabledControlsCommand_base: {
     new (input: ListEnabledControlsCommandInput): import("@smithy/smithy-client").CommandImpl<ListEnabledControlsCommandInput, ListEnabledControlsCommandOutput, ControlTowerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
-    new (__0_0: ListEnabledControlsCommandInput): import("@smithy/smithy-client").CommandImpl<ListEnabledControlsCommandInput, ListEnabledControlsCommandOutput, ControlTowerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (...[input]: [] | [ListEnabledControlsCommandInput]): import("@smithy/smithy-client").CommandImpl<ListEnabledControlsCommandInput, ListEnabledControlsCommandOutput, ControlTowerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
@@ -37,9 +37,20 @@ declare const ListEnabledControlsCommand_base: {
  * // const { ControlTowerClient, ListEnabledControlsCommand } = require("@aws-sdk/client-controltower"); // CommonJS import
  * const client = new ControlTowerClient(config);
  * const input = { // ListEnabledControlsInput
- *   targetIdentifier: "STRING_VALUE", // required
+ *   targetIdentifier: "STRING_VALUE",
  *   nextToken: "STRING_VALUE",
  *   maxResults: Number("int"),
+ *   filter: { // EnabledControlFilter
+ *     controlIdentifiers: [ // ControlIdentifiers
+ *       "STRING_VALUE",
+ *     ],
+ *     statuses: [ // EnablementStatuses
+ *       "SUCCEEDED" || "FAILED" || "UNDER_CHANGE",
+ *     ],
+ *     driftStatuses: [ // DriftStatuses
+ *       "DRIFTED" || "IN_SYNC" || "NOT_CHECKING" || "UNKNOWN",
+ *     ],
+ *   },
  * };
  * const command = new ListEnabledControlsCommand(input);
  * const response = await client.send(command);

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

@@ -26,7 +26,9 @@ declare const ResetEnabledBaselineCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Re-enables an <code>EnabledBaseline</code> resource. For example, this API can re-apply the existing <code>Baseline</code> after a new member account is moved to the target OU.</p>
+ * <p>Re-enables an <code>EnabledBaseline</code> resource. For example, this API can re-apply the existing <code>Baseline</code> after a new member account is moved to the target OU. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -26,7 +26,9 @@ declare const UpdateEnabledBaselineCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Updates an <code>EnabledBaseline</code> resource's applied parameters or version.</p>
+ * <p>Updates an <code>EnabledBaseline</code> resource's applied parameters or version. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">
+ *                <i>the Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -12,6 +12,7 @@ export * from "./GetEnabledControlCommand";
 export * from "./GetLandingZoneCommand";
 export * from "./GetLandingZoneOperationCommand";
 export * from "./ListBaselinesCommand";
+export * from "./ListControlOperationsCommand";
 export * from "./ListEnabledBaselinesCommand";
 export * from "./ListEnabledControlsCommand";
 export * from "./ListLandingZonesCommand";

package/dist-types/index.d.ts

@@ -1,5 +1,35 @@
 /**
- * <p>These interfaces allow you to apply the Amazon Web Services library of pre-defined
+ * <p>Amazon Web Services Control Tower offers application programming interface (API) operations that support programmatic interaction with these types of resources:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/controls.html">
+ *                      <i>controls</i>
+ *                   </a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/lz-api-launch.html">
+ *                      <i>landing zones</i>
+ *                   </a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/types-of-baselines.html">
+ *                      <i>baselines</i>
+ *                   </a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ *          <p>For more information about these types of resources, see the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/what-is-control-tower.html">
+ *                <i>Amazon Web Services Control Tower User Guide</i>
+ *             </a>.</p>
+ *          <p>
+ *             <b>About control APIs</b>
+ *          </p>
+ *          <p>These interfaces allow you to apply the Amazon Web Services library of pre-defined
  *          <i>controls</i> to your organizational units, programmatically. In Amazon Web Services Control Tower, the terms "control" and "guardrail" are synonyms.</p>
  *          <p>To call these APIs, you'll need to know:</p>
  *          <ul>
@@ -20,7 +50,7 @@
  *          <p>The <code>controlIdentifier</code> is an ARN that is specified for each
  *          control. You can view the <code>controlIdentifier</code> in the console on the <b>Control details</b> page, as well as in the documentation.</p>
  *          <p>The <code>controlIdentifier</code> is unique in each Amazon Web Services Region for each control. You can
- *          find the <code>controlIdentifier</code> for each Region and control in the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Tables of control metadata</a> in the <i>Amazon Web Services Control Tower User Guide.</i>
+ *          find the <code>controlIdentifier</code> for each Region and control in the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Tables of control metadata</a> or the <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-region-tables.html">Control availability by Region tables</a> in the <i>Amazon Web Services Control Tower User Guide.</i>
  *          </p>
  *          <p>A quick-reference list of control identifers for the Amazon Web Services Control Tower legacy <i>Strongly recommended</i> and
  *          <i>Elective</i> controls is given in <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-identifiers.html.html">Resource identifiers for
@@ -52,6 +82,17 @@
  *                <code>arn:${Partition}:organizations::${MasterAccountId}:ou/o-${OrganizationId}/ou-${OrganizationalUnitId}</code>
  *             </p>
  *          </note>
+ *          <p>
+ *             <b> About landing zone APIs</b>
+ *          </p>
+ *          <p>You can configure and launch an Amazon Web Services Control Tower landing zone with APIs. For an introduction and steps, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/getting-started-apis.html">Getting started with Amazon Web Services Control Tower using APIs</a>.</p>
+ *          <p>For an overview of landing zone API operations, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/2023-all.html#landing-zone-apis"> Amazon Web Services Control Tower supports landing zone APIs</a>. The individual API operations for landing zones are detailed in this document, the <a href="https://docs.aws.amazon.com/controltower/latest/APIReference/API_Operations.html">API reference manual</a>, in the "Actions" section.</p>
+ *          <p>
+ *             <b>About baseline APIs</b>
+ *          </p>
+ *          <p>You can apply the <code>AWSControlTowerBaseline</code> baseline to an organizational unit (OU) as a way to register the OU with Amazon Web Services Control Tower, programmatically. For a general overview of this capability, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/2024-all.html#baseline-apis">Amazon Web Services Control Tower supports APIs for OU registration and configuration with baselines</a>.</p>
+ *          <p>You can call the baseline API operations to view the baselines that Amazon Web Services Control Tower enables for your landing zone, on your behalf, when setting up the landing zone. These baselines are read-only baselines.</p>
+ *          <p>The individual API operations for baselines are detailed in this document, the <a href="https://docs.aws.amazon.com/controltower/latest/APIReference/API_Operations.html">API reference manual</a>, in the "Actions" section. For usage examples, see <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">Baseline API input and output examples with CLI</a>.</p>
  *          <p class="title">
  *             <b>Details and examples</b>
  *          </p>
@@ -63,12 +104,27 @@
  *             </li>
  *             <li>
  *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/baseline-api-examples.html">Baseline API input and output examples with CLI</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
  *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/enable-controls.html">Enable controls with CloudFormation</a>
  *                </p>
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Control metadata tables</a>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/lz-apis-cfn-setup.html">Launch a landing zone with CloudFormation</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-metadata-tables.html">Control metadata tables (large page)</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/controltower/latest/userguide/control-region-tables.html">Control availability by Region tables (large page)</a>
  *                </p>
  *             </li>
  *             <li>