

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# `AWS-ECSRunTask`
<a name="aws-run-ecs-task"></a>

 **Descrizione** 

 Il `AWS-ECSRunTask` runbook esegue il task Amazon Elastic Container Service (Amazon ECS) specificato dall'utente. 

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ECSRunTask) 

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

Linux

**Parametri**
+ AutomationAssumeRole

  Tipo: String

  Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
+ capacityProviderStrategy

  Tipo: String

  Descrizione: (Facoltativo) La strategia del provider di capacità da utilizzare per l'attività.
+ cluster

  Tipo: String

  Descrizione: (Facoltativo) Il nome breve o l'ARN del cluster su cui eseguire l'attività. Se non si specifica un cluster, viene utilizzato il cluster predefinito.
+ count

  Tipo: String

  Descrizione: (Facoltativo) Il numero di istanze dell'attività specificata da inserire nel cluster. È possibile specificare fino a 10 attività per ogni richiesta.
+ abilita i ECSManaged tag

  Tipo: Booleano

  Descrizione: (Facoltativo) Speciifica se utilizzare i tag gestiti di Amazon ECS per l'attività. Per ulteriori informazioni, consulta la sezione [Tagging delle risorse Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) nella *Guida per gli sviluppatori di Amazon Elastic Container Service*.
+ enableExecuteCommand

  Tipo: Booleano

  Descrizione: (Facoltativo) Determina se attivare la funzionalità del comando di esecuzione per i contenitori di questa attività. Se impostato su true, ciò attiva la funzionalità di esecuzione dei comandi su tutti i contenitori dell'attività.
+ gruppo

  Tipo: String

  Descrizione: (Facoltativo) Il nome del gruppo di attività da associare all'attività. Il valore predefinito è il cognome della definizione dell'attività. Ad esempio, `family:my-family-name`.
+ Tipo di avvio

  Tipo: String

  Valori validi: EC2 \$1 FARGATE \$1 EXTERNAL

  Descrizione: (Facoltativo) L'infrastruttura su cui eseguire l'attività autonoma.
+ networkConfiguration

  Tipo: String

  Descrizione: (Facoltativo) La configurazione di rete per l'attività. Questo parametro è necessario per le definizioni delle attività che utilizzano la modalità di `awsvpc` rete per ricevere la propria interfaccia di rete elastica e non è supportato per altre modalità di rete.
+ sovrascrive

  Tipo: String

  Descrizione: (Facoltativo) Un elenco di sostituzioni dei contenitori in formato JSON che specificano il nome di un contenitore nella definizione dell'attività specificata e le sostituzioni che deve ricevere. Puoi sovrascrivere il comando predefinito per un contenitore specificato nella definizione dell'attività o nell'immagine Docker con un comando override. Puoi anche sovrascrivere le variabili di ambiente esistenti specificate nella definizione dell'attività o nell'immagine Docker su un contenitore. Inoltre, puoi aggiungere nuove variabili di ambiente con un'override di ambiente.
+ placementConstraints

  Tipo: String

  Descrizione: (Facoltativo) Una serie di oggetti con vincoli di posizionamento da utilizzare per l'attività. È possibile specificare fino a 10 vincoli per ogni attività, inclusi i vincoli nella definizione dell'attività e quelli specificati in fase di esecuzione.
+ placementStrategy

  Tipo: String

  Descrizione: (Facoltativo) Gli oggetti della strategia di posizionamento da utilizzare per l'attività. È possibile specificare un massimo di 5 regole strategiche per ogni attività.
+ platformVersion

  Tipo: String

  Descrizione: (Facoltativo) La versione della piattaforma utilizzata dall'attività. Una versione della piattaforma è specificata solo per le attività ospitate su Fargate. Se non è specificata, di default viene utilizzata la versione della piattaforma `LATEST`.
+ propagateTags

  Tipo: String

  Descrizione: (Facoltativo) Determina se i tag si propagano dalla definizione dell'attività all'attività. Se non viene specificato alcun valore, i tag non vengono propagati. I tag possono essere propagati all'attività solo durante la creazione della stessa.
+ referenceId

  Tipo: String

  Descrizione: (Facoltativo) L'ID di riferimento da utilizzare per l'attività. L'ID di riferimento può avere una lunghezza massima di 1024 caratteri.
+ Iniziato da

  Tipo: String

  Descrizione: (Facoltativo) Un tag opzionale specificato all'avvio di un'attività. Questo ti aiuta a identificare quali attività appartengono a un lavoro specifico filtrando i risultati di un'operazione `ListTasks` API. Sono consentiti fino a 36 lettere (maiuscole e minuscole), numeri, trattini (-) e caratteri di sottolineatura (\$1).
+ tag

  Tipo: String

  Descrizione: (Facoltativo) Metadati che desideri applicare all'attività per aiutarti a classificare e organizzare le attività. Ogni tag è costituito da una chiave e da un valore definiti dall'utente.
+ Definizione dell'attività

  Tipo: String

  Descrizione: (Facoltativo) L'`family`and `revision` (`family`:`revision`) o l'ARN completo della definizione dell'attività da eseguire. Se non viene specificata una revisione, viene utilizzata la `ACTIVE` revisione più recente.

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+  `ecs:RunTask` 

 **Fasi del documento** 

 `aws:executeScript`- Esegue l'attività Amazon ECS in base ai valori specificati per i parametri di input del runbook. 