UpdateRole
Updates the description, maximum session duration, or maximum sign-in session duration of a role. You cannot change the maximum sign-in session duration of a service-linked role.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- Description
-
The new description that you want to apply to the specified role.
Type: String
Length Constraints: Maximum length of 1000.
Pattern:
[\u0009\u000A\u000D\u0020-\u007E\u00A1-\u00FF]*Required: No
- MaxSessionDuration
-
The maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default value of one hour is applied. This setting can have a value from 1 hour to 12 hours.
Anyone who assumes the role from the AWS CLI or API can use the
DurationSecondsAPI parameter or theduration-secondsAWS CLI parameter to request a longer session. TheMaxSessionDurationsetting determines the maximum duration that can be requested using theDurationSecondsparameter. If users don't specify a value for theDurationSecondsparameter, their security credentials are valid for one hour by default. This applies when you use theAssumeRole*API operations or theassume-role*AWS CLI operations but does not apply when you use those operations to create a console URL. For more information, see Using IAM roles in the IAM User Guide.NoteIAM role credentials provided by Amazon EC2 instances assigned to the role are not subject to the specified maximum session duration.
Type: Integer
Valid Range: Minimum value of 3600. Maximum value of 43200.
Required: No
- MaxSigninSessionDuration
-
The maximum duration (in seconds) of an AWS Sign-In session for users who sign in with the specified role. This setting can have a value from 1 hour (3600 seconds) to 90 days (7776000 seconds), inclusive, and replaces any value currently configured for the role. This setting is independent of
MaxSessionDuration.If you omit both this parameter and
ResetMaxSigninSessionDuration, the current setting is unchanged. You cannot specify this parameter and setResetMaxSigninSessionDurationtotruein the same request.Changes to this setting apply to new sign-in sessions. Sessions that are already established are not affected.
NoteYou cannot set this value on a service-linked role.
Type: Integer
Valid Range: Minimum value of 3600. Maximum value of 7776000.
Required: No
- ResetMaxSigninSessionDuration
-
Specifies whether to clear the role's maximum sign-in session duration. Set this value to
trueto return the setting to its unset state, so that the existing sign-in session behavior applies. When the setting is unset, the role'sMaxSigninSessionDurationis omitted from responses.If you set this value to
falseor omit it, the current setting is not cleared. You cannot set this value totrueand specifyMaxSigninSessionDurationin the same request. Clearing a setting that is already unset has no effect.NoteYou cannot reset this value on a service-linked role.
Type: Boolean
Required: No
- RoleName
-
The name of the role that you want to modify.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Pattern:
[\w+=,.@-]+Required: Yes
Errors
For information about the errors that are common to all actions, see Common Error Types.
- InvalidInput
-
The request was rejected because an invalid or out-of-range value was supplied for an input parameter.
HTTP Status Code: 400
- NoSuchEntity
-
The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.
HTTP Status Code: 404
- ServiceFailure
-
The request processing has failed because of an unknown error, exception or failure.
HTTP Status Code: 500
- UnmodifiableEntity
-
The request was rejected because service-linked roles are protected AWS resources. Only the service that depends on the service-linked role can modify or delete the role on your behalf. The error message includes the name of the service that depends on this service-linked role. You must request the change through that service.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: