// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
/// Constructs a fluent builder for the [`CreateGroup`](crate::operation::create_group::builders::CreateGroupFluentBuilder) operation.
///
/// - The fluent builder is configurable:
/// - [`group_name(impl Into<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::group_name) / [`set_group_name(Option<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::set_group_name):<br>required: **true**<br><p>The name of the group. Must be unique.</p><br>
/// - [`user_pool_id(impl Into<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::user_pool_id) / [`set_user_pool_id(Option<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::set_user_pool_id):<br>required: **true**<br><p>The user pool ID for the user pool.</p><br>
/// - [`description(impl Into<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::set_description):<br>required: **false**<br><p>A string containing the description of the group.</p><br>
/// - [`role_arn(impl Into<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::role_arn) / [`set_role_arn(Option<String>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::set_role_arn):<br>required: **false**<br><p>The role Amazon Resource Name (ARN) for the group.</p><br>
/// - [`precedence(i32)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::precedence) / [`set_precedence(Option<i32>)`](crate::operation::create_group::builders::CreateGroupFluentBuilder::set_precedence):<br>required: **false**<br><p>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 <code>Precedence</code> values take precedence over groups with higher or null <code>Precedence</code> 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 <code>cognito:roles</code> and <code>cognito:preferred_role</code> claims.</p> <p>Two groups can have the same <code>Precedence</code> value. If this happens, neither group takes precedence over the other. If two groups with the same <code>Precedence</code> have the same role ARN, that role is used in the <code>cognito:preferred_role</code> claim in tokens for users in each group. If the two groups have different role ARNs, the <code>cognito:preferred_role</code> claim isn't set in users' tokens.</p> <p>The default <code>Precedence</code> value is null. The maximum <code>Precedence</code> value is <code>2^31-1</code>.</p><br>
/// - On success, responds with [`CreateGroupOutput`](crate::operation::create_group::CreateGroupOutput) with field(s):
/// - [`group(Option<GroupType>)`](crate::operation::create_group::CreateGroupOutput::group): <p>The group object for the group.</p>
/// - On failure, responds with [`SdkError<CreateGroupError>`](crate::operation::create_group::CreateGroupError)
pub fn create_group(&self) -> crate::operation::create_group::builders::CreateGroupFluentBuilder {
crate::operation::create_group::builders::CreateGroupFluentBuilder::new(self.handle.clone())
}
}