aws_sdk_cognitoidentityprovider/client/
set_user_mfa_preference.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`SetUserMFAPreference`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`sms_mfa_settings(SmsMfaSettingsType)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::sms_mfa_settings) / [`set_sms_mfa_settings(Option<SmsMfaSettingsType>)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::set_sms_mfa_settings):<br>required: **false**<br><p>User preferences for SMS message MFA. Activates or deactivates SMS MFA and sets it as the preferred MFA method when multiple methods are available.</p><br>
7    ///   - [`software_token_mfa_settings(SoftwareTokenMfaSettingsType)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::software_token_mfa_settings) / [`set_software_token_mfa_settings(Option<SoftwareTokenMfaSettingsType>)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::set_software_token_mfa_settings):<br>required: **false**<br><p>User preferences for time-based one-time password (TOTP) MFA. Activates or deactivates TOTP MFA and sets it as the preferred MFA method when multiple methods are available. Users must register a TOTP authenticator before they set this as their preferred MFA method.</p><br>
8    ///   - [`email_mfa_settings(EmailMfaSettingsType)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::email_mfa_settings) / [`set_email_mfa_settings(Option<EmailMfaSettingsType>)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::set_email_mfa_settings):<br>required: **false**<br><p>User preferences for email message MFA. Activates or deactivates email MFA and sets it as the preferred MFA method when multiple methods are available. To activate this setting, your user pool must be in the <a href="https://docs.aws.amazon.com/cognito/latest/developerguide/feature-plans-features-essentials.html"> Essentials tier</a> or higher.</p><br>
9    ///   - [`access_token(impl Into<String>)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::access_token) / [`set_access_token(Option<String>)`](crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::set_access_token):<br>required: **true**<br><p>A valid access token that Amazon Cognito issued to the currently signed-in user. Must include a scope claim for <code>aws.cognito.signin.user.admin</code>.</p><br>
10    /// - On success, responds with [`SetUserMfaPreferenceOutput`](crate::operation::set_user_mfa_preference::SetUserMfaPreferenceOutput)
11    /// - On failure, responds with [`SdkError<SetUserMFAPreferenceError>`](crate::operation::set_user_mfa_preference::SetUserMFAPreferenceError)
12    pub fn set_user_mfa_preference(&self) -> crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder {
13        crate::operation::set_user_mfa_preference::builders::SetUserMFAPreferenceFluentBuilder::new(self.handle.clone())
14    }
15}