CreateUserGroup - Amazon ElastiCache
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

CreateUserGroup

For Redis engine version 6.0 onwards: Creates a Redis user group. For more information, see Using Role Based Access Control (RBAC)

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

Engine

The current supported value is Redis.

Type: String

Pattern: [a-zA-Z]*

Required: Yes

UserGroupId

The ID of the user group.

Type: String

Required: Yes

Tags.Tag.N

A list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted. Available for Redis only.

Type: Array of Tag objects

Required: No

UserIds.member.N

The list of user IDs that belong to the user group.

Type: Array of strings

Array Members: Minimum number of 1 item.

Length Constraints: Minimum length of 1.

Pattern: [a-zA-Z][a-zA-Z0-9\-]*

Required: No

Response Elements

The following elements are returned by the service.

ARN

The Amazon Resource Name (ARN) of the user group.

Type: String

Engine

The current supported value is Redis.

Type: String

Pattern: [a-zA-Z]*

MinimumEngineVersion

The minimum engine version required, which is Redis 6.0

Type: String

PendingChanges

A list of updates being applied to the user group.

Type: UserGroupPendingChanges object

ReplicationGroups.member.N

A list of replication groups that the user group can access.

Type: Array of strings

ServerlessCaches.member.N

Indicates which serverless caches the specified user group is associated with. Available for Redis only.

Type: Array of strings

Status

Indicates user group status. Can be "creating", "active", "modifying", "deleting".

Type: String

UserGroupId

The ID of the user group.

Type: String

UserIds.member.N

The list of user IDs that belong to the user group.

Type: Array of strings

Length Constraints: Minimum length of 1.

Pattern: [a-zA-Z][a-zA-Z0-9\-]*

Errors

For information about the errors that are common to all actions, see Common Errors.

DefaultUserRequired

You must add default user to a user group.

HTTP Status Code: 400

DuplicateUserName

A user with this username already exists.

HTTP Status Code: 400

InvalidParameterValue

The value for a parameter is invalid.

HTTP Status Code: 400

ServiceLinkedRoleNotFoundFault

The specified service linked role (SLR) was not found.

HTTP Status Code: 400

TagQuotaPerResourceExceeded

The request cannot be processed because it would cause the resource to have more than the allowed number of tags. The maximum number of tags permitted on a resource is 50.

HTTP Status Code: 400

UserGroupAlreadyExists

The user group with this ID already exists.

HTTP Status Code: 400

UserGroupQuotaExceeded

The number of users exceeds the user group limit.

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 Amazon SDKs, see the following: