GuardDuty / Client / get_organization_statistics
get_organization_statistics#
- GuardDuty.Client.get_organization_statistics()#
Retrieves how many active member accounts in your Amazon Web Services organization have each feature enabled within GuardDuty. Only a delegated GuardDuty administrator of an organization can run this API.
When you create a new Amazon Web Services organization, it might take up to 24 hours to generate the statistics for the entire organization.
See also: AWS API Documentation
Request Syntax
response = client.get_organization_statistics()
- Return type:
dict
- Returns:
Response Syntax
{ 'OrganizationDetails': { 'UpdatedAt': datetime(2015, 1, 1), 'OrganizationStatistics': { 'TotalAccountsCount': 123, 'MemberAccountsCount': 123, 'ActiveAccountsCount': 123, 'EnabledAccountsCount': 123, 'CountByFeature': [ { 'Name': 'S3_DATA_EVENTS'|'EKS_AUDIT_LOGS'|'EBS_MALWARE_PROTECTION'|'RDS_LOGIN_EVENTS'|'EKS_RUNTIME_MONITORING'|'LAMBDA_NETWORK_LOGS'|'RUNTIME_MONITORING', 'EnabledAccountsCount': 123, 'AdditionalConfiguration': [ { 'Name': 'EKS_ADDON_MANAGEMENT'|'ECS_FARGATE_AGENT_MANAGEMENT', 'EnabledAccountsCount': 123 }, ] }, ] } } }
Response Structure
(dict) –
OrganizationDetails (dict) –
Information about the statistics report for your organization.
UpdatedAt (datetime) –
The timestamp at which the organization statistics was last updated. This is in UTC format.
OrganizationStatistics (dict) –
Information about the GuardDuty coverage statistics for members in your Amazon Web Services organization.
TotalAccountsCount (integer) –
Total number of accounts in your Amazon Web Services organization.
MemberAccountsCount (integer) –
Total number of accounts in your Amazon Web Services organization that are associated with GuardDuty.
ActiveAccountsCount (integer) –
Total number of active accounts in your Amazon Web Services organization that are associated with GuardDuty.
EnabledAccountsCount (integer) –
Total number of accounts that have enabled GuardDuty.
CountByFeature (list) –
Retrieves the coverage statistics for each feature.
(dict) –
Information about the number of accounts that have enabled a specific feature.
Name (string) –
Name of the feature.
EnabledAccountsCount (integer) –
Total number of accounts that have enabled a specific feature.
AdditionalConfiguration (list) –
Name of the additional configuration.
(dict) –
Information about the coverage statistic for the additional configuration of the feature.
Name (string) –
Name of the additional configuration within a feature.
EnabledAccountsCount (integer) –
Total number of accounts that have enabled the additional configuration.
Exceptions
GuardDuty.Client.exceptions.BadRequestException
GuardDuty.Client.exceptions.InternalServerErrorException