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

# Perbarui setelan untuk peran
<a name="id_roles_update-role-settings"></a>

Gunakan prosedur berikut untuk memperbarui deskripsi peran atau mengubah durasi sesi maksimum untuk peran.

## Memperbarui deskripsi peran
<a name="id_roles_update-description"></a>

Untuk mengubah deskripsi peran, ubah teks deskripsi.

### Memperbarui deskripsi peran (konsol)
<a name="id_roles_update-description-console"></a>

**Untuk mengubah deskripsi peran (konsol)**

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

1. Di panel navigasi konsol IAM, pilih **Peran**.

1. Pilih nama peran yang akan diubah.

1. Di bagian **Ringkasan**, pilih **Edit**.

1. Memasukkan Deskripsi baru di kotak, dan memilih **Simpan perubahan**.

### Memperbarui deskripsi peran (AWS CLI)
<a name="id_roles_update-description-cli"></a>

**Untuk mengubah deskripsi peran (AWS CLI)**

1. (Opsional) Untuk melihat deskripsi peran terkini, jalankan perintah berikut:
   + [aws iam mendapatkan peran](https://docs.aws.amazon.com/cli/latest/reference/iam/get-role.html)

1. Untuk memperbarui deskripsi peran, jalankan perintah berikut dengan parameter deskripsi:
   + [peran pembaruan aws iam](https://docs.aws.amazon.com/cli/latest/reference/iam/update-role.html)

### Memperbarui deskripsi peran (AWS API)
<a name="id_roles_update-description-api"></a>

**Untuk mengubah deskripsi peran (AWS API)**

1. (Opsional) Untuk melihat desripsi terkini untuk peran, panggil operasi berikut:
   + [GetRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetRole.html) 

1. Untuk memperbarui deskripsi peran, panggil operasi berikut dengan parameter deskripsi:
   + [UpdateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateRole.html)

## Memperbarui durasi sesi maksimum untuk peran
<a name="id_roles_update-session-duration"></a>

Untuk menentukan setelan durasi sesi maksimum untuk peran yang diasumsikan menggunakan konsol, API AWS CLI, atau AWS API, ubah nilai setelan durasi sesi maksimum. Pengaturan ini dapat memiliki nilai dari 1 jam hingga 12 jam. Jika Anda tidak menentukan nilai, defaultnya maksimum 1 jam diterapkan. Pengaturan ini tidak membatasi sesi yang diasumsikan oleh AWS layanan.

### Memperbarui durasi sesi peran maksimum (konsol)
<a name="id_roles_update-session-duration-console"></a><a name="id_roles_modify_max-session"></a>

**Untuk mengubah setelan durasi sesi maksimum untuk peran yang diasumsikan menggunakan konsol, AWS CLI, atau AWS API (konsol)**

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

1. Di panel navigasi konsol IAM, pilih **Peran**.

1. Pilih nama peran yang akan diubah.

1. Di bagian **Ringkasan**, pilih **Edit**.

1. Untuk **Durasi sesi maksimum**, pilih nilai. Atau, pilih **Durasi kustom** dan masukkan nilai (dalam detik).

1. Pilih **Simpan perubahan**.

   Perubahan Anda tidak berlaku sampai saat berikutnya seseorang mengasumsikan peran ini. Untuk mempelajari cara mencabut sesi yang ada untuk peran ini, lihat [Mencabut kredensi keamanan sementara peran IAM](id_roles_use_revoke-sessions.md).

Dalam Konsol Manajemen AWS, sesi pengguna IAM adalah 12 jam secara default. Pengguna IAM yang beralih peran di konsol diberikan durasi sesi maksimum peran, atau sisa waktu dalam sesi pengguna, mana yang lebih sedikit.

Siapa pun yang mengambil peran dari AWS CLI atau AWS API dapat meminta sesi yang lebih lama, hingga maksimum ini. Pengaturan `MaxSessionDuration` menentukan durasi maksimum dari sesi peran yang dapat diminta.
+ Untuk menentukan durasi sesi menggunakan AWS CLI menggunakan `duration-seconds` parameter. Untuk mempelajari selengkapnya, lihat [Beralih ke peran IAM ()AWS CLI](id_roles_use_switch-role-cli.md).
+ Untuk menentukan durasi sesi menggunakan AWS API, gunakan `DurationSeconds` parameter. Untuk mempelajari selengkapnya, lihat [Beralih ke peran IAM (AWS API)](id_roles_use_switch-role-api.md). 

### Memperbarui durasi sesi peran maksimum (AWS CLI)
<a name="id_roles_update-session-duration-cli"></a>

**catatan**  
Siapa pun yang mengambil peran dari AWS CLI atau API dapat menggunakan parameter `duration-seconds` CLI atau parameter API untuk meminta sesi `DurationSeconds` yang lebih lama. Pengaturan `MaxSessionDuration` menentukan durasi maksimum dari sesi peran yang dapat diminta dengan menggunakan parameter `DurationSeconds`. Jika pengguna tidak menentukan nilai untuk parameter `DurationSeconds` tersebut, kredensial keamanan mereka berlaku selama satu jam.

**Untuk mengubah setelan durasi sesi maksimum untuk peran yang diasumsikan menggunakan AWS CLI (AWS CLI)**

1. (Opsional) Untuk melihat durasi sesi maksimum peran untuk peran, jalankan perintah berikut:
   + [aws iam mendapatkan peran](https://docs.aws.amazon.com/cli/latest/reference/iam/get-role.html)

1. Untuk memperbarui pengaturan durasi sesi maksimum peran, jalankan perintah berikut dengan parameter `max-session-duration` CLI atau parameter API `MaxSessionDuration`:
   + [peran pembaruan aws iam](https://docs.aws.amazon.com/cli/latest/reference/iam/update-role.html)

   Perubahan Anda tidak berlaku sampai saat berikutnya seseorang mengasumsikan peran ini. Untuk mempelajari cara mencabut sesi yang ada untuk peran ini, lihat [Mencabut kredensi keamanan sementara peran IAM](id_roles_use_revoke-sessions.md).

### Memperbarui durasi sesi peran maksimum (AWS API)
<a name="id_roles_update-session-duration-api"></a>

**catatan**  
Siapa pun yang mengambil peran dari AWS CLI atau API dapat menggunakan parameter `duration-seconds` CLI atau parameter API untuk meminta sesi `DurationSeconds` yang lebih lama. Pengaturan `MaxSessionDuration` menentukan durasi maksimum dari sesi peran yang dapat diminta dengan menggunakan parameter `DurationSeconds`. Jika pengguna tidak menentukan nilai untuk parameter `DurationSeconds` tersebut, kredensial keamanan mereka berlaku selama satu jam.

**Untuk mengubah setelan durasi sesi maksimum untuk peran yang diasumsikan menggunakan API (AWS API)**

1. (Opsional) Untuk melihat durasi sesi maksimum terkini untuk peran, panggil operasi berikut:
   + [GetRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetRole.html) 

1. Untuk memperbarui pengaturan durasi sesi maksimum peran, panggil operasi berikut dengan `max-session-duration` Parameter CLI atau `MaxSessionDuration` Parameter API:
   + [UpdateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateRole.html)

   Perubahan Anda tidak berlaku sampai saat berikutnya seseorang mengasumsikan peran ini. Untuk mempelajari cara mencabut sesi yang ada untuk peran ini, lihat [Mencabut kredensi keamanan sementara peran IAM](id_roles_use_revoke-sessions.md).