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

Updates the status of the Amazon Web Services Systems Manager document (SSM document) associated with the specified * managed node.

*

* UpdateAssociationStatus is primarily used by the Amazon Web Services Systems Manager Agent (SSM Agent) to * report status updates about your associations and is only used for associations created with the * InstanceId legacy parameter.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { SSMClient, UpdateAssociationStatusCommand } from "@aws-sdk/client-ssm"; // ES Modules import * // const { SSMClient, UpdateAssociationStatusCommand } = require("@aws-sdk/client-ssm"); // CommonJS import * const client = new SSMClient(config); * const input = { // UpdateAssociationStatusRequest * Name: "STRING_VALUE", // required * InstanceId: "STRING_VALUE", // required * AssociationStatus: { // AssociationStatus * Date: new Date("TIMESTAMP"), // required * Name: "Pending" || "Success" || "Failed", // required * Message: "STRING_VALUE", // required * AdditionalInfo: "STRING_VALUE", * }, * }; * const command = new UpdateAssociationStatusCommand(input); * const response = await client.send(command); * // { // UpdateAssociationStatusResult * // AssociationDescription: { // AssociationDescription * // Name: "STRING_VALUE", * // InstanceId: "STRING_VALUE", * // AssociationVersion: "STRING_VALUE", * // Date: new Date("TIMESTAMP"), * // LastUpdateAssociationDate: new Date("TIMESTAMP"), * // Status: { // AssociationStatus * // Date: new Date("TIMESTAMP"), // required * // Name: "Pending" || "Success" || "Failed", // required * // Message: "STRING_VALUE", // required * // AdditionalInfo: "STRING_VALUE", * // }, * // Overview: { // AssociationOverview * // Status: "STRING_VALUE", * // DetailedStatus: "STRING_VALUE", * // AssociationStatusAggregatedCount: { // AssociationStatusAggregatedCount * // "": Number("int"), * // }, * // }, * // DocumentVersion: "STRING_VALUE", * // AutomationTargetParameterName: "STRING_VALUE", * // Parameters: { // Parameters * // "": [ // ParameterValueList * // "STRING_VALUE", * // ], * // }, * // AssociationId: "STRING_VALUE", * // Targets: [ // Targets * // { // Target * // Key: "STRING_VALUE", * // Values: [ // TargetValues * // "STRING_VALUE", * // ], * // }, * // ], * // ScheduleExpression: "STRING_VALUE", * // OutputLocation: { // InstanceAssociationOutputLocation * // S3Location: { // S3OutputLocation * // OutputS3Region: "STRING_VALUE", * // OutputS3BucketName: "STRING_VALUE", * // OutputS3KeyPrefix: "STRING_VALUE", * // }, * // }, * // LastExecutionDate: new Date("TIMESTAMP"), * // LastSuccessfulExecutionDate: new Date("TIMESTAMP"), * // AssociationName: "STRING_VALUE", * // MaxErrors: "STRING_VALUE", * // MaxConcurrency: "STRING_VALUE", * // ComplianceSeverity: "CRITICAL" || "HIGH" || "MEDIUM" || "LOW" || "UNSPECIFIED", * // SyncCompliance: "AUTO" || "MANUAL", * // ApplyOnlyAtCronInterval: true || false, * // CalendarNames: [ // CalendarNameOrARNList * // "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", * // }, * // ], * // ScheduleOffset: Number("int"), * // Duration: Number("int"), * // TargetMaps: [ // TargetMaps * // { // TargetMap * // "": [ // TargetMapValueList * // "STRING_VALUE", * // ], * // }, * // ], * // AlarmConfiguration: { * // IgnorePollAlarmFailure: true || false, * // Alarms: [ // required * // { * // Name: "STRING_VALUE", // required * // }, * // ], * // }, * // TriggeredAlarms: [ // AlarmStateInformationList * // { // AlarmStateInformation * // Name: "STRING_VALUE", // required * // State: "UNKNOWN" || "ALARM", // required * // }, * // ], * // }, * // }; * * ``` * * @param UpdateAssociationStatusCommandInput - {@link UpdateAssociationStatusCommandInput} * @returns {@link UpdateAssociationStatusCommandOutput} * @see {@link UpdateAssociationStatusCommandInput} for command's `input` shape. * @see {@link UpdateAssociationStatusCommandOutput} for command's `response` shape. * @see {@link SSMClientResolvedConfig | config} for SSMClient's `config` shape. * * @throws {@link AssociationDoesNotExist} (client fault) *

The specified association doesn't exist.

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

An error occurred on the server side.

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

The specified SSM document doesn't exist.

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

The following problems can cause this exception:

*
    *
  • *

    You don't have permission to access the managed node.

    *
  • *
  • *

    Amazon Web Services Systems Manager Agent (SSM Agent) isn't running. Verify that SSM Agent is * running.

    *
  • *
  • *

    SSM Agent isn't registered with the SSM endpoint. Try reinstalling SSM Agent.

    *
  • *
  • *

    The managed node isn't in a valid state. Valid states are: Running, * Pending, Stopped, and Stopping. Invalid states are: * Shutting-down and Terminated.

    *
  • *
* * @throws {@link StatusUnchanged} (client fault) *

The updated status is the same as the current status.

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

There are concurrent updates for a resource that supports one update at a time.

* * @throws {@link SSMServiceException} *

Base exception class for all service exceptions from SSM service.

* * * @public */ export declare class UpdateAssociationStatusCommand extends UpdateAssociationStatusCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: UpdateAssociationStatusRequest; output: UpdateAssociationStatusResult; }; sdk: { input: UpdateAssociationStatusCommandInput; output: UpdateAssociationStatusCommandOutput; }; }; }