/AWS1/CL_SSMMAINTENANCEWINDO13¶
The parameters for a RUN_COMMAND task type.
For information about specifying and updating task parameters, see RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.
LoggingInfo has been deprecated. To specify an Amazon Simple Storage Service (Amazon S3) bucket to contain logs, instead use the
OutputS3BucketName and OutputS3KeyPrefix options in the TaskInvocationParameters structure.
For information about how Amazon Web Services Systems Manager handles these options for the supported maintenance
window task types, see MaintenanceWindowTaskInvocationParameters.
TaskParameters has been deprecated. To specify parameters to pass to a task when it runs,
instead use the Parameters option in the TaskInvocationParameters structure. For information
about how Systems Manager handles these options for the supported maintenance window task
types, see MaintenanceWindowTaskInvocationParameters.
For RUN_COMMAND tasks, Systems Manager uses specified values for
TaskParameters and LoggingInfo only if no values are specified for
TaskInvocationParameters.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
iv_comment TYPE /AWS1/SSMCOMMENT /AWS1/SSMCOMMENT¶
Information about the commands to run.
io_cloudwatchoutputconfig TYPE REF TO /AWS1/CL_SSMCLOUDWATCHOUTCFG /AWS1/CL_SSMCLOUDWATCHOUTCFG¶
CloudWatchOutputConfig
iv_documenthash TYPE /AWS1/SSMDOCUMENTHASH /AWS1/SSMDOCUMENTHASH¶
The SHA-256 or SHA-1 hash created by the system when the document was created. SHA-1 hashes have been deprecated.
iv_documenthashtype TYPE /AWS1/SSMDOCUMENTHASHTYPE /AWS1/SSMDOCUMENTHASHTYPE¶
SHA-256 or SHA-1. SHA-1 hashes have been deprecated.
iv_documentversion TYPE /AWS1/SSMDOCUMENTVERSION /AWS1/SSMDOCUMENTVERSION¶
The Amazon Web Services Systems Manager document (SSM document) version to use in the request. You can specify
$DEFAULT,$LATEST, or a specific version number. If you run commands by using the Amazon Web Services CLI, then you must escape the first two options by using a backslash. If you specify a version number, then you don't need to use the backslash. For example:
--document-version "\$DEFAULT"
--document-version "\$LATEST"
--document-version "3"
io_notificationconfig TYPE REF TO /AWS1/CL_SSMNOTIFICATIONCONFIG /AWS1/CL_SSMNOTIFICATIONCONFIG¶
Configurations for sending notifications about command status changes on a per-managed node basis.
iv_outputs3bucketname TYPE /AWS1/SSMS3BUCKETNAME /AWS1/SSMS3BUCKETNAME¶
The name of the Amazon Simple Storage Service (Amazon S3) bucket.
iv_outputs3keyprefix TYPE /AWS1/SSMS3KEYPREFIX /AWS1/SSMS3KEYPREFIX¶
The S3 bucket subfolder.
it_parameters TYPE /AWS1/CL_SSMPARAMVALUELIST_W=>TT_PARAMETERS TT_PARAMETERS¶
The parameters for the
RUN_COMMANDtask execution.
iv_servicerolearn TYPE /AWS1/SSMSERVICEROLE /AWS1/SSMSERVICEROLE¶
The Amazon Resource Name (ARN) of the IAM service role for Amazon Web Services Systems Manager to assume when running a maintenance window task. If you do not specify a service role ARN, Systems Manager uses a service-linked role in your account. If no appropriate service-linked role for Systems Manager exists in your account, it is created when you run
RegisterTaskWithMaintenanceWindow.However, for an improved security posture, we strongly recommend creating a custom policy and custom service role for running your maintenance window tasks. The policy can be crafted to provide only the permissions needed for your particular maintenance window tasks. For more information, see Setting up Maintenance Windows in the in the Amazon Web Services Systems Manager User Guide.
iv_timeoutseconds TYPE /AWS1/SSMTIMEOUTSECONDS /AWS1/SSMTIMEOUTSECONDS¶
If this time is reached and the command hasn't already started running, it doesn't run.
Queryable Attributes¶
Comment¶
Information about the commands to run.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_COMMENT() |
Getter for COMMENT, with configurable default |
ASK_COMMENT() |
Getter for COMMENT w/ exceptions if field has no value |
HAS_COMMENT() |
Determine if COMMENT has a value |
CloudWatchOutputConfig¶
CloudWatchOutputConfig
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CLOUDWATCHOUTPUTCONFIG() |
Getter for CLOUDWATCHOUTPUTCONFIG |
DocumentHash¶
The SHA-256 or SHA-1 hash created by the system when the document was created. SHA-1 hashes have been deprecated.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DOCUMENTHASH() |
Getter for DOCUMENTHASH, with configurable default |
ASK_DOCUMENTHASH() |
Getter for DOCUMENTHASH w/ exceptions if field has no value |
HAS_DOCUMENTHASH() |
Determine if DOCUMENTHASH has a value |
DocumentHashType¶
SHA-256 or SHA-1. SHA-1 hashes have been deprecated.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DOCUMENTHASHTYPE() |
Getter for DOCUMENTHASHTYPE, with configurable default |
ASK_DOCUMENTHASHTYPE() |
Getter for DOCUMENTHASHTYPE w/ exceptions if field has no va |
HAS_DOCUMENTHASHTYPE() |
Determine if DOCUMENTHASHTYPE has a value |
DocumentVersion¶
The Amazon Web Services Systems Manager document (SSM document) version to use in the request. You can specify
$DEFAULT,$LATEST, or a specific version number. If you run commands by using the Amazon Web Services CLI, then you must escape the first two options by using a backslash. If you specify a version number, then you don't need to use the backslash. For example:
--document-version "\$DEFAULT"
--document-version "\$LATEST"
--document-version "3"
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DOCUMENTVERSION() |
Getter for DOCUMENTVERSION, with configurable default |
ASK_DOCUMENTVERSION() |
Getter for DOCUMENTVERSION w/ exceptions if field has no val |
HAS_DOCUMENTVERSION() |
Determine if DOCUMENTVERSION has a value |
NotificationConfig¶
Configurations for sending notifications about command status changes on a per-managed node basis.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_NOTIFICATIONCONFIG() |
Getter for NOTIFICATIONCONFIG |
OutputS3BucketName¶
The name of the Amazon Simple Storage Service (Amazon S3) bucket.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_OUTPUTS3BUCKETNAME() |
Getter for OUTPUTS3BUCKETNAME, with configurable default |
ASK_OUTPUTS3BUCKETNAME() |
Getter for OUTPUTS3BUCKETNAME w/ exceptions if field has no |
HAS_OUTPUTS3BUCKETNAME() |
Determine if OUTPUTS3BUCKETNAME has a value |
OutputS3KeyPrefix¶
The S3 bucket subfolder.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_OUTPUTS3KEYPREFIX() |
Getter for OUTPUTS3KEYPREFIX, with configurable default |
ASK_OUTPUTS3KEYPREFIX() |
Getter for OUTPUTS3KEYPREFIX w/ exceptions if field has no v |
HAS_OUTPUTS3KEYPREFIX() |
Determine if OUTPUTS3KEYPREFIX has a value |
Parameters¶
The parameters for the
RUN_COMMANDtask execution.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PARAMETERS() |
Getter for PARAMETERS, with configurable default |
ASK_PARAMETERS() |
Getter for PARAMETERS w/ exceptions if field has no value |
HAS_PARAMETERS() |
Determine if PARAMETERS has a value |
ServiceRoleArn¶
The Amazon Resource Name (ARN) of the IAM service role for Amazon Web Services Systems Manager to assume when running a maintenance window task. If you do not specify a service role ARN, Systems Manager uses a service-linked role in your account. If no appropriate service-linked role for Systems Manager exists in your account, it is created when you run
RegisterTaskWithMaintenanceWindow.However, for an improved security posture, we strongly recommend creating a custom policy and custom service role for running your maintenance window tasks. The policy can be crafted to provide only the permissions needed for your particular maintenance window tasks. For more information, see Setting up Maintenance Windows in the in the Amazon Web Services Systems Manager User Guide.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SERVICEROLEARN() |
Getter for SERVICEROLEARN, with configurable default |
ASK_SERVICEROLEARN() |
Getter for SERVICEROLEARN w/ exceptions if field has no valu |
HAS_SERVICEROLEARN() |
Determine if SERVICEROLEARN has a value |
TimeoutSeconds¶
If this time is reached and the command hasn't already started running, it doesn't run.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TIMEOUTSECONDS() |
Getter for TIMEOUTSECONDS, with configurable default |
ASK_TIMEOUTSECONDS() |
Getter for TIMEOUTSECONDS w/ exceptions if field has no valu |
HAS_TIMEOUTSECONDS() |
Determine if TIMEOUTSECONDS has a value |