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

# Amazon ECS EventBridge Peran IAM
<a name="CWE_IAM_role"></a>

Sebelum Anda dapat menggunakan tugas terjadwal Amazon ECS dengan EventBridge Aturan dan sasaran, EventBridge layanan memerlukan izin untuk menjalankan tugas Amazon ECS atas nama Anda. Izin ini berasal dari EventBridge Peran IAM (`ecsEventsRole`).

 `AmazonEC2ContainerServiceEventsRole` kebijakan adalah sebagai berikut.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["ecs:RunTask"],
            "Resource": ["*"]
        },
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": ["*"],
            "Condition": {
                "StringLike": {"iam:PassedToService": "ecs-tasks.amazonaws.com"}
            }
        },
        {
            "Effect": "Allow",
            "Action": "ecs:TagResource",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "ecs:CreateAction": ["RunTask"]
                }
            }
        }
    ]
}
```

------

Jika tugas yang dijadwalkan memerlukan penggunaan peran eksekusi tugas, peran tugas, atau penggantian peran tugas, maka Anda harus menambahkan `iam:PassRole` izin untuk setiap peran eksekusi tugas, peran tugas, atau peran tugas diganti ke EventBridge Peran IAM. Untuk informasi selengkapnya tentang peran eksekusi tugas, lihat [Peran IAM pelaksanaan tugas Amazon ECS](task_execution_IAM_role.md).

**catatan**  
Tentukan ARN penuh dari peran eksekusi tugas Anda atau penimpaan peran tugas.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": [
            "arn:aws:iam::{{111122223333}}:role/{{ecsTaskExecutionRole_or_TaskRole_name}}"
            ]
        }
    ]
}
```

------

Anda dapat memilih untuk membiarkan Konsol Manajemen AWS buat EventBridge peran untuk Anda saat Anda mengonfigurasi tugas terjadwal. Untuk informasi selengkapnya, lihat [Menggunakan Amazon EventBridge Penjadwal untuk menjadwalkan tugas Amazon ECS](tasks-scheduled-eventbridge-scheduler.md).

## Menciptakan EventBridge peran
<a name="cw-iam-role-create"></a>

Ganti semua {{user input}} dengan informasi Anda sendiri.

1. Buat file bernama `eventbridge-trust-policy.json` yang berisi kebijakan kepercayaan yang akan digunakan untuk peran IAM. File tersebut harus berisi hal berikut:

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Sid": "",
         "Effect": "Allow",
         "Principal": {
           "Service": "events.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

1. Gunakan perintah berikut untuk membuat peran IAM bernama `ecsEventsRole` dengan menggunakan kebijakan kepercayaan yang Anda buat di langkah sebelumnya.

   ```
   aws iam create-role \
         --role-name {{ecsEventsRole}} \
         --assume-role-policy-document file://{{eventbridge-trust-policy.json}}
   ```

1. Pasang AWS dikelola `AmazonEC2ContainerServiceEventsRole` ke `ecsEventsRole` peran menggunakan perintah berikut.

   ```
   aws iam attach-role-policy \
         --role-name {{ecsEventsRole}} \
         --policy-arn arn:aws:iam::aws:policy/service-role/AmazonEC2ContainerServiceEventsRole
   ```

Anda juga dapat menggunakan konsol IAM **Kebijakan kepercayaan khusus** alur kerja ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) untuk menciptakan peran. Untuk informasi lebih lanjut, lihat [Membuat peran menggunakan kebijakan kepercayaan khusus (konsol)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) di *Panduan Pengguna IAM*.

## Melampirkan kebijakan ke `ecsEventsRole` peran
<a name="cw-iam-role-attach"></a>

Anda dapat menggunakan prosedur berikut untuk menambahkan izin untuk peran eksekusi tugas ke EventBridge Peran IAM.

------
#### [ Konsol Manajemen AWS ]

**Cara menggunakan editor kebijakan JSON untuk membuat kebijakan**

1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Pada panel navigasi di sebelah kiri, pilih **Kebijakan**. 

   Jika ini pertama kalinya Anda memilih **Kebijakan**, akan muncul halaman **Selamat Datang di Kebijakan Terkelola**. Pilih **Memulai**.

1. Di bagian atas halaman, pilih **Buat kebijakan**.

1. Di bagian **Editor kebijakan**, pilih opsi **JSON**.

1. Masukkan dokumen kebijakan JSON berikut:

   ```
   {
       "Version": "2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": ["arn:aws:iam::111122223333:role/<ecsTaskExecutionRole_or_TaskRole_name>"]
           }
       ]
   }
   ```

1. Pilih **Berikutnya**.
**catatan**  
Anda dapat beralih antara opsi editor **Visual** dan **JSON** kapan saja. Namun, jika Anda melakukan perubahan atau memilih **Berikutnya** di editor **Visual**, IAM dapat merestrukturisasi kebijakan Anda untuk mengoptimalkannya bagi editor visual. Untuk informasi selengkapnya, lihat [Restrukturisasi kebijakan](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure) dalam *Panduan Pengguna IAM*.

1. Pada halaman **Tinjau dan buat**, masukkan **Nama kebijakan** dan **Deskripsi** (opsional) untuk kebijakan yang Anda buat. Tinjau **Izin yang ditentukan dalam kebijakan ini** untuk melihat izin yang diberikan oleh kebijakan Anda.

1. Pilih **Buat kebijakan** untuk menyimpan kebijakan baru Anda.

Setelah Anda membuat kebijakan, lampirkan kebijakan ke EventBridge peran. Untuk informasi tentang cara melampirkan kebijakan ke peran, lihat [Memperbarui izin untuk peran](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html) di *AWS Identity and Access Management Panduan Pengguna*.

------
#### [ AWS CLI ]

Ganti semua {{user input}} dengan informasi Anda sendiri.

1. Buat file bernama `ev-iam-passrole.json` dengan konten berikut.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": [
               "arn:aws:iam::{{111122223333}}:role/{{ecsTaskExecutionRole_or_TaskRole_name}}"
               ]
           }
       ]
   }
   ```

------

1. Gunakan yang berikut AWS CLI perintah untuk membuat kebijakan IAM menggunakan file dokumen kebijakan JSON.

   ```
   aws iam create-policy \
         --policy-name {{eventsTaskExecutionPolicy}} \
         --policy-document file://{{ev-iam-passrole.json}}
   ```

1. Ambil ARN dari kebijakan IAM yang Anda buat menggunakan perintah berikut.

   ```
   aws iam list-policies --scope Local --query 'Policies[?PolicyName==`{{eventsTaskExecutionPolicy}}`].Arn'
   ```

1. Gunakan perintah berikut untuk melampirkan kebijakan ke EventBridge Peran IAM dengan menggunakan kebijakan ARN.

   ```
   aws iam attach-role-policy \
         --role-name {{ecsEventsRole}} \
         --policy-arn arn:aws:iam:111122223333:aws:policy/{{eventsTaskExecutionPolicy}}
   ```

------