:doc:`IAM <../../iam>` / Client / get_account_summary

*******************
get_account_summary
*******************



.. py:method:: IAM.Client.get_account_summary()

  

  Retrieves information about IAM entity usage and IAM quotas in the Amazon Web Services account.

   

  For information about IAM quotas, see `IAM and STS quotas <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html>`__ in the *IAM User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/GetAccountSummary>`_  


  **Request Syntax**

  ::

    response = client.get_account_summary()
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'SummaryMap': {
              'string': 123
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Contains the response to a successful `GetAccountSummary <https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetAccountSummary.html>`__ request.

      
      

      - **SummaryMap** *(dict) --* 

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

        
        

        - *(string) --* 
          

          - *(integer) --* 
    
  
  
  **Exceptions**
  
  *   :py:class:`IAM.Client.exceptions.ServiceFailureException`

  

  **Examples**

  The following command returns information about the IAM entity quotas and usage in the current AWS account.
  ::

    response = client.get_account_summary(
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'SummaryMap': {
            'AccessKeysPerUserQuota': 2,
            'AccountAccessKeysPresent': 1,
            'AccountMFAEnabled': 0,
            'AccountSigningCertificatesPresent': 0,
            'AttachedPoliciesPerGroupQuota': 10,
            'AttachedPoliciesPerRoleQuota': 10,
            'AttachedPoliciesPerUserQuota': 10,
            'GlobalEndpointTokenVersion': 2,
            'GroupPolicySizeQuota': 5120,
            'Groups': 15,
            'GroupsPerUserQuota': 10,
            'GroupsQuota': 100,
            'MFADevices': 6,
            'MFADevicesInUse': 3,
            'Policies': 8,
            'PoliciesQuota': 1000,
            'PolicySizeQuota': 5120,
            'PolicyVersionsInUse': 22,
            'PolicyVersionsInUseQuota': 10000,
            'ServerCertificates': 1,
            'ServerCertificatesQuota': 20,
            'SigningCertificatesPerUserQuota': 2,
            'UserPolicySizeQuota': 2048,
            'Users': 27,
            'UsersQuota': 5000,
            'VersionsPerPolicyQuota': 5,
        },
        'ResponseMetadata': {
            '...': '...',
        },
    }

  