aws_sdk_cognitoidentityprovider/client/

update_group.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`UpdateGroup`](crate::operation::update_group::builders::UpdateGroupFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`group_name(impl Into<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::group_name) / [`set_group_name(Option<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::set_group_name):<br>required: **true**<br><p>The name of the group that you want to update.</p><br>
    ///   - [`user_pool_id(impl Into<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::user_pool_id) / [`set_user_pool_id(Option<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::set_user_pool_id):<br>required: **true**<br><p>The ID of the user pool that contains the group you want to update.</p><br>
    ///   - [`description(impl Into<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::set_description):<br>required: **false**<br><p>A new description of the existing group.</p><br>
    ///   - [`role_arn(impl Into<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::role_arn) / [`set_role_arn(Option<String>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::set_role_arn):<br>required: **false**<br><p>The Amazon Resource Name (ARN) of an IAM role that you want to associate with the group. The role assignment contributes to the <code>cognito:roles</code> and <code>cognito:preferred_role</code> claims in group members' tokens.</p><br>
    ///   - [`precedence(i32)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::precedence) / [`set_precedence(Option<i32>)`](crate::operation::update_group::builders::UpdateGroupFluentBuilder::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 [`UpdateGroupOutput`](crate::operation::update_group::UpdateGroupOutput) with field(s):
    ///   - [`group(Option<GroupType>)`](crate::operation::update_group::UpdateGroupOutput::group): <p>Contains the updated details of the group, including precedence, IAM role, and description.</p>
    /// - On failure, responds with [`SdkError<UpdateGroupError>`](crate::operation::update_group::UpdateGroupError)
    pub fn update_group(&self) -> crate::operation::update_group::builders::UpdateGroupFluentBuilder {
        crate::operation::update_group::builders::UpdateGroupFluentBuilder::new(self.handle.clone())
    }
}