View a markdown version of this page

AWS-ECSRunTask - AWS Systems Manager Referencia del manual de procedimientos de Automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS-ECSRunTask

Descripción

El AWS-ECSRunTask manual ejecuta la tarea de Amazon Elastic Container Service (Amazon ECS) que usted especifique.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux

Parámetros

  • AutomationAssumeRole

    Tipo: cadena

    Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

  • capacidad ProviderStrategy

    Tipo: cadena

    Descripción: (Opcional) La estrategia del proveedor de capacidad que se utilizará para la tarea.

  • clúster

    Tipo: cadena

    Descripción: (Opcional) El nombre abreviado o ARN del clúster en el que ejecutar la tarea. Si no especifica ningún clúster, se utiliza el clúster predeterminado.

  • count

    Tipo: cadena

    Descripción: (opcional) El número de instancias de la tarea especificada que se van a colocar en el clúster. Puedes especificar hasta 10 tareas para cada solicitud.

  • habilitar ECSManagedTags

    Tipo: Booleano

    Descripción: (opcional) Especifica si se deben usar etiquetas administradas de Amazon ECS para la tarea. Para obtener más información, consulte Etiquetado de los recursos de Amazon ECS en la Guía para desarrolladores de Amazon Elastic Container Service.

  • habilitar ExecuteCommand

    Tipo: Booleano

    Descripción: (opcional) Determina si se debe activar la funcionalidad de ejecución del comando para los contenedores de esta tarea. Si es verdadero, esto activa la funcionalidad de ejecución del comando en todos los contenedores de la tarea.

  • grupo

    Tipo: cadena

    Descripción: (opcional) El nombre del grupo de tareas que se va a asociar a la tarea. El valor predeterminado es el apellido de la definición de la tarea. Por ejemplo, family:my-family-name.

  • LaunchType

    Tipo: cadena

    Valores válidos: EC2 | FARGATE | EXTERNAL

    Descripción: (Opcional) La infraestructura en la que ejecutar la tarea independiente.

  • Configuración de red

    Tipo: cadena

    Descripción: (opcional) La configuración de red para la tarea. Este parámetro es necesario para las definiciones de tareas que utilizan el modo de awsvpc red para recibir su propia interfaz de red elástica, y no es compatible con otros modos de red.

  • anulaciones

    Tipo: cadena

    Descripción: (opcional) Una lista de anulaciones de contenedores en formato JSON en la que se especifica el nombre de un contenedor en la definición de tarea especificada y las anulaciones que debe recibir. Puedes anular el comando predeterminado de un contenedor especificado en la definición de la tarea o en la imagen de Docker con una anulación de comandos. También puedes anular las variables de entorno existentes que se especifican en la definición de la tarea o en la imagen de Docker de un contenedor. Además, puedes añadir nuevas variables de entorno con una anulación de entorno.

  • placementConstraints

    Tipo: cadena

    Descripción: (opcional) Una matriz de objetos de restricción de ubicación para usar en la tarea. Puede especificar hasta 10 restricciones para cada tarea, incluidas las restricciones de la definición de la tarea y las especificadas en tiempo de ejecución.

  • placementStrategy

    Tipo: cadena

    Descripción: (opcional) Los objetos de la estrategia de ubicación que se van a utilizar para la tarea. Puedes especificar un máximo de 5 reglas de estrategia para cada tarea.

  • platformVersion

    Tipo: cadena

    Descripción: (opcional) La versión de plataforma que usa la tarea. La versión de plataforma solo se especifica para las tareas alojadas en Fargate. Si no se especifica una versión de la plataforma, se utilizará la versión LATEST.

  • Propague etiquetas

    Tipo: cadena

    Descripción: (opcional) Determina si las etiquetas se propagan de la definición de la tarea a la tarea. Si no se especifica ningún valor, las etiquetas no se propagan. Las etiquetas solo se pueden propagar a la tarea durante la creación de tareas.

  • referenceId

    Tipo: cadena

    Descripción: (opcional) El identificador de referencia que se va a utilizar para la tarea. El ID de referencia puede tener una longitud máxima de 1024 caracteres.

  • Empezado por

    Tipo: cadena

    Descripción: (opcional) Una etiqueta opcional que se especifica cuando se inicia una tarea. Esto le ayuda a identificar qué tareas pertenecen a un trabajo específico filtrando los resultados de una operación de la ListTasks API. Se permiten hasta 36 letras (mayúsculas y minúsculas), números, guiones (-) y guiones bajos (_).

  • etiquetas

    Tipo: cadena

    Descripción: metadatos (opcional) que desea aplicar a la tarea para ayudarle a categorizar y organizar las tareas. Cada etiqueta consta de una clave y un valor definidos por el usuario.

  • Definición de tarea

    Tipo: cadena

    Descripción: (opcional) El family y revision (family:revision) o el ARN completo de la definición de la tarea que se va a ejecutar. Si no se especifica ninguna revisión, se usa la últimaACTIVE.

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • ecs:RunTask

Pasos de documentos

aws:executeScript- Ejecuta la tarea de Amazon ECS en función de los valores que especifique para los parámetros de entrada del runbook.