/

The Amazon SSM multi-region endpoint

http://ssm.{region}.amazonaws.com

POST

Modifies a task assigned to a maintenance window. You can't change the task type, but you can change the following values:

TaskARN. For example, you can change a RUN_COMMAND task from AWS-RunPowerShellScript to AWS-RunShellScript.
ServiceRoleArn
TaskInvocationParameters
Priority
MaxConcurrency
MaxErrors

If the value for a parameter in UpdateMaintenanceWindowTask is null, then the corresponding field isn't modified. If you set Replace to true, then all fields required by the RegisterTaskWithMaintenanceWindow operation are required for this request. Optional fields that aren't specified are set to null.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http://ssm.{region}.amazonaws.com/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "WindowId": "string",
    "WindowTaskId": "string",
    "Targets": [],
    "TaskArn": "string",
    "ServiceRoleArn": "string",
    "TaskParameters": {
        "property1": {
            "Values": []
        }
    },
    "TaskInvocationParameters": {
        "RunCommand": {},
        "Automation": {
            "DocumentVersion": "string",
            "Parameters": {
                "property1": [
                    "string"
                ],
                "property2": [
                    "string"
                ]
            }
        },
        "StepFunctions": {},
        "Lambda": {}
    },
    "Priority": 0,
    "MaxConcurrency": "string",
    "MaxErrors": "string",
    "LoggingInfo": {},
    "Name": "string",
    "Description": "string",
    "Replace": true,
    "CutoffBehavior": "CONTINUE_TASK",
    "AlarmConfiguration": {
        "IgnorePollAlarmFailure": true,
        "Alarms": []
    }
}'

Response Example

200 - Example 1

{
    "WindowId": "string",
    "WindowTaskId": "string",
    "Targets": [],
    "TaskArn": "string",
    "ServiceRoleArn": "string",
    "TaskParameters": {
        "property1": {
            "Values": []
        }
    },
    "TaskInvocationParameters": {
        "RunCommand": {},
        "Automation": {
            "DocumentVersion": "string",
            "Parameters": {
                "property1": [
                    "string"
                ],
                "property2": [
                    "string"
                ]
            }
        },
        "StepFunctions": {},
        "Lambda": {}
    },
    "Priority": 0,
    "MaxConcurrency": "string",
    "MaxErrors": "string",
    "LoggingInfo": {},
    "Name": "string",
    "Description": "string",
    "CutoffBehavior": "CONTINUE_TASK",
    "AlarmConfiguration": {
        "IgnorePollAlarmFailure": true,
        "Alarms": []
    }
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠480DoesNotExistException

🟠481InternalServerError

Modified at 2023-08-15 10:32:33