AWS::SSM::MaintenanceWindowTask MaintenanceWindowRunCommandParameters

The MaintenanceWindowRunCommandParameters property type specifies the parameters for a RUN_COMMAND task type for a maintenance window task in AWS Systems Manager. This means that these parameters are the same as those for the SendCommand API call. For more information about SendCommand parameters, see SendCommand in the AWS Systems Manager API Reference.

For information about available parameters in SSM Command documents, you can view the content of the document itself in the Systems Manager console. For information, see Viewing SSM command document content in the AWS Systems Manager User Guide.

MaintenanceWindowRunCommandParameters is a property of the TaskInvocationParameters property type.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Comment" : String,
  "DocumentHash" : String,
  "DocumentHashType" : String,
  "NotificationConfig" : NotificationConfig,
  "OutputS3BucketName" : String,
  "OutputS3KeyPrefix" : String,
  "Parameters" : Json,
  "ServiceRoleArn" : String,
  "TimeoutSeconds" : Integer
}

YAML

  Comment: String
  DocumentHash: String
  DocumentHashType: String
  NotificationConfig: 
    NotificationConfig
  OutputS3BucketName: String
  OutputS3KeyPrefix: String
  Parameters: Json
  ServiceRoleArn: String
  TimeoutSeconds: Integer

Properties

Comment

Information about the command or commands to run.

Required: No

Type: String

Maximum: 100

Update requires: No interruption

DocumentHash

The SHA-256 or SHA-1 hash created by the system when the document was created. SHA-1 hashes have been deprecated.

Required: No

Type: String

Maximum: 256

Update requires: No interruption

DocumentHashType

The SHA-256 or SHA-1 hash type. SHA-1 hashes are deprecated.

Required: No

Type: String

Allowed values: Sha1 | Sha256

Update requires: No interruption

NotificationConfig

Configurations for sending notifications about command status changes on a per-instance basis.

Required: No

Type: NotificationConfig

Update requires: No interruption

OutputS3BucketName

The name of the S3 bucket.

Required: No

Type: String

Minimum: 3

Maximum: 63

Update requires: No interruption

OutputS3KeyPrefix

The S3 bucket subfolder.

Required: No

Type: String

Maximum: 500

Update requires: No interruption

Parameters

The parameters for the RUN_COMMAND task execution.

The supported parameters are the same as those for the SendCommand API call. For more information, see SendCommand in the AWS Systems Manager API Reference.

Required: No

Type: Json

Update requires: No interruption

ServiceRoleArn

The ARN of the IAM service role to use to publish Amazon Simple Notification Service (Amazon SNS) notifications for maintenance window Run Command tasks.

Required: No

Type: String

Update requires: No interruption

TimeoutSeconds

If this time is reached and the command has not already started running, it doesn't run.

Required: No

Type: Integer

Minimum: 30

Maximum: 2592000

Update requires: No interruption