aws-sdk-guardduty 1.85.0 → 1.86.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0127ffee286d134a03e62ae968b8210d28fa50372e74145c798c05b4573b225e
-  data.tar.gz: fb1bf98faaf6bb7c9eeff60d7eaffbd008bf5cf5a781588894d9b7fb041f5a87
+  metadata.gz: 71e132b3fd29f5b9a317c73d560f28728ec006e1768881e44cbcdd1db378ddcc
+  data.tar.gz: f047f6bdde39f530020f4b5fe2488a792a63f579407261b2c646c8838b62387e
 SHA512:
-  metadata.gz: '078533a2c05c970133b4a0a4c0640ea32ffcb1ef668d91bb6219848c0edb3a676fe38b9ed0961fd06ca9805633cb4c697fc314ead1fd30bf231c8c16c99e1cbb'
-  data.tar.gz: 7dd2d22dafcf3f58c381d800d83a89778327188318b9966396c1fcf2e214ddddc5c3daca06d6b38989dcf86d359d866c26285fca7089bb1b4b2ec085fb1e9a44
+  metadata.gz: cb96d3223a6bf1ab7e0be73e0d43fc713b01dbe325b80d51a795888cad106514edcb01832d8d90c7f11a64f3ef9378cb2002885c271a098c8982f411b2166c27
+  data.tar.gz: 800a099087206222d84f1389cd39e9839c6e9040ff1ac16ac290c857ae32cbfeb1a198a56708b7bfb47ff97bd25020b9b02b1abaf44afdfabdeb3ef8ec05a393

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.86.0 (2023-12-20)
+------------------
+
+* Feature - This release 1) introduces a new API: GetOrganizationStatistics , and 2) adds a new UsageStatisticType TOP_ACCOUNTS_BY_FEATURE for GetUsageStatistics API
+
 1.85.0 (2023-11-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.85.0
+1.86.0

data/lib/aws-sdk-guardduty/client.rb

@@ -968,22 +968,30 @@ module Aws::GuardDuty
     # organization delegated administrator account. A delegated
     # administrator must enable GuardDuty prior to being added as a member.
     #
+    # When you use CreateMembers as an Organizations delegated
+    # administrator, GuardDuty applies your organization's auto-enable
+    # settings to the member accounts in this request, irrespective of the
+    # accounts being new or existing members. For more information about the
+    # existing auto-enable settings for your organization, see
+    # [DescribeOrganizationConfiguration][1].
+    #
     # If you are adding accounts by invitation, before using
-    # [InviteMembers][1], use `CreateMembers` after GuardDuty has been
+    # [InviteMembers][2], use `CreateMembers` after GuardDuty has been
     # enabled in potential member accounts.
     #
     # If you disassociate a member from a GuardDuty delegated administrator,
     # the member account details obtained from this API, including the
     # associated email addresses, will be retained. This is done so that the
-    # delegated administrator can invoke the [InviteMembers][1] API without
+    # delegated administrator can invoke the [InviteMembers][2] API without
     # the need to invoke the CreateMembers API again. To remove the details
     # associated with a member account, the delegated administrator must
-    # invoke the [DeleteMembers][2] API.
+    # invoke the [DeleteMembers][3] API.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_InviteMembers.html
-    # [2]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_DeleteMembers.html
+    # [1]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_DescribeOrganizationConfiguration.html
+    # [2]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_InviteMembers.html
+    # [3]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_DeleteMembers.html
     #
     # @option params [required, String] :detector_id
     #   The unique ID of the detector of the GuardDuty account that you want
@@ -1852,8 +1860,8 @@ module Aws::GuardDuty
     # Retrieves aggregated statistics for your account. If you are a
     # GuardDuty administrator, you can retrieve the statistics for all the
     # resources associated with the active member accounts in your
-    # organization who have enabled EKS Runtime Monitoring and have the
-    # GuardDuty agent running on their EKS nodes.
+    # organization who have enabled Runtime Monitoring and have the
+    # GuardDuty security agent running on their resources.
     #
     # @option params [required, String] :detector_id
     #   The unique ID of the GuardDuty detector associated to the coverage
@@ -2823,6 +2831,40 @@ module Aws::GuardDuty
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # @return [Types::GetOrganizationStatisticsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetOrganizationStatisticsResponse#organization_details #organization_details} => Types::OrganizationDetails
+    #
+    # @example Response structure
+    #
+    #   resp.organization_details.updated_at #=> Time
+    #   resp.organization_details.organization_statistics.total_accounts_count #=> Integer
+    #   resp.organization_details.organization_statistics.member_accounts_count #=> Integer
+    #   resp.organization_details.organization_statistics.active_accounts_count #=> Integer
+    #   resp.organization_details.organization_statistics.enabled_accounts_count #=> Integer
+    #   resp.organization_details.organization_statistics.count_by_feature #=> Array
+    #   resp.organization_details.organization_statistics.count_by_feature[0].name #=> String, one of "S3_DATA_EVENTS", "EKS_AUDIT_LOGS", "EBS_MALWARE_PROTECTION", "RDS_LOGIN_EVENTS", "EKS_RUNTIME_MONITORING", "LAMBDA_NETWORK_LOGS", "RUNTIME_MONITORING"
+    #   resp.organization_details.organization_statistics.count_by_feature[0].enabled_accounts_count #=> Integer
+    #   resp.organization_details.organization_statistics.count_by_feature[0].additional_configuration #=> Array
+    #   resp.organization_details.organization_statistics.count_by_feature[0].additional_configuration[0].name #=> String, one of "EKS_ADDON_MANAGEMENT", "ECS_FARGATE_AGENT_MANAGEMENT"
+    #   resp.organization_details.organization_statistics.count_by_feature[0].additional_configuration[0].enabled_accounts_count #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/GetOrganizationStatistics AWS API Documentation
+    #
+    # @overload get_organization_statistics(params = {})
+    # @param [Hash] params ({})
+    def get_organization_statistics(params = {}, options = {})
+      req = build_request(:get_organization_statistics, params)
+      req.send_request(options)
+    end
+
     # Provides the number of days left for each data source used in the free
     # trial period.
     #
@@ -2959,7 +3001,7 @@ module Aws::GuardDuty
     #
     #   resp = client.get_usage_statistics({
     #     detector_id: "DetectorId", # required
-    #     usage_statistic_type: "SUM_BY_ACCOUNT", # required, accepts SUM_BY_ACCOUNT, SUM_BY_DATA_SOURCE, SUM_BY_RESOURCE, TOP_RESOURCES, SUM_BY_FEATURES
+    #     usage_statistic_type: "SUM_BY_ACCOUNT", # required, accepts SUM_BY_ACCOUNT, SUM_BY_DATA_SOURCE, SUM_BY_RESOURCE, TOP_RESOURCES, SUM_BY_FEATURES, TOP_ACCOUNTS_BY_FEATURE
     #     usage_criteria: { # required
     #       account_ids: ["AccountId"],
     #       data_sources: ["FLOW_LOGS"], # accepts FLOW_LOGS, CLOUD_TRAIL, DNS_LOGS, S3_LOGS, KUBERNETES_AUDIT_LOGS, EC2_MALWARE_SCAN
@@ -2977,6 +3019,12 @@ module Aws::GuardDuty
     #   resp.usage_statistics.sum_by_account[0].account_id #=> String
     #   resp.usage_statistics.sum_by_account[0].total.amount #=> String
     #   resp.usage_statistics.sum_by_account[0].total.unit #=> String
+    #   resp.usage_statistics.top_accounts_by_feature #=> Array
+    #   resp.usage_statistics.top_accounts_by_feature[0].feature #=> String, one of "FLOW_LOGS", "CLOUD_TRAIL", "DNS_LOGS", "S3_DATA_EVENTS", "EKS_AUDIT_LOGS", "EBS_MALWARE_PROTECTION", "RDS_LOGIN_EVENTS", "LAMBDA_NETWORK_LOGS", "EKS_RUNTIME_MONITORING", "FARGATE_RUNTIME_MONITORING", "EC2_RUNTIME_MONITORING"
+    #   resp.usage_statistics.top_accounts_by_feature[0].accounts #=> Array
+    #   resp.usage_statistics.top_accounts_by_feature[0].accounts[0].account_id #=> String
+    #   resp.usage_statistics.top_accounts_by_feature[0].accounts[0].total.amount #=> String
+    #   resp.usage_statistics.top_accounts_by_feature[0].accounts[0].total.unit #=> String
     #   resp.usage_statistics.sum_by_data_source #=> Array
     #   resp.usage_statistics.sum_by_data_source[0].data_source #=> String, one of "FLOW_LOGS", "CLOUD_TRAIL", "DNS_LOGS", "S3_LOGS", "KUBERNETES_AUDIT_LOGS", "EC2_MALWARE_SCAN"
     #   resp.usage_statistics.sum_by_data_source[0].total.amount #=> String
@@ -3085,8 +3133,8 @@ module Aws::GuardDuty
     # GuardDuty administrator, you can retrieve all resources associated
     # with the active member accounts in your organization.
     #
-    # Make sure the accounts have EKS Runtime Monitoring enabled and
-    # GuardDuty agent running on their EKS nodes.
+    # Make sure the accounts have Runtime Monitoring enabled and GuardDuty
+    # agent running on their resources.
     #
     # @option params [required, String] :detector_id
     #   The unique ID of the detector whose coverage details you want to
@@ -4548,7 +4596,7 @@ module Aws::GuardDuty
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-guardduty'
-      context[:gem_version] = '1.85.0'
+      context[:gem_version] = '1.86.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-guardduty/client_api.rb

@@ -225,6 +225,7 @@ module Aws::GuardDuty
     GetMemberDetectorsResponse = Shapes::StructureShape.new(name: 'GetMemberDetectorsResponse')
     GetMembersRequest = Shapes::StructureShape.new(name: 'GetMembersRequest')
     GetMembersResponse = Shapes::StructureShape.new(name: 'GetMembersResponse')
+    GetOrganizationStatisticsResponse = Shapes::StructureShape.new(name: 'GetOrganizationStatisticsResponse')
     GetRemainingFreeTrialDaysRequest = Shapes::StructureShape.new(name: 'GetRemainingFreeTrialDaysRequest')
     GetRemainingFreeTrialDaysResponse = Shapes::StructureShape.new(name: 'GetRemainingFreeTrialDaysResponse')
     GetThreatIntelSetRequest = Shapes::StructureShape.new(name: 'GetThreatIntelSetRequest')
@@ -335,10 +336,15 @@ module Aws::GuardDuty
     OrganizationAdditionalConfigurations = Shapes::ListShape.new(name: 'OrganizationAdditionalConfigurations')
     OrganizationDataSourceConfigurations = Shapes::StructureShape.new(name: 'OrganizationDataSourceConfigurations')
     OrganizationDataSourceConfigurationsResult = Shapes::StructureShape.new(name: 'OrganizationDataSourceConfigurationsResult')
+    OrganizationDetails = Shapes::StructureShape.new(name: 'OrganizationDetails')
     OrganizationEbsVolumes = Shapes::StructureShape.new(name: 'OrganizationEbsVolumes')
     OrganizationEbsVolumesResult = Shapes::StructureShape.new(name: 'OrganizationEbsVolumesResult')
     OrganizationFeatureConfiguration = Shapes::StructureShape.new(name: 'OrganizationFeatureConfiguration')
     OrganizationFeatureConfigurationResult = Shapes::StructureShape.new(name: 'OrganizationFeatureConfigurationResult')
+    OrganizationFeatureStatistics = Shapes::StructureShape.new(name: 'OrganizationFeatureStatistics')
+    OrganizationFeatureStatisticsAdditionalConfiguration = Shapes::StructureShape.new(name: 'OrganizationFeatureStatisticsAdditionalConfiguration')
+    OrganizationFeatureStatisticsAdditionalConfigurations = Shapes::ListShape.new(name: 'OrganizationFeatureStatisticsAdditionalConfigurations')
+    OrganizationFeatureStatisticsResults = Shapes::ListShape.new(name: 'OrganizationFeatureStatisticsResults')
     OrganizationFeaturesConfigurations = Shapes::ListShape.new(name: 'OrganizationFeaturesConfigurations')
     OrganizationFeaturesConfigurationsResults = Shapes::ListShape.new(name: 'OrganizationFeaturesConfigurationsResults')
     OrganizationKubernetesAuditLogsConfiguration = Shapes::StructureShape.new(name: 'OrganizationKubernetesAuditLogsConfiguration')
@@ -351,6 +357,7 @@ module Aws::GuardDuty
     OrganizationS3LogsConfigurationResult = Shapes::StructureShape.new(name: 'OrganizationS3LogsConfigurationResult')
     OrganizationScanEc2InstanceWithFindings = Shapes::StructureShape.new(name: 'OrganizationScanEc2InstanceWithFindings')
     OrganizationScanEc2InstanceWithFindingsResult = Shapes::StructureShape.new(name: 'OrganizationScanEc2InstanceWithFindingsResult')
+    OrganizationStatistics = Shapes::StructureShape.new(name: 'OrganizationStatistics')
     Owner = Shapes::StructureShape.new(name: 'Owner')
     PermissionConfiguration = Shapes::StructureShape.new(name: 'PermissionConfiguration')
     PortProbeAction = Shapes::StructureShape.new(name: 'PortProbeAction')
@@ -475,6 +482,10 @@ module Aws::GuardDuty
     UsageResourceResultList = Shapes::ListShape.new(name: 'UsageResourceResultList')
     UsageStatisticType = Shapes::StringShape.new(name: 'UsageStatisticType')
     UsageStatistics = Shapes::StructureShape.new(name: 'UsageStatistics')
+    UsageTopAccountResult = Shapes::StructureShape.new(name: 'UsageTopAccountResult')
+    UsageTopAccountsByFeatureList = Shapes::ListShape.new(name: 'UsageTopAccountsByFeatureList')
+    UsageTopAccountsResult = Shapes::StructureShape.new(name: 'UsageTopAccountsResult')
+    UsageTopAccountsResultList = Shapes::ListShape.new(name: 'UsageTopAccountsResultList')
     Volume = Shapes::StructureShape.new(name: 'Volume')
     VolumeDetail = Shapes::StructureShape.new(name: 'VolumeDetail')
     VolumeDetails = Shapes::ListShape.new(name: 'VolumeDetails')
@@ -1228,6 +1239,9 @@ module Aws::GuardDuty
     GetMembersResponse.add_member(:unprocessed_accounts, Shapes::ShapeRef.new(shape: UnprocessedAccounts, required: true, location_name: "unprocessedAccounts"))
     GetMembersResponse.struct_class = Types::GetMembersResponse
 
+    GetOrganizationStatisticsResponse.add_member(:organization_details, Shapes::ShapeRef.new(shape: OrganizationDetails, location_name: "organizationDetails"))
+    GetOrganizationStatisticsResponse.struct_class = Types::GetOrganizationStatisticsResponse
+
     GetRemainingFreeTrialDaysRequest.add_member(:detector_id, Shapes::ShapeRef.new(shape: DetectorId, required: true, location: "uri", location_name: "detectorId"))
     GetRemainingFreeTrialDaysRequest.add_member(:account_ids, Shapes::ShapeRef.new(shape: AccountIds, location_name: "accountIds"))
     GetRemainingFreeTrialDaysRequest.struct_class = Types::GetRemainingFreeTrialDaysRequest
@@ -1652,6 +1666,10 @@ module Aws::GuardDuty
     OrganizationDataSourceConfigurationsResult.add_member(:malware_protection, Shapes::ShapeRef.new(shape: OrganizationMalwareProtectionConfigurationResult, location_name: "malwareProtection"))
     OrganizationDataSourceConfigurationsResult.struct_class = Types::OrganizationDataSourceConfigurationsResult
 
+    OrganizationDetails.add_member(:updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "updatedAt"))
+    OrganizationDetails.add_member(:organization_statistics, Shapes::ShapeRef.new(shape: OrganizationStatistics, location_name: "organizationStatistics"))
+    OrganizationDetails.struct_class = Types::OrganizationDetails
+
     OrganizationEbsVolumes.add_member(:auto_enable, Shapes::ShapeRef.new(shape: Boolean, location_name: "autoEnable"))
     OrganizationEbsVolumes.struct_class = Types::OrganizationEbsVolumes
 
@@ -1668,6 +1686,19 @@ module Aws::GuardDuty
     OrganizationFeatureConfigurationResult.add_member(:additional_configuration, Shapes::ShapeRef.new(shape: OrganizationAdditionalConfigurationResults, location_name: "additionalConfiguration"))
     OrganizationFeatureConfigurationResult.struct_class = Types::OrganizationFeatureConfigurationResult
 
+    OrganizationFeatureStatistics.add_member(:name, Shapes::ShapeRef.new(shape: OrgFeature, location_name: "name"))
+    OrganizationFeatureStatistics.add_member(:enabled_accounts_count, Shapes::ShapeRef.new(shape: Integer, location_name: "enabledAccountsCount"))
+    OrganizationFeatureStatistics.add_member(:additional_configuration, Shapes::ShapeRef.new(shape: OrganizationFeatureStatisticsAdditionalConfigurations, location_name: "additionalConfiguration"))
+    OrganizationFeatureStatistics.struct_class = Types::OrganizationFeatureStatistics
+
+    OrganizationFeatureStatisticsAdditionalConfiguration.add_member(:name, Shapes::ShapeRef.new(shape: OrgFeatureAdditionalConfiguration, location_name: "name"))
+    OrganizationFeatureStatisticsAdditionalConfiguration.add_member(:enabled_accounts_count, Shapes::ShapeRef.new(shape: Integer, location_name: "enabledAccountsCount"))
+    OrganizationFeatureStatisticsAdditionalConfiguration.struct_class = Types::OrganizationFeatureStatisticsAdditionalConfiguration
+
+    OrganizationFeatureStatisticsAdditionalConfigurations.member = Shapes::ShapeRef.new(shape: OrganizationFeatureStatisticsAdditionalConfiguration)
+
+    OrganizationFeatureStatisticsResults.member = Shapes::ShapeRef.new(shape: OrganizationFeatureStatistics)
+
     OrganizationFeaturesConfigurations.member = Shapes::ShapeRef.new(shape: OrganizationFeatureConfiguration)
 
     OrganizationFeaturesConfigurationsResults.member = Shapes::ShapeRef.new(shape: OrganizationFeatureConfigurationResult)
@@ -1702,6 +1733,13 @@ module Aws::GuardDuty
     OrganizationScanEc2InstanceWithFindingsResult.add_member(:ebs_volumes, Shapes::ShapeRef.new(shape: OrganizationEbsVolumesResult, location_name: "ebsVolumes"))
     OrganizationScanEc2InstanceWithFindingsResult.struct_class = Types::OrganizationScanEc2InstanceWithFindingsResult
 
+    OrganizationStatistics.add_member(:total_accounts_count, Shapes::ShapeRef.new(shape: Integer, location_name: "totalAccountsCount"))
+    OrganizationStatistics.add_member(:member_accounts_count, Shapes::ShapeRef.new(shape: Integer, location_name: "memberAccountsCount"))
+    OrganizationStatistics.add_member(:active_accounts_count, Shapes::ShapeRef.new(shape: Integer, location_name: "activeAccountsCount"))
+    OrganizationStatistics.add_member(:enabled_accounts_count, Shapes::ShapeRef.new(shape: Integer, location_name: "enabledAccountsCount"))
+    OrganizationStatistics.add_member(:count_by_feature, Shapes::ShapeRef.new(shape: OrganizationFeatureStatisticsResults, location_name: "countByFeature"))
+    OrganizationStatistics.struct_class = Types::OrganizationStatistics
+
     Owner.add_member(:id, Shapes::ShapeRef.new(shape: String, location_name: "id"))
     Owner.struct_class = Types::Owner
 
@@ -2154,12 +2192,25 @@ module Aws::GuardDuty
     UsageResourceResultList.member = Shapes::ShapeRef.new(shape: UsageResourceResult)
 
     UsageStatistics.add_member(:sum_by_account, Shapes::ShapeRef.new(shape: UsageAccountResultList, location_name: "sumByAccount"))
+    UsageStatistics.add_member(:top_accounts_by_feature, Shapes::ShapeRef.new(shape: UsageTopAccountsResultList, location_name: "topAccountsByFeature"))
     UsageStatistics.add_member(:sum_by_data_source, Shapes::ShapeRef.new(shape: UsageDataSourceResultList, location_name: "sumByDataSource"))
     UsageStatistics.add_member(:sum_by_resource, Shapes::ShapeRef.new(shape: UsageResourceResultList, location_name: "sumByResource"))
     UsageStatistics.add_member(:top_resources, Shapes::ShapeRef.new(shape: UsageResourceResultList, location_name: "topResources"))
     UsageStatistics.add_member(:sum_by_feature, Shapes::ShapeRef.new(shape: UsageFeatureResultList, location_name: "sumByFeature"))
     UsageStatistics.struct_class = Types::UsageStatistics
 
+    UsageTopAccountResult.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, location_name: "accountId"))
+    UsageTopAccountResult.add_member(:total, Shapes::ShapeRef.new(shape: Total, location_name: "total"))
+    UsageTopAccountResult.struct_class = Types::UsageTopAccountResult
+
+    UsageTopAccountsByFeatureList.member = Shapes::ShapeRef.new(shape: UsageTopAccountResult)
+
+    UsageTopAccountsResult.add_member(:feature, Shapes::ShapeRef.new(shape: UsageFeature, location_name: "feature"))
+    UsageTopAccountsResult.add_member(:accounts, Shapes::ShapeRef.new(shape: UsageTopAccountsByFeatureList, location_name: "accounts"))
+    UsageTopAccountsResult.struct_class = Types::UsageTopAccountsResult
+
+    UsageTopAccountsResultList.member = Shapes::ShapeRef.new(shape: UsageTopAccountsResult)
+
     Volume.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
     Volume.add_member(:host_path, Shapes::ShapeRef.new(shape: HostPath, location_name: "hostPath"))
     Volume.struct_class = Types::Volume
@@ -2601,6 +2652,16 @@ module Aws::GuardDuty
         o.errors << Shapes::ShapeRef.new(shape: InternalServerErrorException)
       end)
 
+      api.add_operation(:get_organization_statistics, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetOrganizationStatistics"
+        o.http_method = "GET"
+        o.http_request_uri = "/organization/statistics"
+        o.input = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.output = Shapes::ShapeRef.new(shape: GetOrganizationStatisticsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: BadRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerErrorException)
+      end)
+
       api.add_operation(:get_remaining_free_trial_days, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetRemainingFreeTrialDays"
         o.http_method = "POST"

data/lib/aws-sdk-guardduty/endpoints.rb

@@ -544,6 +544,20 @@ module Aws::GuardDuty
       end
     end
 
+    class GetOrganizationStatistics
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::GuardDuty::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class GetRemainingFreeTrialDays
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-guardduty/plugins/endpoints.rb

@@ -133,6 +133,8 @@ module Aws::GuardDuty
             Aws::GuardDuty::Endpoints::GetMemberDetectors.build(context)
           when :get_members
             Aws::GuardDuty::Endpoints::GetMembers.build(context)
+          when :get_organization_statistics
+            Aws::GuardDuty::Endpoints::GetOrganizationStatistics.build(context)
           when :get_remaining_free_trial_days
             Aws::GuardDuty::Endpoints::GetRemainingFreeTrialDays.build(context)
           when :get_threat_intel_set

data/lib/aws-sdk-guardduty/types.rb

@@ -810,13 +810,18 @@ module Aws::GuardDuty
 
     # <note markdown="1"> This API is also used when you use GuardDuty Runtime Monitoring for
     # your Amazon EC2 instances (currently in preview release) and is
-    # subject to change.
+    # subject to change. The use of this API is subject to Section 2 of the
+    # [Amazon Web Services Service Terms][1] ("Betas and Previews").
     #
     #  </note>
     #
     # Contains information about the Amazon EC2 instance runtime coverage
     # details.
     #
+    #
+    #
+    # [1]: http://aws.amazon.com/service-terms/
+    #
     # @!attribute [rw] instance_id
     #   The Amazon EC2 instance ID.
     #   @return [String]
@@ -845,7 +850,7 @@ module Aws::GuardDuty
     #     manage the GuardDuty security agent updates for this resource.
     #
     #   <note markdown="1"> The `DISABLED` status doesn't apply to Amazon EC2 instances and
-    #   Amazon EKS clusters that run on Amazon EC2 instances.
+    #   Amazon EKS clusters.
     #
     #    </note>
     #   @return [String]
@@ -1059,12 +1064,17 @@ module Aws::GuardDuty
     # @!attribute [rw] ec2_instance_details
     #   <note markdown="1"> This API is also used when you use GuardDuty Runtime Monitoring for
     #   your Amazon EC2 instances (currently in preview release) and is
-    #   subject to change.
+    #   subject to change. The use of this API is subject to Section 2 of
+    #   the [Amazon Web Services Service Terms][1] ("Betas and Previews").
     #
     #    </note>
     #
     #   Information about the Amazon EC2 instance assessed for runtime
     #   coverage.
+    #
+    #
+    #
+    #   [1]: http://aws.amazon.com/service-terms/
     #   @return [Types::CoverageEc2InstanceDetails]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/CoverageResourceDetails AWS API Documentation
@@ -2798,12 +2808,12 @@ module Aws::GuardDuty
       include Aws::Structure
     end
 
-    # Contains information about AWS Fargate details associated with an
-    # Amazon ECS cluster.
+    # Contains information about Amazon Web Services Fargate details
+    # associated with an Amazon ECS cluster.
     #
     # @!attribute [rw] issues
-    #   Runtime coverage issues identified for the resource running on AWS
-    #   Fargate.
+    #   Runtime coverage issues identified for the resource running on
+    #   Amazon Web Services Fargate.
     #   @return [Array<String>]
     #
     # @!attribute [rw] management_type
@@ -2813,11 +2823,13 @@ module Aws::GuardDuty
     #   * `AUTO_MANAGED` indicates that GuardDuty deploys and manages
     #     updates for this resource.
     #
-    #   * `MANUAL` indicates that you are responsible to deploy, update, and
-    #     manage the GuardDuty security agent updates for this resource.
-    #
     #   * `DISABLED` indicates that the deployment of the GuardDuty security
     #     agent is disabled for this resource.
+    #
+    #   <note markdown="1"> The `MANUAL` status doesn't apply to the Amazon Web Services
+    #   Fargate (Amazon ECS only) woprkloads.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/FargateDetails AWS API Documentation
@@ -3513,6 +3525,18 @@ module Aws::GuardDuty
       include Aws::Structure
     end
 
+    # @!attribute [rw] organization_details
+    #   Information about the statistics report for your organization.
+    #   @return [Types::OrganizationDetails]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/GetOrganizationStatisticsResponse AWS API Documentation
+    #
+    class GetOrganizationStatisticsResponse < Struct.new(
+      :organization_details)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] detector_id
     #   The unique ID of the detector of the GuardDuty member account.
     #   @return [String]
@@ -5603,6 +5627,28 @@ module Aws::GuardDuty
       include Aws::Structure
     end
 
+    # Information about GuardDuty coverage statistics for members in your
+    # Amazon Web Services organization.
+    #
+    # @!attribute [rw] updated_at
+    #   The timestamp at which the organization statistics was last updated.
+    #   This is in UTC format.
+    #   @return [Time]
+    #
+    # @!attribute [rw] organization_statistics
+    #   Information about the GuardDuty coverage statistics for members in
+    #   your Amazon Web Services organization.
+    #   @return [Types::OrganizationStatistics]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/OrganizationDetails AWS API Documentation
+    #
+    class OrganizationDetails < Struct.new(
+      :updated_at,
+      :organization_statistics)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Organization-wide EBS volumes scan configuration.
     #
     # @!attribute [rw] auto_enable
@@ -5716,6 +5762,52 @@ module Aws::GuardDuty
       include Aws::Structure
     end
 
+    # Information about the number of accounts that have enabled a specific
+    # feature.
+    #
+    # @!attribute [rw] name
+    #   Name of the feature.
+    #   @return [String]
+    #
+    # @!attribute [rw] enabled_accounts_count
+    #   Total number of accounts that have enabled a specific feature.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] additional_configuration
+    #   Name of the additional configuration.
+    #   @return [Array<Types::OrganizationFeatureStatisticsAdditionalConfiguration>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/OrganizationFeatureStatistics AWS API Documentation
+    #
+    class OrganizationFeatureStatistics < Struct.new(
+      :name,
+      :enabled_accounts_count,
+      :additional_configuration)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Information about the coverage statistic for the additional
+    # configuration of the feature.
+    #
+    # @!attribute [rw] name
+    #   Name of the additional configuration within a feature.
+    #   @return [String]
+    #
+    # @!attribute [rw] enabled_accounts_count
+    #   Total number of accounts that have enabled the additional
+    #   configuration.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/OrganizationFeatureStatisticsAdditionalConfiguration AWS API Documentation
+    #
+    class OrganizationFeatureStatisticsAdditionalConfiguration < Struct.new(
+      :name,
+      :enabled_accounts_count)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Organization-wide Kubernetes audit logs configuration.
     #
     # @!attribute [rw] auto_enable
@@ -5873,6 +5965,47 @@ module Aws::GuardDuty
       include Aws::Structure
     end
 
+    # Information about the coverage statistics of the features for the
+    # entire Amazon Web Services organization.
+    #
+    # When you create a new Amazon Web Services organization, it might take
+    # up to 24 hours to generate the statistics summary for this
+    # organization.
+    #
+    # @!attribute [rw] total_accounts_count
+    #   Total number of accounts in your Amazon Web Services organization.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] member_accounts_count
+    #   Total number of accounts in your Amazon Web Services organization
+    #   that are associated with GuardDuty.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] active_accounts_count
+    #   Total number of active accounts in your Amazon Web Services
+    #   organization that are associated with GuardDuty.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] enabled_accounts_count
+    #   Total number of accounts that have enabled GuardDuty.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] count_by_feature
+    #   Retrieves the coverage statistics for each feature.
+    #   @return [Array<Types::OrganizationFeatureStatistics>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/OrganizationStatistics AWS API Documentation
+    #
+    class OrganizationStatistics < Struct.new(
+      :total_accounts_count,
+      :member_accounts_count,
+      :active_accounts_count,
+      :enabled_accounts_count,
+      :count_by_feature)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains information on the owner of the bucket.
     #
     # @!attribute [rw] id
@@ -7853,6 +7986,13 @@ module Aws::GuardDuty
     #   The usage statistic sum organized by account ID.
     #   @return [Array<Types::UsageAccountResult>]
     #
+    # @!attribute [rw] top_accounts_by_feature
+    #   Lists the top 50 accounts by feature that have generated the most
+    #   GuardDuty usage, in the order from most to least expensive.
+    #
+    #   Currently, this doesn't support `RDS_LOGIN_EVENTS`.
+    #   @return [Array<Types::UsageTopAccountsResult>]
+    #
     # @!attribute [rw] sum_by_data_source
     #   The usage statistic sum organized by on data source.
     #   @return [Array<Types::UsageDataSourceResult>]
@@ -7874,6 +8014,7 @@ module Aws::GuardDuty
     #
     class UsageStatistics < Struct.new(
       :sum_by_account,
+      :top_accounts_by_feature,
       :sum_by_data_source,
       :sum_by_resource,
       :top_resources,
@@ -7882,6 +8023,50 @@ module Aws::GuardDuty
       include Aws::Structure
     end
 
+    # Contains information on the total of usage based on the topmost 50
+    # account IDs.
+    #
+    # @!attribute [rw] account_id
+    #   The unique account ID.
+    #   @return [String]
+    #
+    # @!attribute [rw] total
+    #   Contains the total usage with the corresponding currency unit for
+    #   that value.
+    #   @return [Types::Total]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/UsageTopAccountResult AWS API Documentation
+    #
+    class UsageTopAccountResult < Struct.new(
+      :account_id,
+      :total)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Information about the usage statistics, calculated by top accounts by
+    # feature.
+    #
+    # @!attribute [rw] feature
+    #   Features by which you can generate the usage statistics.
+    #
+    #   `RDS_LOGIN_EVENTS` is currently not supported with
+    #   `topAccountsByFeature`.
+    #   @return [String]
+    #
+    # @!attribute [rw] accounts
+    #   The accounts that contributed to the total usage cost.
+    #   @return [Array<Types::UsageTopAccountResult>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/UsageTopAccountsResult AWS API Documentation
+    #
+    class UsageTopAccountsResult < Struct.new(
+      :feature,
+      :accounts)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Volume used by the Kubernetes workload.
     #
     # @!attribute [rw] name

data/lib/aws-sdk-guardduty.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-guardduty/customizations'
 # @!group service
 module Aws::GuardDuty
 
-  GEM_VERSION = '1.85.0'
+  GEM_VERSION = '1.86.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-guardduty
 version: !ruby/object:Gem::Version
-  version: 1.85.0
+  version: 1.86.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-28 00:00:00.000000000 Z
+date: 2023-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core