We recommend new projects start with resources from the AWS provider.
aws-native.cognito.getUserPoolGroup
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
Resource Type definition for AWS::Cognito::UserPoolGroup
Using getUserPoolGroup
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getUserPoolGroup(args: GetUserPoolGroupArgs, opts?: InvokeOptions): Promise<GetUserPoolGroupResult>
function getUserPoolGroupOutput(args: GetUserPoolGroupOutputArgs, opts?: InvokeOptions): Output<GetUserPoolGroupResult>
def get_user_pool_group(group_name: Optional[str] = None,
user_pool_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetUserPoolGroupResult
def get_user_pool_group_output(group_name: Optional[pulumi.Input[str]] = None,
user_pool_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetUserPoolGroupResult]
func LookupUserPoolGroup(ctx *Context, args *LookupUserPoolGroupArgs, opts ...InvokeOption) (*LookupUserPoolGroupResult, error)
func LookupUserPoolGroupOutput(ctx *Context, args *LookupUserPoolGroupOutputArgs, opts ...InvokeOption) LookupUserPoolGroupResultOutput
> Note: This function is named LookupUserPoolGroup
in the Go SDK.
public static class GetUserPoolGroup
{
public static Task<GetUserPoolGroupResult> InvokeAsync(GetUserPoolGroupArgs args, InvokeOptions? opts = null)
public static Output<GetUserPoolGroupResult> Invoke(GetUserPoolGroupInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetUserPoolGroupResult> getUserPoolGroup(GetUserPoolGroupArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:cognito:getUserPoolGroup
arguments:
# arguments dictionary
The following arguments are supported:
- Group
Name string - The name of the group. Must be unique.
- User
Pool stringId - The user pool ID for the user pool.
- Group
Name string - The name of the group. Must be unique.
- User
Pool stringId - The user pool ID for the user pool.
- group
Name String - The name of the group. Must be unique.
- user
Pool StringId - The user pool ID for the user pool.
- group
Name string - The name of the group. Must be unique.
- user
Pool stringId - The user pool ID for the user pool.
- group_
name str - The name of the group. Must be unique.
- user_
pool_ strid - The user pool ID for the user pool.
- group
Name String - The name of the group. Must be unique.
- user
Pool StringId - The user pool ID for the user pool.
getUserPoolGroup Result
The following output properties are available:
- Description string
- A string containing the description of the group.
- Precedence int
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 nullPrecedence
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 thecognito:roles
andcognito: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 samePrecedence
have the same role ARN, that role is used in thecognito:preferred_role
claim in tokens for users in each group. If the two groups have different role ARNs, thecognito:preferred_role
claim isn't set in users' tokens.The default
Precedence
value is null. The maximumPrecedence
value is2^31-1
.- Role
Arn string - The role Amazon Resource Name (ARN) for the group.
- Description string
- A string containing the description of the group.
- Precedence int
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 nullPrecedence
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 thecognito:roles
andcognito: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 samePrecedence
have the same role ARN, that role is used in thecognito:preferred_role
claim in tokens for users in each group. If the two groups have different role ARNs, thecognito:preferred_role
claim isn't set in users' tokens.The default
Precedence
value is null. The maximumPrecedence
value is2^31-1
.- Role
Arn string - The role Amazon Resource Name (ARN) for the group.
- description String
- A string containing the description of the group.
- precedence Integer
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 nullPrecedence
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 thecognito:roles
andcognito: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 samePrecedence
have the same role ARN, that role is used in thecognito:preferred_role
claim in tokens for users in each group. If the two groups have different role ARNs, thecognito:preferred_role
claim isn't set in users' tokens.The default
Precedence
value is null. The maximumPrecedence
value is2^31-1
.- role
Arn String - The role Amazon Resource Name (ARN) for the group.
- description string
- A string containing the description of the group.
- precedence number
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 nullPrecedence
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 thecognito:roles
andcognito: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 samePrecedence
have the same role ARN, that role is used in thecognito:preferred_role
claim in tokens for users in each group. If the two groups have different role ARNs, thecognito:preferred_role
claim isn't set in users' tokens.The default
Precedence
value is null. The maximumPrecedence
value is2^31-1
.- role
Arn string - The role Amazon Resource Name (ARN) for the group.
- description str
- A string containing the description of the group.
- precedence int
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 nullPrecedence
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 thecognito:roles
andcognito: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 samePrecedence
have the same role ARN, that role is used in thecognito:preferred_role
claim in tokens for users in each group. If the two groups have different role ARNs, thecognito:preferred_role
claim isn't set in users' tokens.The default
Precedence
value is null. The maximumPrecedence
value is2^31-1
.- role_
arn str - The role Amazon Resource Name (ARN) for the group.
- description String
- A string containing the description of the group.
- precedence Number
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 nullPrecedence
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 thecognito:roles
andcognito: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 samePrecedence
have the same role ARN, that role is used in thecognito:preferred_role
claim in tokens for users in each group. If the two groups have different role ARNs, thecognito:preferred_role
claim isn't set in users' tokens.The default
Precedence
value is null. The maximumPrecedence
value is2^31-1
.- role
Arn String - The role Amazon Resource Name (ARN) for the group.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.