aws-sdk-securityir 1.28.0 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ab5f48e407999188b745303e23863cc8cbd191f5fc721256c0642585d8e115b
-  data.tar.gz: c8dad78f4996e7c0a9ddf5643cd593c01e7b9d198684b341c9ff7c1e09b7a0b2
+  metadata.gz: 75fa61c5ac1ae27b711677de79f50ce6d8363899895de8dc6d14ac6afda9267a
+  data.tar.gz: fdcc5e9e6b4b5e677ea3e539372e0b2613c341d0e02b1c24b90624bbf29a2fcb
 SHA512:
-  metadata.gz: 312dda872598ca73b944a6bbf80661f106e42fe72987a7f2d8887bf5c666d0c7f051efc15285c48d6907d798c85ffda5ef3e1da122fbd5b94111b8240a8c6a96
-  data.tar.gz: f8f9a64f2b81820ddd1828f3d91ad71632a5825bb563f4d8670f022b529edd63b502e2420f16c6fcb9d8f4fcff2bd568a5b3425cbf7c090fcc67b93db222aa0b
+  metadata.gz: e1a2d2e6e87d6f29d3fa8eab647b57cab22505216b42da3e45c61429e6c337fc99418f4851eb76f3204ba3f29da6201c96c4c4d9e970f955696b70bbad85069f
+  data.tar.gz: e2b3449e6471c2195a4d0f1a6c302d2725aacc0b1a1525ef1713358564ec7d502b9805dbe1be2146785a35ced16435bf52d81c21c5fb79b80afbcbed4d0459e9

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.29.0 (2026-10-08)
+------------------
+
+* Feature - Adds support for retrieving finding-lifecycle metrics for an AWS Security Incident Response membership.
+
 1.28.0 (2026-09-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.28.0
+1.29.0

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

@@ -1224,6 +1224,86 @@ module Aws::SecurityIR
       req.send_request(options)
     end
 
+    # Returns finding-lifecycle metrics for a membership over a date range.
+    #
+    # @option params [required, String] :membership_id
+    #   The membership ID to retrieve metrics for.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :start_date
+    #   The start of the day-aligned UTC window, inclusive.
+    #
+    # @option params [required, Time,DateTime,Date,Integer,String] :end_date
+    #   The end of the day-aligned UTC window, inclusive.
+    #
+    # @return [Types::GetFindingMetricsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetFindingMetricsResponse#findings_ingested_security_hub #findings_ingested_security_hub} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_ingested_guard_duty #findings_ingested_guard_duty} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_triaged #findings_triaged} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_triaged_false_positive #findings_triaged_false_positive} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_investigated #findings_investigated} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_investigated_false_positive #findings_investigated_false_positive} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_escalated #findings_escalated} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_escalated_false_positive #findings_escalated_false_positive} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_true_positive #findings_true_positive} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_investigated_in_progress #findings_investigated_in_progress} => Integer
+    #   * {Types::GetFindingMetricsResponse#findings_escalated_in_progress #findings_escalated_in_progress} => Integer
+    #
+    #
+    # @example Example: Retrieve finding-lifecycle metrics for a membership
+    #
+    #   resp = client.get_finding_metrics({
+    #     end_date: Time.parse("2026-08-18T00:00:00Z"), 
+    #     membership_id: "m-a1b2c3d4e5f", 
+    #     start_date: Time.parse("2026-08-01T00:00:00Z"), 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     findings_escalated: 8, 
+    #     findings_escalated_false_positive: 2, 
+    #     findings_escalated_in_progress: 0, 
+    #     findings_ingested_guard_duty: 45, 
+    #     findings_ingested_security_hub: 120, 
+    #     findings_investigated: 60, 
+    #     findings_investigated_false_positive: 12, 
+    #     findings_investigated_in_progress: 40, 
+    #     findings_triaged: 165, 
+    #     findings_triaged_false_positive: 30, 
+    #     findings_true_positive: 6, 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_finding_metrics({
+    #     membership_id: "MembershipId", # required
+    #     start_date: Time.now, # required
+    #     end_date: Time.now, # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.findings_ingested_security_hub #=> Integer
+    #   resp.findings_ingested_guard_duty #=> Integer
+    #   resp.findings_triaged #=> Integer
+    #   resp.findings_triaged_false_positive #=> Integer
+    #   resp.findings_investigated #=> Integer
+    #   resp.findings_investigated_false_positive #=> Integer
+    #   resp.findings_escalated #=> Integer
+    #   resp.findings_escalated_false_positive #=> Integer
+    #   resp.findings_true_positive #=> Integer
+    #   resp.findings_investigated_in_progress #=> Integer
+    #   resp.findings_escalated_in_progress #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/security-ir-2018-05-10/GetFindingMetrics AWS API Documentation
+    #
+    # @overload get_finding_metrics(params = {})
+    # @param [Hash] params ({})
+    def get_finding_metrics(params = {}, options = {})
+      req = build_request(:get_finding_metrics, params)
+      req.send_request(options)
+    end
+
     # Returns the attributes of a membership.
     #
     # @option params [required, String] :membership_id
@@ -2385,7 +2465,7 @@ module Aws::SecurityIR
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-securityir'
-      context[:gem_version] = '1.28.0'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -74,6 +74,8 @@ module Aws::SecurityIR
     GetCaseAttachmentUploadUrlResponse = Shapes::StructureShape.new(name: 'GetCaseAttachmentUploadUrlResponse')
     GetCaseRequest = Shapes::StructureShape.new(name: 'GetCaseRequest')
     GetCaseResponse = Shapes::StructureShape.new(name: 'GetCaseResponse')
+    GetFindingMetricsRequest = Shapes::StructureShape.new(name: 'GetFindingMetricsRequest')
+    GetFindingMetricsResponse = Shapes::StructureShape.new(name: 'GetFindingMetricsResponse')
     GetMembershipAccountDetailError = Shapes::StructureShape.new(name: 'GetMembershipAccountDetailError')
     GetMembershipAccountDetailErrors = Shapes::ListShape.new(name: 'GetMembershipAccountDetailErrors')
     GetMembershipAccountDetailItem = Shapes::StructureShape.new(name: 'GetMembershipAccountDetailItem')
@@ -319,6 +321,24 @@ module Aws::SecurityIR
     GetCaseResponse.add_member(:case_metadata, Shapes::ShapeRef.new(shape: CaseMetadata, location_name: "caseMetadata"))
     GetCaseResponse.struct_class = Types::GetCaseResponse
 
+    GetFindingMetricsRequest.add_member(:membership_id, Shapes::ShapeRef.new(shape: MembershipId, required: true, location: "uri", location_name: "membershipId"))
+    GetFindingMetricsRequest.add_member(:start_date, Shapes::ShapeRef.new(shape: Timestamp, required: true, location: "querystring", location_name: "startDate"))
+    GetFindingMetricsRequest.add_member(:end_date, Shapes::ShapeRef.new(shape: Timestamp, required: true, location: "querystring", location_name: "endDate"))
+    GetFindingMetricsRequest.struct_class = Types::GetFindingMetricsRequest
+
+    GetFindingMetricsResponse.add_member(:findings_ingested_security_hub, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsIngestedSecurityHub"))
+    GetFindingMetricsResponse.add_member(:findings_ingested_guard_duty, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsIngestedGuardDuty"))
+    GetFindingMetricsResponse.add_member(:findings_triaged, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsTriaged"))
+    GetFindingMetricsResponse.add_member(:findings_triaged_false_positive, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsTriagedFalsePositive"))
+    GetFindingMetricsResponse.add_member(:findings_investigated, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsInvestigated"))
+    GetFindingMetricsResponse.add_member(:findings_investigated_false_positive, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsInvestigatedFalsePositive"))
+    GetFindingMetricsResponse.add_member(:findings_escalated, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsEscalated"))
+    GetFindingMetricsResponse.add_member(:findings_escalated_false_positive, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsEscalatedFalsePositive"))
+    GetFindingMetricsResponse.add_member(:findings_true_positive, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsTruePositive"))
+    GetFindingMetricsResponse.add_member(:findings_investigated_in_progress, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsInvestigatedInProgress"))
+    GetFindingMetricsResponse.add_member(:findings_escalated_in_progress, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "findingsEscalatedInProgress"))
+    GetFindingMetricsResponse.struct_class = Types::GetFindingMetricsResponse
+
     GetMembershipAccountDetailError.add_member(:account_id, Shapes::ShapeRef.new(shape: AWSAccountId, required: true, location_name: "accountId"))
     GetMembershipAccountDetailError.add_member(:error, Shapes::ShapeRef.new(shape: String, required: true, location_name: "error"))
     GetMembershipAccountDetailError.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -793,6 +813,23 @@ module Aws::SecurityIR
         o.errors << Shapes::ShapeRef.new(shape: InvalidTokenException)
       end)
 
+      api.add_operation(:get_finding_metrics, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetFindingMetrics"
+        o.http_method = "GET"
+        o.http_request_uri = "/v1/membership/{membershipId}/finding-metrics"
+        o.input = Shapes::ShapeRef.new(shape: GetFindingMetricsRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetFindingMetricsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: SecurityIncidentResponseNotActiveException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidTokenException)
+      end)
+
       api.add_operation(:get_membership, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetMembership"
         o.http_method = "GET"

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

@@ -678,6 +678,101 @@ module Aws::SecurityIR
       include Aws::Structure
     end
 
+    # @!attribute [rw] membership_id
+    #   The membership ID to retrieve metrics for.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_date
+    #   The start of the day-aligned UTC window, inclusive.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_date
+    #   The end of the day-aligned UTC window, inclusive.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/security-ir-2018-05-10/GetFindingMetricsRequest AWS API Documentation
+    #
+    class GetFindingMetricsRequest < Struct.new(
+      :membership_id,
+      :start_date,
+      :end_date)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Finding-lifecycle metrics for a membership over the requested date
+    # range.
+    #
+    # @!attribute [rw] findings_ingested_security_hub
+    #   The number of findings ingested from AWS Security Hub during the
+    #   requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_ingested_guard_duty
+    #   The number of findings ingested from Amazon GuardDuty during the
+    #   requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_triaged
+    #   The number of findings triaged during the requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_triaged_false_positive
+    #   The number of triaged findings that were closed as false positives
+    #   during the requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_investigated
+    #   The number of findings investigated during the requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_investigated_false_positive
+    #   The number of investigated findings that were closed as false
+    #   positives during the requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_escalated
+    #   The number of findings escalated during the requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_escalated_false_positive
+    #   The number of escalated findings that were closed as false positives
+    #   during the requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_true_positive
+    #   The number of findings confirmed as true positives during the
+    #   requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_investigated_in_progress
+    #   The number of findings whose investigation was in progress during
+    #   the requested date range.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] findings_escalated_in_progress
+    #   The number of findings whose escalation was in progress during the
+    #   requested date range.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/security-ir-2018-05-10/GetFindingMetricsResponse AWS API Documentation
+    #
+    class GetFindingMetricsResponse < Struct.new(
+      :findings_ingested_security_hub,
+      :findings_ingested_guard_duty,
+      :findings_triaged,
+      :findings_triaged_false_positive,
+      :findings_investigated,
+      :findings_investigated_false_positive,
+      :findings_escalated,
+      :findings_escalated_false_positive,
+      :findings_true_positive,
+      :findings_investigated_in_progress,
+      :findings_escalated_in_progress)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] account_id
     #   @return [String]
     #

data/lib/aws-sdk-securityir.rb

@@ -55,7 +55,7 @@ module Aws::SecurityIR
   autoload :EndpointProvider, 'aws-sdk-securityir/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-securityir/endpoints'
 
-  GEM_VERSION = '1.28.0'
+  GEM_VERSION = '1.29.0'
 
 end
 

data/sig/client.rbs

@@ -239,6 +239,28 @@ module Aws
                                           ) -> _GetCaseAttachmentUploadUrlResponseSuccess
                                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetCaseAttachmentUploadUrlResponseSuccess
 
+      interface _GetFindingMetricsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetFindingMetricsResponse]
+        def findings_ingested_security_hub: () -> ::Integer
+        def findings_ingested_guard_duty: () -> ::Integer
+        def findings_triaged: () -> ::Integer
+        def findings_triaged_false_positive: () -> ::Integer
+        def findings_investigated: () -> ::Integer
+        def findings_investigated_false_positive: () -> ::Integer
+        def findings_escalated: () -> ::Integer
+        def findings_escalated_false_positive: () -> ::Integer
+        def findings_true_positive: () -> ::Integer
+        def findings_investigated_in_progress: () -> ::Integer
+        def findings_escalated_in_progress: () -> ::Integer
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SecurityIR/Client.html#get_finding_metrics-instance_method
+      def get_finding_metrics: (
+                                 membership_id: ::String,
+                                 start_date: ::Time,
+                                 end_date: ::Time
+                               ) -> _GetFindingMetricsResponseSuccess
+                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetFindingMetricsResponseSuccess
+
       interface _GetMembershipResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetMembershipResponse]
         def membership_id: () -> ::String

data/sig/types.rbs

@@ -177,6 +177,28 @@ module Aws::SecurityIR
       SENSITIVE: [:title, :description]
     end
 
+    class GetFindingMetricsRequest
+      attr_accessor membership_id: ::String
+      attr_accessor start_date: ::Time
+      attr_accessor end_date: ::Time
+      SENSITIVE: []
+    end
+
+    class GetFindingMetricsResponse
+      attr_accessor findings_ingested_security_hub: ::Integer
+      attr_accessor findings_ingested_guard_duty: ::Integer
+      attr_accessor findings_triaged: ::Integer
+      attr_accessor findings_triaged_false_positive: ::Integer
+      attr_accessor findings_investigated: ::Integer
+      attr_accessor findings_investigated_false_positive: ::Integer
+      attr_accessor findings_escalated: ::Integer
+      attr_accessor findings_escalated_false_positive: ::Integer
+      attr_accessor findings_true_positive: ::Integer
+      attr_accessor findings_investigated_in_progress: ::Integer
+      attr_accessor findings_escalated_in_progress: ::Integer
+      SENSITIVE: []
+    end
+
     class GetMembershipAccountDetailError
       attr_accessor account_id: ::String
       attr_accessor error: ::String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-securityir
 version: !ruby/object:Gem::Version
-  version: 1.28.0
+  version: 1.29.0
 platform: ruby
 authors:
 - Amazon Web Services