GetAccountPasswordPolicy
Retrieves the password policy for the AWS 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.
- PasswordPolicy
-
A structure that contains details about the account's password policy.
Type: PasswordPolicy object
Errors
For information about the errors that are common to all actions, see Common Errors.
- NoSuchEntity
-
The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.
HTTP Status Code: 404
- ServiceFailure
-
The request processing has failed because of an unknown error, exception or failure.
HTTP Status Code: 500
Examples
Example
This example illustrates one usage of GetAccountPasswordPolicy.
Sample Request
https://iam.amazonaws.com/?Action=GetAccountPasswordPolicy
&Version=2010-05-08
&AUTHPARAMS
Sample Response
<GetAccountPasswordPolicyResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
<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 AWS SDKs, see the following: