ModifyUser
Changes user password(s) and/or access string.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- UserId
-
The ID of the user.
Type: String
Length Constraints: Minimum length of 1.
Pattern:
[a-zA-Z][a-zA-Z0-9\-]*
Required: Yes
- AccessString
-
Access permissions string used for this user.
Type: String
Pattern:
.*\S.*
Required: No
- AppendAccessString
-
Adds additional user permissions to the access string.
Type: String
Pattern:
.*\S.*
Required: No
- AuthenticationMode
-
Specifies how to authenticate the user.
Type: AuthenticationMode object
Required: No
- Engine
-
Modifies the engine listed for a user. The options are valkey or redis.
Type: String
Pattern:
[a-zA-Z]*
Required: No
- NoPasswordRequired
-
Indicates no password is required for the user.
Type: Boolean
Required: No
- Passwords.member.N
-
The passwords belonging to the user. You are allowed up to two.
Type: Array of strings
Array Members: Minimum number of 1 item.
Required: No
Response Elements
The following elements are returned by the service.
- AccessString
-
Access permissions string used for this user.
Type: String
- ARN
-
The Amazon Resource Name (ARN) of the user.
Type: String
- Authentication
-
Denotes whether the user requires a password to authenticate.
Type: Authentication object
- Engine
-
The options are valkey or redis.
Type: String
Pattern:
[a-zA-Z]*
- MinimumEngineVersion
-
The minimum engine version required, which is Redis OSS 6.0
Type: String
- Status
-
Indicates the user status. Can be "active", "modifying" or "deleting".
Type: String
- UserGroupIds.member.N
-
Returns a list of the user group IDs the user belongs to.
Type: Array of strings
Length Constraints: Minimum length of 1.
Pattern:
[a-zA-Z][a-zA-Z0-9\-]*
- UserId
-
The ID of the user.
Type: String
- UserName
-
The username of the user.
Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidParameterCombination
-
Two or more incompatible parameters were specified.
HTTP Status Code: 400
- InvalidParameterValue
-
The value for a parameter is invalid.
HTTP Status Code: 400
- InvalidUserState
-
The user is not in active state.
HTTP Status Code: 400
- ServiceLinkedRoleNotFoundFault
-
The specified service linked role (SLR) was not found.
HTTP Status Code: 400
- UserNotFound
-
The user does not exist or could not be found.
HTTP Status Code: 404
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: