Package software.amazon.awscdk.services.cognito

Class CfnUserPoolGroup

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.core.Construct
software.amazon.awscdk.core.CfnElement
software.amazon.awscdk.core.CfnRefElement
software.amazon.awscdk.core.CfnResource
software.amazon.awscdk.services.cognito.CfnUserPoolGroup
All Implemented Interfaces:
IConstruct, IDependable, IInspectable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct
@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)", date="2023-06-19T16:30:43.948Z") @Stability(Stable) public class CfnUserPoolGroup extends CfnResource implements IInspectable
A CloudFormation AWS::Cognito::UserPoolGroup.

Specifies a new group in the identified user pool.

Calling this action requires developer credentials.

If you don't specify a value for a parameter, Amazon Cognito sets it to a default value.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.cognito.*;
 CfnUserPoolGroup cfnUserPoolGroup = CfnUserPoolGroup.Builder.create(this, "MyCfnUserPoolGroup")
         .userPoolId("userPoolId")
         // the properties below are optional
         .description("description")
         .groupName("groupName")
         .precedence(123)
         .roleArn("roleArn")
         .build();

  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.

  • Constructor Details

    • CfnUserPoolGroup

      protected CfnUserPoolGroup(software.amazon.jsii.JsiiObjectRef objRef)

    • CfnUserPoolGroup

      protected CfnUserPoolGroup(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • CfnUserPoolGroup

      @Stability(Stable) public CfnUserPoolGroup(@NotNull Construct scope, @NotNull String id, @NotNull CfnUserPoolGroupProps props)
      Create a new AWS::Cognito::UserPoolGroup.

      Parameters:
      scope -
      • scope in which this resource is defined.
      This parameter is required.
      id -
      • scoped id of the resource.
      This parameter is required.
      props -
      • resource properties.
      This parameter is required.

  • Method Details

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector -
      • tree inspector to collect and process attributes.
      This parameter is required.

    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.

    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource

    • getUserPoolId

      @Stability(Stable) @NotNull public String getUserPoolId()
      The user pool ID for the user pool.

    • setUserPoolId

      @Stability(Stable) public void setUserPoolId(@NotNull String value)
      The user pool ID for the user pool.

    • getDescription

      @Stability(Stable) @Nullable public String getDescription()
      A string containing the description of the group.

    • setDescription

      @Stability(Stable) public void setDescription(@Nullable String value)
      A string containing the description of the group.

    • getGroupName

      @Stability(Stable) @Nullable public String getGroupName()
      The name of the group.

      Must be unique.

    • setGroupName

      @Stability(Stable) public void setGroupName(@Nullable String value)
      The name of the group.

      Must be unique.

    • getPrecedence

      @Stability(Stable) @Nullable public Number getPrecedence()
      A non-negative 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 is given in the user's tokens for the cognito:roles and cognito:preferred_role claims.

      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 isn't set in users' tokens.

      The default Precedence value is null. The maximum Precedence value is 2^31-1 .

    • setPrecedence

      @Stability(Stable) public void setPrecedence(@Nullable Number value)
      A non-negative 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 is given in the user's tokens for the cognito:roles and cognito:preferred_role claims.

      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 isn't set in users' tokens.

      The default Precedence value is null. The maximum Precedence value is 2^31-1 .

    • getRoleArn

      @Stability(Stable) @Nullable public String getRoleArn()
      The role Amazon Resource Name (ARN) for the group.

    • setRoleArn

      @Stability(Stable) public void setRoleArn(@Nullable String value)
      The role Amazon Resource Name (ARN) for the group.