com.amazonaws.services.cognitoidentityprovider.model

Class CreateGroupRequest

java.lang.Object

com.amazonaws.AmazonWebServiceRequest

com.amazonaws.services.cognitoidentityprovider.model.CreateGroupRequest

All Implemented Interfaces:

Serializable, Cloneable

public class CreateGroupRequest
extends AmazonWebServiceRequest
implements Serializable

Creates a new group in the specified user pool.

Requires developer credentials.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CreateGroupRequest()

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
String	getDescription() A string containing the description of the group.
String	getGroupName() The name of the group.
Integer	getPrecedence() A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool.
String	getRoleArn() The role ARN for the group.
String	getUserPoolId() The user pool ID for the user pool.
int	hashCode()
void	setDescription(String description) A string containing the description of the group.
void	setGroupName(String groupName) The name of the group.
void	setPrecedence(Integer precedence) A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool.
void	setRoleArn(String roleArn) The role ARN for the group.
void	setUserPoolId(String userPoolId) The user pool ID for the user pool.
String	toString() Returns a string representation of this object; useful for testing and debugging.
CreateGroupRequest	withDescription(String description) A string containing the description of the group.
CreateGroupRequest	withGroupName(String groupName) The name of the group.
CreateGroupRequest	withPrecedence(Integer precedence) A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool.
CreateGroupRequest	withRoleArn(String roleArn) The role ARN for the group.
CreateGroupRequest	withUserPoolId(String userPoolId) The user pool ID for the user pool.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

clone, copyBaseTo, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CreateGroupRequest

public CreateGroupRequest()

Method Detail

getGroupName

public String getGroupName()

The name of the group. Must be unique.

Constraints:
Length: 1 - 128
Pattern: [\p{L}\p{M}\p{S}\p{N}\p{P}]+

Returns:

The name of the group. Must be unique.

setGroupName

public void setGroupName(String groupName)

The name of the group. Must be unique.

Constraints:
Length: 1 - 128
Pattern: [\p{L}\p{M}\p{S}\p{N}\p{P}]+

Parameters:

groupName -

The name of the group. Must be unique.

withGroupName

public CreateGroupRequest withGroupName(String groupName)

The name of the group. Must be unique.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 1 - 128
Pattern: [\p{L}\p{M}\p{S}\p{N}\p{P}]+

Parameters:

groupName -

The name of the group. Must be unique.

Returns:

A reference to this updated object so that method calls can be chained together.

getUserPoolId

public String getUserPoolId()

The user pool ID for the user pool.

Constraints:
Length: 1 - 55
Pattern: [\w-]+_[0-9a-zA-Z]+

Returns:

The user pool ID for the user pool.

setUserPoolId

public void setUserPoolId(String userPoolId)

The user pool ID for the user pool.

Constraints:
Length: 1 - 55
Pattern: [\w-]+_[0-9a-zA-Z]+

Parameters:

userPoolId -

The user pool ID for the user pool.

withUserPoolId

public CreateGroupRequest withUserPoolId(String userPoolId)

The user pool ID for the user pool.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 1 - 55
Pattern: [\w-]+_[0-9a-zA-Z]+

Parameters:

userPoolId -

The user pool ID for the user pool.

Returns:

A reference to this updated object so that method calls can be chained together.

getDescription

public String getDescription()

A string containing the description of the group.

Constraints:
Length: - 2048

Returns:

A string containing the description of the group.

setDescription

public void setDescription(String description)

A string containing the description of the group.

Constraints:
Length: - 2048

Parameters:

description -

A string containing the description of the group.

withDescription

public CreateGroupRequest withDescription(String description)

A string containing the description of the group.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: - 2048

Parameters:

description -

A string containing the description of the group.

Returns:

A reference to this updated object so that method calls can be chained together.

getRoleArn

public String getRoleArn()

The role ARN for the group.

Constraints:
Length: 20 - 2048
Pattern: arn:[\w+=/,.@-]+:[\w+=/,.@-]+:([\w+=/,.@-]*)?:[0-9]+:[\w+= /,.@-]+(:[\w+=/,.@-]+)?(:[\w+=/,.@-]+)?

Returns:

The role ARN for the group.

setRoleArn

public void setRoleArn(String roleArn)

The role ARN for the group.

Constraints:
Length: 20 - 2048
Pattern: arn:[\w+=/,.@-]+:[\w+=/,.@-]+:([\w+=/,.@-]*)?:[0-9]+:[\w+= /,.@-]+(:[\w+=/,.@-]+)?(:[\w+=/,.@-]+)?

Parameters:

roleArn -

The role ARN for the group.

withRoleArn

public CreateGroupRequest withRoleArn(String roleArn)

The role ARN for the group.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Length: 20 - 2048
Pattern: arn:[\w+=/,.@-]+:[\w+=/,.@-]+:([\w+=/,.@-]*)?:[0-9]+:[\w+= /,.@-]+(:[\w+=/,.@-]+)?(:[\w+=/,.@-]+)?

Parameters:

roleArn -

The role ARN for the group.

Returns:

A reference to this updated object so that method calls can be chained together.

getPrecedence

public Integer getPrecedence()

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. Zero is the highest precedence value. Groups with lower Precedence values take precedence over groups with higher or null Precedence values. If a user belongs to two or more groups, it is the group with the lowest precedence value whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

Constraints:
Range: 0 -

Returns:

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. Zero is the highest precedence value. Groups with lower Precedence values take precedence over groups with higher or null Precedence values. If a user belongs to two or more groups, it is the group with the lowest precedence value whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

setPrecedence

public void setPrecedence(Integer precedence)

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. Zero is the highest precedence value. Groups with lower Precedence values take precedence over groups with higher or null Precedence values. If a user belongs to two or more groups, it is the group with the lowest precedence value whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

Constraints:
Range: 0 -

Parameters:

precedence -

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. Zero is the highest precedence value. Groups with lower Precedence values take precedence over groups with higher or null Precedence values. If a user belongs to two or more groups, it is the group with the lowest precedence value whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

withPrecedence

public CreateGroupRequest withPrecedence(Integer precedence)

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. Zero is the highest precedence value. Groups with lower Precedence values take precedence over groups with higher or null Precedence values. If a user belongs to two or more groups, it is the group with the lowest precedence value whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

Returns a reference to this object so that method calls can be chained together.

Constraints:
Range: 0 -

Parameters:

precedence -

A nonnegative integer value that specifies the precedence of this group relative to the other groups that a user can belong to in the user pool. Zero is the highest precedence value. Groups with lower Precedence values take precedence over groups with higher or null Precedence values. If a user belongs to two or more groups, it is the group with the lowest precedence value whose role ARN will be used in the cognito:roles and cognito:preferred_role claims in the user's tokens.

Two groups can have the same Precedence value. If this happens, neither group takes precedence over the other. If two groups with the same Precedence have the same role ARN, that role is used in the cognito:preferred_role claim in tokens for users in each group. If the two groups have different role ARNs, the cognito:preferred_role claim is not set in users' tokens.

The default Precedence value is null.

Returns:

A reference to this updated object so that method calls can be chained together.

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object