Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

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

# Mengubah peran IAM dari suatu tindakan
<a name="deploy-environments-switch-role"></a>

Secara default, saat Anda mengaitkan [lingkungan](deploy-environments.md) dengan [tindakan alur kerja, tindakan](workflows-actions.md) tersebut mewarisi peran IAM default yang ditentukan dalam lingkungan. Anda dapat mengubah perilaku ini sehingga tindakan menggunakan peran yang berbeda. Anda mungkin ingin tindakan menggunakan peran yang berbeda jika peran IAM default tidak memiliki izin yang diperlukan tindakan untuk beroperasi di AWS cloud.

Untuk menetapkan peran IAM yang berbeda ke tindakan, Anda dapat menggunakan opsi **Beralih peran** di editor visual atau `Connections:` properti di editor YAMAL. Peran baru mengganti peran IAM default yang ditentukan di lingkungan, memungkinkan Anda mempertahankan peran IAM default apa adanya. Anda mungkin ingin mempertahankan peran IAM default apa adanya jika ada tindakan lain yang menggunakannya.

Gunakan petunjuk berikut untuk mengonfigurasi tindakan agar menggunakan peran IAM yang berbeda dari peran yang ditentukan di lingkungannya.

------
#### [ Visual ]

**Untuk menetapkan peran IAM yang berbeda ke tindakan (editor visual)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**

1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

1. Pilih **Edit**.

1. Pilih kotak yang mewakili tindakan yang peran IAM yang ingin Anda perbarui.

1. Pilih tab **Konfigurasi**.

1. Dalam **Apa yang ada di*my-environment*?** kotak, pilih ikon elipsis vertikal ()![\[Ellipsis.\]](http://docs.aws.amazon.com/id_id/codecatalyst/latest/userguide/images/flows/elipsis.png).

1. Pilih **Beralih peran**.

1. Di kotak dialog **Beralih peran**, dalam daftar drop-down **peran IAM**, pilih peran IAM yang ingin digunakan tindakan. Peran ini akan mengganti peran IAM default di lingkungan. Jika peran yang ingin Anda gunakan tidak ada dalam daftar, pastikan Anda telah menambahkannya ke ruang Anda. Untuk informasi selengkapnya, lihat [Menambahkan peran IAM ke koneksi akun](ipa-connect-account-addroles.md).

   Peran yang dipilih sekarang muncul di **What's in*my-environment*?** kotak bersama dengan lencana **Didefined in workflow**. Peran juga muncul di file definisi alur kerja, di `Connections:` bagian.

1. (Opsional) Pilih **Validasi** untuk memvalidasi kode YAMAL alur kerja sebelum melakukan.

1. Pilih **Komit**, masukkan pesan komit, dan pilih **Komit** lagi.

------
#### [ YAML ]

**Untuk menetapkan peran IAM yang berbeda ke tindakan (editor YAMAL)**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pilih proyek Anda.

1. **Di panel navigasi, pilih **CI/CD, lalu pilih Alur** kerja.**

1. Pilih nama alur kerja Anda. Anda dapat memfilter berdasarkan repositori sumber atau nama cabang tempat alur kerja ditentukan, atau memfilter berdasarkan nama atau status alur kerja.

1. Pilih **Edit**.

1. Pilih **YAMAL.**

1. Dalam tindakan alur kerja di mana Anda ingin menggunakan peran IAM yang berbeda, tambahkan `Connections:` bagian, mirip dengan berikut ini:

   ```
   action-name:
     Environment:
       Name: environment-name
       Connections: 
         - Name: account-connection-name
           Role: iam-role-name
   ```

   Pada kode sebelumnya, ganti *account-connection-name* dengan nama [koneksi akun](ipa-connect-account.md) yang berisi peran IAM, dan ganti *iam-role-name* dengan nama peran IAM yang ingin Anda gunakan. Peran ini akan mengganti peran IAM default di lingkungan. Pastikan Anda telah menambahkan peran ke ruang Anda. Untuk informasi selengkapnya, lihat [Menambahkan peran IAM ke koneksi akun](ipa-connect-account-addroles.md).

   Untuk informasi lebih lanjut, lihat [Jenis tindakan](workflows-actions.md#workflows-actions-types) topiknya. Topik ini memiliki tautan ke dalam dokumentasi untuk setiap tindakan, termasuk referensi YAML-nya.

------