docs.aws.amazon.com Open in urlscan Pro
18.66.147.76  Public Scan

Form analysis
0 forms found in the DOM

Text Content

SELECT YOUR COOKIE PREFERENCES

We use essential cookies and similar tools that are necessary to provide our
site and services. We use performance cookies to collect anonymous statistics so
we can understand how customers use our site and make improvements. Essential
cookies cannot be deactivated, but you can click “Customize cookies” to decline
performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide
useful site features, remember your preferences, and display relevant content,
including relevant advertising. To continue without accepting these cookies,
click “Continue without accepting.” To make more detailed choices or learn more,
click “Customize cookies.”

Accept all cookiesContinue without acceptingCustomize cookies


CUSTOMIZE COOKIE PREFERENCES

We use cookies and similar tools (collectively, "cookies") for the following
purposes.


ESSENTIAL

Essential cookies are necessary to provide our site and services and cannot be
deactivated. They are usually set in response to your actions on the site, such
as setting your privacy preferences, signing in, or filling in forms.




PERFORMANCE

Performance cookies provide anonymous statistics about how customers navigate
our site so we can improve site experience and performance. Approved third
parties may perform analytics on our behalf, but they cannot use the data for
their own purposes.

Allow performance category
Allowed


FUNCTIONAL

Functional cookies help us provide useful site features, remember your
preferences, and display relevant content. Approved third parties may set these
cookies to provide certain site features. If you do not allow these cookies,
then some or all of these services may not function properly.

Allow functional category
Allowed


ADVERTISING

Advertising cookies may be set through our site by us or our advertising
partners and help us deliver relevant marketing content. If you do not allow
these cookies, you will experience less relevant advertising.

Allow advertising category
Allowed

Blocking some types of cookies may impact your experience of our sites. You may
review and change your choices at any time by clicking Cookie preferences in the
footer of this site. We and selected third-parties use cookies or similar
technologies as specified in the AWS Cookie Notice

.

CancelSave preferences




UNABLE TO SAVE COOKIE PREFERENCES

We will only store essential cookies at this time, because we were unable to
save your cookie preferences.

If you want to change your cookie preferences, try again later using the link in
the AWS console footer, or contact support if the problem persists.

Dismiss


Contact Us
English


Create an AWS Account
 1. AWS
 2. ...
    
    
 3. Documentation
 4. AWS Identity and Access Management
 5. API Reference

Feedback
Preferences


AWS IDENTITY AND ACCESS MANAGEMENT


API REFERENCE

 * Welcome
 * Actions
    * AddClientIDToOpenIDConnectProvider
    * AddRoleToInstanceProfile
    * AddUserToGroup
    * AttachGroupPolicy
    * AttachRolePolicy
    * AttachUserPolicy
    * ChangePassword
    * CreateAccessKey
    * CreateAccountAlias
    * CreateGroup
    * CreateInstanceProfile
    * CreateLoginProfile
    * CreateOpenIDConnectProvider
    * CreatePolicy
    * CreatePolicyVersion
    * CreateRole
    * CreateSAMLProvider
    * CreateServiceLinkedRole
    * CreateServiceSpecificCredential
    * CreateUser
    * CreateVirtualMFADevice
    * DeactivateMFADevice
    * DeleteAccessKey
    * DeleteAccountAlias
    * DeleteAccountPasswordPolicy
    * DeleteGroup
    * DeleteGroupPolicy
    * DeleteInstanceProfile
    * DeleteLoginProfile
    * DeleteOpenIDConnectProvider
    * DeletePolicy
    * DeletePolicyVersion
    * DeleteRole
    * DeleteRolePermissionsBoundary
    * DeleteRolePolicy
    * DeleteSAMLProvider
    * DeleteServerCertificate
    * DeleteServiceLinkedRole
    * DeleteServiceSpecificCredential
    * DeleteSigningCertificate
    * DeleteSSHPublicKey
    * DeleteUser
    * DeleteUserPermissionsBoundary
    * DeleteUserPolicy
    * DeleteVirtualMFADevice
    * DetachGroupPolicy
    * DetachRolePolicy
    * DetachUserPolicy
    * EnableMFADevice
    * GenerateCredentialReport
    * GenerateOrganizationsAccessReport
    * GenerateServiceLastAccessedDetails
    * GetAccessKeyLastUsed
    * GetAccountAuthorizationDetails
    * GetAccountPasswordPolicy
    * GetAccountSummary
    * GetContextKeysForCustomPolicy
    * GetContextKeysForPrincipalPolicy
    * GetCredentialReport
    * GetGroup
    * GetGroupPolicy
    * GetInstanceProfile
    * GetLoginProfile
    * GetOpenIDConnectProvider
    * GetOrganizationsAccessReport
    * GetPolicy
    * GetPolicyVersion
    * GetRole
    * GetRolePolicy
    * GetSAMLProvider
    * GetServerCertificate
    * GetServiceLastAccessedDetails
    * GetServiceLastAccessedDetailsWithEntities
    * GetServiceLinkedRoleDeletionStatus
    * GetSSHPublicKey
    * GetUser
    * GetUserPolicy
    * ListAccessKeys
    * ListAccountAliases
    * ListAttachedGroupPolicies
    * ListAttachedRolePolicies
    * ListAttachedUserPolicies
    * ListEntitiesForPolicy
    * ListGroupPolicies
    * ListGroups
    * ListGroupsForUser
    * ListInstanceProfiles
    * ListInstanceProfilesForRole
    * ListInstanceProfileTags
    * ListMFADevices
    * ListMFADeviceTags
    * ListOpenIDConnectProviders
    * ListOpenIDConnectProviderTags
    * ListPolicies
    * ListPoliciesGrantingServiceAccess
    * ListPolicyTags
    * ListPolicyVersions
    * ListRolePolicies
    * ListRoles
    * ListRoleTags
    * ListSAMLProviders
    * ListSAMLProviderTags
    * ListServerCertificates
    * ListServerCertificateTags
    * ListServiceSpecificCredentials
    * ListSigningCertificates
    * ListSSHPublicKeys
    * ListUserPolicies
    * ListUsers
    * ListUserTags
    * ListVirtualMFADevices
    * PutGroupPolicy
    * PutRolePermissionsBoundary
    * PutRolePolicy
    * PutUserPermissionsBoundary
    * PutUserPolicy
    * RemoveClientIDFromOpenIDConnectProvider
    * RemoveRoleFromInstanceProfile
    * RemoveUserFromGroup
    * ResetServiceSpecificCredential
    * ResyncMFADevice
    * SetDefaultPolicyVersion
    * SetSecurityTokenServicePreferences
    * SimulateCustomPolicy
    * SimulatePrincipalPolicy
    * TagInstanceProfile
    * TagMFADevice
    * TagOpenIDConnectProvider
    * TagPolicy
    * TagRole
    * TagSAMLProvider
    * TagServerCertificate
    * TagUser
    * UntagInstanceProfile
    * UntagMFADevice
    * UntagOpenIDConnectProvider
    * UntagPolicy
    * UntagRole
    * UntagSAMLProvider
    * UntagServerCertificate
    * UntagUser
    * UpdateAccessKey
    * UpdateAccountPasswordPolicy
    * UpdateAssumeRolePolicy
    * UpdateGroup
    * UpdateLoginProfile
    * UpdateOpenIDConnectProviderThumbprint
    * UpdateRole
    * UpdateRoleDescription
    * UpdateSAMLProvider
    * UpdateServerCertificate
    * UpdateServiceSpecificCredential
    * UpdateSigningCertificate
    * UpdateSSHPublicKey
    * UpdateUser
    * UploadServerCertificate
    * UploadSigningCertificate
    * UploadSSHPublicKey

 * Data Types
    * AccessDetail
    * AccessKey
    * AccessKeyLastUsed
    * AccessKeyMetadata
    * AttachedPermissionsBoundary
    * AttachedPolicy
    * ContextEntry
    * DeletionTaskFailureReasonType
    * EntityDetails
    * EntityInfo
    * ErrorDetails
    * EvaluationResult
    * Group
    * GroupDetail
    * InstanceProfile
    * ListPoliciesGrantingServiceAccessEntry
    * LoginProfile
    * ManagedPolicyDetail
    * MFADevice
    * OpenIDConnectProviderListEntry
    * OrganizationsDecisionDetail
    * PasswordPolicy
    * PermissionsBoundaryDecisionDetail
    * Policy
    * PolicyDetail
    * PolicyGrantingServiceAccess
    * PolicyGroup
    * PolicyRole
    * PolicyUser
    * PolicyVersion
    * Position
    * ResourceSpecificResult
    * Role
    * RoleDetail
    * RoleLastUsed
    * RoleUsageType
    * SAMLProviderListEntry
    * ServerCertificate
    * ServerCertificateMetadata
    * ServiceLastAccessed
    * ServiceSpecificCredential
    * ServiceSpecificCredentialMetadata
    * SigningCertificate
    * SSHPublicKey
    * SSHPublicKeyMetadata
    * Statement
    * Tag
    * TrackedActionLastAccessed
    * User
    * UserDetail
    * VirtualMFADevice

 * Common Parameters
 * Common Errors

GetAccountSummary - AWS Identity and Access Management
AWSDocumentationAWS Identity and Access ManagementAPI Reference
Response ElementsErrorsExamplesSee Also


GETACCOUNTSUMMARY

PDF

Retrieves information about IAM entity usage and IAM quotas in the AWS account.

For information about IAM quotas, see IAM and AWS STS quotas in the IAM User
Guide.


RESPONSE ELEMENTS

The following element is returned by the service.

SummaryMap SummaryMap.entry.N.key (key) SummaryMap.entry.N.value (value)

A set of key–value pairs containing information about IAM entity usage and IAM
quotas.

Type: String to integer map

Valid Keys: Users | UsersQuota | Groups | GroupsQuota | ServerCertificates |
ServerCertificatesQuota | UserPolicySizeQuota | GroupPolicySizeQuota |
GroupsPerUserQuota | SigningCertificatesPerUserQuota | AccessKeysPerUserQuota |
MFADevices | MFADevicesInUse | AccountMFAEnabled | AccountAccessKeysPresent |
AccountSigningCertificatesPresent | AttachedPoliciesPerGroupQuota |
AttachedPoliciesPerRoleQuota | AttachedPoliciesPerUserQuota | Policies |
PoliciesQuota | PolicySizeQuota | PolicyVersionsInUse | PolicyVersionsInUseQuota
| VersionsPerPolicyQuota | GlobalEndpointTokenVersion


ERRORS

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

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 GetAccountSummary.

SAMPLE REQUEST

https://iam.amazonaws.com/?Action=GetAccountSummary
&Version=2010-05-08
&AUTHPARAMS

SAMPLE RESPONSE

<GetAccountSummaryResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
  <GetAccountSummaryResult>
    <SummaryMap>
      <entry>
        <key>Users</key>
        <value>32</value>
      </entry>
      <entry>
        <key>GroupPolicySizeQuota</key>
        <value>10240</value>
      </entry>
      <entry>
        <key>PolicyVersionsInUseQuota</key>
        <value>10000</value>
      </entry>
      <entry>
        <key>ServerCertificatesQuota</key>
        <value>20</value>
      </entry>
      <entry>
        <key>AccountSigningCertificatesPresent</key>
        <value>0</value>
      </entry>
      <entry>
        <key>AccountAccessKeysPresent</key>
        <value>0</value>
      </entry>
      <entry>
        <key>Groups</key>
        <value>7</value>
      </entry>
      <entry>
        <key>UsersQuota</key>
        <value>150</value>
      </entry>
      <entry>
        <key>RolePolicySizeQuota</key>
        <value>2048</value>
      </entry>
      <entry>
        <key>UserPolicySizeQuota</key>
        <value>10240</value>
      </entry>
      <entry>
        <key>GroupsPerUserQuota</key>
        <value>10</value>
      </entry>
      <entry>
        <key>AssumeRolePolicySizeQuota</key>
        <value>2048</value>
      </entry>
      <entry>
        <key>AttachedPoliciesPerGroupQuota</key>
        <value>2</value>
      </entry>
      <entry>
        <key>Roles</key>
        <value>18</value>
      </entry>
      <entry>
        <key>VersionsPerPolicyQuota</key>
        <value>5</value>
      </entry>
      <entry>
        <key>GroupsQuota</key>
        <value>50</value>
      </entry>
      <entry>
        <key>PolicySizeQuota</key>
        <value>5120</value>
      </entry>
      <entry>
        <key>Policies</key>
        <value>22</value>
      </entry>
      <entry>
        <key>RolesQuota</key>
        <value>250</value>
      </entry>
      <entry>
        <key>ServerCertificates</key>
        <value>1</value>
      </entry>
      <entry>
        <key>AttachedPoliciesPerRoleQuota</key>
        <value>2</value>
      </entry>
      <entry>
        <key>MFADevicesInUse</key>
        <value>4</value>
      </entry>
      <entry>
        <key>PoliciesQuota</key>
        <value>1000</value>
      </entry>
      <entry>
        <key>AccountMFAEnabled</key>
        <value>1</value>
      </entry>
      <entry>
        <key>Providers</key>
        <value>3</value>
      </entry>
      <entry>
        <key>InstanceProfilesQuota</key>
        <value>100</value>
      </entry>
      <entry>
        <key>MFADevices</key>
        <value>4</value>
      </entry>
      <entry>
        <key>AccessKeysPerUserQuota</key>
        <value>2</value>
      </entry>
      <entry>
        <key>AttachedPoliciesPerUserQuota</key>
        <value>2</value>
      </entry>
      <entry>
        <key>SigningCertificatesPerUserQuota</key>
        <value>2</value>
      </entry>
      <entry>
        <key>PolicyVersionsInUse</key>
        <value>27</value>
      </entry>
      <entry>
        <key>InstanceProfiles</key>
        <value>12</value>
      </entry>
      <entry>
        <key>GlobalEndpointTokenVersion</key>
        <value>2</value>
      </entry>
    </SummaryMap>
  </GetAccountSummaryResult>
  <ResponseMetadata>
    <RequestId>85cb9b90-ac28-11e4-a88d-97964EXAMPLE</RequestId>
  </ResponseMetadata>
</GetAccountSummaryResponse>


SEE ALSO

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

 * AWS Command Line Interface

 * AWS SDK for .NET

 * AWS SDK for C++

 * AWS SDK for Go

 * AWS SDK for Java V2

 * AWS SDK for JavaScript

 * AWS SDK for PHP V3

 * AWS SDK for Python

 * AWS SDK for Ruby V3

Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please
refer to your browser's Help pages for instructions.

Document Conventions
GetAccountPasswordPolicy
GetContextKeysForCustomPolicy
Did this page help you? - Yes

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of
it.



Did this page help you? - No

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.




Did this page help you?
Yes
No
Provide feedback
Next topic:GetContextKeysForCustomPolicy
Previous topic:GetAccountPasswordPolicy
Need help?
 * Try AWS re:Post 
 * Connect with an AWS IQ expert 

PrivacySite termsCookie preferences
© 2023, Amazon Web Services, Inc. or its affiliates. All rights reserved.


ON THIS PAGE

--------------------------------------------------------------------------------

 * Response Elements
 * Errors
 * Examples
 * See Also





DID THIS PAGE HELP YOU? - NO



Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.




Feedback