Registro de tareas del periodo de mantenimiento sin destinos - AWS Systems Manager

Registro de tareas del periodo de mantenimiento sin destinos

Para cada periodo de mantenimiento que crea, puede especificar una o más tareas que se deben realizar cuando se ejecuta el periodo de mantenimiento. En la mayoría de los casos, debe especificar los recursos o los destinos en los que se ejecutará la tarea. En algunos casos, sin embargo, no es necesario que especifique destinos de forma explícita en la tarea.

Se deben especificar uno o más destinos para las tareas de tipo Systems Manager Run Command del periodo de mantenimiento. Según la naturaleza de la tarea, los destinos son opcionales para otros tipos de tarea de periodo de mantenimiento (Automatización de Systems Manager, AWS Lambda y AWS Step Functions).

Para los tipos de tareas de Lambda y Step Functions, la necesidad de un destino dependerá del contenido de la función o la máquina de estado que haya creado.

En muchos casos, no es necesario especificar de forma explícita un destino para una tarea de automatización. Por ejemplo, suponga que crea una tarea de tipo Automation para actualizar una Amazon Machine Image (AMI) para Linux mediante el manual de procedimientos AWS-UpdateLinuxAmi. Cuando se ejecuta la tarea, la AMI se actualiza con los paquetes de distribución de Linux y el software de Amazon disponibles más recientes. Las instancias nuevas que se crearon a partir de la AMI ya tienen estas actualizaciones instaladas. Como el ID de la AMI que se actualizará se especifica en los parámetros de entrada del manual de procedimientos, no es necesario volver a especificar un destino en la tarea del periodo de mantenimiento.

Del mismo modo, suponga que utiliza la AWS Command Line Interface (AWS CLI) para registrar un periodo de mantenimiento de una tarea de automatización que utiliza el manual de procedimientos AWS-RestartEC2Instance. Puesto que el nodo que se debe reiniciar se especifica en el argumento --task-invocation-parameters, no es necesario especificar también una opción --targets.

nota

En el caso de las tareas del periodo de mantenimiento sin un destino especificado, no puede proporcionar valores para --max-errors ni --max-concurrency. En su lugar, el sistema inserta un valor de marcador 1, el cual podría notificarse en la respuesta a los comandos, como describe-maintenance-window-tasks y get-maintenance-window-task. Estos valores no afectan la ejecución de la tarea y se pueden ignorar.

En el siguiente ejemplo, se muestra la omisión de las opciones --targets, --max-errors y --max-concurrency para una tarea de un periodo de mantenimiento sin destino.

Linux & macOS
aws ssm register-task-with-maintenance-window \ --window-id "mw-ab12cd34eEXAMPLE" \ --service-role-arn "arn:aws:iam::123456789012:role/MaintenanceWindowAndAutomationRole" \ --task-type "AUTOMATION" \ --name "RestartInstanceWithoutTarget" \ --task-arn "AWS-RestartEC2Instance" \ --task-invocation-parameters "{\"Automation\":{\"Parameters\":{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"]}}}" \ --priority 10
Windows
aws ssm register-task-with-maintenance-window ^ --window-id "mw-ab12cd34eEXAMPLE" ^ --service-role-arn "arn:aws:iam::123456789012:role/MaintenanceWindowAndAutomationRole" ^ --task-type "AUTOMATION" ^ --name "RestartInstanceWithoutTarget" ^ --task-arn "AWS-RestartEC2Instance" ^ --task-invocation-parameters "{\"Automation\":{\"Parameters\":{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"]}}}" ^ --priority 10
nota

Para tareas de periodo de mantenimiento registradas antes del 23 de diciembre de 2020: si especificó destinos para la tarea y ya no es necesario uno, puede actualizar esa tarea para eliminar los destinos mediante la consola de Systems Manager o el comando AWS CLI de la update-maintenance-window-task.