

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

 **Deskripsi** 

 `AWS-ECSRunTask`Runbook menjalankan tugas Amazon Elastic Container Service (Amazon ECS) yang Anda tentukan. 

 [Jalankan Otomasi ini (konsol)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ECSRunTask) 

**Jenis dokumen**

Otomatisasi

**Pemilik**

Amazon

**Platform**

Linux

**Parameter**
+ AutomationAssumeRole

  Tipe: String

  Deskripsi: (Opsional) Nama Sumber Daya Amazon (ARN) peran AWS Identity and Access Management (IAM) yang memungkinkan Otomasi Systems Manager untuk melakukan tindakan atas nama Anda. Jika tidak ada peran yang ditentukan, Systems Manager Automation menggunakan izin pengguna yang memulai runbook ini.
+ capacityProviderStrategy

  Tipe: String

  Deskripsi: (Opsional) Strategi penyedia kapasitas yang digunakan untuk tugas tersebut.
+ klaster

  Tipe: String

  Deskripsi: (Opsional) Nama pendek atau ARN cluster untuk menjalankan tugas Anda. Jika Anda tidak menentukan cluster, cluster default digunakan.
+ count

  Tipe: String

  Deskripsi: (Opsional) Jumlah instantiasi tugas yang ditentukan untuk ditempatkan di klaster Anda. Anda dapat menentukan hingga 10 tugas untuk setiap permintaan.
+ aktifkan ECSManaged Tag

  Jenis: Boolean

  Deskripsi: (Opsional) Menentukan apakah akan menggunakan tag terkelola Amazon ECS untuk tugas tersebut. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon ECS Anda di Panduan](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) *Pengembang Layanan Kontainer Elastis Amazon*.
+ enableExecuteCommand

  Jenis: Boolean

  Deskripsi: (Opsional) Menentukan apakah akan mengaktifkan fungsionalitas perintah eksekusi untuk wadah dalam tugas ini. Jika benar, ini mengaktifkan fungsionalitas perintah eksekusi pada semua kontainer dalam tugas.
+ grup

  Tipe: String

  Deskripsi: (Opsional) Nama kelompok tugas untuk dikaitkan dengan tugas. Nilai default adalah nama keluarga dari definisi tugas. Misalnya, `family:my-family-name`.
+ LaunchType

  Tipe: String

  Nilai yang valid: EC2 \$1 FARGATE \$1 EKSTERNAL

  Deskripsi: (Opsional) Infrastruktur untuk menjalankan tugas mandiri Anda.
+ networkConfiguration

  Tipe: String

  Deskripsi: (Opsional) Konfigurasi jaringan untuk tugas tersebut. Parameter ini diperlukan untuk definisi tugas yang menggunakan mode `awsvpc` jaringan untuk menerima elastic network interface mereka sendiri, dan tidak didukung untuk mode jaringan lainnya.
+ mengesampingkan

  Tipe: String

  Deskripsi: (Opsional) Daftar penampungan kontainer dalam format JSON yang menentukan nama kontainer dalam definisi tugas yang ditentukan dan penggantian yang harus diterimanya. Anda dapat mengganti perintah default untuk wadah yang ditentukan dalam definisi tugas atau image Docker dengan penggantian perintah. Anda juga dapat mengganti variabel lingkungan yang ada yang ditentukan dalam definisi tugas atau gambar Docker pada wadah. Selain itu, Anda dapat menambahkan variabel lingkungan baru dengan penggantian lingkungan.
+ Penempatan Kendala

  Tipe: String

  Deskripsi: (Opsional) Sebuah array objek kendala penempatan untuk digunakan untuk tugas. Anda dapat menentukan hingga 10 kendala untuk setiap tugas termasuk kendala dalam definisi tugas dan yang ditentukan saat runtime.
+ Strategi Penempatan

  Tipe: String

  Deskripsi: (Opsional) Objek strategi penempatan yang akan digunakan untuk tugas. Anda dapat menentukan maksimal 5 aturan strategi untuk setiap tugas.
+ platformVersion

  Tipe: String

  Deskripsi: (Opsional) Versi platform yang digunakan tugas. Versi platform hanya ditentukan untuk tugas yang dihosting di Fargate. Jika versi platform tidak ditentukan, versi `LATEST` platform akan digunakan.
+ propagateTags

  Tipe: String

  Deskripsi: (Opsional) Menentukan apakah tag menyebar dari definisi tugas ke tugas. Jika tidak ada nilai yang ditentukan, tanda tidak disebarkan. Tag hanya dapat disebarkan ke tugas selama pembuatan tugas.
+ ReferenceID

  Tipe: String

  Deskripsi: (Opsional) ID referensi yang akan digunakan untuk tugas. ID referensi dapat memiliki panjang maksimum 1024 karakter.
+ dimulaiOleh

  Tipe: String

  Deskripsi: (Opsional) Tag opsional yang ditentukan saat tugas dimulai. Ini membantu Anda mengidentifikasi tugas mana yang termasuk dalam pekerjaan tertentu dengan memfilter hasil operasi `ListTasks` API. Hingga 36 huruf (huruf besar dan kecil), angka, tanda hubung (-), dan garis bawah (\$1) diperbolehkan.
+ tag

  Tipe: String

  Deskripsi: (Opsional) Metadata yang ingin Anda terapkan pada tugas untuk membantu Anda mengkategorikan dan mengatur tugas. Setiap tag terdiri dari kunci dan nilai yang ditentukan pengguna.
+ TaskDefinition

  Tipe: String

  Deskripsi: (Opsional) ARN `family` dan `revision` (`family`:`revision`) atau penuh dari definisi tugas yang akan dijalankan. Jika revisi tidak ditentukan, `ACTIVE` revisi terbaru akan digunakan.

**Izin IAM yang diperlukan**

`AutomationAssumeRole`Parameter memerlukan tindakan berikut untuk menggunakan runbook dengan sukses.
+  `ecs:RunTask` 

 **Langkah Dokumen** 

 `aws:executeScript`- Menjalankan tugas Amazon ECS berdasarkan nilai yang Anda tentukan untuk parameter input runbook. 