Troubleshooting maintenance windows
Use the following information to help you troubleshoot problems with maintenance windows.
Topics
- Edit task error: On the page for editing a maintenance window task, the IAM role list returns an error message: "We couldn't find the IAM maintenance window role specified for this task. It might have been deleted, or it might not have been created yet."
- Not all maintenance window targets are updated
- Task fails with task invocation status: "The provided role does not contain the correct SSM permissions."
- Task fails with error message: "Step fails when it is validating and resolving the step inputs"
- Error messages: "Maintenance window tasks without targets don't support MaxConcurrency values" and "Maintenance window tasks without targets don't support MaxErrors values"
Edit task error: On the page for editing a maintenance window task, the IAM role list returns an error message: "We couldn't find the IAM maintenance window role specified for this task. It might have been deleted, or it might not have been created yet."
Problem 1: The Amazon Identity and Access Management (IAM) maintenance window role you originally specified was deleted after you created the task.
Possible fix: 1) Select a different IAM maintenance window role, if one exists in your account, or create a new one and select it for the task.
Problem 2: If the task was created using the Amazon Command Line Interface
(Amazon CLI), Amazon Tools for Windows PowerShell, or an Amazon SDK, a non-existent IAM maintenance window role
name could have been specified. For example, the IAM maintenance window role could
have been deleted before you created the task, or the role name could have been
typed incorrectly, such as myrole
instead of
my-role
.
Possible fix: Select the correct name of the IAM maintenance window role you want to use, or create a new one to specify for the task.
Not all maintenance window targets are updated
Problem: You notice that maintenance window tasks didn't run on all the resources targeted by your maintenance window. For example, in the maintenance window run results, the task for that resource is marked as failed or timed out.
Solution: The most common reasons for a maintenance window task not running on a target resource involve connectivity and availability. For example:
-
Systems Manager lost connection to the resource before or during the maintenance window operation.
-
The resource was offline or stopped during the maintenance window operation.
You can wait for the next scheduled maintenance window time to run tasks on the resources. You can manually run the maintenance window tasks on the resources that weren't available or were offline.
Task fails with task invocation status: "The provided role does not contain the correct SSM permissions."
Problem: You have specified a maintenance window service role for a task, but the task fails to run successfully and the task invocation status reports that "The provided role does not contain the correct SSM permissions."
-
Solution: In Task 1: Create a custom policy for your maintenance window service role using the console, we provide a basic policy you can attach to your custom maintenance window service role. The policy includes the permissions needed for many task scenarios. However, due to the wide variety of tasks you can run, you might need to provide additional permissions in the policy for your maintenance window role.
For example, some Automation actions work with Amazon CloudFormation stacks. Therefore, you might need to add the additional permissions
cloudformation:CreateStack
,cloudformation:DescribeStacks
, andcloudformation:DeleteStack
to the policy for your maintenance window service role.For another example, the Automation runbook
AWS-CopySnapshot
requires permissions to create an Amazon Elastic Block Store (Amazon EBS) snapshot. Therefore, you might need to add the permissionec2:CreateSnapshot
.For information about the role permissions needed by an Amazon managed Automation runbook, see the runbook descriptions in the Amazon Systems Manager Automation runbook reference.
For information about the role permissions needed by an Amazon managed SSM document, review the content of the document in the Documents
section Systems Manager console. For information about the role permissions needed for Step Functions tasks, Lambda tasks, and custom Automation runbooks and SSM documents, verify permission requirements with the author of those resources.
Task fails with error message: "Step fails when it is validating and resolving the step inputs"
Problem: An Automation runbook or Systems Manager Command
document you're using in a task requires that you specify inputs such as
InstanceId
or SnapshotId
, but a value isn't supplied
or isn't supplied correctly.
-
Solution 1: If your task is targeting a single resource, such as a single node or single snapshot, enter its ID in the input parameters for the task.
-
Solution 2: If your task is targeting multiple resources, such as creating images from multiple nodes when you use the runbook
AWS-CreateImage
, you can use one of the pseudo parameters supported for maintenance window tasks in the input parameters to represent node IDs in the command.The following commands register a Systems Manager Automation task with a maintenance window using the Amazon CLI. The
--targets
value indicates a maintenance window target ID. Also, even though the--targets
parameter specifies a window target ID, parameters of the Automation runbook require that a node ID be provided. In this case, the command uses the pseudo parameter{{RESOURCE_ID}}
as theInstanceId
value.Amazon CLI command:
For more information about working with pseudo parameters for maintenance window tasks, see Using pseudo parameters when registering maintenance window tasks and Task registration examples.
Error messages: "Maintenance window tasks without targets don't support MaxConcurrency values" and "Maintenance window tasks without targets don't support MaxErrors values"
Problem: When you register a Run Command-type task,
you must specify at least one target for the task to run on. For other task types
(Automation, Amazon Lambda, and Amazon Step Functions), depending on the nature of the task, targets
are optional. The options MaxConcurrency
(the number of resources to
run a task on at the same time) and MaxErrors
(the number of failures
to run the task on target resources before the task fails) aren't required or
supported for maintenance window tasks that don't specify targets. The system
generates these error messages if values are specified for either of these options
when no task target is specified.
Solution: If you receive either of these errors, remove the values for concurrency and error threshold before continuing to register or update the maintenance window task.
For more information about running tasks that don't specify targets, see Registering maintenance window tasks without targets in the Amazon Systems Manager User Guide.