aws-sdk-auditmanager 1.27.0 → 1.29.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.
@@ -13,15 +13,6 @@ module Aws::AuditManager
13
13
  # The wrapper of Amazon Web Services account details, such as account ID
14
14
  # or email address.
15
15
  #
16
- # @note When making an API call, you may pass AWSAccount
17
- # data as a hash:
18
- #
19
- # {
20
- # id: "AccountId",
21
- # email_address: "EmailAddress",
22
- # name: "AccountName",
23
- # }
24
- #
25
16
  # @!attribute [rw] id
26
17
  # The identifier for the Amazon Web Services account.
27
18
  # @return [String]
@@ -47,13 +38,6 @@ module Aws::AuditManager
47
38
 
48
39
  # An Amazon Web Service such as Amazon S3 or CloudTrail.
49
40
  #
50
- # @note When making an API call, you may pass AWSService
51
- # data as a hash:
52
- #
53
- # {
54
- # service_name: "AWSServiceName",
55
- # }
56
- #
57
41
  # @!attribute [rw] service_name
58
42
  # The name of the Amazon Web Service.
59
43
  # @return [String]
@@ -149,7 +133,7 @@ module Aws::AuditManager
149
133
  # @return [Array<String>]
150
134
  #
151
135
  # @!attribute [rw] evidence_count
152
- # The amount of evidence that's generated for the control.
136
+ # The amount of evidence that's collected for the control.
153
137
  # @return [Integer]
154
138
  #
155
139
  # @!attribute [rw] assessment_report_evidence_count
@@ -184,7 +168,7 @@ module Aws::AuditManager
184
168
  # @return [String]
185
169
  #
186
170
  # @!attribute [rw] status
187
- # Specifies the current status of the control set.
171
+ # The current status of the control set.
188
172
  # @return [String]
189
173
  #
190
174
  # @!attribute [rw] roles
@@ -403,11 +387,11 @@ module Aws::AuditManager
403
387
  # @return [Integer]
404
388
  #
405
389
  # @!attribute [rw] created_at
406
- # Specifies when the framework was created.
390
+ # The time when the framework was created.
407
391
  # @return [Time]
408
392
  #
409
393
  # @!attribute [rw] last_updated_at
410
- # Specifies when the framework was most recently updated.
394
+ # The time when the framework was most recently updated.
411
395
  # @return [Time]
412
396
  #
413
397
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/AssessmentFrameworkMetadata AWS API Documentation
@@ -691,19 +675,19 @@ module Aws::AuditManager
691
675
  include Aws::Structure
692
676
  end
693
677
 
694
- # An error entity for the `AssessmentReportEvidence` API. This is used
695
- # to provide more meaningful errors than a simple string message.
678
+ # An error entity for assessment report evidence errors. This is used to
679
+ # provide more meaningful errors than a simple string message.
696
680
  #
697
681
  # @!attribute [rw] evidence_id
698
682
  # The identifier for the evidence.
699
683
  # @return [String]
700
684
  #
701
685
  # @!attribute [rw] error_code
702
- # The error code that the `AssessmentReportEvidence` API returned.
686
+ # The error code that was returned.
703
687
  # @return [String]
704
688
  #
705
689
  # @!attribute [rw] error_message
706
- # The error message that the `AssessmentReportEvidence` API returned.
690
+ # The error message that was returned.
707
691
  # @return [String]
708
692
  #
709
693
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/AssessmentReportEvidenceError AWS API Documentation
@@ -769,14 +753,6 @@ module Aws::AuditManager
769
753
  # The location where Audit Manager saves assessment reports for the
770
754
  # given assessment.
771
755
  #
772
- # @note When making an API call, you may pass AssessmentReportsDestination
773
- # data as a hash:
774
- #
775
- # {
776
- # destination_type: "S3", # accepts S3
777
- # destination: "S3Url",
778
- # }
779
- #
780
756
  # @!attribute [rw] destination_type
781
757
  # The destination type, such as Amazon S3.
782
758
  # @return [String]
@@ -794,14 +770,6 @@ module Aws::AuditManager
794
770
  include Aws::Structure
795
771
  end
796
772
 
797
- # @note When making an API call, you may pass AssociateAssessmentReportEvidenceFolderRequest
798
- # data as a hash:
799
- #
800
- # {
801
- # assessment_id: "UUID", # required
802
- # evidence_folder_id: "UUID", # required
803
- # }
804
- #
805
773
  # @!attribute [rw] assessment_id
806
774
  # The identifier for the assessment.
807
775
  # @return [String]
@@ -823,15 +791,6 @@ module Aws::AuditManager
823
791
  #
824
792
  class AssociateAssessmentReportEvidenceFolderResponse < Aws::EmptyStructure; end
825
793
 
826
- # @note When making an API call, you may pass BatchAssociateAssessmentReportEvidenceRequest
827
- # data as a hash:
828
- #
829
- # {
830
- # assessment_id: "UUID", # required
831
- # evidence_folder_id: "UUID", # required
832
- # evidence_ids: ["UUID"], # required
833
- # }
834
- #
835
794
  # @!attribute [rw] assessment_id
836
795
  # The identifier for the assessment.
837
796
  # @return [String]
@@ -900,21 +859,6 @@ module Aws::AuditManager
900
859
  include Aws::Structure
901
860
  end
902
861
 
903
- # @note When making an API call, you may pass BatchCreateDelegationByAssessmentRequest
904
- # data as a hash:
905
- #
906
- # {
907
- # create_delegation_requests: [ # required
908
- # {
909
- # comment: "DelegationComment",
910
- # control_set_id: "ControlSetId",
911
- # role_arn: "IamArn",
912
- # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER
913
- # },
914
- # ],
915
- # assessment_id: "UUID", # required
916
- # }
917
- #
918
862
  # @!attribute [rw] create_delegation_requests
919
863
  # The API request to batch create delegations in Audit Manager.
920
864
  # @return [Array<Types::CreateDelegationRequest>]
@@ -978,14 +922,6 @@ module Aws::AuditManager
978
922
  include Aws::Structure
979
923
  end
980
924
 
981
- # @note When making an API call, you may pass BatchDeleteDelegationByAssessmentRequest
982
- # data as a hash:
983
- #
984
- # {
985
- # delegation_ids: ["UUID"], # required
986
- # assessment_id: "UUID", # required
987
- # }
988
- #
989
925
  # @!attribute [rw] delegation_ids
990
926
  # The identifiers for the delegations.
991
927
  # @return [Array<String>]
@@ -1016,15 +952,6 @@ module Aws::AuditManager
1016
952
  include Aws::Structure
1017
953
  end
1018
954
 
1019
- # @note When making an API call, you may pass BatchDisassociateAssessmentReportEvidenceRequest
1020
- # data as a hash:
1021
- #
1022
- # {
1023
- # assessment_id: "UUID", # required
1024
- # evidence_folder_id: "UUID", # required
1025
- # evidence_ids: ["UUID"], # required
1026
- # }
1027
- #
1028
955
  # @!attribute [rw] assessment_id
1029
956
  # The identifier for the assessment.
1030
957
  # @return [String]
@@ -1094,20 +1021,6 @@ module Aws::AuditManager
1094
1021
  include Aws::Structure
1095
1022
  end
1096
1023
 
1097
- # @note When making an API call, you may pass BatchImportEvidenceToAssessmentControlRequest
1098
- # data as a hash:
1099
- #
1100
- # {
1101
- # assessment_id: "UUID", # required
1102
- # control_set_id: "ControlSetId", # required
1103
- # control_id: "UUID", # required
1104
- # manual_evidence: [ # required
1105
- # {
1106
- # s3_resource_path: "S3Url",
1107
- # },
1108
- # ],
1109
- # }
1110
- #
1111
1024
  # @!attribute [rw] assessment_id
1112
1025
  # The identifier for the assessment.
1113
1026
  # @return [String]
@@ -1224,7 +1137,7 @@ module Aws::AuditManager
1224
1137
  # @return [String]
1225
1138
  #
1226
1139
  # @!attribute [rw] control_sources
1227
- # The data source that determines where Audit Manager collects
1140
+ # The data source types that determine where Audit Manager collects
1228
1141
  # evidence from for the control.
1229
1142
  # @return [String]
1230
1143
  #
@@ -1233,11 +1146,11 @@ module Aws::AuditManager
1233
1146
  # @return [Array<Types::ControlMappingSource>]
1234
1147
  #
1235
1148
  # @!attribute [rw] created_at
1236
- # Specifies when the control was created.
1149
+ # The time when the control was created.
1237
1150
  # @return [Time]
1238
1151
  #
1239
1152
  # @!attribute [rw] last_updated_at
1240
- # Specifies when the control was most recently updated.
1153
+ # The time when the control was most recently updated.
1241
1154
  # @return [Time]
1242
1155
  #
1243
1156
  # @!attribute [rw] created_by
@@ -1420,23 +1333,6 @@ module Aws::AuditManager
1420
1333
  # The data source that determines where Audit Manager collects evidence
1421
1334
  # from for the control.
1422
1335
  #
1423
- # @note When making an API call, you may pass ControlMappingSource
1424
- # data as a hash:
1425
- #
1426
- # {
1427
- # source_id: "UUID",
1428
- # source_name: "SourceName",
1429
- # source_description: "SourceDescription",
1430
- # source_set_up_option: "System_Controls_Mapping", # accepts System_Controls_Mapping, Procedural_Controls_Mapping
1431
- # source_type: "AWS_Cloudtrail", # accepts AWS_Cloudtrail, AWS_Config, AWS_Security_Hub, AWS_API_Call, MANUAL
1432
- # source_keyword: {
1433
- # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST
1434
- # keyword_value: "KeywordValue",
1435
- # },
1436
- # source_frequency: "DAILY", # accepts DAILY, WEEKLY, MONTHLY
1437
- # troubleshooting_text: "TroubleshootingText",
1438
- # }
1439
- #
1440
1336
  # @!attribute [rw] source_id
1441
1337
  # The unique identifier for the source.
1442
1338
  # @return [String]
@@ -1455,8 +1351,7 @@ module Aws::AuditManager
1455
1351
  # @return [String]
1456
1352
  #
1457
1353
  # @!attribute [rw] source_type
1458
- # Specifies one of the five types of data sources for evidence
1459
- # collection.
1354
+ # Specifies one of the five data source types for evidence collection.
1460
1355
  # @return [String]
1461
1356
  #
1462
1357
  # @!attribute [rw] source_keyword
@@ -1527,11 +1422,11 @@ module Aws::AuditManager
1527
1422
  # @return [String]
1528
1423
  #
1529
1424
  # @!attribute [rw] created_at
1530
- # Specifies when the control was created.
1425
+ # The time when the control was created.
1531
1426
  # @return [Time]
1532
1427
  #
1533
1428
  # @!attribute [rw] last_updated_at
1534
- # Specifies when the control was most recently updated.
1429
+ # The time when the control was most recently updated.
1535
1430
  # @return [Time]
1536
1431
  #
1537
1432
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/ControlMetadata AWS API Documentation
@@ -1575,13 +1470,6 @@ module Aws::AuditManager
1575
1470
  # The control entity attributes that uniquely identify an existing
1576
1471
  # control to be added to a framework in Audit Manager.
1577
1472
  #
1578
- # @note When making an API call, you may pass CreateAssessmentFrameworkControl
1579
- # data as a hash:
1580
- #
1581
- # {
1582
- # id: "UUID", # required
1583
- # }
1584
- #
1585
1473
  # @!attribute [rw] id
1586
1474
  # The unique identifier of the control.
1587
1475
  # @return [String]
@@ -1597,18 +1485,6 @@ module Aws::AuditManager
1597
1485
  # A `controlSet` entity that represents a collection of controls in
1598
1486
  # Audit Manager. This doesn't contain the control set ID.
1599
1487
  #
1600
- # @note When making an API call, you may pass CreateAssessmentFrameworkControlSet
1601
- # data as a hash:
1602
- #
1603
- # {
1604
- # name: "ControlSetName", # required
1605
- # controls: [
1606
- # {
1607
- # id: "UUID", # required
1608
- # },
1609
- # ],
1610
- # }
1611
- #
1612
1488
  # @!attribute [rw] name
1613
1489
  # The name of the control set.
1614
1490
  # @return [String]
@@ -1627,28 +1503,6 @@ module Aws::AuditManager
1627
1503
  include Aws::Structure
1628
1504
  end
1629
1505
 
1630
- # @note When making an API call, you may pass CreateAssessmentFrameworkRequest
1631
- # data as a hash:
1632
- #
1633
- # {
1634
- # name: "FrameworkName", # required
1635
- # description: "FrameworkDescription",
1636
- # compliance_type: "ComplianceType",
1637
- # control_sets: [ # required
1638
- # {
1639
- # name: "ControlSetName", # required
1640
- # controls: [
1641
- # {
1642
- # id: "UUID", # required
1643
- # },
1644
- # ],
1645
- # },
1646
- # ],
1647
- # tags: {
1648
- # "TagKey" => "TagValue",
1649
- # },
1650
- # }
1651
- #
1652
1506
  # @!attribute [rw] name
1653
1507
  # The name of the new custom framework.
1654
1508
  # @return [String]
@@ -1695,15 +1549,6 @@ module Aws::AuditManager
1695
1549
  include Aws::Structure
1696
1550
  end
1697
1551
 
1698
- # @note When making an API call, you may pass CreateAssessmentReportRequest
1699
- # data as a hash:
1700
- #
1701
- # {
1702
- # name: "AssessmentReportName", # required
1703
- # description: "AssessmentReportDescription",
1704
- # assessment_id: "UUID", # required
1705
- # }
1706
- #
1707
1552
  # @!attribute [rw] name
1708
1553
  # The name of the new assessment report.
1709
1554
  # @return [String]
@@ -1716,12 +1561,39 @@ module Aws::AuditManager
1716
1561
  # The identifier for the assessment.
1717
1562
  # @return [String]
1718
1563
  #
1564
+ # @!attribute [rw] query_statement
1565
+ # A SQL statement that represents an evidence finder query.
1566
+ #
1567
+ # Provide this parameter when you want to generate an assessment
1568
+ # report from the results of an evidence finder search query. When you
1569
+ # use this parameter, Audit Manager generates a one-time report using
1570
+ # only the evidence from the query output. This report does not
1571
+ # include any assessment evidence that was manually [added to a report
1572
+ # using the console][1], or [associated with a report using the
1573
+ # API][2].
1574
+ #
1575
+ # To use this parameter, the [enablementStatus][3] of evidence finder
1576
+ # must be `ENABLED`.
1577
+ #
1578
+ # For examples and help resolving `queryStatement` validation
1579
+ # exceptions, see [Troubleshooting evidence finder issues][4] in the
1580
+ # *Audit Manager User Guide.*
1581
+ #
1582
+ #
1583
+ #
1584
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/generate-assessment-report.html#generate-assessment-report-include-evidence
1585
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_BatchAssociateAssessmentReportEvidence.html
1586
+ # [3]: https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_EvidenceFinderEnablement.html#auditmanager-Type-EvidenceFinderEnablement-enablementStatus
1587
+ # [4]: https://docs.aws.amazon.com/audit-manager/latest/userguide/evidence-finder-issues.html#querystatement-exceptions
1588
+ # @return [String]
1589
+ #
1719
1590
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/CreateAssessmentReportRequest AWS API Documentation
1720
1591
  #
1721
1592
  class CreateAssessmentReportRequest < Struct.new(
1722
1593
  :name,
1723
1594
  :description,
1724
- :assessment_id)
1595
+ :assessment_id,
1596
+ :query_statement)
1725
1597
  SENSITIVE = []
1726
1598
  include Aws::Structure
1727
1599
  end
@@ -1739,42 +1611,6 @@ module Aws::AuditManager
1739
1611
  include Aws::Structure
1740
1612
  end
1741
1613
 
1742
- # @note When making an API call, you may pass CreateAssessmentRequest
1743
- # data as a hash:
1744
- #
1745
- # {
1746
- # name: "AssessmentName", # required
1747
- # description: "AssessmentDescription",
1748
- # assessment_reports_destination: { # required
1749
- # destination_type: "S3", # accepts S3
1750
- # destination: "S3Url",
1751
- # },
1752
- # scope: { # required
1753
- # aws_accounts: [
1754
- # {
1755
- # id: "AccountId",
1756
- # email_address: "EmailAddress",
1757
- # name: "AccountName",
1758
- # },
1759
- # ],
1760
- # aws_services: [
1761
- # {
1762
- # service_name: "AWSServiceName",
1763
- # },
1764
- # ],
1765
- # },
1766
- # roles: [ # required
1767
- # {
1768
- # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER
1769
- # role_arn: "IamArn", # required
1770
- # },
1771
- # ],
1772
- # framework_id: "UUID", # required
1773
- # tags: {
1774
- # "TagKey" => "TagValue",
1775
- # },
1776
- # }
1777
- #
1778
1614
  # @!attribute [rw] name
1779
1615
  # The name of the assessment to be created.
1780
1616
  # @return [String]
@@ -1838,22 +1674,6 @@ module Aws::AuditManager
1838
1674
  # collection, along with related parameters and metadata. This doesn't
1839
1675
  # contain `mappingID`.
1840
1676
  #
1841
- # @note When making an API call, you may pass CreateControlMappingSource
1842
- # data as a hash:
1843
- #
1844
- # {
1845
- # source_name: "SourceName",
1846
- # source_description: "SourceDescription",
1847
- # source_set_up_option: "System_Controls_Mapping", # accepts System_Controls_Mapping, Procedural_Controls_Mapping
1848
- # source_type: "AWS_Cloudtrail", # accepts AWS_Cloudtrail, AWS_Config, AWS_Security_Hub, AWS_API_Call, MANUAL
1849
- # source_keyword: {
1850
- # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST
1851
- # keyword_value: "KeywordValue",
1852
- # },
1853
- # source_frequency: "DAILY", # accepts DAILY, WEEKLY, MONTHLY
1854
- # troubleshooting_text: "TroubleshootingText",
1855
- # }
1856
- #
1857
1677
  # @!attribute [rw] source_name
1858
1678
  # The name of the control mapping data source.
1859
1679
  # @return [String]
@@ -1919,34 +1739,6 @@ module Aws::AuditManager
1919
1739
  include Aws::Structure
1920
1740
  end
1921
1741
 
1922
- # @note When making an API call, you may pass CreateControlRequest
1923
- # data as a hash:
1924
- #
1925
- # {
1926
- # name: "ControlName", # required
1927
- # description: "ControlDescription",
1928
- # testing_information: "TestingInformation",
1929
- # action_plan_title: "ActionPlanTitle",
1930
- # action_plan_instructions: "ActionPlanInstructions",
1931
- # control_mapping_sources: [ # required
1932
- # {
1933
- # source_name: "SourceName",
1934
- # source_description: "SourceDescription",
1935
- # source_set_up_option: "System_Controls_Mapping", # accepts System_Controls_Mapping, Procedural_Controls_Mapping
1936
- # source_type: "AWS_Cloudtrail", # accepts AWS_Cloudtrail, AWS_Config, AWS_Security_Hub, AWS_API_Call, MANUAL
1937
- # source_keyword: {
1938
- # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST
1939
- # keyword_value: "KeywordValue",
1940
- # },
1941
- # source_frequency: "DAILY", # accepts DAILY, WEEKLY, MONTHLY
1942
- # troubleshooting_text: "TroubleshootingText",
1943
- # },
1944
- # ],
1945
- # tags: {
1946
- # "TagKey" => "TagValue",
1947
- # },
1948
- # }
1949
- #
1950
1742
  # @!attribute [rw] name
1951
1743
  # The name of the control.
1952
1744
  # @return [String]
@@ -2005,16 +1797,6 @@ module Aws::AuditManager
2005
1797
  # A collection of attributes that's used to create a delegation for an
2006
1798
  # assessment in Audit Manager.
2007
1799
  #
2008
- # @note When making an API call, you may pass CreateDelegationRequest
2009
- # data as a hash:
2010
- #
2011
- # {
2012
- # comment: "DelegationComment",
2013
- # control_set_id: "ControlSetId",
2014
- # role_arn: "IamArn",
2015
- # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER
2016
- # }
2017
- #
2018
1800
  # @!attribute [rw] comment
2019
1801
  # A comment that's related to the delegation request.
2020
1802
  # @return [String]
@@ -2170,13 +1952,6 @@ module Aws::AuditManager
2170
1952
  include Aws::Structure
2171
1953
  end
2172
1954
 
2173
- # @note When making an API call, you may pass DeleteAssessmentFrameworkRequest
2174
- # data as a hash:
2175
- #
2176
- # {
2177
- # framework_id: "UUID", # required
2178
- # }
2179
- #
2180
1955
  # @!attribute [rw] framework_id
2181
1956
  # The identifier for the custom framework.
2182
1957
  # @return [String]
@@ -2193,14 +1968,6 @@ module Aws::AuditManager
2193
1968
  #
2194
1969
  class DeleteAssessmentFrameworkResponse < Aws::EmptyStructure; end
2195
1970
 
2196
- # @note When making an API call, you may pass DeleteAssessmentFrameworkShareRequest
2197
- # data as a hash:
2198
- #
2199
- # {
2200
- # request_id: "UUID", # required
2201
- # request_type: "SENT", # required, accepts SENT, RECEIVED
2202
- # }
2203
- #
2204
1971
  # @!attribute [rw] request_id
2205
1972
  # The unique identifier for the share request to be deleted.
2206
1973
  # @return [String]
@@ -2223,14 +1990,6 @@ module Aws::AuditManager
2223
1990
  #
2224
1991
  class DeleteAssessmentFrameworkShareResponse < Aws::EmptyStructure; end
2225
1992
 
2226
- # @note When making an API call, you may pass DeleteAssessmentReportRequest
2227
- # data as a hash:
2228
- #
2229
- # {
2230
- # assessment_id: "UUID", # required
2231
- # assessment_report_id: "UUID", # required
2232
- # }
2233
- #
2234
1993
  # @!attribute [rw] assessment_id
2235
1994
  # The unique identifier for the assessment.
2236
1995
  # @return [String]
@@ -2252,13 +2011,6 @@ module Aws::AuditManager
2252
2011
  #
2253
2012
  class DeleteAssessmentReportResponse < Aws::EmptyStructure; end
2254
2013
 
2255
- # @note When making an API call, you may pass DeleteAssessmentRequest
2256
- # data as a hash:
2257
- #
2258
- # {
2259
- # assessment_id: "UUID", # required
2260
- # }
2261
- #
2262
2014
  # @!attribute [rw] assessment_id
2263
2015
  # The identifier for the assessment.
2264
2016
  # @return [String]
@@ -2275,13 +2027,6 @@ module Aws::AuditManager
2275
2027
  #
2276
2028
  class DeleteAssessmentResponse < Aws::EmptyStructure; end
2277
2029
 
2278
- # @note When making an API call, you may pass DeleteControlRequest
2279
- # data as a hash:
2280
- #
2281
- # {
2282
- # control_id: "UUID", # required
2283
- # }
2284
- #
2285
2030
  # @!attribute [rw] control_id
2286
2031
  # The unique identifier for the control.
2287
2032
  # @return [String]
@@ -2316,13 +2061,6 @@ module Aws::AuditManager
2316
2061
  include Aws::Structure
2317
2062
  end
2318
2063
 
2319
- # @note When making an API call, you may pass DeregisterOrganizationAdminAccountRequest
2320
- # data as a hash:
2321
- #
2322
- # {
2323
- # admin_account_id: "AccountId",
2324
- # }
2325
- #
2326
2064
  # @!attribute [rw] admin_account_id
2327
2065
  # The identifier for the administrator account.
2328
2066
  # @return [String]
@@ -2339,14 +2077,52 @@ module Aws::AuditManager
2339
2077
  #
2340
2078
  class DeregisterOrganizationAdminAccountResponse < Aws::EmptyStructure; end
2341
2079
 
2342
- # @note When making an API call, you may pass DisassociateAssessmentReportEvidenceFolderRequest
2343
- # data as a hash:
2080
+ # The deregistration policy for the data that's stored in Audit
2081
+ # Manager. You can use this attribute to determine how your data is
2082
+ # handled when you [deregister Audit Manager][1].
2083
+ #
2084
+ # By default, Audit Manager retains evidence data for two years from the
2085
+ # time of its creation. Other Audit Manager resources (including
2086
+ # assessments, custom controls, and custom frameworks) remain in Audit
2087
+ # Manager indefinitely, and are available if you [re-register Audit
2088
+ # Manager][2] in the future. For more information about data retention,
2089
+ # see [Data Protection][3] in the *Audit Manager User Guide*.
2090
+ #
2091
+ # If you choose to delete all data, this action permanently deletes all
2092
+ # evidence data in your account within seven days. It also deletes all
2093
+ # of the Audit Manager resources that you created, including
2094
+ # assessments, custom controls, and custom frameworks. Your data will
2095
+ # not be available if you re-register Audit Manager in the future.
2096
+ #
2097
+ #
2098
+ #
2099
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeregisterAccount.html
2100
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_RegisterAccount.html
2101
+ # [3]: https://docs.aws.amazon.com/audit-manager/latest/userguide/data-protection.html
2102
+ #
2103
+ # @!attribute [rw] delete_resources
2104
+ # Specifies which Audit Manager data will be deleted when you
2105
+ # deregister Audit Manager.
2344
2106
  #
2345
- # {
2346
- # assessment_id: "UUID", # required
2347
- # evidence_folder_id: "UUID", # required
2348
- # }
2107
+ # * If you set the value to `ALL`, all of your data is deleted within
2108
+ # seven days of deregistration.
2349
2109
  #
2110
+ # * If you set the value to `DEFAULT`, none of your data is deleted at
2111
+ # the time of deregistration. However, keep in mind that the Audit
2112
+ # Manager data retention policy still applies. As a result, any
2113
+ # evidence data will be deleted two years after its creation date.
2114
+ # Your other Audit Manager resources will continue to exist
2115
+ # indefinitely.
2116
+ # @return [String]
2117
+ #
2118
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/DeregistrationPolicy AWS API Documentation
2119
+ #
2120
+ class DeregistrationPolicy < Struct.new(
2121
+ :delete_resources)
2122
+ SENSITIVE = []
2123
+ include Aws::Structure
2124
+ end
2125
+
2350
2126
  # @!attribute [rw] assessment_id
2351
2127
  # The unique identifier for the assessment.
2352
2128
  # @return [String]
@@ -2370,7 +2146,7 @@ module Aws::AuditManager
2370
2146
 
2371
2147
  # A record that contains the information needed to demonstrate
2372
2148
  # compliance with the requirements specified by a control. Examples of
2373
- # evidence include change activity triggered by a user, or a system
2149
+ # evidence include change activity invoked by a user, or a system
2374
2150
  # configuration snapshot.
2375
2151
  #
2376
2152
  # @!attribute [rw] data_source
@@ -2413,10 +2189,24 @@ module Aws::AuditManager
2413
2189
  # @return [String]
2414
2190
  #
2415
2191
  # @!attribute [rw] compliance_check
2416
- # The evaluation status for evidence that falls under the compliance
2417
- # check category. For evidence collected from Security Hub, a *Pass*
2418
- # or *Fail* result is shown. For evidence collected from Config, a
2419
- # *Compliant* or *Noncompliant* result is shown.
2192
+ # The evaluation status for automated evidence that falls under the
2193
+ # compliance check category.
2194
+ #
2195
+ # * Audit Manager classes evidence as non-compliant if Security Hub
2196
+ # reports a *Fail* result, or if Config reports a *Non-compliant*
2197
+ # result.
2198
+ #
2199
+ # * Audit Manager classes evidence as compliant if Security Hub
2200
+ # reports a *Pass* result, or if Config reports a *Compliant*
2201
+ # result.
2202
+ #
2203
+ # * If a compliance check isn't available or applicable, then no
2204
+ # compliance evaluation can be made for that evidence. This is the
2205
+ # case if the evidence uses Config or Security Hub as the underlying
2206
+ # data source type, but those services aren't enabled. This is also
2207
+ # the case if the evidence uses an underlying data source type that
2208
+ # doesn't support compliance checks (such as manual evidence,
2209
+ # Amazon Web Services API calls, or CloudTrail).
2420
2210
  # @return [String]
2421
2211
  #
2422
2212
  # @!attribute [rw] aws_organization
@@ -2462,6 +2252,74 @@ module Aws::AuditManager
2462
2252
  include Aws::Structure
2463
2253
  end
2464
2254
 
2255
+ # The settings object that specifies whether evidence finder is enabled.
2256
+ # This object also describes the related event data store, and the
2257
+ # backfill status for populating the event data store with evidence
2258
+ # data.
2259
+ #
2260
+ # @!attribute [rw] event_data_store_arn
2261
+ # The Amazon Resource Name (ARN) of the CloudTrail Lake event data
2262
+ # store that’s used by evidence finder. The event data store is the
2263
+ # lake of evidence data that evidence finder runs queries against.
2264
+ # @return [String]
2265
+ #
2266
+ # @!attribute [rw] enablement_status
2267
+ # The current status of the evidence finder feature and the related
2268
+ # event data store.
2269
+ #
2270
+ # * `ENABLE_IN_PROGRESS` means that you requested to enable evidence
2271
+ # finder. An event data store is currently being created to support
2272
+ # evidence finder queries.
2273
+ #
2274
+ # * `ENABLED` means that an event data store was successfully created
2275
+ # and evidence finder is enabled. We recommend that you wait 7 days
2276
+ # until the event data store is backfilled with your past two years’
2277
+ # worth of evidence data. You can use evidence finder in the
2278
+ # meantime, but not all data might be available until the backfill
2279
+ # is complete.
2280
+ #
2281
+ # * `DISABLE_IN_PROGRESS` means that you requested to disable evidence
2282
+ # finder, and your request is pending the deletion of the event data
2283
+ # store.
2284
+ #
2285
+ # * `DISABLED` means that you have permanently disabled evidence
2286
+ # finder and the event data store has been deleted. You can't
2287
+ # re-enable evidence finder after this point.
2288
+ # @return [String]
2289
+ #
2290
+ # @!attribute [rw] backfill_status
2291
+ # The current status of the evidence data backfill process.
2292
+ #
2293
+ # The backfill starts after you enable evidence finder. During this
2294
+ # task, Audit Manager populates an event data store with your past two
2295
+ # years’ worth of evidence data so that your evidence can be queried.
2296
+ #
2297
+ # * `NOT_STARTED` means that the backfill hasn’t started yet.
2298
+ #
2299
+ # * `IN_PROGRESS` means that the backfill is in progress. This can
2300
+ # take up to 7 days to complete, depending on the amount of evidence
2301
+ # data.
2302
+ #
2303
+ # * `COMPLETED` means that the backfill is complete. All of your past
2304
+ # evidence is now queryable.
2305
+ # @return [String]
2306
+ #
2307
+ # @!attribute [rw] error
2308
+ # Represents any errors that occurred when enabling or disabling
2309
+ # evidence finder.
2310
+ # @return [String]
2311
+ #
2312
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/EvidenceFinderEnablement AWS API Documentation
2313
+ #
2314
+ class EvidenceFinderEnablement < Struct.new(
2315
+ :event_data_store_arn,
2316
+ :enablement_status,
2317
+ :backfill_status,
2318
+ :error)
2319
+ SENSITIVE = []
2320
+ include Aws::Structure
2321
+ end
2322
+
2465
2323
  # A breakdown of the latest compliance check status for the evidence in
2466
2324
  # your Audit Manager assessments.
2467
2325
  #
@@ -2547,11 +2405,11 @@ module Aws::AuditManager
2547
2405
  # @return [Array<Types::ControlSet>]
2548
2406
  #
2549
2407
  # @!attribute [rw] created_at
2550
- # Specifies when the framework was created.
2408
+ # The time when the framework was created.
2551
2409
  # @return [Time]
2552
2410
  #
2553
2411
  # @!attribute [rw] last_updated_at
2554
- # Specifies when the framework was most recently updated.
2412
+ # The time when the framework was most recently updated.
2555
2413
  # @return [Time]
2556
2414
  #
2557
2415
  # @!attribute [rw] created_by
@@ -2635,13 +2493,6 @@ module Aws::AuditManager
2635
2493
  include Aws::Structure
2636
2494
  end
2637
2495
 
2638
- # @note When making an API call, you may pass GetAssessmentFrameworkRequest
2639
- # data as a hash:
2640
- #
2641
- # {
2642
- # framework_id: "UUID", # required
2643
- # }
2644
- #
2645
2496
  # @!attribute [rw] framework_id
2646
2497
  # The identifier for the framework.
2647
2498
  # @return [String]
@@ -2666,14 +2517,6 @@ module Aws::AuditManager
2666
2517
  include Aws::Structure
2667
2518
  end
2668
2519
 
2669
- # @note When making an API call, you may pass GetAssessmentReportUrlRequest
2670
- # data as a hash:
2671
- #
2672
- # {
2673
- # assessment_report_id: "UUID", # required
2674
- # assessment_id: "UUID", # required
2675
- # }
2676
- #
2677
2520
  # @!attribute [rw] assessment_report_id
2678
2521
  # The unique identifier for the assessment report.
2679
2522
  # @return [String]
@@ -2704,13 +2547,6 @@ module Aws::AuditManager
2704
2547
  include Aws::Structure
2705
2548
  end
2706
2549
 
2707
- # @note When making an API call, you may pass GetAssessmentRequest
2708
- # data as a hash:
2709
- #
2710
- # {
2711
- # assessment_id: "UUID", # required
2712
- # }
2713
- #
2714
2550
  # @!attribute [rw] assessment_id
2715
2551
  # The unique identifier for the assessment.
2716
2552
  # @return [String]
@@ -2744,17 +2580,6 @@ module Aws::AuditManager
2744
2580
  include Aws::Structure
2745
2581
  end
2746
2582
 
2747
- # @note When making an API call, you may pass GetChangeLogsRequest
2748
- # data as a hash:
2749
- #
2750
- # {
2751
- # assessment_id: "UUID", # required
2752
- # control_set_id: "ControlSetId",
2753
- # control_id: "UUID",
2754
- # next_token: "Token",
2755
- # max_results: 1,
2756
- # }
2757
- #
2758
2583
  # @!attribute [rw] assessment_id
2759
2584
  # The unique identifier for the assessment.
2760
2585
  # @return [String]
@@ -2805,13 +2630,6 @@ module Aws::AuditManager
2805
2630
  include Aws::Structure
2806
2631
  end
2807
2632
 
2808
- # @note When making an API call, you may pass GetControlRequest
2809
- # data as a hash:
2810
- #
2811
- # {
2812
- # control_id: "UUID", # required
2813
- # }
2814
- #
2815
2633
  # @!attribute [rw] control_id
2816
2634
  # The identifier for the control.
2817
2635
  # @return [String]
@@ -2836,14 +2654,6 @@ module Aws::AuditManager
2836
2654
  include Aws::Structure
2837
2655
  end
2838
2656
 
2839
- # @note When making an API call, you may pass GetDelegationsRequest
2840
- # data as a hash:
2841
- #
2842
- # {
2843
- # next_token: "Token",
2844
- # max_results: 1,
2845
- # }
2846
- #
2847
2657
  # @!attribute [rw] next_token
2848
2658
  # The pagination token that's used to fetch the next set of results.
2849
2659
  # @return [String]
@@ -2879,17 +2689,6 @@ module Aws::AuditManager
2879
2689
  include Aws::Structure
2880
2690
  end
2881
2691
 
2882
- # @note When making an API call, you may pass GetEvidenceByEvidenceFolderRequest
2883
- # data as a hash:
2884
- #
2885
- # {
2886
- # assessment_id: "UUID", # required
2887
- # control_set_id: "ControlSetId", # required
2888
- # evidence_folder_id: "UUID", # required
2889
- # next_token: "Token",
2890
- # max_results: 1,
2891
- # }
2892
- #
2893
2692
  # @!attribute [rw] assessment_id
2894
2693
  # The identifier for the assessment.
2895
2694
  # @return [String]
@@ -2941,15 +2740,6 @@ module Aws::AuditManager
2941
2740
  include Aws::Structure
2942
2741
  end
2943
2742
 
2944
- # @note When making an API call, you may pass GetEvidenceFolderRequest
2945
- # data as a hash:
2946
- #
2947
- # {
2948
- # assessment_id: "UUID", # required
2949
- # control_set_id: "ControlSetId", # required
2950
- # evidence_folder_id: "UUID", # required
2951
- # }
2952
- #
2953
2743
  # @!attribute [rw] assessment_id
2954
2744
  # The unique identifier for the assessment.
2955
2745
  # @return [String]
@@ -2984,17 +2774,6 @@ module Aws::AuditManager
2984
2774
  include Aws::Structure
2985
2775
  end
2986
2776
 
2987
- # @note When making an API call, you may pass GetEvidenceFoldersByAssessmentControlRequest
2988
- # data as a hash:
2989
- #
2990
- # {
2991
- # assessment_id: "UUID", # required
2992
- # control_set_id: "ControlSetId", # required
2993
- # control_id: "UUID", # required
2994
- # next_token: "Token",
2995
- # max_results: 1,
2996
- # }
2997
- #
2998
2777
  # @!attribute [rw] assessment_id
2999
2778
  # The identifier for the assessment.
3000
2779
  # @return [String]
@@ -3046,15 +2825,6 @@ module Aws::AuditManager
3046
2825
  include Aws::Structure
3047
2826
  end
3048
2827
 
3049
- # @note When making an API call, you may pass GetEvidenceFoldersByAssessmentRequest
3050
- # data as a hash:
3051
- #
3052
- # {
3053
- # assessment_id: "UUID", # required
3054
- # next_token: "Token",
3055
- # max_results: 1,
3056
- # }
3057
- #
3058
2828
  # @!attribute [rw] assessment_id
3059
2829
  # The unique identifier for the assessment.
3060
2830
  # @return [String]
@@ -3096,16 +2866,6 @@ module Aws::AuditManager
3096
2866
  include Aws::Structure
3097
2867
  end
3098
2868
 
3099
- # @note When making an API call, you may pass GetEvidenceRequest
3100
- # data as a hash:
3101
- #
3102
- # {
3103
- # assessment_id: "UUID", # required
3104
- # control_set_id: "ControlSetId", # required
3105
- # evidence_folder_id: "UUID", # required
3106
- # evidence_id: "UUID", # required
3107
- # }
3108
- #
3109
2869
  # @!attribute [rw] assessment_id
3110
2870
  # The unique identifier for the assessment.
3111
2871
  # @return [String]
@@ -3134,7 +2894,7 @@ module Aws::AuditManager
3134
2894
  end
3135
2895
 
3136
2896
  # @!attribute [rw] evidence
3137
- # The evidence that the `GetEvidenceResponse` API returned.
2897
+ # The evidence that the `GetEvidence` API returned.
3138
2898
  # @return [Types::Evidence]
3139
2899
  #
3140
2900
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetEvidenceResponse AWS API Documentation
@@ -3145,13 +2905,6 @@ module Aws::AuditManager
3145
2905
  include Aws::Structure
3146
2906
  end
3147
2907
 
3148
- # @note When making an API call, you may pass GetInsightsByAssessmentRequest
3149
- # data as a hash:
3150
- #
3151
- # {
3152
- # assessment_id: "UUID", # required
3153
- # }
3154
- #
3155
2908
  # @!attribute [rw] assessment_id
3156
2909
  # The unique identifier for the assessment.
3157
2910
  # @return [String]
@@ -3236,15 +2989,8 @@ module Aws::AuditManager
3236
2989
  include Aws::Structure
3237
2990
  end
3238
2991
 
3239
- # @note When making an API call, you may pass GetSettingsRequest
3240
- # data as a hash:
3241
- #
3242
- # {
3243
- # attribute: "ALL", # required, accepts ALL, IS_AWS_ORG_ENABLED, SNS_TOPIC, DEFAULT_ASSESSMENT_REPORTS_DESTINATION, DEFAULT_PROCESS_OWNERS
3244
- # }
3245
- #
3246
2992
  # @!attribute [rw] attribute
3247
- # The list of `SettingAttribute` enum values.
2993
+ # The list of setting attribute enum values.
3248
2994
  # @return [String]
3249
2995
  #
3250
2996
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetSettingsRequest AWS API Documentation
@@ -3448,16 +3194,6 @@ module Aws::AuditManager
3448
3194
  include Aws::Structure
3449
3195
  end
3450
3196
 
3451
- # @note When making an API call, you may pass ListAssessmentControlInsightsByControlDomainRequest
3452
- # data as a hash:
3453
- #
3454
- # {
3455
- # control_domain_id: "UUID", # required
3456
- # assessment_id: "UUID", # required
3457
- # next_token: "Token",
3458
- # max_results: 1,
3459
- # }
3460
- #
3461
3197
  # @!attribute [rw] control_domain_id
3462
3198
  # The unique identifier for the control domain.
3463
3199
  # @return [String]
@@ -3504,15 +3240,6 @@ module Aws::AuditManager
3504
3240
  include Aws::Structure
3505
3241
  end
3506
3242
 
3507
- # @note When making an API call, you may pass ListAssessmentFrameworkShareRequestsRequest
3508
- # data as a hash:
3509
- #
3510
- # {
3511
- # request_type: "SENT", # required, accepts SENT, RECEIVED
3512
- # next_token: "Token",
3513
- # max_results: 1,
3514
- # }
3515
- #
3516
3243
  # @!attribute [rw] request_type
3517
3244
  # Specifies whether the share request is a sent request or a received
3518
3245
  # request.
@@ -3555,15 +3282,6 @@ module Aws::AuditManager
3555
3282
  include Aws::Structure
3556
3283
  end
3557
3284
 
3558
- # @note When making an API call, you may pass ListAssessmentFrameworksRequest
3559
- # data as a hash:
3560
- #
3561
- # {
3562
- # framework_type: "Standard", # required, accepts Standard, Custom
3563
- # next_token: "Token",
3564
- # max_results: 1,
3565
- # }
3566
- #
3567
3285
  # @!attribute [rw] framework_type
3568
3286
  # The type of framework, such as a standard framework or a custom
3569
3287
  # framework.
@@ -3605,14 +3323,6 @@ module Aws::AuditManager
3605
3323
  include Aws::Structure
3606
3324
  end
3607
3325
 
3608
- # @note When making an API call, you may pass ListAssessmentReportsRequest
3609
- # data as a hash:
3610
- #
3611
- # {
3612
- # next_token: "Token",
3613
- # max_results: 1,
3614
- # }
3615
- #
3616
3326
  # @!attribute [rw] next_token
3617
3327
  # The pagination token that's used to fetch the next set of results.
3618
3328
  # @return [String]
@@ -3649,15 +3359,6 @@ module Aws::AuditManager
3649
3359
  include Aws::Structure
3650
3360
  end
3651
3361
 
3652
- # @note When making an API call, you may pass ListAssessmentsRequest
3653
- # data as a hash:
3654
- #
3655
- # {
3656
- # status: "ACTIVE", # accepts ACTIVE, INACTIVE
3657
- # next_token: "Token",
3658
- # max_results: 1,
3659
- # }
3660
- #
3661
3362
  # @!attribute [rw] status
3662
3363
  # The current status of the assessment.
3663
3364
  # @return [String]
@@ -3698,15 +3399,6 @@ module Aws::AuditManager
3698
3399
  include Aws::Structure
3699
3400
  end
3700
3401
 
3701
- # @note When making an API call, you may pass ListControlDomainInsightsByAssessmentRequest
3702
- # data as a hash:
3703
- #
3704
- # {
3705
- # assessment_id: "UUID", # required
3706
- # next_token: "Token",
3707
- # max_results: 1,
3708
- # }
3709
- #
3710
3402
  # @!attribute [rw] assessment_id
3711
3403
  # The unique identifier for the active assessment.
3712
3404
  # @return [String]
@@ -3748,14 +3440,6 @@ module Aws::AuditManager
3748
3440
  include Aws::Structure
3749
3441
  end
3750
3442
 
3751
- # @note When making an API call, you may pass ListControlDomainInsightsRequest
3752
- # data as a hash:
3753
- #
3754
- # {
3755
- # next_token: "Token",
3756
- # max_results: 1,
3757
- # }
3758
- #
3759
3443
  # @!attribute [rw] next_token
3760
3444
  # The pagination token that's used to fetch the next set of results.
3761
3445
  # @return [String]
@@ -3792,15 +3476,6 @@ module Aws::AuditManager
3792
3476
  include Aws::Structure
3793
3477
  end
3794
3478
 
3795
- # @note When making an API call, you may pass ListControlInsightsByControlDomainRequest
3796
- # data as a hash:
3797
- #
3798
- # {
3799
- # control_domain_id: "UUID", # required
3800
- # next_token: "Token",
3801
- # max_results: 1,
3802
- # }
3803
- #
3804
3479
  # @!attribute [rw] control_domain_id
3805
3480
  # The unique identifier for the control domain.
3806
3481
  # @return [String]
@@ -3842,15 +3517,6 @@ module Aws::AuditManager
3842
3517
  include Aws::Structure
3843
3518
  end
3844
3519
 
3845
- # @note When making an API call, you may pass ListControlsRequest
3846
- # data as a hash:
3847
- #
3848
- # {
3849
- # control_type: "Standard", # required, accepts Standard, Custom
3850
- # next_token: "Token",
3851
- # max_results: 1,
3852
- # }
3853
- #
3854
3520
  # @!attribute [rw] control_type
3855
3521
  # The type of control, such as a standard control or a custom control.
3856
3522
  # @return [String]
@@ -3892,15 +3558,6 @@ module Aws::AuditManager
3892
3558
  include Aws::Structure
3893
3559
  end
3894
3560
 
3895
- # @note When making an API call, you may pass ListKeywordsForDataSourceRequest
3896
- # data as a hash:
3897
- #
3898
- # {
3899
- # source: "AWS_Cloudtrail", # required, accepts AWS_Cloudtrail, AWS_Config, AWS_Security_Hub, AWS_API_Call, MANUAL
3900
- # next_token: "Token",
3901
- # max_results: 1,
3902
- # }
3903
- #
3904
3561
  # @!attribute [rw] source
3905
3562
  # The control mapping data source that the keywords apply to.
3906
3563
  # @return [String]
@@ -3941,14 +3598,6 @@ module Aws::AuditManager
3941
3598
  include Aws::Structure
3942
3599
  end
3943
3600
 
3944
- # @note When making an API call, you may pass ListNotificationsRequest
3945
- # data as a hash:
3946
- #
3947
- # {
3948
- # next_token: "Token",
3949
- # max_results: 1,
3950
- # }
3951
- #
3952
3601
  # @!attribute [rw] next_token
3953
3602
  # The pagination token that's used to fetch the next set of results.
3954
3603
  # @return [String]
@@ -3984,13 +3633,6 @@ module Aws::AuditManager
3984
3633
  include Aws::Structure
3985
3634
  end
3986
3635
 
3987
- # @note When making an API call, you may pass ListTagsForResourceRequest
3988
- # data as a hash:
3989
- #
3990
- # {
3991
- # resource_arn: "AuditManagerArn", # required
3992
- # }
3993
- #
3994
3636
  # @!attribute [rw] resource_arn
3995
3637
  # The Amazon Resource Name (ARN) of the resource.
3996
3638
  # @return [String]
@@ -4017,13 +3659,6 @@ module Aws::AuditManager
4017
3659
 
4018
3660
  # Evidence that's uploaded to Audit Manager manually.
4019
3661
  #
4020
- # @note When making an API call, you may pass ManualEvidence
4021
- # data as a hash:
4022
- #
4023
- # {
4024
- # s3_resource_path: "S3Url",
4025
- # }
4026
- #
4027
3662
  # @!attribute [rw] s3_resource_path
4028
3663
  # The Amazon S3 URL that points to a manual evidence object.
4029
3664
  # @return [String]
@@ -4088,14 +3723,6 @@ module Aws::AuditManager
4088
3723
  include Aws::Structure
4089
3724
  end
4090
3725
 
4091
- # @note When making an API call, you may pass RegisterAccountRequest
4092
- # data as a hash:
4093
- #
4094
- # {
4095
- # kms_key: "KmsKey",
4096
- # delegated_admin_account: "AccountId",
4097
- # }
4098
- #
4099
3726
  # @!attribute [rw] kms_key
4100
3727
  # The KMS key details.
4101
3728
  # @return [String]
@@ -4125,13 +3752,6 @@ module Aws::AuditManager
4125
3752
  include Aws::Structure
4126
3753
  end
4127
3754
 
4128
- # @note When making an API call, you may pass RegisterOrganizationAdminAccountRequest
4129
- # data as a hash:
4130
- #
4131
- # {
4132
- # admin_account_id: "AccountId", # required
4133
- # }
4134
- #
4135
3755
  # @!attribute [rw] admin_account_id
4136
3756
  # The identifier for the delegated administrator account.
4137
3757
  # @return [String]
@@ -4171,11 +3791,34 @@ module Aws::AuditManager
4171
3791
  # The value of the resource.
4172
3792
  # @return [String]
4173
3793
  #
3794
+ # @!attribute [rw] compliance_check
3795
+ # The evaluation status for a resource that was assessed when
3796
+ # collecting compliance check evidence.
3797
+ #
3798
+ # * Audit Manager classes the resource as non-compliant if Security
3799
+ # Hub reports a *Fail* result, or if Config reports a
3800
+ # *Non-compliant* result.
3801
+ #
3802
+ # * Audit Manager classes the resource as compliant if Security Hub
3803
+ # reports a *Pass* result, or if Config reports a *Compliant*
3804
+ # result.
3805
+ #
3806
+ # * If a compliance check isn't available or applicable, then no
3807
+ # compliance evaluation can be made for that resource. This is the
3808
+ # case if a resource assessment uses Config or Security Hub as the
3809
+ # underlying data source type, but those services aren't enabled.
3810
+ # This is also the case if the resource assessment uses an
3811
+ # underlying data source type that doesn't support compliance
3812
+ # checks (such as manual evidence, Amazon Web Services API calls, or
3813
+ # CloudTrail).
3814
+ # @return [String]
3815
+ #
4174
3816
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/Resource AWS API Documentation
4175
3817
  #
4176
3818
  class Resource < Struct.new(
4177
3819
  :arn,
4178
- :value)
3820
+ :value,
3821
+ :compliance_check)
4179
3822
  SENSITIVE = []
4180
3823
  include Aws::Structure
4181
3824
  end
@@ -4207,14 +3850,6 @@ module Aws::AuditManager
4207
3850
  # current user. This includes the role type and IAM Amazon Resource Name
4208
3851
  # (ARN).
4209
3852
  #
4210
- # @note When making an API call, you may pass Role
4211
- # data as a hash:
4212
- #
4213
- # {
4214
- # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER
4215
- # role_arn: "IamArn", # required
4216
- # }
4217
- #
4218
3853
  # @!attribute [rw] role_type
4219
3854
  # The type of customer persona.
4220
3855
  #
@@ -4244,24 +3879,6 @@ module Aws::AuditManager
4244
3879
  # The wrapper that contains the Amazon Web Services accounts and
4245
3880
  # services that are in scope for the assessment.
4246
3881
  #
4247
- # @note When making an API call, you may pass Scope
4248
- # data as a hash:
4249
- #
4250
- # {
4251
- # aws_accounts: [
4252
- # {
4253
- # id: "AccountId",
4254
- # email_address: "EmailAddress",
4255
- # name: "AccountName",
4256
- # },
4257
- # ],
4258
- # aws_services: [
4259
- # {
4260
- # service_name: "AWSServiceName",
4261
- # },
4262
- # ],
4263
- # }
4264
- #
4265
3882
  # @!attribute [rw] aws_accounts
4266
3883
  # The Amazon Web Services accounts that are included in the scope of
4267
3884
  # the assessment.
@@ -4356,6 +3973,16 @@ module Aws::AuditManager
4356
3973
  # The KMS key details.
4357
3974
  # @return [String]
4358
3975
  #
3976
+ # @!attribute [rw] evidence_finder_enablement
3977
+ # The current evidence finder status and event data store details.
3978
+ # @return [Types::EvidenceFinderEnablement]
3979
+ #
3980
+ # @!attribute [rw] deregistration_policy
3981
+ # The deregistration policy for your Audit Manager data. You can use
3982
+ # this attribute to determine how your data is handled when you
3983
+ # deregister Audit Manager.
3984
+ # @return [Types::DeregistrationPolicy]
3985
+ #
4359
3986
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/Settings AWS API Documentation
4360
3987
  #
4361
3988
  class Settings < Struct.new(
@@ -4363,7 +3990,9 @@ module Aws::AuditManager
4363
3990
  :sns_topic,
4364
3991
  :default_assessment_reports_destination,
4365
3992
  :default_process_owners,
4366
- :kms_key)
3993
+ :kms_key,
3994
+ :evidence_finder_enablement,
3995
+ :deregistration_policy)
4367
3996
  SENSITIVE = []
4368
3997
  include Aws::Structure
4369
3998
  end
@@ -4390,14 +4019,6 @@ module Aws::AuditManager
4390
4019
  # [3]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-api.html
4391
4020
  # [4]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-cloudtrail.html
4392
4021
  #
4393
- # @note When making an API call, you may pass SourceKeyword
4394
- # data as a hash:
4395
- #
4396
- # {
4397
- # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST
4398
- # keyword_value: "KeywordValue",
4399
- # }
4400
- #
4401
4022
  # @!attribute [rw] keyword_input_type
4402
4023
  # The input method for the keyword.
4403
4024
  # @return [String]
@@ -4437,11 +4058,6 @@ module Aws::AuditManager
4437
4058
  # `keywordValue`\: `Custom_CustomRuleForAccount-conformance-pack`
4438
4059
  #
4439
4060
  # * Service-linked rule name:
4440
- # securityhub-api-gw-cache-encrypted-101104e1
4441
- #
4442
- # `keywordValue`\: `Custom_securityhub-api-gw-cache-encrypted`
4443
- #
4444
- # * Service-linked rule name:
4445
4061
  # OrgConfigRule-s3-bucket-versioning-enabled-dbgzf8ba
4446
4062
  #
4447
4063
  # `keywordValue`\:
@@ -4465,16 +4081,6 @@ module Aws::AuditManager
4465
4081
  include Aws::Structure
4466
4082
  end
4467
4083
 
4468
- # @note When making an API call, you may pass StartAssessmentFrameworkShareRequest
4469
- # data as a hash:
4470
- #
4471
- # {
4472
- # framework_id: "UUID", # required
4473
- # destination_account: "AccountId", # required
4474
- # destination_region: "Region", # required
4475
- # comment: "ShareRequestComment",
4476
- # }
4477
- #
4478
4084
  # @!attribute [rw] framework_id
4479
4085
  # The unique identifier for the custom framework to be shared.
4480
4086
  # @return [String]
@@ -4515,16 +4121,6 @@ module Aws::AuditManager
4515
4121
  include Aws::Structure
4516
4122
  end
4517
4123
 
4518
- # @note When making an API call, you may pass TagResourceRequest
4519
- # data as a hash:
4520
- #
4521
- # {
4522
- # resource_arn: "AuditManagerArn", # required
4523
- # tags: { # required
4524
- # "TagKey" => "TagValue",
4525
- # },
4526
- # }
4527
- #
4528
4124
  # @!attribute [rw] resource_arn
4529
4125
  # The Amazon Resource Name (ARN) of the resource.
4530
4126
  # @return [String]
@@ -4579,14 +4175,6 @@ module Aws::AuditManager
4579
4175
  include Aws::Structure
4580
4176
  end
4581
4177
 
4582
- # @note When making an API call, you may pass UntagResourceRequest
4583
- # data as a hash:
4584
- #
4585
- # {
4586
- # resource_arn: "AuditManagerArn", # required
4587
- # tag_keys: ["TagKey"], # required
4588
- # }
4589
- #
4590
4178
  # @!attribute [rw] resource_arn
4591
4179
  # The Amazon Resource Name (ARN) of the specified resource.
4592
4180
  # @return [String]
@@ -4608,17 +4196,6 @@ module Aws::AuditManager
4608
4196
  #
4609
4197
  class UntagResourceResponse < Aws::EmptyStructure; end
4610
4198
 
4611
- # @note When making an API call, you may pass UpdateAssessmentControlRequest
4612
- # data as a hash:
4613
- #
4614
- # {
4615
- # assessment_id: "UUID", # required
4616
- # control_set_id: "ControlSetId", # required
4617
- # control_id: "UUID", # required
4618
- # control_status: "UNDER_REVIEW", # accepts UNDER_REVIEW, REVIEWED, INACTIVE
4619
- # comment_body: "ControlCommentBody",
4620
- # }
4621
- #
4622
4199
  # @!attribute [rw] assessment_id
4623
4200
  # The unique identifier for the assessment.
4624
4201
  # @return [String]
@@ -4664,16 +4241,6 @@ module Aws::AuditManager
4664
4241
  include Aws::Structure
4665
4242
  end
4666
4243
 
4667
- # @note When making an API call, you may pass UpdateAssessmentControlSetStatusRequest
4668
- # data as a hash:
4669
- #
4670
- # {
4671
- # assessment_id: "UUID", # required
4672
- # control_set_id: "String", # required
4673
- # status: "ACTIVE", # required, accepts ACTIVE, UNDER_REVIEW, REVIEWED
4674
- # comment: "DelegationComment", # required
4675
- # }
4676
- #
4677
4244
  # @!attribute [rw] assessment_id
4678
4245
  # The unique identifier for the assessment.
4679
4246
  # @return [String]
@@ -4717,19 +4284,6 @@ module Aws::AuditManager
4717
4284
  # A `controlSet` entity that represents a collection of controls in
4718
4285
  # Audit Manager. This doesn't contain the control set ID.
4719
4286
  #
4720
- # @note When making an API call, you may pass UpdateAssessmentFrameworkControlSet
4721
- # data as a hash:
4722
- #
4723
- # {
4724
- # id: "ControlSetName",
4725
- # name: "ControlSetName", # required
4726
- # controls: [ # required
4727
- # {
4728
- # id: "UUID", # required
4729
- # },
4730
- # ],
4731
- # }
4732
- #
4733
4287
  # @!attribute [rw] id
4734
4288
  # The unique identifier for the control set.
4735
4289
  # @return [String]
@@ -4752,27 +4306,6 @@ module Aws::AuditManager
4752
4306
  include Aws::Structure
4753
4307
  end
4754
4308
 
4755
- # @note When making an API call, you may pass UpdateAssessmentFrameworkRequest
4756
- # data as a hash:
4757
- #
4758
- # {
4759
- # framework_id: "UUID", # required
4760
- # name: "FrameworkName", # required
4761
- # description: "FrameworkDescription",
4762
- # compliance_type: "ComplianceType",
4763
- # control_sets: [ # required
4764
- # {
4765
- # id: "ControlSetName",
4766
- # name: "ControlSetName", # required
4767
- # controls: [ # required
4768
- # {
4769
- # id: "UUID", # required
4770
- # },
4771
- # ],
4772
- # },
4773
- # ],
4774
- # }
4775
- #
4776
4309
  # @!attribute [rw] framework_id
4777
4310
  # The unique identifier for the framework.
4778
4311
  # @return [String]
@@ -4818,15 +4351,6 @@ module Aws::AuditManager
4818
4351
  include Aws::Structure
4819
4352
  end
4820
4353
 
4821
- # @note When making an API call, you may pass UpdateAssessmentFrameworkShareRequest
4822
- # data as a hash:
4823
- #
4824
- # {
4825
- # request_id: "UUID", # required
4826
- # request_type: "SENT", # required, accepts SENT, RECEIVED
4827
- # action: "ACCEPT", # required, accepts ACCEPT, DECLINE, REVOKE
4828
- # }
4829
- #
4830
4354
  # @!attribute [rw] request_id
4831
4355
  # The unique identifier for the share request.
4832
4356
  # @return [String]
@@ -4863,39 +4387,6 @@ module Aws::AuditManager
4863
4387
  include Aws::Structure
4864
4388
  end
4865
4389
 
4866
- # @note When making an API call, you may pass UpdateAssessmentRequest
4867
- # data as a hash:
4868
- #
4869
- # {
4870
- # assessment_id: "UUID", # required
4871
- # assessment_name: "AssessmentName",
4872
- # assessment_description: "AssessmentDescription",
4873
- # scope: { # required
4874
- # aws_accounts: [
4875
- # {
4876
- # id: "AccountId",
4877
- # email_address: "EmailAddress",
4878
- # name: "AccountName",
4879
- # },
4880
- # ],
4881
- # aws_services: [
4882
- # {
4883
- # service_name: "AWSServiceName",
4884
- # },
4885
- # ],
4886
- # },
4887
- # assessment_reports_destination: {
4888
- # destination_type: "S3", # accepts S3
4889
- # destination: "S3Url",
4890
- # },
4891
- # roles: [
4892
- # {
4893
- # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER
4894
- # role_arn: "IamArn", # required
4895
- # },
4896
- # ],
4897
- # }
4898
- #
4899
4390
  # @!attribute [rw] assessment_id
4900
4391
  # The unique identifier for the assessment.
4901
4392
  # @return [String]
@@ -4935,8 +4426,8 @@ module Aws::AuditManager
4935
4426
  end
4936
4427
 
4937
4428
  # @!attribute [rw] assessment
4938
- # The response object for the `UpdateAssessmentRequest` API. This is
4939
- # the name of the updated assessment.
4429
+ # The response object for the `UpdateAssessment` API. This is the name
4430
+ # of the updated assessment.
4940
4431
  # @return [Types::Assessment]
4941
4432
  #
4942
4433
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/UpdateAssessmentResponse AWS API Documentation
@@ -4947,14 +4438,6 @@ module Aws::AuditManager
4947
4438
  include Aws::Structure
4948
4439
  end
4949
4440
 
4950
- # @note When making an API call, you may pass UpdateAssessmentStatusRequest
4951
- # data as a hash:
4952
- #
4953
- # {
4954
- # assessment_id: "UUID", # required
4955
- # status: "ACTIVE", # required, accepts ACTIVE, INACTIVE
4956
- # }
4957
- #
4958
4441
  # @!attribute [rw] assessment_id
4959
4442
  # The unique identifier for the assessment.
4960
4443
  # @return [String]
@@ -4985,33 +4468,6 @@ module Aws::AuditManager
4985
4468
  include Aws::Structure
4986
4469
  end
4987
4470
 
4988
- # @note When making an API call, you may pass UpdateControlRequest
4989
- # data as a hash:
4990
- #
4991
- # {
4992
- # control_id: "UUID", # required
4993
- # name: "ControlName", # required
4994
- # description: "ControlDescription",
4995
- # testing_information: "TestingInformation",
4996
- # action_plan_title: "ActionPlanTitle",
4997
- # action_plan_instructions: "ActionPlanInstructions",
4998
- # control_mapping_sources: [ # required
4999
- # {
5000
- # source_id: "UUID",
5001
- # source_name: "SourceName",
5002
- # source_description: "SourceDescription",
5003
- # source_set_up_option: "System_Controls_Mapping", # accepts System_Controls_Mapping, Procedural_Controls_Mapping
5004
- # source_type: "AWS_Cloudtrail", # accepts AWS_Cloudtrail, AWS_Config, AWS_Security_Hub, AWS_API_Call, MANUAL
5005
- # source_keyword: {
5006
- # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST
5007
- # keyword_value: "KeywordValue",
5008
- # },
5009
- # source_frequency: "DAILY", # accepts DAILY, WEEKLY, MONTHLY
5010
- # troubleshooting_text: "TroubleshootingText",
5011
- # },
5012
- # ],
5013
- # }
5014
- #
5015
4471
  # @!attribute [rw] control_id
5016
4472
  # The identifier for the control.
5017
4473
  # @return [String]
@@ -5068,24 +4524,6 @@ module Aws::AuditManager
5068
4524
  include Aws::Structure
5069
4525
  end
5070
4526
 
5071
- # @note When making an API call, you may pass UpdateSettingsRequest
5072
- # data as a hash:
5073
- #
5074
- # {
5075
- # sns_topic: "SnsArn",
5076
- # default_assessment_reports_destination: {
5077
- # destination_type: "S3", # accepts S3
5078
- # destination: "S3Url",
5079
- # },
5080
- # default_process_owners: [
5081
- # {
5082
- # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER
5083
- # role_arn: "IamArn", # required
5084
- # },
5085
- # ],
5086
- # kms_key: "KmsKey",
5087
- # }
5088
- #
5089
4527
  # @!attribute [rw] sns_topic
5090
4528
  # The Amazon Simple Notification Service (Amazon SNS) topic that Audit
5091
4529
  # Manager sends notifications to.
@@ -5103,13 +4541,37 @@ module Aws::AuditManager
5103
4541
  # The KMS key details.
5104
4542
  # @return [String]
5105
4543
  #
4544
+ # @!attribute [rw] evidence_finder_enabled
4545
+ # Specifies whether the evidence finder feature is enabled. Change
4546
+ # this attribute to enable or disable evidence finder.
4547
+ #
4548
+ # When you use this attribute to disable evidence finder, Audit
4549
+ # Manager deletes the event data store that’s used to query your
4550
+ # evidence data. As a result, you can’t re-enable evidence finder and
4551
+ # use the feature again. Your only alternative is to [deregister][1]
4552
+ # and then [re-register][2] Audit Manager.
4553
+ #
4554
+ #
4555
+ #
4556
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_DeregisterAccount.html
4557
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_RegisterAccount.html
4558
+ # @return [Boolean]
4559
+ #
4560
+ # @!attribute [rw] deregistration_policy
4561
+ # The deregistration policy for your Audit Manager data. You can use
4562
+ # this attribute to determine how your data is handled when you
4563
+ # deregister Audit Manager.
4564
+ # @return [Types::DeregistrationPolicy]
4565
+ #
5106
4566
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/UpdateSettingsRequest AWS API Documentation
5107
4567
  #
5108
4568
  class UpdateSettingsRequest < Struct.new(
5109
4569
  :sns_topic,
5110
4570
  :default_assessment_reports_destination,
5111
4571
  :default_process_owners,
5112
- :kms_key)
4572
+ :kms_key,
4573
+ :evidence_finder_enabled,
4574
+ :deregistration_policy)
5113
4575
  SENSITIVE = []
5114
4576
  include Aws::Structure
5115
4577
  end
@@ -5126,13 +4588,6 @@ module Aws::AuditManager
5126
4588
  include Aws::Structure
5127
4589
  end
5128
4590
 
5129
- # @note When making an API call, you may pass ValidateAssessmentReportIntegrityRequest
5130
- # data as a hash:
5131
- #
5132
- # {
5133
- # s3_relative_path: "S3Url", # required
5134
- # }
5135
- #
5136
4591
  # @!attribute [rw] s3_relative_path
5137
4592
  # The relative path of the Amazon S3 bucket that the assessment report
5138
4593
  # is stored in.