本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 更新角色的設定
<a name="id_roles_update-role-settings"></a>

使用下列程序來更新角色的描述，或者，變更角色的工作階段持續時間上限。

## 更新角色描述
<a name="id_roles_update-description"></a>

若要變更描述的描述，請修改描述文字。

### 更新角色描述 (主控台)
<a name="id_roles_update-description-console"></a>

**變更角色的說明 (主控台)**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。

1. 在 IAM 主控台的導覽窗格中，選擇 **Roles** (角色)。

1. 選擇要修改之角色的名稱。

1. 在 **Summary** (摘要) 區段中，選擇 **Edit** (編輯)。

1. 在方塊中輸入新說明，然後選擇 **Save changes** (儲存變更)。

### 更新角色描述 (AWS CLI)
<a name="id_roles_update-description-cli"></a>

**變更角色的說明 (AWS CLI)**

1. (選用) 若要檢視角色的目前說明，請執行下列命令：
   + [aws iam get-role](https://docs.aws.amazon.com/cli/latest/reference/iam/get-role.html)

1. 若要更新角色的說明，請使用說明參數執行下列命令：
   + [aws iam update-role](https://docs.aws.amazon.com/cli/latest/reference/iam/update-role.html)

### 更新角色描述 (AWS API)
<a name="id_roles_update-description-api"></a>

**變更角色的描述 (AWS API)**

1. (選用) 若要檢視角色的目前說明，請呼叫下列操作：
   + [GetRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetRole.html) 

1. 若要更新角色的說明，請使用說明參數呼叫下列操作：
   + [UpdateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateRole.html)

## 更新角色的最大工作階段持續時間
<a name="id_roles_update-session-duration"></a>

若要為使用主控台 AWS CLI、 或 AWS API 擔任的角色指定工作階段持續時間上限設定，請修改工作階段持續時間上限設定值。此設定的值可介於 1 小時至 12 小時。如果未指定值，則套用預設最大值 1 小時。此設定不會限制 AWS 服務所擔任的工作階段。

### 更新最大角色工作階段持續時間 (主控台)
<a name="id_roles_update-session-duration-console"></a><a name="id_roles_modify_max-session"></a>

**變更使用主控台 AWS CLI或 AWS API （主控台） 擔任之角色的工作階段持續時間上限設定**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 開啟 IAM 主控台。

1. 在 IAM 主控台的導覽窗格中，選擇 **Roles** (角色)。

1. 選擇要修改之角色的名稱。

1. 在 **Summary** (摘要) 區段中，選擇 **Edit** (編輯)。

1. 在 **Maximum session duration** (最大工作階段持續時間) 中，選擇一個值。或者，選擇 **Custom duration** (自訂持續時間) 並輸入一個值 (以秒為單位)。

1. 選擇**儲存變更**。

   在下次有人擔任此角色之前，您的變更不會生效。若要了解如何撤銷此角色的現有工作階段，請參閱[撤銷 IAM 角色臨時安全憑證](id_roles_use_revoke-sessions.md)。

在 中 AWS 管理主控台，IAM 使用者工作階段預設為 12 小時。在主控台中切換角色的 IAM 使用者會被授予角色最長工作階段持續時間或使用者工作階段中的剩餘時間，以較短者為準。

從 AWS CLI 或 AWS API 擔任角色的任何人都可以請求更長的工作階段，最高可達此上限。`MaxSessionDuration` 設定決定可以請求之角色工作階段的最大持續時間。
+ 若要使用 指定工作階段持續時間， AWS CLI 請使用 `duration-seconds` 參數。如需詳細資訊，請參閱 [切換到 IAM 角色 (AWS CLI)](id_roles_use_switch-role-cli.md)。
+ 若要使用 AWS API 指定工作階段持續時間，請使用 `DurationSeconds` 參數。如需詳細資訊，請參閱 [切換到 IAM 角色 (AWS API)](id_roles_use_switch-role-api.md)。

### 更新角色工作階段持續時間上限 (AWS CLI)
<a name="id_roles_update-session-duration-cli"></a>

**注意**  
從 AWS CLI 或 API 擔任角色的任何人都可以使用 `duration-seconds` CLI 參數或 `DurationSeconds` API 參數來請求更長的工作階段。`MaxSessionDuration` 設定決定可以使用`DurationSeconds` 參數請求的角色工作階段的最大持續時間。如果使用者不為 `DurationSeconds` 參數指定一個值，則使用者的安全憑證有效期為 1 小時。

**使用 AWS CLI (AWS CLI) 變更所擔任角色的工作階段持續時間上限設定**

1. (選用) 若要檢視角色的目前最大工作階段持續時間設定，請執行下列命令：
   + [aws iam get-role](https://docs.aws.amazon.com/cli/latest/reference/iam/get-role.html)

1. 若要更新角色的工作階段持續時間設定，請使用 `max-session-duration` CLI 參數或 `MaxSessionDuration` API 參數執行以下命令：
   + [aws iam update-role](https://docs.aws.amazon.com/cli/latest/reference/iam/update-role.html)

   在下次有人擔任此角色之前，您的變更不會生效。若要了解如何撤銷此角色的現有工作階段，請參閱[撤銷 IAM 角色臨時安全憑證](id_roles_use_revoke-sessions.md)。

### 更新角色工作階段持續時間上限 (AWS API)
<a name="id_roles_update-session-duration-api"></a>

**注意**  
從 AWS CLI 或 API 擔任角色的任何人都可以使用 `duration-seconds` CLI 參數或 `DurationSeconds` API 參數來請求更長的工作階段。`MaxSessionDuration` 設定決定可以使用`DurationSeconds` 參數請求的角色工作階段的最大持續時間。如果使用者不為 `DurationSeconds` 參數指定一個值，則使用者的安全憑證有效期為 1 小時。

**變更使用 API (AWS API) 擔任之角色的工作階段持續時間上限設定**

1. (選用) 若要檢視角色的目前最大工作階段持續時間設定，請呼叫下列操作：
   + [GetRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetRole.html) 

1. 若要更新角色的工作階段持續時間設定，請使用 `max-session-duration` CLI 參數或 `MaxSessionDuration` API 參數呼叫以下操作：
   + [UpdateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateRole.html)

   在下次有人擔任此角色之前，您的變更不會生效。若要了解如何撤銷此角色的現有工作階段，請參閱[撤銷 IAM 角色臨時安全憑證](id_roles_use_revoke-sessions.md)。