import { Command as $Command } from "@smithy/smithy-client"; import { MetadataBearer as __MetadataBearer } from "@smithy/types"; import { StartChangeRequestExecutionRequest, StartChangeRequestExecutionResult } from "../models/models_2"; import { ServiceInputTypes, ServiceOutputTypes, SSMClientResolvedConfig } from "../SSMClient"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link StartChangeRequestExecutionCommand}. */ export interface StartChangeRequestExecutionCommandInput extends StartChangeRequestExecutionRequest { } /** * @public * * The output of {@link StartChangeRequestExecutionCommand}. */ export interface StartChangeRequestExecutionCommandOutput extends StartChangeRequestExecutionResult, __MetadataBearer { } declare const StartChangeRequestExecutionCommand_base: { new (input: StartChangeRequestExecutionCommandInput): import("@smithy/smithy-client").CommandImpl; new (input: StartChangeRequestExecutionCommandInput): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Creates a change request for Change Manager. The Automation runbooks specified in the * change request run only after all required approvals for the change request have been * received.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { SSMClient, StartChangeRequestExecutionCommand } from "@aws-sdk/client-ssm"; // ES Modules import * // const { SSMClient, StartChangeRequestExecutionCommand } = require("@aws-sdk/client-ssm"); // CommonJS import * const client = new SSMClient(config); * const input = { // StartChangeRequestExecutionRequest * ScheduledTime: new Date("TIMESTAMP"), * DocumentName: "STRING_VALUE", // required * DocumentVersion: "STRING_VALUE", * Parameters: { // AutomationParameterMap * "": [ // AutomationParameterValueList * "STRING_VALUE", * ], * }, * ChangeRequestName: "STRING_VALUE", * ClientToken: "STRING_VALUE", * AutoApprove: true || false, * Runbooks: [ // Runbooks // required * { // Runbook * DocumentName: "STRING_VALUE", // required * DocumentVersion: "STRING_VALUE", * Parameters: { * "": [ * "STRING_VALUE", * ], * }, * TargetParameterName: "STRING_VALUE", * Targets: [ // Targets * { // Target * Key: "STRING_VALUE", * Values: [ // TargetValues * "STRING_VALUE", * ], * }, * ], * TargetMaps: [ // TargetMaps * { // TargetMap * "": [ // TargetMapValueList * "STRING_VALUE", * ], * }, * ], * MaxConcurrency: "STRING_VALUE", * MaxErrors: "STRING_VALUE", * TargetLocations: [ // TargetLocations * { // TargetLocation * Accounts: [ // Accounts * "STRING_VALUE", * ], * Regions: [ // Regions * "STRING_VALUE", * ], * TargetLocationMaxConcurrency: "STRING_VALUE", * TargetLocationMaxErrors: "STRING_VALUE", * ExecutionRoleName: "STRING_VALUE", * TargetLocationAlarmConfiguration: { // AlarmConfiguration * IgnorePollAlarmFailure: true || false, * Alarms: [ // AlarmList // required * { // Alarm * Name: "STRING_VALUE", // required * }, * ], * }, * IncludeChildOrganizationUnits: true || false, * ExcludeAccounts: [ // ExcludeAccounts * "STRING_VALUE", * ], * Targets: [ * { * Key: "STRING_VALUE", * Values: [ * "STRING_VALUE", * ], * }, * ], * TargetsMaxConcurrency: "STRING_VALUE", * TargetsMaxErrors: "STRING_VALUE", * }, * ], * }, * ], * Tags: [ // TagList * { // Tag * Key: "STRING_VALUE", // required * Value: "STRING_VALUE", // required * }, * ], * ScheduledEndTime: new Date("TIMESTAMP"), * ChangeDetails: "STRING_VALUE", * }; * const command = new StartChangeRequestExecutionCommand(input); * const response = await client.send(command); * // { // StartChangeRequestExecutionResult * // AutomationExecutionId: "STRING_VALUE", * // }; * * ``` * * @param StartChangeRequestExecutionCommandInput - {@link StartChangeRequestExecutionCommandInput} * @returns {@link StartChangeRequestExecutionCommandOutput} * @see {@link StartChangeRequestExecutionCommandInput} for command's `input` shape. * @see {@link StartChangeRequestExecutionCommandOutput} for command's `response` shape. * @see {@link SSMClientResolvedConfig | config} for SSMClient's `config` shape. * * @throws {@link AutomationDefinitionNotApprovedException} (client fault) *

Indicates that the Change Manager change template used in the change request was rejected or is * still in a pending state.

* * @throws {@link AutomationDefinitionNotFoundException} (client fault) *

An Automation runbook with the specified name couldn't be found.

* * @throws {@link AutomationDefinitionVersionNotFoundException} (client fault) *

An Automation runbook with the specified name and version couldn't be found.

* * @throws {@link AutomationExecutionLimitExceededException} (client fault) *

The number of simultaneously running Automation executions exceeded the allowable * limit.

* * @throws {@link IdempotentParameterMismatch} (client fault) *

Error returned when an idempotent operation is retried and the parameters don't match the * original call to the API with the same idempotency token.

* * @throws {@link InternalServerError} (server fault) *

An error occurred on the server side.

* * @throws {@link InvalidAutomationExecutionParametersException} (client fault) *

The supplied parameters for invoking the specified Automation runbook are incorrect. For * example, they may not match the set of parameters permitted for the specified Automation * document.

* * @throws {@link SSMServiceException} *

Base exception class for all service exceptions from SSM service.

* * * @public */ export declare class StartChangeRequestExecutionCommand extends StartChangeRequestExecutionCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: StartChangeRequestExecutionRequest; output: StartChangeRequestExecutionResult; }; sdk: { input: StartChangeRequestExecutionCommandInput; output: StartChangeRequestExecutionCommandOutput; }; }; }