Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.IAM.UpdateAccountPasswordPolicy

Contents

Creating a Request
Request Lenses
Destructuring the Response

Description

Updates the password policy settings for the Amazon Web Services account.

This operation does not support partial updates. No parameters are required, but if you do not specify a parameter, that parameter's value reverts to its default value. See the Request Parameters section for each parameter's default value. Also note that some parameters do not allow the default parameter to be explicitly set. Instead, to invoke the default value, do not include that parameter when you invoke the operation.

For more information about using a password policy, see Managing an IAM password policy in the IAM User Guide.

Synopsis

Creating a Request

data UpdateAccountPasswordPolicy Source #

See: newUpdateAccountPasswordPolicy smart constructor.

Constructors

UpdateAccountPasswordPolicy'

Fields

minimumPasswordLength :: Maybe Natural
The minimum number of characters allowed in an IAM user password.
If you do not specify a value for this parameter, then the operation uses the default value of 6.
requireNumbers :: Maybe Bool
Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).
If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one numeric character.
passwordReusePrevention :: Maybe Natural
Specifies the number of previous passwords that IAM users are prevented from reusing.
If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM users are not prevented from reusing previous passwords.
requireLowercaseCharacters :: Maybe Bool
Specifies whether IAM user passwords must contain at least one lowercase character from the ISO basic Latin alphabet (a to z).
If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one lowercase character.
maxPasswordAge :: Maybe Natural
The number of days that an IAM user password is valid.
If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM user passwords never expire.
hardExpiry :: Maybe Bool
Prevents IAM users from setting a new password after their password has expired. The IAM user cannot be accessed until an administrator resets the password.
If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users can change their passwords after they expire and continue to sign in as the user.
requireSymbols :: Maybe Bool
Specifies whether IAM user passwords must contain at least one of the following non-alphanumeric characters:
! @ # $ % ^ & * ( ) _ + - = [ ] { } | '
If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one symbol character.
requireUppercaseCharacters :: Maybe Bool
Specifies whether IAM user passwords must contain at least one uppercase character from the ISO basic Latin alphabet (A to Z).
If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one uppercase character.
allowUsersToChangePassword :: Maybe Bool
Allows all IAM users in your account to use the Amazon Web Services Management Console to change their own passwords. For more information, see Letting IAM users change their own passwords in the IAM User Guide.
If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users in the account do not automatically have permissions to change their own password.

Instances

Instances details

Eq UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods (==) :: UpdateAccountPasswordPolicy -> UpdateAccountPasswordPolicy -> Bool # (/=) :: UpdateAccountPasswordPolicy -> UpdateAccountPasswordPolicy -> Bool #
Read UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods readsPrec :: Int -> ReadS UpdateAccountPasswordPolicy # readList :: ReadS [UpdateAccountPasswordPolicy] # readPrec :: ReadPrec UpdateAccountPasswordPolicy # readListPrec :: ReadPrec [UpdateAccountPasswordPolicy] #
Show UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods showsPrec :: Int -> UpdateAccountPasswordPolicy -> ShowS # show :: UpdateAccountPasswordPolicy -> String # showList :: [UpdateAccountPasswordPolicy] -> ShowS #
Generic UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Associated Types type Rep UpdateAccountPasswordPolicy :: Type -> Type # Methods from :: UpdateAccountPasswordPolicy -> Rep UpdateAccountPasswordPolicy x # to :: Rep UpdateAccountPasswordPolicy x -> UpdateAccountPasswordPolicy #
NFData UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods rnf :: UpdateAccountPasswordPolicy -> () #
Hashable UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods hashWithSalt :: Int -> UpdateAccountPasswordPolicy -> Int # hash :: UpdateAccountPasswordPolicy -> Int #
AWSRequest UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Associated Types type AWSResponse UpdateAccountPasswordPolicy # Methods request :: UpdateAccountPasswordPolicy -> Request UpdateAccountPasswordPolicy # response :: MonadResource m => Logger -> Service -> Proxy UpdateAccountPasswordPolicy -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse UpdateAccountPasswordPolicy))) #
ToHeaders UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods toHeaders :: UpdateAccountPasswordPolicy -> [Header] #
ToPath UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods toPath :: UpdateAccountPasswordPolicy -> ByteString #
ToQuery UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods toQuery :: UpdateAccountPasswordPolicy -> QueryString #
type Rep UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy type Rep UpdateAccountPasswordPolicy = D1 ('MetaData "UpdateAccountPasswordPolicy" "Amazonka.IAM.UpdateAccountPasswordPolicy" "libZSservicesZSamazonka-iamZSamazonka-iam" 'False) (C1 ('MetaCons "UpdateAccountPasswordPolicy'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "minimumPasswordLength") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :: S1 ('MetaSel ('Just "requireNumbers") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))) :: (S1 ('MetaSel ('Just "passwordReusePrevention") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :: S1 ('MetaSel ('Just "requireLowercaseCharacters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)))) :: ((S1 ('MetaSel ('Just "maxPasswordAge") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :: S1 ('MetaSel ('Just "hardExpiry") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))) :: (S1 ('MetaSel ('Just "requireSymbols") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: (S1 ('MetaSel ('Just "requireUppercaseCharacters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: S1 ('MetaSel ('Just "allowUsersToChangePassword") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)))))))
type AWSResponse UpdateAccountPasswordPolicy Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy type AWSResponse UpdateAccountPasswordPolicy = UpdateAccountPasswordPolicyResponse

newUpdateAccountPasswordPolicy :: UpdateAccountPasswordPolicy Source #

Create a value of UpdateAccountPasswordPolicy with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:minimumPasswordLength:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_minimumPasswordLength - The minimum number of characters allowed in an IAM user password.

If you do not specify a value for this parameter, then the operation uses the default value of 6.

$sel:requireNumbers:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_requireNumbers - Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one numeric character.

$sel:passwordReusePrevention:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_passwordReusePrevention - Specifies the number of previous passwords that IAM users are prevented from reusing.

If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM users are not prevented from reusing previous passwords.

$sel:requireLowercaseCharacters:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_requireLowercaseCharacters - Specifies whether IAM user passwords must contain at least one lowercase character from the ISO basic Latin alphabet (a to z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one lowercase character.

$sel:maxPasswordAge:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_maxPasswordAge - The number of days that an IAM user password is valid.

If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM user passwords never expire.

$sel:hardExpiry:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_hardExpiry - Prevents IAM users from setting a new password after their password has expired. The IAM user cannot be accessed until an administrator resets the password.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users can change their passwords after they expire and continue to sign in as the user.

$sel:requireSymbols:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_requireSymbols - Specifies whether IAM user passwords must contain at least one of the following non-alphanumeric characters:

! @ # $ % ^ & * ( ) _ + - = [ ] { } | '

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one symbol character.

$sel:requireUppercaseCharacters:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_requireUppercaseCharacters - Specifies whether IAM user passwords must contain at least one uppercase character from the ISO basic Latin alphabet (A to Z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one uppercase character.

$sel:allowUsersToChangePassword:UpdateAccountPasswordPolicy', updateAccountPasswordPolicy_allowUsersToChangePassword - Allows all IAM users in your account to use the Amazon Web Services Management Console to change their own passwords. For more information, see Letting IAM users change their own passwords in the IAM User Guide.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users in the account do not automatically have permissions to change their own password.

Request Lenses

updateAccountPasswordPolicy_minimumPasswordLength :: Lens' UpdateAccountPasswordPolicy (Maybe Natural) Source #

The minimum number of characters allowed in an IAM user password.

If you do not specify a value for this parameter, then the operation uses the default value of 6.

updateAccountPasswordPolicy_requireNumbers :: Lens' UpdateAccountPasswordPolicy (Maybe Bool) Source #

Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one numeric character.

updateAccountPasswordPolicy_passwordReusePrevention :: Lens' UpdateAccountPasswordPolicy (Maybe Natural) Source #

Specifies the number of previous passwords that IAM users are prevented from reusing.

If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM users are not prevented from reusing previous passwords.

updateAccountPasswordPolicy_requireLowercaseCharacters :: Lens' UpdateAccountPasswordPolicy (Maybe Bool) Source #

Specifies whether IAM user passwords must contain at least one lowercase character from the ISO basic Latin alphabet (a to z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one lowercase character.

updateAccountPasswordPolicy_maxPasswordAge :: Lens' UpdateAccountPasswordPolicy (Maybe Natural) Source #

The number of days that an IAM user password is valid.

If you do not specify a value for this parameter, then the operation uses the default value of 0. The result is that IAM user passwords never expire.

updateAccountPasswordPolicy_hardExpiry :: Lens' UpdateAccountPasswordPolicy (Maybe Bool) Source #

Prevents IAM users from setting a new password after their password has expired. The IAM user cannot be accessed until an administrator resets the password.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users can change their passwords after they expire and continue to sign in as the user.

updateAccountPasswordPolicy_requireSymbols :: Lens' UpdateAccountPasswordPolicy (Maybe Bool) Source #

Specifies whether IAM user passwords must contain at least one of the following non-alphanumeric characters:

! @ # $ % ^ & * ( ) _ + - = [ ] { } | '

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one symbol character.

updateAccountPasswordPolicy_requireUppercaseCharacters :: Lens' UpdateAccountPasswordPolicy (Maybe Bool) Source #

Specifies whether IAM user passwords must contain at least one uppercase character from the ISO basic Latin alphabet (A to Z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one uppercase character.

updateAccountPasswordPolicy_allowUsersToChangePassword :: Lens' UpdateAccountPasswordPolicy (Maybe Bool) Source #

Allows all IAM users in your account to use the Amazon Web Services Management Console to change their own passwords. For more information, see Letting IAM users change their own passwords in the IAM User Guide.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users in the account do not automatically have permissions to change their own password.

Destructuring the Response

data UpdateAccountPasswordPolicyResponse Source #

See: newUpdateAccountPasswordPolicyResponse smart constructor.

Constructors

UpdateAccountPasswordPolicyResponse'

Instances

Instances details

Eq UpdateAccountPasswordPolicyResponse Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods (==) :: UpdateAccountPasswordPolicyResponse -> UpdateAccountPasswordPolicyResponse -> Bool # (/=) :: UpdateAccountPasswordPolicyResponse -> UpdateAccountPasswordPolicyResponse -> Bool #
Read UpdateAccountPasswordPolicyResponse Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods readsPrec :: Int -> ReadS UpdateAccountPasswordPolicyResponse # readList :: ReadS [UpdateAccountPasswordPolicyResponse] # readPrec :: ReadPrec UpdateAccountPasswordPolicyResponse # readListPrec :: ReadPrec [UpdateAccountPasswordPolicyResponse] #
Show UpdateAccountPasswordPolicyResponse Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods showsPrec :: Int -> UpdateAccountPasswordPolicyResponse -> ShowS # show :: UpdateAccountPasswordPolicyResponse -> String # showList :: [UpdateAccountPasswordPolicyResponse] -> ShowS #
Generic UpdateAccountPasswordPolicyResponse Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Associated Types type Rep UpdateAccountPasswordPolicyResponse :: Type -> Type # Methods from :: UpdateAccountPasswordPolicyResponse -> Rep UpdateAccountPasswordPolicyResponse x # to :: Rep UpdateAccountPasswordPolicyResponse x -> UpdateAccountPasswordPolicyResponse #
NFData UpdateAccountPasswordPolicyResponse Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy Methods rnf :: UpdateAccountPasswordPolicyResponse -> () #
type Rep UpdateAccountPasswordPolicyResponse Source #
Instance details Defined in Amazonka.IAM.UpdateAccountPasswordPolicy type Rep UpdateAccountPasswordPolicyResponse = D1 ('MetaData "UpdateAccountPasswordPolicyResponse" "Amazonka.IAM.UpdateAccountPasswordPolicy" "libZSservicesZSamazonka-iamZSamazonka-iam" 'False) (C1 ('MetaCons "UpdateAccountPasswordPolicyResponse'" 'PrefixI 'False) (U1 :: Type -> Type))

newUpdateAccountPasswordPolicyResponse :: UpdateAccountPasswordPolicyResponse Source #

Create a value of UpdateAccountPasswordPolicyResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.