GetAccountPasswordPolicy - Amazon Identity and Access Management
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.


Retrieves the password policy for the Amazon Web Services account. This tells you the complexity requirements and mandatory rotation periods for the IAM user passwords in your account. For more information about using a password policy, see Managing an IAM password policy.

Response Elements

The following element is returned by the service.


A structure that contains details about the account's password policy.

Type: PasswordPolicy object


For information about the errors that are common to all actions, see Common Errors.


The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.

HTTP Status Code: 404


The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500



This example illustrates one usage of GetAccountPasswordPolicy.

Sample Request &Version=2010-05-08 &AUTHPARAMS

Sample Response

<GetAccountPasswordPolicyResponse xmlns=""> <GetAccountPasswordPolicyResult> <PasswordPolicy> <AllowUsersToChangePassword>true</AllowUsersToChangePassword> <RequireUppercaseCharacters>true</RequireUppercaseCharacters> <RequireSymbols>true</RequireSymbols> <ExpirePasswords>false</ExpirePasswords> <PasswordReusePrevention>12</PasswordReusePrevention> <RequireLowercaseCharacters>true</RequireLowercaseCharacters> <MaxPasswordAge>90</MaxPasswordAge> <HardExpiry>false</HardExpiry> <RequireNumbers>true</RequireNumbers> <MinimumPasswordLength>12</MinimumPasswordLength> </PasswordPolicy> </GetAccountPasswordPolicyResult> <ResponseMetadata> <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId> </ResponseMetadata> </GetAccountPasswordPolicyResponse>

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: