aws-sdk-securityhub 1.144.0 → 1.146.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-securityhub/client.rb +277 -61
- data/lib/aws-sdk-securityhub/client_api.rb +164 -1
- data/lib/aws-sdk-securityhub/endpoint_parameters.rb +4 -4
- data/lib/aws-sdk-securityhub/types.rb +460 -5
- data/lib/aws-sdk-securityhub.rb +1 -1
- data/sig/client.rbs +130 -26
- data/sig/types.rbs +129 -11
- metadata +1 -1
|
@@ -2139,7 +2139,7 @@ module Aws::SecurityHub
|
|
|
2139
2139
|
# permission to perform the `securityhub:BatchUpdateFindings` action.
|
|
2140
2140
|
# Updates from `BatchUpdateFindingsV2` don't affect the value of
|
|
2141
2141
|
# f`inding_info.modified_time`, `finding_info.modified_time_dt`, `time`,
|
|
2142
|
-
# `time_dt for a finding`. This API is in
|
|
2142
|
+
# `time_dt for a finding`. This API is in public preview and subject to
|
|
2143
2143
|
# change.
|
|
2144
2144
|
#
|
|
2145
2145
|
# @option params [Array<String>] :metadata_uids
|
|
@@ -2299,7 +2299,7 @@ module Aws::SecurityHub
|
|
|
2299
2299
|
end
|
|
2300
2300
|
|
|
2301
2301
|
# Grants permission to complete the authorization based on input
|
|
2302
|
-
# parameters. This API is in preview
|
|
2302
|
+
# parameters. This API is in public preview and subject to change.
|
|
2303
2303
|
#
|
|
2304
2304
|
# @option params [required, String] :auth_code
|
|
2305
2305
|
# The authCode retrieved from authUrl to complete the OAuth 2.0
|
|
@@ -2393,7 +2393,7 @@ module Aws::SecurityHub
|
|
|
2393
2393
|
end
|
|
2394
2394
|
|
|
2395
2395
|
# Enables aggregation across Amazon Web Services Regions. This API is in
|
|
2396
|
-
#
|
|
2396
|
+
# public preview and subject to change.
|
|
2397
2397
|
#
|
|
2398
2398
|
# @option params [required, String] :region_linking_mode
|
|
2399
2399
|
# Determines how Regions are linked to an Aggregator V2.
|
|
@@ -2878,7 +2878,7 @@ module Aws::SecurityHub
|
|
|
2878
2878
|
req.send_request(options)
|
|
2879
2879
|
end
|
|
2880
2880
|
|
|
2881
|
-
# Creates a V2 automation rule. This API is in
|
|
2881
|
+
# Creates a V2 automation rule. This API is in public preview and
|
|
2882
2882
|
# subject to change.
|
|
2883
2883
|
#
|
|
2884
2884
|
# @option params [required, String] :rule_name
|
|
@@ -2926,7 +2926,7 @@ module Aws::SecurityHub
|
|
|
2926
2926
|
# {
|
|
2927
2927
|
# string_filters: [
|
|
2928
2928
|
# {
|
|
2929
|
-
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name
|
|
2929
|
+
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name, databucket.encryption_details.algorithm, databucket.encryption_details.key_uid, databucket.file.data_classifications.classifier_details.type, evidences.actor.user.account.uid, evidences.api.operation, evidences.api.response.error_message, evidences.api.service.name, evidences.connection_info.direction, evidences.connection_info.protocol_name, evidences.dst_endpoint.autonomous_system.name, evidences.dst_endpoint.location.city, evidences.dst_endpoint.location.country, evidences.src_endpoint.autonomous_system.name, evidences.src_endpoint.hostname, evidences.src_endpoint.location.city, evidences.src_endpoint.location.country, finding_info.analytic.name, malware.name, malware_scan_info.uid, malware.severity, resources.cloud_function.layers.uid_alt, resources.cloud_function.runtime, resources.cloud_function.user.uid, resources.device.encryption_details.key_uid, resources.device.image.uid, resources.image.architecture, resources.image.registry_uid, resources.image.repository_name, resources.image.uid, resources.subnet_info.uid, resources.vpc_uid, vulnerabilities.affected_code.file.path, vulnerabilities.affected_packages.name, vulnerabilities.cve.epss.score, vulnerabilities.cve.uid, vulnerabilities.related_vulnerabilities, cloud.account.name
|
|
2930
2930
|
# filter: {
|
|
2931
2931
|
# value: "NonEmptyString",
|
|
2932
2932
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
@@ -2935,7 +2935,7 @@ module Aws::SecurityHub
|
|
|
2935
2935
|
# ],
|
|
2936
2936
|
# date_filters: [
|
|
2937
2937
|
# {
|
|
2938
|
-
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt
|
|
2938
|
+
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt, resources.image.created_time_dt, resources.image.last_used_time_dt, resources.modified_time_dt
|
|
2939
2939
|
# filter: {
|
|
2940
2940
|
# start: "NonEmptyString",
|
|
2941
2941
|
# end: "NonEmptyString",
|
|
@@ -2956,7 +2956,7 @@ module Aws::SecurityHub
|
|
|
2956
2956
|
# ],
|
|
2957
2957
|
# number_filters: [
|
|
2958
2958
|
# {
|
|
2959
|
-
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count
|
|
2959
|
+
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count, evidences.api.response.code, evidences.dst_endpoint.autonomous_system.number, evidences.dst_endpoint.port, evidences.src_endpoint.autonomous_system.number, evidences.src_endpoint.port, resources.image.in_use_count
|
|
2960
2960
|
# filter: {
|
|
2961
2961
|
# gte: 1.0,
|
|
2962
2962
|
# lte: 1.0,
|
|
@@ -2968,7 +2968,7 @@ module Aws::SecurityHub
|
|
|
2968
2968
|
# ],
|
|
2969
2969
|
# map_filters: [
|
|
2970
2970
|
# {
|
|
2971
|
-
# field_name: "resources.tags", # accepts resources.tags
|
|
2971
|
+
# field_name: "resources.tags", # accepts resources.tags, compliance.control_parameters, databucket.tags, finding_info.tags
|
|
2972
2972
|
# filter: {
|
|
2973
2973
|
# key: "NonEmptyString",
|
|
2974
2974
|
# value: "NonEmptyString",
|
|
@@ -2976,6 +2976,17 @@ module Aws::SecurityHub
|
|
|
2976
2976
|
# },
|
|
2977
2977
|
# },
|
|
2978
2978
|
# ],
|
|
2979
|
+
# ip_filters: [
|
|
2980
|
+
# {
|
|
2981
|
+
# field_name: "evidences.dst_endpoint.ip", # accepts evidences.dst_endpoint.ip, evidences.src_endpoint.ip
|
|
2982
|
+
# filter: {
|
|
2983
|
+
# cidr: "NonEmptyString",
|
|
2984
|
+
# },
|
|
2985
|
+
# },
|
|
2986
|
+
# ],
|
|
2987
|
+
# nested_composite_filters: {
|
|
2988
|
+
# # recursive CompositeFilterList
|
|
2989
|
+
# },
|
|
2979
2990
|
# operator: "AND", # accepts AND, OR
|
|
2980
2991
|
# },
|
|
2981
2992
|
# ],
|
|
@@ -3211,7 +3222,7 @@ module Aws::SecurityHub
|
|
|
3211
3222
|
end
|
|
3212
3223
|
|
|
3213
3224
|
# Grants permission to create a connectorV2 based on input parameters.
|
|
3214
|
-
# This API is in preview
|
|
3225
|
+
# This API is in public preview and subject to change.
|
|
3215
3226
|
#
|
|
3216
3227
|
# @option params [required, String] :name
|
|
3217
3228
|
# The unique name of the connectorV2.
|
|
@@ -4269,7 +4280,7 @@ module Aws::SecurityHub
|
|
|
4269
4280
|
|
|
4270
4281
|
# Grants permission to create a ticket in the chosen ITSM based on
|
|
4271
4282
|
# finding information for the provided finding metadata UID. This API is
|
|
4272
|
-
# in preview
|
|
4283
|
+
# in public preview and subject to change.
|
|
4273
4284
|
#
|
|
4274
4285
|
# @option params [required, String] :connector_id
|
|
4275
4286
|
# The UUID of the connectorV2 to identify connectorV2 resource.
|
|
@@ -4426,7 +4437,7 @@ module Aws::SecurityHub
|
|
|
4426
4437
|
req.send_request(options)
|
|
4427
4438
|
end
|
|
4428
4439
|
|
|
4429
|
-
# Deletes the Aggregator V2. This API is in
|
|
4440
|
+
# Deletes the Aggregator V2. This API is in public preview and subject
|
|
4430
4441
|
# to change.
|
|
4431
4442
|
#
|
|
4432
4443
|
# @option params [required, String] :aggregator_v2_arn
|
|
@@ -4449,7 +4460,7 @@ module Aws::SecurityHub
|
|
|
4449
4460
|
req.send_request(options)
|
|
4450
4461
|
end
|
|
4451
4462
|
|
|
4452
|
-
# Deletes a V2 automation rule. This API is in
|
|
4463
|
+
# Deletes a V2 automation rule. This API is in public preview and
|
|
4453
4464
|
# subject to change.
|
|
4454
4465
|
#
|
|
4455
4466
|
# @option params [required, String] :identifier
|
|
@@ -4508,8 +4519,8 @@ module Aws::SecurityHub
|
|
|
4508
4519
|
req.send_request(options)
|
|
4509
4520
|
end
|
|
4510
4521
|
|
|
4511
|
-
# Grants permission to delete a connectorV2. This API is in
|
|
4512
|
-
#
|
|
4522
|
+
# Grants permission to delete a connectorV2. This API is in public
|
|
4523
|
+
# preview and subject to change.
|
|
4513
4524
|
#
|
|
4514
4525
|
# @option params [required, String] :connector_id
|
|
4515
4526
|
# The UUID of the connectorV2 to identify connectorV2 resource.
|
|
@@ -5015,7 +5026,7 @@ module Aws::SecurityHub
|
|
|
5015
5026
|
req.send_request(options)
|
|
5016
5027
|
end
|
|
5017
5028
|
|
|
5018
|
-
# Gets information about the product integration. This API is in
|
|
5029
|
+
# Gets information about the product integration. This API is in public
|
|
5019
5030
|
# preview and subject to change.
|
|
5020
5031
|
#
|
|
5021
5032
|
# @option params [String] :next_token
|
|
@@ -5065,7 +5076,7 @@ module Aws::SecurityHub
|
|
|
5065
5076
|
end
|
|
5066
5077
|
|
|
5067
5078
|
# Returns details about the service resource in your account. This API
|
|
5068
|
-
# is in
|
|
5079
|
+
# is in public preview and subject to change.
|
|
5069
5080
|
#
|
|
5070
5081
|
# @return [Types::DescribeSecurityHubV2Response] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
5071
5082
|
#
|
|
@@ -5394,7 +5405,7 @@ module Aws::SecurityHub
|
|
|
5394
5405
|
end
|
|
5395
5406
|
|
|
5396
5407
|
# Disable the service for the current Amazon Web Services Region or
|
|
5397
|
-
# specified Amazon Web Services Region. This API is in
|
|
5408
|
+
# specified Amazon Web Services Region. This API is in public preview
|
|
5398
5409
|
# and subject to change.
|
|
5399
5410
|
#
|
|
5400
5411
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
@@ -5692,7 +5703,7 @@ module Aws::SecurityHub
|
|
|
5692
5703
|
end
|
|
5693
5704
|
|
|
5694
5705
|
# Enables the service in account for the current Amazon Web Services
|
|
5695
|
-
# Region or specified Amazon Web Services Region. This API is in
|
|
5706
|
+
# Region or specified Amazon Web Services Region. This API is in public
|
|
5696
5707
|
# preview and subject to change.
|
|
5697
5708
|
#
|
|
5698
5709
|
# @option params [Hash<String,String>] :tags
|
|
@@ -5768,7 +5779,7 @@ module Aws::SecurityHub
|
|
|
5768
5779
|
end
|
|
5769
5780
|
|
|
5770
5781
|
# Returns the configuration of the specified Aggregator V2. This API is
|
|
5771
|
-
# in
|
|
5782
|
+
# in public preview and subject to change.
|
|
5772
5783
|
#
|
|
5773
5784
|
# @option params [required, String] :aggregator_v2_arn
|
|
5774
5785
|
# The ARN of the Aggregator V2.
|
|
@@ -5803,7 +5814,7 @@ module Aws::SecurityHub
|
|
|
5803
5814
|
req.send_request(options)
|
|
5804
5815
|
end
|
|
5805
5816
|
|
|
5806
|
-
# Returns an automation rule for the V2 service. This API is in
|
|
5817
|
+
# Returns an automation rule for the V2 service. This API is in public
|
|
5807
5818
|
# preview and subject to change.
|
|
5808
5819
|
#
|
|
5809
5820
|
# @option params [required, String] :identifier
|
|
@@ -5838,11 +5849,11 @@ module Aws::SecurityHub
|
|
|
5838
5849
|
# resp.description #=> String
|
|
5839
5850
|
# resp.criteria.ocsf_finding_criteria.composite_filters #=> Array
|
|
5840
5851
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].string_filters #=> Array
|
|
5841
|
-
# resp.criteria.ocsf_finding_criteria.composite_filters[0].string_filters[0].field_name #=> String, one of "metadata.uid", "activity_name", "cloud.account.uid", "cloud.provider", "cloud.region", "compliance.assessments.category", "compliance.assessments.name", "compliance.control", "compliance.status", "compliance.standards", "finding_info.desc", "finding_info.src_url", "finding_info.title", "finding_info.types", "finding_info.uid", "finding_info.related_events.uid", "finding_info.related_events.product.uid", "finding_info.related_events.title", "metadata.product.name", "metadata.product.uid", "metadata.product.vendor_name", "remediation.desc", "remediation.references", "resources.cloud_partition", "resources.region", "resources.type", "resources.uid", "severity", "status", "comment", "vulnerabilities.fix_coverage", "class_name"
|
|
5852
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].string_filters[0].field_name #=> String, one of "metadata.uid", "activity_name", "cloud.account.uid", "cloud.provider", "cloud.region", "compliance.assessments.category", "compliance.assessments.name", "compliance.control", "compliance.status", "compliance.standards", "finding_info.desc", "finding_info.src_url", "finding_info.title", "finding_info.types", "finding_info.uid", "finding_info.related_events.uid", "finding_info.related_events.product.uid", "finding_info.related_events.title", "metadata.product.name", "metadata.product.uid", "metadata.product.vendor_name", "remediation.desc", "remediation.references", "resources.cloud_partition", "resources.region", "resources.type", "resources.uid", "severity", "status", "comment", "vulnerabilities.fix_coverage", "class_name", "databucket.encryption_details.algorithm", "databucket.encryption_details.key_uid", "databucket.file.data_classifications.classifier_details.type", "evidences.actor.user.account.uid", "evidences.api.operation", "evidences.api.response.error_message", "evidences.api.service.name", "evidences.connection_info.direction", "evidences.connection_info.protocol_name", "evidences.dst_endpoint.autonomous_system.name", "evidences.dst_endpoint.location.city", "evidences.dst_endpoint.location.country", "evidences.src_endpoint.autonomous_system.name", "evidences.src_endpoint.hostname", "evidences.src_endpoint.location.city", "evidences.src_endpoint.location.country", "finding_info.analytic.name", "malware.name", "malware_scan_info.uid", "malware.severity", "resources.cloud_function.layers.uid_alt", "resources.cloud_function.runtime", "resources.cloud_function.user.uid", "resources.device.encryption_details.key_uid", "resources.device.image.uid", "resources.image.architecture", "resources.image.registry_uid", "resources.image.repository_name", "resources.image.uid", "resources.subnet_info.uid", "resources.vpc_uid", "vulnerabilities.affected_code.file.path", "vulnerabilities.affected_packages.name", "vulnerabilities.cve.epss.score", "vulnerabilities.cve.uid", "vulnerabilities.related_vulnerabilities", "cloud.account.name"
|
|
5842
5853
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].string_filters[0].filter.value #=> String
|
|
5843
5854
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].string_filters[0].filter.comparison #=> String, one of "EQUALS", "PREFIX", "NOT_EQUALS", "PREFIX_NOT_EQUALS", "CONTAINS", "NOT_CONTAINS", "CONTAINS_WORD"
|
|
5844
5855
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].date_filters #=> Array
|
|
5845
|
-
# resp.criteria.ocsf_finding_criteria.composite_filters[0].date_filters[0].field_name #=> String, one of "finding_info.created_time_dt", "finding_info.first_seen_time_dt", "finding_info.last_seen_time_dt", "finding_info.modified_time_dt"
|
|
5856
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].date_filters[0].field_name #=> String, one of "finding_info.created_time_dt", "finding_info.first_seen_time_dt", "finding_info.last_seen_time_dt", "finding_info.modified_time_dt", "resources.image.created_time_dt", "resources.image.last_used_time_dt", "resources.modified_time_dt"
|
|
5846
5857
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].date_filters[0].filter.start #=> String
|
|
5847
5858
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].date_filters[0].filter.end #=> String
|
|
5848
5859
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].date_filters[0].filter.date_range.value #=> Integer
|
|
@@ -5851,17 +5862,21 @@ module Aws::SecurityHub
|
|
|
5851
5862
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].boolean_filters[0].field_name #=> String, one of "compliance.assessments.meets_criteria", "vulnerabilities.is_exploit_available", "vulnerabilities.is_fix_available"
|
|
5852
5863
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].boolean_filters[0].filter.value #=> Boolean
|
|
5853
5864
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters #=> Array
|
|
5854
|
-
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters[0].field_name #=> String, one of "activity_id", "compliance.status_id", "confidence_score", "severity_id", "status_id", "finding_info.related_events_count"
|
|
5865
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters[0].field_name #=> String, one of "activity_id", "compliance.status_id", "confidence_score", "severity_id", "status_id", "finding_info.related_events_count", "evidences.api.response.code", "evidences.dst_endpoint.autonomous_system.number", "evidences.dst_endpoint.port", "evidences.src_endpoint.autonomous_system.number", "evidences.src_endpoint.port", "resources.image.in_use_count"
|
|
5855
5866
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters[0].filter.gte #=> Float
|
|
5856
5867
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters[0].filter.lte #=> Float
|
|
5857
5868
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters[0].filter.eq #=> Float
|
|
5858
5869
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters[0].filter.gt #=> Float
|
|
5859
5870
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].number_filters[0].filter.lt #=> Float
|
|
5860
5871
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].map_filters #=> Array
|
|
5861
|
-
# resp.criteria.ocsf_finding_criteria.composite_filters[0].map_filters[0].field_name #=> String, one of "resources.tags"
|
|
5872
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].map_filters[0].field_name #=> String, one of "resources.tags", "compliance.control_parameters", "databucket.tags", "finding_info.tags"
|
|
5862
5873
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].map_filters[0].filter.key #=> String
|
|
5863
5874
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].map_filters[0].filter.value #=> String
|
|
5864
5875
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].map_filters[0].filter.comparison #=> String, one of "EQUALS", "NOT_EQUALS", "CONTAINS", "NOT_CONTAINS"
|
|
5876
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].ip_filters #=> Array
|
|
5877
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].ip_filters[0].field_name #=> String, one of "evidences.dst_endpoint.ip", "evidences.src_endpoint.ip"
|
|
5878
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].ip_filters[0].filter.cidr #=> String
|
|
5879
|
+
# resp.criteria.ocsf_finding_criteria.composite_filters[0].nested_composite_filters #=> Types::CompositeFilterList
|
|
5865
5880
|
# resp.criteria.ocsf_finding_criteria.composite_filters[0].operator #=> String, one of "AND", "OR"
|
|
5866
5881
|
# resp.criteria.ocsf_finding_criteria.composite_operator #=> String, one of "AND", "OR"
|
|
5867
5882
|
# resp.actions #=> Array
|
|
@@ -6065,7 +6080,7 @@ module Aws::SecurityHub
|
|
|
6065
6080
|
end
|
|
6066
6081
|
|
|
6067
6082
|
# Grants permission to retrieve details for a connectorV2 based on
|
|
6068
|
-
# connector id. This API is in preview
|
|
6083
|
+
# connector id. This API is in public preview and subject to change.
|
|
6069
6084
|
#
|
|
6070
6085
|
# @option params [required, String] :connector_id
|
|
6071
6086
|
# The UUID of the connectorV2 to identify connectorV2 resource.
|
|
@@ -6423,7 +6438,7 @@ module Aws::SecurityHub
|
|
|
6423
6438
|
# Returns aggregated statistical data about findings.
|
|
6424
6439
|
# `GetFindingStatisticsV2` use `securityhub:GetAdhocInsightResults` in
|
|
6425
6440
|
# the `Action` element of an IAM policy statement. You must have
|
|
6426
|
-
# permission to perform the `s` action. This API is in
|
|
6441
|
+
# permission to perform the `s` action. This API is in public preview
|
|
6427
6442
|
# and subject to change.
|
|
6428
6443
|
#
|
|
6429
6444
|
# @option params [required, Array<Types::GroupByRule>] :group_by_rules
|
|
@@ -6452,7 +6467,7 @@ module Aws::SecurityHub
|
|
|
6452
6467
|
# {
|
|
6453
6468
|
# string_filters: [
|
|
6454
6469
|
# {
|
|
6455
|
-
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name
|
|
6470
|
+
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name, databucket.encryption_details.algorithm, databucket.encryption_details.key_uid, databucket.file.data_classifications.classifier_details.type, evidences.actor.user.account.uid, evidences.api.operation, evidences.api.response.error_message, evidences.api.service.name, evidences.connection_info.direction, evidences.connection_info.protocol_name, evidences.dst_endpoint.autonomous_system.name, evidences.dst_endpoint.location.city, evidences.dst_endpoint.location.country, evidences.src_endpoint.autonomous_system.name, evidences.src_endpoint.hostname, evidences.src_endpoint.location.city, evidences.src_endpoint.location.country, finding_info.analytic.name, malware.name, malware_scan_info.uid, malware.severity, resources.cloud_function.layers.uid_alt, resources.cloud_function.runtime, resources.cloud_function.user.uid, resources.device.encryption_details.key_uid, resources.device.image.uid, resources.image.architecture, resources.image.registry_uid, resources.image.repository_name, resources.image.uid, resources.subnet_info.uid, resources.vpc_uid, vulnerabilities.affected_code.file.path, vulnerabilities.affected_packages.name, vulnerabilities.cve.epss.score, vulnerabilities.cve.uid, vulnerabilities.related_vulnerabilities, cloud.account.name
|
|
6456
6471
|
# filter: {
|
|
6457
6472
|
# value: "NonEmptyString",
|
|
6458
6473
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
@@ -6461,7 +6476,7 @@ module Aws::SecurityHub
|
|
|
6461
6476
|
# ],
|
|
6462
6477
|
# date_filters: [
|
|
6463
6478
|
# {
|
|
6464
|
-
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt
|
|
6479
|
+
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt, resources.image.created_time_dt, resources.image.last_used_time_dt, resources.modified_time_dt
|
|
6465
6480
|
# filter: {
|
|
6466
6481
|
# start: "NonEmptyString",
|
|
6467
6482
|
# end: "NonEmptyString",
|
|
@@ -6482,7 +6497,7 @@ module Aws::SecurityHub
|
|
|
6482
6497
|
# ],
|
|
6483
6498
|
# number_filters: [
|
|
6484
6499
|
# {
|
|
6485
|
-
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count
|
|
6500
|
+
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count, evidences.api.response.code, evidences.dst_endpoint.autonomous_system.number, evidences.dst_endpoint.port, evidences.src_endpoint.autonomous_system.number, evidences.src_endpoint.port, resources.image.in_use_count
|
|
6486
6501
|
# filter: {
|
|
6487
6502
|
# gte: 1.0,
|
|
6488
6503
|
# lte: 1.0,
|
|
@@ -6494,7 +6509,7 @@ module Aws::SecurityHub
|
|
|
6494
6509
|
# ],
|
|
6495
6510
|
# map_filters: [
|
|
6496
6511
|
# {
|
|
6497
|
-
# field_name: "resources.tags", # accepts resources.tags
|
|
6512
|
+
# field_name: "resources.tags", # accepts resources.tags, compliance.control_parameters, databucket.tags, finding_info.tags
|
|
6498
6513
|
# filter: {
|
|
6499
6514
|
# key: "NonEmptyString",
|
|
6500
6515
|
# value: "NonEmptyString",
|
|
@@ -6502,12 +6517,23 @@ module Aws::SecurityHub
|
|
|
6502
6517
|
# },
|
|
6503
6518
|
# },
|
|
6504
6519
|
# ],
|
|
6520
|
+
# ip_filters: [
|
|
6521
|
+
# {
|
|
6522
|
+
# field_name: "evidences.dst_endpoint.ip", # accepts evidences.dst_endpoint.ip, evidences.src_endpoint.ip
|
|
6523
|
+
# filter: {
|
|
6524
|
+
# cidr: "NonEmptyString",
|
|
6525
|
+
# },
|
|
6526
|
+
# },
|
|
6527
|
+
# ],
|
|
6528
|
+
# nested_composite_filters: {
|
|
6529
|
+
# # recursive CompositeFilterList
|
|
6530
|
+
# },
|
|
6505
6531
|
# operator: "AND", # accepts AND, OR
|
|
6506
6532
|
# },
|
|
6507
6533
|
# ],
|
|
6508
6534
|
# composite_operator: "AND", # accepts AND, OR
|
|
6509
6535
|
# },
|
|
6510
|
-
# group_by_field: "activity_name", # required, accepts activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.name, compliance.status, compliance.control, finding_info.title, finding_info.types, metadata.product.name, metadata.product.uid, resources.type, resources.uid, severity, status, vulnerabilities.fix_coverage, class_name
|
|
6536
|
+
# group_by_field: "activity_name", # required, accepts activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.name, compliance.status, compliance.control, finding_info.title, finding_info.types, metadata.product.name, metadata.product.uid, resources.type, resources.uid, severity, status, vulnerabilities.fix_coverage, class_name, vulnerabilities.affected_packages.name, finding_info.analytic.name, compliance.standards, cloud.account.name
|
|
6511
6537
|
# },
|
|
6512
6538
|
# ],
|
|
6513
6539
|
# sort_order: "asc", # accepts asc, desc
|
|
@@ -7396,11 +7422,95 @@ module Aws::SecurityHub
|
|
|
7396
7422
|
req.send_request(options)
|
|
7397
7423
|
end
|
|
7398
7424
|
|
|
7425
|
+
# Returns findings trend data based on the specified criteria. This
|
|
7426
|
+
# operation helps you analyze patterns and changes in findings over
|
|
7427
|
+
# time. This API is in public preview and subject to change.
|
|
7428
|
+
#
|
|
7429
|
+
# @option params [Types::FindingsTrendsFilters] :filters
|
|
7430
|
+
# The filters to apply to the findings trend data.
|
|
7431
|
+
#
|
|
7432
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :start_time
|
|
7433
|
+
# The starting timestamp for the time period to analyze findings trends,
|
|
7434
|
+
# in ISO 8601 format.
|
|
7435
|
+
#
|
|
7436
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :end_time
|
|
7437
|
+
# The ending timestamp for the time period to analyze findings trends,
|
|
7438
|
+
# in ISO 8601 format.
|
|
7439
|
+
#
|
|
7440
|
+
# @option params [String] :next_token
|
|
7441
|
+
# The token to use for paginating results. This value is returned in the
|
|
7442
|
+
# response if more results are available.
|
|
7443
|
+
#
|
|
7444
|
+
# @option params [Integer] :max_results
|
|
7445
|
+
# The maximum number of trend data points to return in a single
|
|
7446
|
+
# response.
|
|
7447
|
+
#
|
|
7448
|
+
# @return [Types::GetFindingsTrendsV2Response] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
7449
|
+
#
|
|
7450
|
+
# * {Types::GetFindingsTrendsV2Response#granularity #granularity} => String
|
|
7451
|
+
# * {Types::GetFindingsTrendsV2Response#trends_metrics #trends_metrics} => Array<Types::TrendsMetricsResult>
|
|
7452
|
+
# * {Types::GetFindingsTrendsV2Response#next_token #next_token} => String
|
|
7453
|
+
#
|
|
7454
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
|
7455
|
+
#
|
|
7456
|
+
# @example Request syntax with placeholder values
|
|
7457
|
+
#
|
|
7458
|
+
# resp = client.get_findings_trends_v2({
|
|
7459
|
+
# filters: {
|
|
7460
|
+
# composite_filters: [
|
|
7461
|
+
# {
|
|
7462
|
+
# string_filters: [
|
|
7463
|
+
# {
|
|
7464
|
+
# field_name: "account_id", # accepts account_id, region, finding_types, finding_status, finding_cve_ids, finding_compliance_status, finding_control_id, finding_class_name, finding_provider, finding_activity_name
|
|
7465
|
+
# filter: {
|
|
7466
|
+
# value: "NonEmptyString",
|
|
7467
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
7468
|
+
# },
|
|
7469
|
+
# },
|
|
7470
|
+
# ],
|
|
7471
|
+
# nested_composite_filters: {
|
|
7472
|
+
# # recursive FindingsTrendsCompositeFilterList
|
|
7473
|
+
# },
|
|
7474
|
+
# operator: "AND", # accepts AND, OR
|
|
7475
|
+
# },
|
|
7476
|
+
# ],
|
|
7477
|
+
# composite_operator: "AND", # accepts AND, OR
|
|
7478
|
+
# },
|
|
7479
|
+
# start_time: Time.now, # required
|
|
7480
|
+
# end_time: Time.now, # required
|
|
7481
|
+
# next_token: "NextToken",
|
|
7482
|
+
# max_results: 1,
|
|
7483
|
+
# })
|
|
7484
|
+
#
|
|
7485
|
+
# @example Response structure
|
|
7486
|
+
#
|
|
7487
|
+
# resp.granularity #=> String, one of "Daily", "Weekly", "Monthly"
|
|
7488
|
+
# resp.trends_metrics #=> Array
|
|
7489
|
+
# resp.trends_metrics[0].timestamp #=> Time
|
|
7490
|
+
# resp.trends_metrics[0].trends_values.severity_trends.unknown #=> Integer
|
|
7491
|
+
# resp.trends_metrics[0].trends_values.severity_trends.informational #=> Integer
|
|
7492
|
+
# resp.trends_metrics[0].trends_values.severity_trends.low #=> Integer
|
|
7493
|
+
# resp.trends_metrics[0].trends_values.severity_trends.medium #=> Integer
|
|
7494
|
+
# resp.trends_metrics[0].trends_values.severity_trends.high #=> Integer
|
|
7495
|
+
# resp.trends_metrics[0].trends_values.severity_trends.critical #=> Integer
|
|
7496
|
+
# resp.trends_metrics[0].trends_values.severity_trends.fatal #=> Integer
|
|
7497
|
+
# resp.trends_metrics[0].trends_values.severity_trends.other #=> Integer
|
|
7498
|
+
# resp.next_token #=> String
|
|
7499
|
+
#
|
|
7500
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetFindingsTrendsV2 AWS API Documentation
|
|
7501
|
+
#
|
|
7502
|
+
# @overload get_findings_trends_v2(params = {})
|
|
7503
|
+
# @param [Hash] params ({})
|
|
7504
|
+
def get_findings_trends_v2(params = {}, options = {})
|
|
7505
|
+
req = build_request(:get_findings_trends_v2, params)
|
|
7506
|
+
req.send_request(options)
|
|
7507
|
+
end
|
|
7508
|
+
|
|
7399
7509
|
# Return a list of findings that match the specified criteria.
|
|
7400
7510
|
# `GetFindings` and `GetFindingsV2` both use `securityhub:GetFindings`
|
|
7401
7511
|
# in the `Action` element of an IAM policy statement. You must have
|
|
7402
7512
|
# permission to perform the `securityhub:GetFindings` action. This API
|
|
7403
|
-
# is in
|
|
7513
|
+
# is in public preview and subject to change.
|
|
7404
7514
|
#
|
|
7405
7515
|
# @option params [Types::OcsfFindingFilters] :filters
|
|
7406
7516
|
# The finding attributes used to define a condition to filter the
|
|
@@ -7435,7 +7545,7 @@ module Aws::SecurityHub
|
|
|
7435
7545
|
# {
|
|
7436
7546
|
# string_filters: [
|
|
7437
7547
|
# {
|
|
7438
|
-
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name
|
|
7548
|
+
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name, databucket.encryption_details.algorithm, databucket.encryption_details.key_uid, databucket.file.data_classifications.classifier_details.type, evidences.actor.user.account.uid, evidences.api.operation, evidences.api.response.error_message, evidences.api.service.name, evidences.connection_info.direction, evidences.connection_info.protocol_name, evidences.dst_endpoint.autonomous_system.name, evidences.dst_endpoint.location.city, evidences.dst_endpoint.location.country, evidences.src_endpoint.autonomous_system.name, evidences.src_endpoint.hostname, evidences.src_endpoint.location.city, evidences.src_endpoint.location.country, finding_info.analytic.name, malware.name, malware_scan_info.uid, malware.severity, resources.cloud_function.layers.uid_alt, resources.cloud_function.runtime, resources.cloud_function.user.uid, resources.device.encryption_details.key_uid, resources.device.image.uid, resources.image.architecture, resources.image.registry_uid, resources.image.repository_name, resources.image.uid, resources.subnet_info.uid, resources.vpc_uid, vulnerabilities.affected_code.file.path, vulnerabilities.affected_packages.name, vulnerabilities.cve.epss.score, vulnerabilities.cve.uid, vulnerabilities.related_vulnerabilities, cloud.account.name
|
|
7439
7549
|
# filter: {
|
|
7440
7550
|
# value: "NonEmptyString",
|
|
7441
7551
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
@@ -7444,7 +7554,7 @@ module Aws::SecurityHub
|
|
|
7444
7554
|
# ],
|
|
7445
7555
|
# date_filters: [
|
|
7446
7556
|
# {
|
|
7447
|
-
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt
|
|
7557
|
+
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt, resources.image.created_time_dt, resources.image.last_used_time_dt, resources.modified_time_dt
|
|
7448
7558
|
# filter: {
|
|
7449
7559
|
# start: "NonEmptyString",
|
|
7450
7560
|
# end: "NonEmptyString",
|
|
@@ -7465,7 +7575,7 @@ module Aws::SecurityHub
|
|
|
7465
7575
|
# ],
|
|
7466
7576
|
# number_filters: [
|
|
7467
7577
|
# {
|
|
7468
|
-
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count
|
|
7578
|
+
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count, evidences.api.response.code, evidences.dst_endpoint.autonomous_system.number, evidences.dst_endpoint.port, evidences.src_endpoint.autonomous_system.number, evidences.src_endpoint.port, resources.image.in_use_count
|
|
7469
7579
|
# filter: {
|
|
7470
7580
|
# gte: 1.0,
|
|
7471
7581
|
# lte: 1.0,
|
|
@@ -7477,7 +7587,7 @@ module Aws::SecurityHub
|
|
|
7477
7587
|
# ],
|
|
7478
7588
|
# map_filters: [
|
|
7479
7589
|
# {
|
|
7480
|
-
# field_name: "resources.tags", # accepts resources.tags
|
|
7590
|
+
# field_name: "resources.tags", # accepts resources.tags, compliance.control_parameters, databucket.tags, finding_info.tags
|
|
7481
7591
|
# filter: {
|
|
7482
7592
|
# key: "NonEmptyString",
|
|
7483
7593
|
# value: "NonEmptyString",
|
|
@@ -7485,6 +7595,17 @@ module Aws::SecurityHub
|
|
|
7485
7595
|
# },
|
|
7486
7596
|
# },
|
|
7487
7597
|
# ],
|
|
7598
|
+
# ip_filters: [
|
|
7599
|
+
# {
|
|
7600
|
+
# field_name: "evidences.dst_endpoint.ip", # accepts evidences.dst_endpoint.ip, evidences.src_endpoint.ip
|
|
7601
|
+
# filter: {
|
|
7602
|
+
# cidr: "NonEmptyString",
|
|
7603
|
+
# },
|
|
7604
|
+
# },
|
|
7605
|
+
# ],
|
|
7606
|
+
# nested_composite_filters: {
|
|
7607
|
+
# # recursive CompositeFilterList
|
|
7608
|
+
# },
|
|
7488
7609
|
# operator: "AND", # accepts AND, OR
|
|
7489
7610
|
# },
|
|
7490
7611
|
# ],
|
|
@@ -8188,7 +8309,7 @@ module Aws::SecurityHub
|
|
|
8188
8309
|
end
|
|
8189
8310
|
|
|
8190
8311
|
# Retrieves statistical information about Amazon Web Services resources
|
|
8191
|
-
# and their associated security findings. This API is in
|
|
8312
|
+
# and their associated security findings. This API is in public preview
|
|
8192
8313
|
# and subject to change.
|
|
8193
8314
|
#
|
|
8194
8315
|
# @option params [required, Array<Types::ResourceGroupByRule>] :group_by_rules
|
|
@@ -8210,13 +8331,13 @@ module Aws::SecurityHub
|
|
|
8210
8331
|
# resp = client.get_resources_statistics_v2({
|
|
8211
8332
|
# group_by_rules: [ # required
|
|
8212
8333
|
# {
|
|
8213
|
-
# group_by_field: "
|
|
8334
|
+
# group_by_field: "AccountId", # required, accepts AccountId, Region, ResourceCategory, ResourceType, ResourceName, FindingsSummary.FindingType
|
|
8214
8335
|
# filters: {
|
|
8215
8336
|
# composite_filters: [
|
|
8216
8337
|
# {
|
|
8217
8338
|
# string_filters: [
|
|
8218
8339
|
# {
|
|
8219
|
-
# field_name: "
|
|
8340
|
+
# field_name: "ResourceGuid", # accepts ResourceGuid, ResourceId, AccountId, Region, ResourceCategory, ResourceType, ResourceName, FindingsSummary.FindingType, FindingsSummary.ProductName
|
|
8220
8341
|
# filter: {
|
|
8221
8342
|
# value: "NonEmptyString",
|
|
8222
8343
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
@@ -8225,7 +8346,7 @@ module Aws::SecurityHub
|
|
|
8225
8346
|
# ],
|
|
8226
8347
|
# date_filters: [
|
|
8227
8348
|
# {
|
|
8228
|
-
# field_name: "
|
|
8349
|
+
# field_name: "ResourceDetailCaptureTime", # accepts ResourceDetailCaptureTime, ResourceCreationTime
|
|
8229
8350
|
# filter: {
|
|
8230
8351
|
# start: "NonEmptyString",
|
|
8231
8352
|
# end: "NonEmptyString",
|
|
@@ -8238,7 +8359,7 @@ module Aws::SecurityHub
|
|
|
8238
8359
|
# ],
|
|
8239
8360
|
# number_filters: [
|
|
8240
8361
|
# {
|
|
8241
|
-
# field_name: "
|
|
8362
|
+
# field_name: "FindingsSummary.TotalFindings", # accepts FindingsSummary.TotalFindings, FindingsSummary.Severities.Other, FindingsSummary.Severities.Fatal, FindingsSummary.Severities.Critical, FindingsSummary.Severities.High, FindingsSummary.Severities.Medium, FindingsSummary.Severities.Low, FindingsSummary.Severities.Informational, FindingsSummary.Severities.Unknown
|
|
8242
8363
|
# filter: {
|
|
8243
8364
|
# gte: 1.0,
|
|
8244
8365
|
# lte: 1.0,
|
|
@@ -8250,7 +8371,7 @@ module Aws::SecurityHub
|
|
|
8250
8371
|
# ],
|
|
8251
8372
|
# map_filters: [
|
|
8252
8373
|
# {
|
|
8253
|
-
# field_name: "
|
|
8374
|
+
# field_name: "ResourceTags", # accepts ResourceTags
|
|
8254
8375
|
# filter: {
|
|
8255
8376
|
# key: "NonEmptyString",
|
|
8256
8377
|
# value: "NonEmptyString",
|
|
@@ -8258,6 +8379,9 @@ module Aws::SecurityHub
|
|
|
8258
8379
|
# },
|
|
8259
8380
|
# },
|
|
8260
8381
|
# ],
|
|
8382
|
+
# nested_composite_filters: {
|
|
8383
|
+
# # recursive ResourcesCompositeFilterList
|
|
8384
|
+
# },
|
|
8261
8385
|
# operator: "AND", # accepts AND, OR
|
|
8262
8386
|
# },
|
|
8263
8387
|
# ],
|
|
@@ -8286,8 +8410,86 @@ module Aws::SecurityHub
|
|
|
8286
8410
|
req.send_request(options)
|
|
8287
8411
|
end
|
|
8288
8412
|
|
|
8289
|
-
# Returns
|
|
8290
|
-
#
|
|
8413
|
+
# Returns resource trend data based on the specified criteria. This
|
|
8414
|
+
# operation helps you analyze patterns and changes in resource
|
|
8415
|
+
# compliance over time. This API is in public preview and subject to
|
|
8416
|
+
# change.
|
|
8417
|
+
#
|
|
8418
|
+
# @option params [Types::ResourcesTrendsFilters] :filters
|
|
8419
|
+
# The filters to apply to the resources trend data.
|
|
8420
|
+
#
|
|
8421
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :start_time
|
|
8422
|
+
# The starting timestamp for the time period to analyze resources
|
|
8423
|
+
# trends, in ISO 8601 format.
|
|
8424
|
+
#
|
|
8425
|
+
# @option params [required, Time,DateTime,Date,Integer,String] :end_time
|
|
8426
|
+
# The ending timestamp for the time period to analyze resources trends,
|
|
8427
|
+
# in ISO 8601 format.
|
|
8428
|
+
#
|
|
8429
|
+
# @option params [String] :next_token
|
|
8430
|
+
# The token to use for paginating results. This value is returned in the
|
|
8431
|
+
# response if more results are available.
|
|
8432
|
+
#
|
|
8433
|
+
# @option params [Integer] :max_results
|
|
8434
|
+
# The maximum number of trend data points to return in a single
|
|
8435
|
+
# response.
|
|
8436
|
+
#
|
|
8437
|
+
# @return [Types::GetResourcesTrendsV2Response] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
8438
|
+
#
|
|
8439
|
+
# * {Types::GetResourcesTrendsV2Response#granularity #granularity} => String
|
|
8440
|
+
# * {Types::GetResourcesTrendsV2Response#trends_metrics #trends_metrics} => Array<Types::ResourcesTrendsMetricsResult>
|
|
8441
|
+
# * {Types::GetResourcesTrendsV2Response#next_token #next_token} => String
|
|
8442
|
+
#
|
|
8443
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
|
8444
|
+
#
|
|
8445
|
+
# @example Request syntax with placeholder values
|
|
8446
|
+
#
|
|
8447
|
+
# resp = client.get_resources_trends_v2({
|
|
8448
|
+
# filters: {
|
|
8449
|
+
# composite_filters: [
|
|
8450
|
+
# {
|
|
8451
|
+
# string_filters: [
|
|
8452
|
+
# {
|
|
8453
|
+
# field_name: "account_id", # accepts account_id, region, resource_type, resource_category
|
|
8454
|
+
# filter: {
|
|
8455
|
+
# value: "NonEmptyString",
|
|
8456
|
+
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
8457
|
+
# },
|
|
8458
|
+
# },
|
|
8459
|
+
# ],
|
|
8460
|
+
# nested_composite_filters: {
|
|
8461
|
+
# # recursive ResourcesTrendsCompositeFilterList
|
|
8462
|
+
# },
|
|
8463
|
+
# operator: "AND", # accepts AND, OR
|
|
8464
|
+
# },
|
|
8465
|
+
# ],
|
|
8466
|
+
# composite_operator: "AND", # accepts AND, OR
|
|
8467
|
+
# },
|
|
8468
|
+
# start_time: Time.now, # required
|
|
8469
|
+
# end_time: Time.now, # required
|
|
8470
|
+
# next_token: "NextToken",
|
|
8471
|
+
# max_results: 1,
|
|
8472
|
+
# })
|
|
8473
|
+
#
|
|
8474
|
+
# @example Response structure
|
|
8475
|
+
#
|
|
8476
|
+
# resp.granularity #=> String, one of "Daily", "Weekly", "Monthly"
|
|
8477
|
+
# resp.trends_metrics #=> Array
|
|
8478
|
+
# resp.trends_metrics[0].timestamp #=> Time
|
|
8479
|
+
# resp.trends_metrics[0].trends_values.resources_count.all_resources #=> Integer
|
|
8480
|
+
# resp.next_token #=> String
|
|
8481
|
+
#
|
|
8482
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetResourcesTrendsV2 AWS API Documentation
|
|
8483
|
+
#
|
|
8484
|
+
# @overload get_resources_trends_v2(params = {})
|
|
8485
|
+
# @param [Hash] params ({})
|
|
8486
|
+
def get_resources_trends_v2(params = {}, options = {})
|
|
8487
|
+
req = build_request(:get_resources_trends_v2, params)
|
|
8488
|
+
req.send_request(options)
|
|
8489
|
+
end
|
|
8490
|
+
|
|
8491
|
+
# Returns a list of resources. This API is in public preview and subject
|
|
8492
|
+
# to change.
|
|
8291
8493
|
#
|
|
8292
8494
|
# @option params [Types::ResourcesFilters] :filters
|
|
8293
8495
|
# Filters resources based on a set of criteria.
|
|
@@ -8319,7 +8521,7 @@ module Aws::SecurityHub
|
|
|
8319
8521
|
# {
|
|
8320
8522
|
# string_filters: [
|
|
8321
8523
|
# {
|
|
8322
|
-
# field_name: "
|
|
8524
|
+
# field_name: "ResourceGuid", # accepts ResourceGuid, ResourceId, AccountId, Region, ResourceCategory, ResourceType, ResourceName, FindingsSummary.FindingType, FindingsSummary.ProductName
|
|
8323
8525
|
# filter: {
|
|
8324
8526
|
# value: "NonEmptyString",
|
|
8325
8527
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
@@ -8328,7 +8530,7 @@ module Aws::SecurityHub
|
|
|
8328
8530
|
# ],
|
|
8329
8531
|
# date_filters: [
|
|
8330
8532
|
# {
|
|
8331
|
-
# field_name: "
|
|
8533
|
+
# field_name: "ResourceDetailCaptureTime", # accepts ResourceDetailCaptureTime, ResourceCreationTime
|
|
8332
8534
|
# filter: {
|
|
8333
8535
|
# start: "NonEmptyString",
|
|
8334
8536
|
# end: "NonEmptyString",
|
|
@@ -8341,7 +8543,7 @@ module Aws::SecurityHub
|
|
|
8341
8543
|
# ],
|
|
8342
8544
|
# number_filters: [
|
|
8343
8545
|
# {
|
|
8344
|
-
# field_name: "
|
|
8546
|
+
# field_name: "FindingsSummary.TotalFindings", # accepts FindingsSummary.TotalFindings, FindingsSummary.Severities.Other, FindingsSummary.Severities.Fatal, FindingsSummary.Severities.Critical, FindingsSummary.Severities.High, FindingsSummary.Severities.Medium, FindingsSummary.Severities.Low, FindingsSummary.Severities.Informational, FindingsSummary.Severities.Unknown
|
|
8345
8547
|
# filter: {
|
|
8346
8548
|
# gte: 1.0,
|
|
8347
8549
|
# lte: 1.0,
|
|
@@ -8353,7 +8555,7 @@ module Aws::SecurityHub
|
|
|
8353
8555
|
# ],
|
|
8354
8556
|
# map_filters: [
|
|
8355
8557
|
# {
|
|
8356
|
-
# field_name: "
|
|
8558
|
+
# field_name: "ResourceTags", # accepts ResourceTags
|
|
8357
8559
|
# filter: {
|
|
8358
8560
|
# key: "NonEmptyString",
|
|
8359
8561
|
# value: "NonEmptyString",
|
|
@@ -8361,6 +8563,9 @@ module Aws::SecurityHub
|
|
|
8361
8563
|
# },
|
|
8362
8564
|
# },
|
|
8363
8565
|
# ],
|
|
8566
|
+
# nested_composite_filters: {
|
|
8567
|
+
# # recursive ResourcesCompositeFilterList
|
|
8568
|
+
# },
|
|
8364
8569
|
# operator: "AND", # accepts AND, OR
|
|
8365
8570
|
# },
|
|
8366
8571
|
# ],
|
|
@@ -8379,7 +8584,7 @@ module Aws::SecurityHub
|
|
|
8379
8584
|
# @example Response structure
|
|
8380
8585
|
#
|
|
8381
8586
|
# resp.resources #=> Array
|
|
8382
|
-
# resp.resources[0].
|
|
8587
|
+
# resp.resources[0].resource_guid #=> String
|
|
8383
8588
|
# resp.resources[0].resource_id #=> String
|
|
8384
8589
|
# resp.resources[0].account_id #=> String
|
|
8385
8590
|
# resp.resources[0].region #=> String
|
|
@@ -8591,7 +8796,7 @@ module Aws::SecurityHub
|
|
|
8591
8796
|
req.send_request(options)
|
|
8592
8797
|
end
|
|
8593
8798
|
|
|
8594
|
-
# Retrieves a list of V2 aggregators. This API is in
|
|
8799
|
+
# Retrieves a list of V2 aggregators. This API is in public preview and
|
|
8595
8800
|
# subject to change.
|
|
8596
8801
|
#
|
|
8597
8802
|
# @option params [String] :next_token
|
|
@@ -8717,7 +8922,7 @@ module Aws::SecurityHub
|
|
|
8717
8922
|
end
|
|
8718
8923
|
|
|
8719
8924
|
# Returns a list of automation rules and metadata for the calling
|
|
8720
|
-
# account. This API is in
|
|
8925
|
+
# account. This API is in public preview and subject to change.
|
|
8721
8926
|
#
|
|
8722
8927
|
# @option params [String] :next_token
|
|
8723
8928
|
# The token required for pagination. On your first call, set the value
|
|
@@ -8944,7 +9149,7 @@ module Aws::SecurityHub
|
|
|
8944
9149
|
end
|
|
8945
9150
|
|
|
8946
9151
|
# Grants permission to retrieve a list of connectorsV2 and their
|
|
8947
|
-
# metadata for the calling account. This API is in preview
|
|
9152
|
+
# metadata for the calling account. This API is in public preview and
|
|
8948
9153
|
# subject to change.
|
|
8949
9154
|
#
|
|
8950
9155
|
# @option params [String] :next_token
|
|
@@ -9907,8 +10112,8 @@ module Aws::SecurityHub
|
|
|
9907
10112
|
req.send_request(options)
|
|
9908
10113
|
end
|
|
9909
10114
|
|
|
9910
|
-
# Udpates the configuration for the Aggregator V2. This API is in
|
|
9911
|
-
#
|
|
10115
|
+
# Udpates the configuration for the Aggregator V2. This API is in public
|
|
10116
|
+
# preview and subject to change.
|
|
9912
10117
|
#
|
|
9913
10118
|
# @option params [required, String] :aggregator_v2_arn
|
|
9914
10119
|
# The ARN of the Aggregator V2.
|
|
@@ -9952,7 +10157,7 @@ module Aws::SecurityHub
|
|
|
9952
10157
|
req.send_request(options)
|
|
9953
10158
|
end
|
|
9954
10159
|
|
|
9955
|
-
# Updates a V2 automation rule. This API is in
|
|
10160
|
+
# Updates a V2 automation rule. This API is in public preview and
|
|
9956
10161
|
# subject to change.
|
|
9957
10162
|
#
|
|
9958
10163
|
# @option params [required, String] :identifier
|
|
@@ -9992,7 +10197,7 @@ module Aws::SecurityHub
|
|
|
9992
10197
|
# {
|
|
9993
10198
|
# string_filters: [
|
|
9994
10199
|
# {
|
|
9995
|
-
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name
|
|
10200
|
+
# field_name: "metadata.uid", # accepts metadata.uid, activity_name, cloud.account.uid, cloud.provider, cloud.region, compliance.assessments.category, compliance.assessments.name, compliance.control, compliance.status, compliance.standards, finding_info.desc, finding_info.src_url, finding_info.title, finding_info.types, finding_info.uid, finding_info.related_events.uid, finding_info.related_events.product.uid, finding_info.related_events.title, metadata.product.name, metadata.product.uid, metadata.product.vendor_name, remediation.desc, remediation.references, resources.cloud_partition, resources.region, resources.type, resources.uid, severity, status, comment, vulnerabilities.fix_coverage, class_name, databucket.encryption_details.algorithm, databucket.encryption_details.key_uid, databucket.file.data_classifications.classifier_details.type, evidences.actor.user.account.uid, evidences.api.operation, evidences.api.response.error_message, evidences.api.service.name, evidences.connection_info.direction, evidences.connection_info.protocol_name, evidences.dst_endpoint.autonomous_system.name, evidences.dst_endpoint.location.city, evidences.dst_endpoint.location.country, evidences.src_endpoint.autonomous_system.name, evidences.src_endpoint.hostname, evidences.src_endpoint.location.city, evidences.src_endpoint.location.country, finding_info.analytic.name, malware.name, malware_scan_info.uid, malware.severity, resources.cloud_function.layers.uid_alt, resources.cloud_function.runtime, resources.cloud_function.user.uid, resources.device.encryption_details.key_uid, resources.device.image.uid, resources.image.architecture, resources.image.registry_uid, resources.image.repository_name, resources.image.uid, resources.subnet_info.uid, resources.vpc_uid, vulnerabilities.affected_code.file.path, vulnerabilities.affected_packages.name, vulnerabilities.cve.epss.score, vulnerabilities.cve.uid, vulnerabilities.related_vulnerabilities, cloud.account.name
|
|
9996
10201
|
# filter: {
|
|
9997
10202
|
# value: "NonEmptyString",
|
|
9998
10203
|
# comparison: "EQUALS", # accepts EQUALS, PREFIX, NOT_EQUALS, PREFIX_NOT_EQUALS, CONTAINS, NOT_CONTAINS, CONTAINS_WORD
|
|
@@ -10001,7 +10206,7 @@ module Aws::SecurityHub
|
|
|
10001
10206
|
# ],
|
|
10002
10207
|
# date_filters: [
|
|
10003
10208
|
# {
|
|
10004
|
-
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt
|
|
10209
|
+
# field_name: "finding_info.created_time_dt", # accepts finding_info.created_time_dt, finding_info.first_seen_time_dt, finding_info.last_seen_time_dt, finding_info.modified_time_dt, resources.image.created_time_dt, resources.image.last_used_time_dt, resources.modified_time_dt
|
|
10005
10210
|
# filter: {
|
|
10006
10211
|
# start: "NonEmptyString",
|
|
10007
10212
|
# end: "NonEmptyString",
|
|
@@ -10022,7 +10227,7 @@ module Aws::SecurityHub
|
|
|
10022
10227
|
# ],
|
|
10023
10228
|
# number_filters: [
|
|
10024
10229
|
# {
|
|
10025
|
-
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count
|
|
10230
|
+
# field_name: "activity_id", # accepts activity_id, compliance.status_id, confidence_score, severity_id, status_id, finding_info.related_events_count, evidences.api.response.code, evidences.dst_endpoint.autonomous_system.number, evidences.dst_endpoint.port, evidences.src_endpoint.autonomous_system.number, evidences.src_endpoint.port, resources.image.in_use_count
|
|
10026
10231
|
# filter: {
|
|
10027
10232
|
# gte: 1.0,
|
|
10028
10233
|
# lte: 1.0,
|
|
@@ -10034,7 +10239,7 @@ module Aws::SecurityHub
|
|
|
10034
10239
|
# ],
|
|
10035
10240
|
# map_filters: [
|
|
10036
10241
|
# {
|
|
10037
|
-
# field_name: "resources.tags", # accepts resources.tags
|
|
10242
|
+
# field_name: "resources.tags", # accepts resources.tags, compliance.control_parameters, databucket.tags, finding_info.tags
|
|
10038
10243
|
# filter: {
|
|
10039
10244
|
# key: "NonEmptyString",
|
|
10040
10245
|
# value: "NonEmptyString",
|
|
@@ -10042,6 +10247,17 @@ module Aws::SecurityHub
|
|
|
10042
10247
|
# },
|
|
10043
10248
|
# },
|
|
10044
10249
|
# ],
|
|
10250
|
+
# ip_filters: [
|
|
10251
|
+
# {
|
|
10252
|
+
# field_name: "evidences.dst_endpoint.ip", # accepts evidences.dst_endpoint.ip, evidences.src_endpoint.ip
|
|
10253
|
+
# filter: {
|
|
10254
|
+
# cidr: "NonEmptyString",
|
|
10255
|
+
# },
|
|
10256
|
+
# },
|
|
10257
|
+
# ],
|
|
10258
|
+
# nested_composite_filters: {
|
|
10259
|
+
# # recursive CompositeFilterList
|
|
10260
|
+
# },
|
|
10045
10261
|
# operator: "AND", # accepts AND, OR
|
|
10046
10262
|
# },
|
|
10047
10263
|
# ],
|
|
@@ -10273,7 +10489,7 @@ module Aws::SecurityHub
|
|
|
10273
10489
|
end
|
|
10274
10490
|
|
|
10275
10491
|
# Grants permission to update a connectorV2 based on its id and input
|
|
10276
|
-
# parameters. This API is in preview
|
|
10492
|
+
# parameters. This API is in public preview and subject to change.
|
|
10277
10493
|
#
|
|
10278
10494
|
# @option params [required, String] :connector_id
|
|
10279
10495
|
# The UUID of the connectorV2 to identify connectorV2 resource.
|
|
@@ -12195,7 +12411,7 @@ module Aws::SecurityHub
|
|
|
12195
12411
|
tracer: tracer
|
|
12196
12412
|
)
|
|
12197
12413
|
context[:gem_name] = 'aws-sdk-securityhub'
|
|
12198
|
-
context[:gem_version] = '1.
|
|
12414
|
+
context[:gem_version] = '1.146.0'
|
|
12199
12415
|
Seahorse::Client::Request.new(handlers, context)
|
|
12200
12416
|
end
|
|
12201
12417
|
|