AWS-ECSRunTask - AWS Systems Manager Referencia del manual 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 (AmazonECS) que 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 del recurso de Amazon (ARN) del rol 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.

  • capacityProviderStrategy

    Tipo: cadena

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

  • Clúster

    Tipo: cadena

    Descripción: (opcional) El nombre abreviado ARN del clúster en el que se ejecutará la tarea. Si no especifica un clúster, se utilizará 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.

  • enableECSManagedEtiquetas

    Tipo: Booleano

    Descripción: (opcional) Especifica si se van a utilizar etiquetas ECS gestionadas por Amazon para la tarea. Para obtener más información, consulta Cómo etiquetar tus ECS recursos de Amazon en la Guía para desarrolladores de Amazon Elastic Container Service.

  • enableExecuteCommand

    Tipo: Booleano

    Descripción: (opcional) Determina si se debe activar la funcionalidad de ejecución de comandos para los contenedores en esta tarea. Si es cierto, se activa la función de ejecución de comandos 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.

  • networkConfiguration

    Tipo: cadena

    Descripción: (opcional) La configuración de red de 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 se admite en otros modos de red.

  • anula

    Tipo: cadena

    Descripción: (opcional) Una lista de anulaciones de contenedores en un JSON formato que 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 sobrescritura 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 utilizarlos en la tarea. Puede especificar hasta 10 restricciones para cada tarea, incluidas las restricciones en 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 colocación que se van a utilizar en la tarea. Puede especificar un máximo de 5 reglas de estrategia para cada tarea.

  • platformVersion

    Tipo: cadena

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

  • propagateTags

    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 en la tarea. El identificador de referencia puede tener una longitud máxima de 1024 caracteres.

  • startedBy

    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 al filtrar los resultados de una ListTasks API operación. Se permiten hasta 36 letras (mayúsculas y minúsculas), números, guiones (-) y guiones bajos (_).

  • etiquetas

    Tipo: cadena

    Descripción: (opcional) Metadatos 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.

  • taskDefinition

    Tipo: cadena

    Descripción: (opcional) Los caracteres family y revision (family:revision) o completa ARN de la definición de tarea que se va a ejecutar. Si no se especifica una revisión, se utiliza la última ACTIVE revisión.

IAMPermisos 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 ECS tarea de Amazon en función de los valores que especifiques para los parámetros de entrada del runbook.