aws-sdk-guardduty 1.133.0 → 1.134.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.
@@ -420,6 +420,25 @@ module Aws::GuardDuty
420
420
  include Aws::Structure
421
421
  end
422
422
 
423
+ # Contains additional information about the detected threat.
424
+ #
425
+ # @!attribute [rw] version_id
426
+ # The version ID of the S3 object, if applicable.
427
+ # @return [String]
428
+ #
429
+ # @!attribute [rw] device_name
430
+ # The device name of the EBS volume, if applicable.
431
+ # @return [String]
432
+ #
433
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/AdditionalInfo AWS API Documentation
434
+ #
435
+ class AdditionalInfo < Struct.new(
436
+ :version_id,
437
+ :device_name)
438
+ SENSITIVE = []
439
+ include Aws::Structure
440
+ end
441
+
423
442
  # Information about the installed EKS add-on (GuardDuty security agent).
424
443
  #
425
444
  # @!attribute [rw] addon_version
@@ -3288,6 +3307,35 @@ module Aws::GuardDuty
3288
3307
  include Aws::Structure
3289
3308
  end
3290
3309
 
3310
+ # Contains information about an EBS snapshot that was scanned for
3311
+ # malware.
3312
+ #
3313
+ # @!attribute [rw] device_name
3314
+ # The device name of the EBS snapshot that was scanned.
3315
+ # @return [String]
3316
+ #
3317
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/EbsSnapshot AWS API Documentation
3318
+ #
3319
+ class EbsSnapshot < Struct.new(
3320
+ :device_name)
3321
+ SENSITIVE = []
3322
+ include Aws::Structure
3323
+ end
3324
+
3325
+ # Contains details about the EBS snapshot that was scanned for malware.
3326
+ #
3327
+ # @!attribute [rw] snapshot_arn
3328
+ # The Amazon Resource Name (ARN) of the EBS snapshot.
3329
+ # @return [String]
3330
+ #
3331
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/EbsSnapshotDetails AWS API Documentation
3332
+ #
3333
+ class EbsSnapshotDetails < Struct.new(
3334
+ :snapshot_arn)
3335
+ SENSITIVE = []
3336
+ include Aws::Structure
3337
+ end
3338
+
3291
3339
  # Contains list of scanned and skipped EBS volumes with details.
3292
3340
  #
3293
3341
  # @!attribute [rw] scanned_volume_details
@@ -3371,6 +3419,20 @@ module Aws::GuardDuty
3371
3419
  include Aws::Structure
3372
3420
  end
3373
3421
 
3422
+ # Contains details about the EC2 AMI that was scanned.
3423
+ #
3424
+ # @!attribute [rw] image_arn
3425
+ # The Amazon Resource Name (ARN) of the EC2 AMI.
3426
+ # @return [String]
3427
+ #
3428
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Ec2ImageDetails AWS API Documentation
3429
+ #
3430
+ class Ec2ImageDetails < Struct.new(
3431
+ :image_arn)
3432
+ SENSITIVE = []
3433
+ include Aws::Structure
3434
+ end
3435
+
3374
3436
  # Details about the potentially impacted Amazon EC2 instance resource.
3375
3437
  #
3376
3438
  # @!attribute [rw] availability_zone
@@ -4512,6 +4574,188 @@ module Aws::GuardDuty
4512
4574
  include Aws::Structure
4513
4575
  end
4514
4576
 
4577
+ # @!attribute [rw] scan_id
4578
+ # A unique identifier that gets generated when you invoke the API
4579
+ # without any error. Each malware scan has a corresponding scan ID.
4580
+ # Using this scan ID, you can monitor the status of your malware scan.
4581
+ # @return [String]
4582
+ #
4583
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/GetMalwareScanRequest AWS API Documentation
4584
+ #
4585
+ class GetMalwareScanRequest < Struct.new(
4586
+ :scan_id)
4587
+ SENSITIVE = []
4588
+ include Aws::Structure
4589
+ end
4590
+
4591
+ # @!attribute [rw] scan_id
4592
+ # A unique identifier associated with the malware scan. Each malware
4593
+ # scan has a corresponding scan ID. Using this scan ID, you can
4594
+ # monitor the status of your malware scan.
4595
+ # @return [String]
4596
+ #
4597
+ # @!attribute [rw] detector_id
4598
+ # The unique ID of the detector that is associated with the request,
4599
+ # if it belongs to an account which is a GuardDuty customer.
4600
+ #
4601
+ # To find the `detectorId` in the current Region, see the Settings
4602
+ # page in the GuardDuty console, or run the [ListDetectors][1] API.
4603
+ #
4604
+ #
4605
+ #
4606
+ # [1]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html
4607
+ # @return [String]
4608
+ #
4609
+ # @!attribute [rw] admin_detector_id
4610
+ # The unique detector ID of the administrator account that the request
4611
+ # is associated with. If the account is an administrator, the
4612
+ # `AdminDetectorId` will be the same as the one used for `DetectorId.
4613
+ # If the customer is not a GuardDuty customer, this field will not be
4614
+ # present.`.
4615
+ #
4616
+ # To find the `detectorId` in the current Region, see the Settings
4617
+ # page in the GuardDuty console, or run the [ListDetectors][1] API.
4618
+ #
4619
+ #
4620
+ #
4621
+ # [1]: https://docs.aws.amazon.com/guardduty/latest/APIReference/API_ListDetectors.html
4622
+ # @return [String]
4623
+ #
4624
+ # @!attribute [rw] resource_arn
4625
+ # Amazon Resource Name (ARN) of the resource on which a malware scan
4626
+ # was invoked.
4627
+ # @return [String]
4628
+ #
4629
+ # @!attribute [rw] resource_type
4630
+ # The type of resource that was scanned for malware.
4631
+ # @return [String]
4632
+ #
4633
+ # @!attribute [rw] scanned_resources_count
4634
+ # The total number of resources that were successfully scanned. This
4635
+ # is dependent on the resource type.
4636
+ # @return [Integer]
4637
+ #
4638
+ # @!attribute [rw] skipped_resources_count
4639
+ # The total number of resources that were skipped during the scan.
4640
+ # @return [Integer]
4641
+ #
4642
+ # @!attribute [rw] failed_resources_count
4643
+ # The total number of resources that failed to be scanned.
4644
+ # @return [Integer]
4645
+ #
4646
+ # @!attribute [rw] scanned_resources
4647
+ # A list of resources along with their metadata that were scanned as
4648
+ # part of the malware scan operation.
4649
+ # @return [Array<Types::ScannedResource>]
4650
+ #
4651
+ # @!attribute [rw] scan_configuration
4652
+ # Information about the scan configuration used for the malware scan.
4653
+ # @return [Types::ScanConfiguration]
4654
+ #
4655
+ # @!attribute [rw] scan_category
4656
+ # The category of the malware scan, indicating the type of scan
4657
+ # performed.
4658
+ # @return [String]
4659
+ #
4660
+ # @!attribute [rw] scan_status
4661
+ # A value representing the current status of the malware scan.
4662
+ # @return [String]
4663
+ #
4664
+ # @!attribute [rw] scan_status_reason
4665
+ # Represents the reason for the current scan status, if applicable.
4666
+ # @return [String]
4667
+ #
4668
+ # @!attribute [rw] scan_type
4669
+ # A value representing the initiator of the scan.
4670
+ # @return [String]
4671
+ #
4672
+ # @!attribute [rw] scan_started_at
4673
+ # The timestamp representing when the malware scan was started.
4674
+ # @return [Time]
4675
+ #
4676
+ # @!attribute [rw] scan_completed_at
4677
+ # The timestamp representing when the malware scan was completed.
4678
+ # @return [Time]
4679
+ #
4680
+ # @!attribute [rw] scan_result_details
4681
+ # Detailed information about the results of the malware scan, if the
4682
+ # scan completed.
4683
+ # @return [Types::GetMalwareScanResultDetails]
4684
+ #
4685
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/GetMalwareScanResponse AWS API Documentation
4686
+ #
4687
+ class GetMalwareScanResponse < Struct.new(
4688
+ :scan_id,
4689
+ :detector_id,
4690
+ :admin_detector_id,
4691
+ :resource_arn,
4692
+ :resource_type,
4693
+ :scanned_resources_count,
4694
+ :skipped_resources_count,
4695
+ :failed_resources_count,
4696
+ :scanned_resources,
4697
+ :scan_configuration,
4698
+ :scan_category,
4699
+ :scan_status,
4700
+ :scan_status_reason,
4701
+ :scan_type,
4702
+ :scan_started_at,
4703
+ :scan_completed_at,
4704
+ :scan_result_details)
4705
+ SENSITIVE = []
4706
+ include Aws::Structure
4707
+ end
4708
+
4709
+ # Contains information about the results of the malware scan.
4710
+ #
4711
+ # @!attribute [rw] scan_result_status
4712
+ # Status indicating whether threats were found for a completed scan.
4713
+ # @return [String]
4714
+ #
4715
+ # @!attribute [rw] skipped_file_count
4716
+ # The total number of files that were skipped during the scan.
4717
+ # @return [Integer]
4718
+ #
4719
+ # @!attribute [rw] failed_file_count
4720
+ # The total number of files that failed to be scanned.
4721
+ # @return [Integer]
4722
+ #
4723
+ # @!attribute [rw] threat_found_file_count
4724
+ # The total number of files in which threats were detected.
4725
+ # @return [Integer]
4726
+ #
4727
+ # @!attribute [rw] total_file_count
4728
+ # The total number of files that were processed during the scan.
4729
+ # @return [Integer]
4730
+ #
4731
+ # @!attribute [rw] total_bytes
4732
+ # The total number of bytes that were scanned.
4733
+ # @return [Integer]
4734
+ #
4735
+ # @!attribute [rw] unique_threat_count
4736
+ # The total number of unique threats that were detected during the
4737
+ # scan.
4738
+ # @return [Integer]
4739
+ #
4740
+ # @!attribute [rw] threats
4741
+ # The threats that were detected during the malware scan.
4742
+ # @return [Array<Types::ScanResultThreat>]
4743
+ #
4744
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/GetMalwareScanResultDetails AWS API Documentation
4745
+ #
4746
+ class GetMalwareScanResultDetails < Struct.new(
4747
+ :scan_result_status,
4748
+ :skipped_file_count,
4749
+ :failed_file_count,
4750
+ :threat_found_file_count,
4751
+ :total_file_count,
4752
+ :total_bytes,
4753
+ :unique_threat_count,
4754
+ :threats)
4755
+ SENSITIVE = []
4756
+ include Aws::Structure
4757
+ end
4758
+
4515
4759
  # @!attribute [rw] detector_id
4516
4760
  # The unique ID of the detector that is associated with this scan.
4517
4761
  #
@@ -5089,6 +5333,22 @@ module Aws::GuardDuty
5089
5333
  include Aws::Structure
5090
5334
  end
5091
5335
 
5336
+ # Contains information about the incremental scan configuration.
5337
+ #
5338
+ # @!attribute [rw] baseline_resource_arn
5339
+ # Amazon Resource Name (ARN) of the baseline resource used for
5340
+ # incremental scanning. The scan will only process changes since this
5341
+ # baseline resource was created.
5342
+ # @return [String]
5343
+ #
5344
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/IncrementalScanDetails AWS API Documentation
5345
+ #
5346
+ class IncrementalScanDetails < Struct.new(
5347
+ :baseline_resource_arn)
5348
+ SENSITIVE = []
5349
+ include Aws::Structure
5350
+ end
5351
+
5092
5352
  # Contains information about the indicators that include a set of
5093
5353
  # signals observed in an attack sequence.
5094
5354
  #
@@ -5300,6 +5560,36 @@ module Aws::GuardDuty
5300
5560
  include Aws::Structure
5301
5561
  end
5302
5562
 
5563
+ # Contains detailed information about where a threat was detected.
5564
+ #
5565
+ # @!attribute [rw] resource_arn
5566
+ # Amazon Resource Name (ARN) of the resource where the threat was
5567
+ # detected.
5568
+ # @return [String]
5569
+ #
5570
+ # @!attribute [rw] item_path
5571
+ # The path where the threat was detected.
5572
+ # @return [String]
5573
+ #
5574
+ # @!attribute [rw] hash
5575
+ # The hash value of the infected item.
5576
+ # @return [String]
5577
+ #
5578
+ # @!attribute [rw] additional_info
5579
+ # Additional information about the detected threat item.
5580
+ # @return [Types::AdditionalInfo]
5581
+ #
5582
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ItemDetails AWS API Documentation
5583
+ #
5584
+ class ItemDetails < Struct.new(
5585
+ :resource_arn,
5586
+ :item_path,
5587
+ :hash,
5588
+ :additional_info)
5589
+ SENSITIVE = []
5590
+ include Aws::Structure
5591
+ end
5592
+
5303
5593
  # Information about the nested item path and hash of the protected
5304
5594
  # resource.
5305
5595
  #
@@ -6276,6 +6566,97 @@ module Aws::GuardDuty
6276
6566
  include Aws::Structure
6277
6567
  end
6278
6568
 
6569
+ # Represents the criteria used to filter the malware scan entries.
6570
+ #
6571
+ # @!attribute [rw] list_malware_scans_filter_criterion
6572
+ # Represents a condition that when matched will be added to the
6573
+ # response of the operation.
6574
+ # @return [Array<Types::ListMalwareScansFilterCriterion>]
6575
+ #
6576
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ListMalwareScansFilterCriteria AWS API Documentation
6577
+ #
6578
+ class ListMalwareScansFilterCriteria < Struct.new(
6579
+ :list_malware_scans_filter_criterion)
6580
+ SENSITIVE = []
6581
+ include Aws::Structure
6582
+ end
6583
+
6584
+ # Represents a condition that when matched will be added to the response
6585
+ # of the operation. Irrespective of using any filter criteria, an
6586
+ # administrator account can view the scan entries for all of its member
6587
+ # accounts. However, each member account can view the scan entries only
6588
+ # for their own account.
6589
+ #
6590
+ # @!attribute [rw] list_malware_scans_criterion_key
6591
+ # An enum value representing possible scan properties to match with
6592
+ # given scan entries.
6593
+ # @return [String]
6594
+ #
6595
+ # @!attribute [rw] filter_condition
6596
+ # Contains information about the condition.
6597
+ # @return [Types::FilterCondition]
6598
+ #
6599
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ListMalwareScansFilterCriterion AWS API Documentation
6600
+ #
6601
+ class ListMalwareScansFilterCriterion < Struct.new(
6602
+ :list_malware_scans_criterion_key,
6603
+ :filter_condition)
6604
+ SENSITIVE = []
6605
+ include Aws::Structure
6606
+ end
6607
+
6608
+ # @!attribute [rw] max_results
6609
+ # You can use this parameter to indicate the maximum number of items
6610
+ # that you want in the response. The default value is 50. The maximum
6611
+ # value is 50.
6612
+ # @return [Integer]
6613
+ #
6614
+ # @!attribute [rw] next_token
6615
+ # You can use this parameter when paginating results. Set the value of
6616
+ # this parameter to null on your first call to the list action. For
6617
+ # subsequent calls to the action, fill nextToken in the request with
6618
+ # the value of NextToken from the previous response to continue
6619
+ # listing results.
6620
+ # @return [String]
6621
+ #
6622
+ # @!attribute [rw] filter_criteria
6623
+ # Represents the criteria used to filter the malware scan entries.
6624
+ # @return [Types::ListMalwareScansFilterCriteria]
6625
+ #
6626
+ # @!attribute [rw] sort_criteria
6627
+ # Represents the criteria used for sorting malware scan entries.
6628
+ # @return [Types::SortCriteria]
6629
+ #
6630
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ListMalwareScansRequest AWS API Documentation
6631
+ #
6632
+ class ListMalwareScansRequest < Struct.new(
6633
+ :max_results,
6634
+ :next_token,
6635
+ :filter_criteria,
6636
+ :sort_criteria)
6637
+ SENSITIVE = []
6638
+ include Aws::Structure
6639
+ end
6640
+
6641
+ # @!attribute [rw] scans
6642
+ # The list of malware scans associated with the provided input
6643
+ # parameters.
6644
+ # @return [Array<Types::MalwareScan>]
6645
+ #
6646
+ # @!attribute [rw] next_token
6647
+ # The pagination parameter to be used on the next list operation to
6648
+ # retrieve more scans.
6649
+ # @return [String]
6650
+ #
6651
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ListMalwareScansResponse AWS API Documentation
6652
+ #
6653
+ class ListMalwareScansResponse < Struct.new(
6654
+ :scans,
6655
+ :next_token)
6656
+ SENSITIVE = []
6657
+ include Aws::Structure
6658
+ end
6659
+
6279
6660
  # @!attribute [rw] detector_id
6280
6661
  # The unique ID of the detector that is associated with the member.
6281
6662
  #
@@ -6747,6 +7128,25 @@ module Aws::GuardDuty
6747
7128
  include Aws::Structure
6748
7129
  end
6749
7130
 
7131
+ # Contains finding configuration details about the malware scan.
7132
+ #
7133
+ # @!attribute [rw] trigger_type
7134
+ # The event that triggered the malware scan.
7135
+ # @return [String]
7136
+ #
7137
+ # @!attribute [rw] incremental_scan_details
7138
+ # Contains information about the incremental scan configuration.
7139
+ # @return [Types::IncrementalScanDetails]
7140
+ #
7141
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/MalwareProtectionFindingsScanConfiguration AWS API Documentation
7142
+ #
7143
+ class MalwareProtectionFindingsScanConfiguration < Struct.new(
7144
+ :trigger_type,
7145
+ :incremental_scan_details)
7146
+ SENSITIVE = []
7147
+ include Aws::Structure
7148
+ end
7149
+
6750
7150
  # Information about whether the tags will be added to the S3 object
6751
7151
  # after scanning.
6752
7152
  #
@@ -6819,6 +7219,58 @@ module Aws::GuardDuty
6819
7219
  include Aws::Structure
6820
7220
  end
6821
7221
 
7222
+ # Contains information about a particular malware scan.
7223
+ #
7224
+ # @!attribute [rw] resource_arn
7225
+ # Amazon Resource Name (ARN) of the resource for the given malware
7226
+ # scan.
7227
+ # @return [String]
7228
+ #
7229
+ # @!attribute [rw] resource_type
7230
+ # The type of resource that was scanned for malware.
7231
+ # @return [String]
7232
+ #
7233
+ # @!attribute [rw] scan_id
7234
+ # A unique identifier that gets generated when you invoke the API
7235
+ # without any error. Each malware scan has a corresponding scan ID.
7236
+ # Using this scan ID, you can monitor the status of your malware scan.
7237
+ # @return [String]
7238
+ #
7239
+ # @!attribute [rw] scan_status
7240
+ # An enum value representing the current status of the malware scan.
7241
+ # @return [String]
7242
+ #
7243
+ # @!attribute [rw] scan_result_status
7244
+ # An enum value representing the result of the malware scan.
7245
+ # @return [String]
7246
+ #
7247
+ # @!attribute [rw] scan_type
7248
+ # An enum value representing the type of scan that was initiated.
7249
+ # @return [String]
7250
+ #
7251
+ # @!attribute [rw] scan_started_at
7252
+ # The timestamp representing when the malware scan was started.
7253
+ # @return [Time]
7254
+ #
7255
+ # @!attribute [rw] scan_completed_at
7256
+ # The timestamp representing when the malware scan was completed.
7257
+ # @return [Time]
7258
+ #
7259
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/MalwareScan AWS API Documentation
7260
+ #
7261
+ class MalwareScan < Struct.new(
7262
+ :resource_arn,
7263
+ :resource_type,
7264
+ :scan_id,
7265
+ :scan_status,
7266
+ :scan_result_status,
7267
+ :scan_type,
7268
+ :scan_started_at,
7269
+ :scan_completed_at)
7270
+ SENSITIVE = []
7271
+ include Aws::Structure
7272
+ end
7273
+
6822
7274
  # Information about the malware scan that generated a GuardDuty finding.
6823
7275
  #
6824
7276
  # @!attribute [rw] threats
@@ -6826,10 +7278,35 @@ module Aws::GuardDuty
6826
7278
  # GuardDuty finding.
6827
7279
  # @return [Array<Types::Threat>]
6828
7280
  #
7281
+ # @!attribute [rw] scan_id
7282
+ # The unique identifier for the malware scan.
7283
+ # @return [String]
7284
+ #
7285
+ # @!attribute [rw] scan_type
7286
+ # The type of malware scan performed.
7287
+ # @return [String]
7288
+ #
7289
+ # @!attribute [rw] scan_category
7290
+ # The category of the malware scan.
7291
+ # @return [String]
7292
+ #
7293
+ # @!attribute [rw] scan_configuration
7294
+ # The configuration settings used for the malware scan.
7295
+ # @return [Types::MalwareProtectionFindingsScanConfiguration]
7296
+ #
7297
+ # @!attribute [rw] unique_threat_count
7298
+ # The number of unique malware threats detected during the scan.
7299
+ # @return [Integer]
7300
+ #
6829
7301
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/MalwareScanDetails AWS API Documentation
6830
7302
  #
6831
7303
  class MalwareScanDetails < Struct.new(
6832
- :threats)
7304
+ :threats,
7305
+ :scan_id,
7306
+ :scan_type,
7307
+ :scan_category,
7308
+ :scan_configuration,
7309
+ :unique_threat_count)
6833
7310
  SENSITIVE = []
6834
7311
  include Aws::Structure
6835
7312
  end
@@ -8215,6 +8692,41 @@ module Aws::GuardDuty
8215
8692
  include Aws::Structure
8216
8693
  end
8217
8694
 
8695
+ # Contains information about the recovery point configuration for
8696
+ # scanning backup data from Amazon Web Services Backup.
8697
+ #
8698
+ # @!attribute [rw] backup_vault_name
8699
+ # The name of the Amazon Web Services Backup vault that contains the
8700
+ # name of the recovery point to be scanned.
8701
+ # @return [String]
8702
+ #
8703
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/RecoveryPoint AWS API Documentation
8704
+ #
8705
+ class RecoveryPoint < Struct.new(
8706
+ :backup_vault_name)
8707
+ SENSITIVE = []
8708
+ include Aws::Structure
8709
+ end
8710
+
8711
+ # Contains details about the backup recovery point.
8712
+ #
8713
+ # @!attribute [rw] recovery_point_arn
8714
+ # The Amazon Resource Name (ARN) of the recovery point.
8715
+ # @return [String]
8716
+ #
8717
+ # @!attribute [rw] backup_vault_name
8718
+ # The name of the backup vault containing the recovery point.
8719
+ # @return [String]
8720
+ #
8721
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/RecoveryPointDetails AWS API Documentation
8722
+ #
8723
+ class RecoveryPointDetails < Struct.new(
8724
+ :recovery_point_arn,
8725
+ :backup_vault_name)
8726
+ SENSITIVE = []
8727
+ include Aws::Structure
8728
+ end
8729
+
8218
8730
  # Contains details about the remote Amazon Web Services account that
8219
8731
  # made the API call.
8220
8732
  #
@@ -8358,6 +8870,18 @@ module Aws::GuardDuty
8358
8870
  # a finding.
8359
8871
  # @return [Types::LambdaDetails]
8360
8872
  #
8873
+ # @!attribute [rw] ebs_snapshot_details
8874
+ # Contains details about the EBS snapshot that was scanned.
8875
+ # @return [Types::EbsSnapshotDetails]
8876
+ #
8877
+ # @!attribute [rw] ec2_image_details
8878
+ # Contains details about the EC2 image that was scanned.
8879
+ # @return [Types::Ec2ImageDetails]
8880
+ #
8881
+ # @!attribute [rw] recovery_point_details
8882
+ # Contains details about the backup recovery point that was scanned.
8883
+ # @return [Types::RecoveryPointDetails]
8884
+ #
8361
8885
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Resource AWS API Documentation
8362
8886
  #
8363
8887
  class Resource < Struct.new(
@@ -8373,7 +8897,10 @@ module Aws::GuardDuty
8373
8897
  :rds_db_instance_details,
8374
8898
  :rds_limitless_db_details,
8375
8899
  :rds_db_user_details,
8376
- :lambda_details)
8900
+ :lambda_details,
8901
+ :ebs_snapshot_details,
8902
+ :ec2_image_details,
8903
+ :recovery_point_details)
8377
8904
  SENSITIVE = []
8378
8905
  include Aws::Structure
8379
8906
  end
@@ -9135,6 +9662,54 @@ module Aws::GuardDuty
9135
9662
  include Aws::Structure
9136
9663
  end
9137
9664
 
9665
+ # Contains information about the configuration used for the malware
9666
+ # scan.
9667
+ #
9668
+ # @!attribute [rw] role
9669
+ # Amazon Resource Name (ARN) of the IAM role that should contain the
9670
+ # required permissions for the scan.
9671
+ # @return [String]
9672
+ #
9673
+ # @!attribute [rw] trigger_details
9674
+ # Information about the entity that triggered the malware scan.
9675
+ # @return [Types::TriggerDetails]
9676
+ #
9677
+ # @!attribute [rw] incremental_scan_details
9678
+ # Information about the incremental scan configuration, if applicable.
9679
+ # @return [Types::IncrementalScanDetails]
9680
+ #
9681
+ # @!attribute [rw] recovery_point
9682
+ # Information about the recovery point configuration used for the
9683
+ # scan, if applicable.
9684
+ # @return [Types::ScanConfigurationRecoveryPoint]
9685
+ #
9686
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ScanConfiguration AWS API Documentation
9687
+ #
9688
+ class ScanConfiguration < Struct.new(
9689
+ :role,
9690
+ :trigger_details,
9691
+ :incremental_scan_details,
9692
+ :recovery_point)
9693
+ SENSITIVE = []
9694
+ include Aws::Structure
9695
+ end
9696
+
9697
+ # Contains information about the recovery point configuration used in
9698
+ # the scan.
9699
+ #
9700
+ # @!attribute [rw] backup_vault_name
9701
+ # The name of the Amazon Web Services Backup vault that contains the
9702
+ # recovery point for the scanned.
9703
+ # @return [String]
9704
+ #
9705
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ScanConfigurationRecoveryPoint AWS API Documentation
9706
+ #
9707
+ class ScanConfigurationRecoveryPoint < Struct.new(
9708
+ :backup_vault_name)
9709
+ SENSITIVE = []
9710
+ include Aws::Structure
9711
+ end
9712
+
9138
9713
  # Contains a complete view providing malware scan result details.
9139
9714
  #
9140
9715
  # @!attribute [rw] scanned_item_count
@@ -9262,6 +9837,41 @@ module Aws::GuardDuty
9262
9837
  include Aws::Structure
9263
9838
  end
9264
9839
 
9840
+ # Contains information about a specific threat that was detected during
9841
+ # the malware scan.
9842
+ #
9843
+ # @!attribute [rw] name
9844
+ # The name of the detected threat.
9845
+ # @return [String]
9846
+ #
9847
+ # @!attribute [rw] source
9848
+ # The source that detected this threat.
9849
+ # @return [String]
9850
+ #
9851
+ # @!attribute [rw] count
9852
+ # The number of instances of this threat that were detected.
9853
+ # @return [Integer]
9854
+ #
9855
+ # @!attribute [rw] hash
9856
+ # The hash value associated with the detected threat.
9857
+ # @return [String]
9858
+ #
9859
+ # @!attribute [rw] item_details
9860
+ # Additional information about where this threat was detected.
9861
+ # @return [Array<Types::ItemDetails>]
9862
+ #
9863
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ScanResultThreat AWS API Documentation
9864
+ #
9865
+ class ScanResultThreat < Struct.new(
9866
+ :name,
9867
+ :source,
9868
+ :count,
9869
+ :hash,
9870
+ :item_details)
9871
+ SENSITIVE = []
9872
+ include Aws::Structure
9873
+ end
9874
+
9265
9875
  # Contains files infected with the given threat providing details of
9266
9876
  # malware name and severity.
9267
9877
  #
@@ -9316,6 +9926,61 @@ module Aws::GuardDuty
9316
9926
  include Aws::Structure
9317
9927
  end
9318
9928
 
9929
+ # Contains information about a resource that was scanned as part of the
9930
+ # malware scan operation.
9931
+ #
9932
+ # @!attribute [rw] scanned_resource_arn
9933
+ # Amazon Resource Name (ARN) of the scanned resource.
9934
+ # @return [String]
9935
+ #
9936
+ # @!attribute [rw] scanned_resource_type
9937
+ # The resource type of the scanned resource.
9938
+ # @return [String]
9939
+ #
9940
+ # @!attribute [rw] scanned_resource_status
9941
+ # The status of the scanned resource.
9942
+ # @return [String]
9943
+ #
9944
+ # @!attribute [rw] scan_status_reason
9945
+ # The reason for the scan status of this particular resource, if
9946
+ # applicable.
9947
+ # @return [String]
9948
+ #
9949
+ # @!attribute [rw] resource_details
9950
+ # Information about the scanned resource.
9951
+ # @return [Types::ScannedResourceDetails]
9952
+ #
9953
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ScannedResource AWS API Documentation
9954
+ #
9955
+ class ScannedResource < Struct.new(
9956
+ :scanned_resource_arn,
9957
+ :scanned_resource_type,
9958
+ :scanned_resource_status,
9959
+ :scan_status_reason,
9960
+ :resource_details)
9961
+ SENSITIVE = []
9962
+ include Aws::Structure
9963
+ end
9964
+
9965
+ # Contains additional information about a resource that was scanned.
9966
+ #
9967
+ # @!attribute [rw] ebs_volume
9968
+ # Contains information about the EBS volume that was scanned.
9969
+ # @return [Types::VolumeDetail]
9970
+ #
9971
+ # @!attribute [rw] ebs_snapshot
9972
+ # Contains information about the EBS snapshot that was scanned.
9973
+ # @return [Types::EbsSnapshot]
9974
+ #
9975
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/ScannedResourceDetails AWS API Documentation
9976
+ #
9977
+ class ScannedResourceDetails < Struct.new(
9978
+ :ebs_volume,
9979
+ :ebs_snapshot)
9980
+ SENSITIVE = []
9981
+ include Aws::Structure
9982
+ end
9983
+
9319
9984
  # Container security context.
9320
9985
  #
9321
9986
  # @!attribute [rw] privileged
@@ -9743,15 +10408,58 @@ module Aws::GuardDuty
9743
10408
  include Aws::Structure
9744
10409
  end
9745
10410
 
10411
+ # Contains information about the configuration to be used for the
10412
+ # malware scan.
10413
+ #
10414
+ # @!attribute [rw] role
10415
+ # Amazon Resource Name (ARN) of the IAM role that is used for scanning
10416
+ # the resource.
10417
+ # @return [String]
10418
+ #
10419
+ # @!attribute [rw] incremental_scan_details
10420
+ # Contains information about the incremental scan configuration. When
10421
+ # specified, the scan will only process changes since the baseline
10422
+ # resource.
10423
+ # @return [Types::IncrementalScanDetails]
10424
+ #
10425
+ # @!attribute [rw] recovery_point
10426
+ # Contains information about the recovery point configuration for the
10427
+ # requested scan.
10428
+ # @return [Types::RecoveryPoint]
10429
+ #
10430
+ # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/StartMalwareScanConfiguration AWS API Documentation
10431
+ #
10432
+ class StartMalwareScanConfiguration < Struct.new(
10433
+ :role,
10434
+ :incremental_scan_details,
10435
+ :recovery_point)
10436
+ SENSITIVE = []
10437
+ include Aws::Structure
10438
+ end
10439
+
9746
10440
  # @!attribute [rw] resource_arn
9747
10441
  # Amazon Resource Name (ARN) of the resource for which you invoked the
9748
10442
  # API.
9749
10443
  # @return [String]
9750
10444
  #
10445
+ # @!attribute [rw] client_token
10446
+ # The idempotency token for the create request.
10447
+ #
10448
+ # **A suitable default value is auto-generated.** You should normally
10449
+ # not need to pass this option.
10450
+ # @return [String]
10451
+ #
10452
+ # @!attribute [rw] scan_configuration
10453
+ # Contains information about the configuration to be used for the
10454
+ # malware scan.
10455
+ # @return [Types::StartMalwareScanConfiguration]
10456
+ #
9751
10457
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/StartMalwareScanRequest AWS API Documentation
9752
10458
  #
9753
10459
  class StartMalwareScanRequest < Struct.new(
9754
- :resource_arn)
10460
+ :resource_arn,
10461
+ :client_token,
10462
+ :scan_configuration)
9755
10463
  SENSITIVE = []
9756
10464
  include Aws::Structure
9757
10465
  end
@@ -9906,12 +10614,28 @@ module Aws::GuardDuty
9906
10614
  # resource.
9907
10615
  # @return [Array<Types::ItemPath>]
9908
10616
  #
10617
+ # @!attribute [rw] count
10618
+ # The number of occurrences of this specific threat detected during
10619
+ # the scan.
10620
+ # @return [Integer]
10621
+ #
10622
+ # @!attribute [rw] hash
10623
+ # The hash identifier of the detected malware threat.
10624
+ # @return [String]
10625
+ #
10626
+ # @!attribute [rw] item_details
10627
+ # Detailed information about the detected malware threat.
10628
+ # @return [Array<Types::ItemDetails>]
10629
+ #
9909
10630
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/Threat AWS API Documentation
9910
10631
  #
9911
10632
  class Threat < Struct.new(
9912
10633
  :name,
9913
10634
  :source,
9914
- :item_paths)
10635
+ :item_paths,
10636
+ :count,
10637
+ :hash,
10638
+ :item_details)
9915
10639
  SENSITIVE = []
9916
10640
  include Aws::Structure
9917
10641
  end
@@ -10017,11 +10741,16 @@ module Aws::GuardDuty
10017
10741
  # The description of the scan trigger.
10018
10742
  # @return [String]
10019
10743
  #
10744
+ # @!attribute [rw] trigger_type
10745
+ # Specifies the trigger type that started the malware scan.
10746
+ # @return [String]
10747
+ #
10020
10748
  # @see http://docs.aws.amazon.com/goto/WebAPI/guardduty-2017-11-28/TriggerDetails AWS API Documentation
10021
10749
  #
10022
10750
  class TriggerDetails < Struct.new(
10023
10751
  :guard_duty_finding_id,
10024
- :description)
10752
+ :description,
10753
+ :trigger_type)
10025
10754
  SENSITIVE = []
10026
10755
  include Aws::Structure
10027
10756
  end