Package com.pulumi.aws.iam

Class AccountPasswordPolicy

  • public class AccountPasswordPolicy
extends com.pulumi.resources.CustomResource
    > **Note:** There is only a single policy allowed per AWS account. An existing policy will be lost when using this resource as an effect of this limitation. Manages Password Policy for the AWS Account. See more about [Account Password Policy](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_account-policy.html) in the official AWS docs. ## Example Usage 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.iam.AccountPasswordPolicy;
 import com.pulumi.aws.iam.AccountPasswordPolicyArgs;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Map;
 import java.io.File;
 import java.nio.file.Files;
 import java.nio.file.Paths;
 
 public class App {
     public static void main(String[] args) {
         Pulumi.run(App::stack);
     }
 
     public static void stack(Context ctx) {
         var strict = new AccountPasswordPolicy("strict", AccountPasswordPolicyArgs.builder()
             .minimumPasswordLength(8)
             .requireLowercaseCharacters(true)
             .requireNumbers(true)
             .requireUppercaseCharacters(true)
             .requireSymbols(true)
             .allowUsersToChangePassword(true)
             .build());
 
     }
 }
    ## Import Using `pulumi import`, import IAM Account Password Policy using the word `iam-account-password-policy`. For example: ```sh $ pulumi import aws:iam/accountPasswordPolicy:AccountPasswordPolicy strict iam-account-password-policy ```

    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

        com.pulumi.resources.CustomResource.CustomResourceInternal

      • Nested classes/interfaces inherited from class com.pulumi.resources.Resource

        com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

    • Field Summary

      • Fields inherited from class com.pulumi.resources.Resource

        childResources, remote

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> allowUsersToChangePassword()  
      com.pulumi.core.Output<java.lang.Boolean> expirePasswords()  
      static AccountPasswordPolicy get​(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, AccountPasswordPolicyState state, com.pulumi.resources.CustomResourceOptions options)
      Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
      com.pulumi.core.Output<java.lang.Boolean> hardExpiry()  
      com.pulumi.core.Output<java.lang.Integer> maxPasswordAge()  
      com.pulumi.core.Output<java.util.Optional<java.lang.Integer>> minimumPasswordLength()  
      com.pulumi.core.Output<java.lang.Integer> passwordReusePrevention()  
      com.pulumi.core.Output<java.lang.Boolean> requireLowercaseCharacters()  
      com.pulumi.core.Output<java.lang.Boolean> requireNumbers()  
      com.pulumi.core.Output<java.lang.Boolean> requireSymbols()  
      com.pulumi.core.Output<java.lang.Boolean> requireUppercaseCharacters()  

      • Methods inherited from class com.pulumi.resources.CustomResource

        getId, id, idFuture

      • Methods inherited from class com.pulumi.resources.Resource

        getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • AccountPasswordPolicy

        public AccountPasswordPolicy​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.

      • AccountPasswordPolicy

        public AccountPasswordPolicy​(java.lang.String name,
                             @Nullable
                             AccountPasswordPolicyArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.

      • AccountPasswordPolicy

        public AccountPasswordPolicy​(java.lang.String name,
                             @Nullable
                             AccountPasswordPolicyArgs args,
                             @Nullable
                             com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.

    • Method Detail

      • allowUsersToChangePassword

        public com.pulumi.core.Output<java.util.Optional<java.lang.Boolean>> allowUsersToChangePassword()
        Returns:
        Whether to allow users to change their own password

      • expirePasswords

        public com.pulumi.core.Output<java.lang.Boolean> expirePasswords()
        Returns:
        Indicates whether passwords in the account expire. Returns `true` if `maxPasswordAge` contains a value greater than `0`. Returns `false` if it is `0` or _not present_.

      • hardExpiry

        public com.pulumi.core.Output<java.lang.Boolean> hardExpiry()
        Returns:
        Whether users are prevented from setting a new password after their password has expired (i.e., require administrator reset)

      • maxPasswordAge

        public com.pulumi.core.Output<java.lang.Integer> maxPasswordAge()
        Returns:
        The number of days that an user password is valid.

      • minimumPasswordLength

        public com.pulumi.core.Output<java.util.Optional<java.lang.Integer>> minimumPasswordLength()
        Returns:
        Minimum length to require for user passwords.

      • passwordReusePrevention

        public com.pulumi.core.Output<java.lang.Integer> passwordReusePrevention()
        Returns:
        The number of previous passwords that users are prevented from reusing.

      • requireLowercaseCharacters

        public com.pulumi.core.Output<java.lang.Boolean> requireLowercaseCharacters()
        Returns:
        Whether to require lowercase characters for user passwords.

      • requireNumbers

        public com.pulumi.core.Output<java.lang.Boolean> requireNumbers()
        Returns:
        Whether to require numbers for user passwords.

      • requireSymbols

        public com.pulumi.core.Output<java.lang.Boolean> requireSymbols()
        Returns:
        Whether to require symbols for user passwords.

      • requireUppercaseCharacters

        public com.pulumi.core.Output<java.lang.Boolean> requireUppercaseCharacters()
        Returns:
        Whether to require uppercase characters for user passwords.

      • get

        public static AccountPasswordPolicy get​(java.lang.String name,
                                        com.pulumi.core.Output<java.lang.String> id,
                                        @Nullable
                                        AccountPasswordPolicyState state,
                                        @Nullable
                                        com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        state -
        options - Optional settings to control the behavior of the CustomResource.