aws-sdk-auditmanager 1.32.0 → 1.34.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ecebd55933a905e415184c5b1621071801311a3e06f88dda32b0e718710fb9b1
4
- data.tar.gz: 64fba66b517e923c647fc90cc2d71a23159539864ec645ee41a6439d0ee694b5
3
+ metadata.gz: 500753188ee5249f02335904363dd9c2ca12c766719c5f4fc5e1241ae9a9bea7
4
+ data.tar.gz: 56e8d0a0a0ae4c025a10b0aeb13a82fa0fee8654b9c2c17c58d0f77c8029442f
5
5
  SHA512:
6
- metadata.gz: 263d9275451f8ec7fdc889c2b11c496996681cab6ff8a001b8c34cf1f984ea2971acce01df4cbb2d0279b732c5f67f748ff897cf5b22e9e902e90afe07ee25c4
7
- data.tar.gz: a4484026dc0c02eaa9bfc05f34fffb3ad5ba36067c15a317822cd7380ff51920744e7b3856a16c3291700e79bcb28373ef0233afaf86ec509f1d586ac1f986c7
6
+ metadata.gz: 5e70ce600d3e959c7ba5d8e8166b2ad1f601e91c9bf20d421d97372cabe6d5988e0ddbabd9e3022ff4236beca305682fd179a61236c5b797e7e6ac341d58abe1
7
+ data.tar.gz: 1c45aec9361218f095471fb5224a1e51fcbaf095e236dbd595fa80418af2c1f7f79c47353a447f5ba6532251595fc574032ec812968b46f1206ed65417160d2f
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.34.0 (2023-06-28)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.33.0 (2023-06-15)
10
+ ------------------
11
+
12
+ * Feature - This release introduces 2 Audit Manager features: CSV exports and new manual evidence options. You can now export your evidence finder results in CSV format. In addition, you can now add manual evidence to a control by entering free-form text or uploading a file from your browser.
13
+
4
14
  1.32.0 (2023-05-31)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.32.0
1
+ 1.34.0
@@ -579,34 +579,32 @@ module Aws::AuditManager
579
579
  req.send_request(options)
580
580
  end
581
581
 
582
- # Uploads one or more pieces of evidence to a control in an Audit
583
- # Manager assessment. You can upload manual evidence from any Amazon
584
- # Simple Storage Service (Amazon S3) bucket by specifying the S3 URI of
585
- # the evidence.
582
+ # Adds one or more pieces of evidence to a control in an Audit Manager
583
+ # assessment.
586
584
  #
587
- # You must upload manual evidence to your S3 bucket before you can
588
- # upload it to your assessment. For instructions, see [CreateBucket][1]
589
- # and [PutObject][2] in the *Amazon Simple Storage Service API
590
- # Reference.*
585
+ # You can import manual evidence from any S3 bucket by specifying the S3
586
+ # URI of the object. You can also upload a file from your browser, or
587
+ # enter plain text in response to a risk assessment question.
591
588
  #
592
589
  # The following restrictions apply to this action:
593
590
  #
591
+ # * `manualEvidence` can be only one of the following:
592
+ # `evidenceFileName`, `s3ResourcePath`, or `textResponse`
593
+ #
594
594
  # * Maximum size of an individual evidence file: 100 MB
595
595
  #
596
596
  # * Number of daily manual evidence uploads per control: 100
597
597
  #
598
598
  # * Supported file formats: See [Supported file types for manual
599
- # evidence][3] in the *Audit Manager User Guide*
599
+ # evidence][1] in the *Audit Manager User Guide*
600
600
  #
601
601
  # For more information about Audit Manager service restrictions, see
602
- # [Quotas and restrictions for Audit Manager][4].
602
+ # [Quotas and restrictions for Audit Manager][2].
603
603
  #
604
604
  #
605
605
  #
606
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
607
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
608
- # [3]: https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#supported-manual-evidence-files
609
- # [4]: https://docs.aws.amazon.com/audit-manager/latest/userguide/service-quotas.html
606
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#supported-manual-evidence-files
607
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/service-quotas.html
610
608
  #
611
609
  # @option params [required, String] :assessment_id
612
610
  # The identifier for the assessment.
@@ -633,6 +631,8 @@ module Aws::AuditManager
633
631
  # manual_evidence: [ # required
634
632
  # {
635
633
  # s3_resource_path: "S3Url",
634
+ # text_response: "ManualEvidenceTextResponse",
635
+ # evidence_file_name: "ManualEvidenceLocalFileName",
636
636
  # },
637
637
  # ],
638
638
  # })
@@ -641,6 +641,8 @@ module Aws::AuditManager
641
641
  #
642
642
  # resp.errors #=> Array
643
643
  # resp.errors[0].manual_evidence.s3_resource_path #=> String
644
+ # resp.errors[0].manual_evidence.text_response #=> String
645
+ # resp.errors[0].manual_evidence.evidence_file_name #=> String
644
646
  # resp.errors[0].error_code #=> String
645
647
  # resp.errors[0].error_message #=> String
646
648
  #
@@ -879,7 +881,7 @@ module Aws::AuditManager
879
881
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_description #=> String
880
882
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_set_up_option #=> String, one of "System_Controls_Mapping", "Procedural_Controls_Mapping"
881
883
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_type #=> String, one of "AWS_Cloudtrail", "AWS_Config", "AWS_Security_Hub", "AWS_API_Call", "MANUAL"
882
- # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST"
884
+ # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST", "UPLOAD_FILE", "INPUT_TEXT"
883
885
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_value #=> String
884
886
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_frequency #=> String, one of "DAILY", "WEEKLY", "MONTHLY"
885
887
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].troubleshooting_text #=> String
@@ -1016,7 +1018,7 @@ module Aws::AuditManager
1016
1018
  # source_set_up_option: "System_Controls_Mapping", # accepts System_Controls_Mapping, Procedural_Controls_Mapping
1017
1019
  # source_type: "AWS_Cloudtrail", # accepts AWS_Cloudtrail, AWS_Config, AWS_Security_Hub, AWS_API_Call, MANUAL
1018
1020
  # source_keyword: {
1019
- # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST
1021
+ # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST, UPLOAD_FILE, INPUT_TEXT
1020
1022
  # keyword_value: "KeywordValue",
1021
1023
  # },
1022
1024
  # source_frequency: "DAILY", # accepts DAILY, WEEKLY, MONTHLY
@@ -1045,7 +1047,7 @@ module Aws::AuditManager
1045
1047
  # resp.control.control_mapping_sources[0].source_description #=> String
1046
1048
  # resp.control.control_mapping_sources[0].source_set_up_option #=> String, one of "System_Controls_Mapping", "Procedural_Controls_Mapping"
1047
1049
  # resp.control.control_mapping_sources[0].source_type #=> String, one of "AWS_Cloudtrail", "AWS_Config", "AWS_Security_Hub", "AWS_API_Call", "MANUAL"
1048
- # resp.control.control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST"
1050
+ # resp.control.control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST", "UPLOAD_FILE", "INPUT_TEXT"
1049
1051
  # resp.control.control_mapping_sources[0].source_keyword.keyword_value #=> String
1050
1052
  # resp.control.control_mapping_sources[0].source_frequency #=> String, one of "DAILY", "WEEKLY", "MONTHLY"
1051
1053
  # resp.control.control_mapping_sources[0].troubleshooting_text #=> String
@@ -1192,6 +1194,12 @@ module Aws::AuditManager
1192
1194
 
1193
1195
  # Deletes a custom control in Audit Manager.
1194
1196
  #
1197
+ # When you invoke this operation, the custom control is deleted from any
1198
+ # frameworks or assessments that it’s currently part of. As a result,
1199
+ # Audit Manager will stop collecting evidence for that custom control in
1200
+ # all of your assessments. This includes assessments that you previously
1201
+ # created before you deleted the custom control.
1202
+ #
1195
1203
  # @option params [required, String] :control_id
1196
1204
  # The unique identifier for the control.
1197
1205
  #
@@ -1367,7 +1375,7 @@ module Aws::AuditManager
1367
1375
  req.send_request(options)
1368
1376
  end
1369
1377
 
1370
- # Returns the registration status of an account in Audit Manager.
1378
+ # Gets the registration status of an account in Audit Manager.
1371
1379
  #
1372
1380
  # @return [Types::GetAccountStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1373
1381
  #
@@ -1386,7 +1394,7 @@ module Aws::AuditManager
1386
1394
  req.send_request(options)
1387
1395
  end
1388
1396
 
1389
- # Returns an assessment from Audit Manager.
1397
+ # Gets information about a specified assessment.
1390
1398
  #
1391
1399
  # @option params [required, String] :assessment_id
1392
1400
  # The unique identifier for the assessment.
@@ -1493,7 +1501,7 @@ module Aws::AuditManager
1493
1501
  req.send_request(options)
1494
1502
  end
1495
1503
 
1496
- # Returns a framework from Audit Manager.
1504
+ # Gets information about a specified framework.
1497
1505
  #
1498
1506
  # @option params [required, String] :framework_id
1499
1507
  # The identifier for the framework.
@@ -1537,7 +1545,7 @@ module Aws::AuditManager
1537
1545
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_description #=> String
1538
1546
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_set_up_option #=> String, one of "System_Controls_Mapping", "Procedural_Controls_Mapping"
1539
1547
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_type #=> String, one of "AWS_Cloudtrail", "AWS_Config", "AWS_Security_Hub", "AWS_API_Call", "MANUAL"
1540
- # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST"
1548
+ # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST", "UPLOAD_FILE", "INPUT_TEXT"
1541
1549
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_value #=> String
1542
1550
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_frequency #=> String, one of "DAILY", "WEEKLY", "MONTHLY"
1543
1551
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].troubleshooting_text #=> String
@@ -1563,7 +1571,7 @@ module Aws::AuditManager
1563
1571
  req.send_request(options)
1564
1572
  end
1565
1573
 
1566
- # Returns the URL of an assessment report in Audit Manager.
1574
+ # Gets the URL of an assessment report in Audit Manager.
1567
1575
  #
1568
1576
  # @option params [required, String] :assessment_report_id
1569
1577
  # The unique identifier for the assessment report.
@@ -1596,7 +1604,7 @@ module Aws::AuditManager
1596
1604
  req.send_request(options)
1597
1605
  end
1598
1606
 
1599
- # Returns a list of changelogs from Audit Manager.
1607
+ # Gets a list of changelogs from Audit Manager.
1600
1608
  #
1601
1609
  # @option params [required, String] :assessment_id
1602
1610
  # The unique identifier for the assessment.
@@ -1650,7 +1658,7 @@ module Aws::AuditManager
1650
1658
  req.send_request(options)
1651
1659
  end
1652
1660
 
1653
- # Returns a control from Audit Manager.
1661
+ # Gets information about a specified control.
1654
1662
  #
1655
1663
  # @option params [required, String] :control_id
1656
1664
  # The identifier for the control.
@@ -1682,7 +1690,7 @@ module Aws::AuditManager
1682
1690
  # resp.control.control_mapping_sources[0].source_description #=> String
1683
1691
  # resp.control.control_mapping_sources[0].source_set_up_option #=> String, one of "System_Controls_Mapping", "Procedural_Controls_Mapping"
1684
1692
  # resp.control.control_mapping_sources[0].source_type #=> String, one of "AWS_Cloudtrail", "AWS_Config", "AWS_Security_Hub", "AWS_API_Call", "MANUAL"
1685
- # resp.control.control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST"
1693
+ # resp.control.control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST", "UPLOAD_FILE", "INPUT_TEXT"
1686
1694
  # resp.control.control_mapping_sources[0].source_keyword.keyword_value #=> String
1687
1695
  # resp.control.control_mapping_sources[0].source_frequency #=> String, one of "DAILY", "WEEKLY", "MONTHLY"
1688
1696
  # resp.control.control_mapping_sources[0].troubleshooting_text #=> String
@@ -1702,7 +1710,7 @@ module Aws::AuditManager
1702
1710
  req.send_request(options)
1703
1711
  end
1704
1712
 
1705
- # Returns a list of delegations from an audit owner to a delegate.
1713
+ # Gets a list of delegations from an audit owner to a delegate.
1706
1714
  #
1707
1715
  # @option params [String] :next_token
1708
1716
  # The pagination token that's used to fetch the next set of results.
@@ -1746,7 +1754,7 @@ module Aws::AuditManager
1746
1754
  req.send_request(options)
1747
1755
  end
1748
1756
 
1749
- # Returns evidence from Audit Manager.
1757
+ # Gets information about a specified evidence item.
1750
1758
  #
1751
1759
  # @option params [required, String] :assessment_id
1752
1760
  # The unique identifier for the assessment.
@@ -1804,8 +1812,7 @@ module Aws::AuditManager
1804
1812
  req.send_request(options)
1805
1813
  end
1806
1814
 
1807
- # Returns all evidence from a specified evidence folder in Audit
1808
- # Manager.
1815
+ # Gets all evidence from a specified evidence folder in Audit Manager.
1809
1816
  #
1810
1817
  # @option params [required, String] :assessment_id
1811
1818
  # The identifier for the assessment.
@@ -1873,8 +1880,64 @@ module Aws::AuditManager
1873
1880
  req.send_request(options)
1874
1881
  end
1875
1882
 
1876
- # Returns an evidence folder from the specified assessment in Audit
1877
- # Manager.
1883
+ # Creates a presigned Amazon S3 URL that can be used to upload a file as
1884
+ # manual evidence. For instructions on how to use this operation, see
1885
+ # [Upload a file from your browser ][1] in the *Audit Manager User
1886
+ # Guide*.
1887
+ #
1888
+ # The following restrictions apply to this operation:
1889
+ #
1890
+ # * Maximum size of an individual evidence file: 100 MB
1891
+ #
1892
+ # * Number of daily manual evidence uploads per control: 100
1893
+ #
1894
+ # * Supported file formats: See [Supported file types for manual
1895
+ # evidence][2] in the *Audit Manager User Guide*
1896
+ #
1897
+ # For more information about Audit Manager service restrictions, see
1898
+ # [Quotas and restrictions for Audit Manager][3].
1899
+ #
1900
+ #
1901
+ #
1902
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#how-to-upload-manual-evidence-files
1903
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#supported-manual-evidence-files
1904
+ # [3]: https://docs.aws.amazon.com/audit-manager/latest/userguide/service-quotas.html
1905
+ #
1906
+ # @option params [required, String] :file_name
1907
+ # The file that you want to upload. For a list of supported file
1908
+ # formats, see [Supported file types for manual evidence][1] in the
1909
+ # *Audit Manager User Guide*.
1910
+ #
1911
+ #
1912
+ #
1913
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#supported-manual-evidence-files
1914
+ #
1915
+ # @return [Types::GetEvidenceFileUploadUrlResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1916
+ #
1917
+ # * {Types::GetEvidenceFileUploadUrlResponse#evidence_file_name #evidence_file_name} => String
1918
+ # * {Types::GetEvidenceFileUploadUrlResponse#upload_url #upload_url} => String
1919
+ #
1920
+ # @example Request syntax with placeholder values
1921
+ #
1922
+ # resp = client.get_evidence_file_upload_url({
1923
+ # file_name: "ManualEvidenceLocalFileName", # required
1924
+ # })
1925
+ #
1926
+ # @example Response structure
1927
+ #
1928
+ # resp.evidence_file_name #=> String
1929
+ # resp.upload_url #=> String
1930
+ #
1931
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetEvidenceFileUploadUrl AWS API Documentation
1932
+ #
1933
+ # @overload get_evidence_file_upload_url(params = {})
1934
+ # @param [Hash] params ({})
1935
+ def get_evidence_file_upload_url(params = {}, options = {})
1936
+ req = build_request(:get_evidence_file_upload_url, params)
1937
+ req.send_request(options)
1938
+ end
1939
+
1940
+ # Gets an evidence folder from a specified assessment in Audit Manager.
1878
1941
  #
1879
1942
  # @option params [required, String] :assessment_id
1880
1943
  # The unique identifier for the assessment.
@@ -1927,7 +1990,7 @@ module Aws::AuditManager
1927
1990
  req.send_request(options)
1928
1991
  end
1929
1992
 
1930
- # Returns the evidence folders from a specified assessment in Audit
1993
+ # Gets the evidence folders from a specified assessment in Audit
1931
1994
  # Manager.
1932
1995
  #
1933
1996
  # @option params [required, String] :assessment_id
@@ -1987,8 +2050,8 @@ module Aws::AuditManager
1987
2050
  req.send_request(options)
1988
2051
  end
1989
2052
 
1990
- # Returns a list of evidence folders that are associated with a
1991
- # specified control in an Audit Manager assessment.
2053
+ # Gets a list of evidence folders that are associated with a specified
2054
+ # control in an Audit Manager assessment.
1992
2055
  #
1993
2056
  # @option params [required, String] :assessment_id
1994
2057
  # The identifier for the assessment.
@@ -2114,8 +2177,8 @@ module Aws::AuditManager
2114
2177
  req.send_request(options)
2115
2178
  end
2116
2179
 
2117
- # Returns the name of the delegated Amazon Web Services administrator
2118
- # account for the organization.
2180
+ # Gets the name of the delegated Amazon Web Services administrator
2181
+ # account for a specified organization.
2119
2182
  #
2120
2183
  # @return [Types::GetOrganizationAdminAccountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2121
2184
  #
@@ -2136,8 +2199,8 @@ module Aws::AuditManager
2136
2199
  req.send_request(options)
2137
2200
  end
2138
2201
 
2139
- # Returns a list of all of the Amazon Web Services that you can choose
2140
- # to include in your assessment. When you [create an assessment][1],
2202
+ # Gets a list of all of the Amazon Web Services that you can choose to
2203
+ # include in your assessment. When you [create an assessment][1],
2141
2204
  # specify which of these services you want to include to narrow the
2142
2205
  # assessment's [scope][2].
2143
2206
  #
@@ -2167,7 +2230,7 @@ module Aws::AuditManager
2167
2230
  req.send_request(options)
2168
2231
  end
2169
2232
 
2170
- # Returns the settings for the specified Amazon Web Services account.
2233
+ # Gets the settings for a specified Amazon Web Services account.
2171
2234
  #
2172
2235
  # @option params [required, String] :attribute
2173
2236
  # The list of setting attribute enum values.
@@ -2179,7 +2242,7 @@ module Aws::AuditManager
2179
2242
  # @example Request syntax with placeholder values
2180
2243
  #
2181
2244
  # resp = client.get_settings({
2182
- # attribute: "ALL", # required, accepts ALL, IS_AWS_ORG_ENABLED, SNS_TOPIC, DEFAULT_ASSESSMENT_REPORTS_DESTINATION, DEFAULT_PROCESS_OWNERS, EVIDENCE_FINDER_ENABLEMENT, DEREGISTRATION_POLICY
2245
+ # attribute: "ALL", # required, accepts ALL, IS_AWS_ORG_ENABLED, SNS_TOPIC, DEFAULT_ASSESSMENT_REPORTS_DESTINATION, DEFAULT_PROCESS_OWNERS, EVIDENCE_FINDER_ENABLEMENT, DEREGISTRATION_POLICY, DEFAULT_EXPORT_DESTINATION
2183
2246
  # })
2184
2247
  #
2185
2248
  # @example Response structure
@@ -2197,6 +2260,8 @@ module Aws::AuditManager
2197
2260
  # resp.settings.evidence_finder_enablement.backfill_status #=> String, one of "NOT_STARTED", "IN_PROGRESS", "COMPLETED"
2198
2261
  # resp.settings.evidence_finder_enablement.error #=> String
2199
2262
  # resp.settings.deregistration_policy.delete_resources #=> String, one of "ALL", "DEFAULT"
2263
+ # resp.settings.default_export_destination.destination_type #=> String, one of "S3"
2264
+ # resp.settings.default_export_destination.destination #=> String
2200
2265
  #
2201
2266
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetSettings AWS API Documentation
2202
2267
  #
@@ -3377,7 +3442,7 @@ module Aws::AuditManager
3377
3442
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_description #=> String
3378
3443
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_set_up_option #=> String, one of "System_Controls_Mapping", "Procedural_Controls_Mapping"
3379
3444
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_type #=> String, one of "AWS_Cloudtrail", "AWS_Config", "AWS_Security_Hub", "AWS_API_Call", "MANUAL"
3380
- # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST"
3445
+ # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST", "UPLOAD_FILE", "INPUT_TEXT"
3381
3446
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_keyword.keyword_value #=> String
3382
3447
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].source_frequency #=> String, one of "DAILY", "WEEKLY", "MONTHLY"
3383
3448
  # resp.framework.control_sets[0].controls[0].control_mapping_sources[0].troubleshooting_text #=> String
@@ -3606,7 +3671,7 @@ module Aws::AuditManager
3606
3671
  # source_set_up_option: "System_Controls_Mapping", # accepts System_Controls_Mapping, Procedural_Controls_Mapping
3607
3672
  # source_type: "AWS_Cloudtrail", # accepts AWS_Cloudtrail, AWS_Config, AWS_Security_Hub, AWS_API_Call, MANUAL
3608
3673
  # source_keyword: {
3609
- # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST
3674
+ # keyword_input_type: "SELECT_FROM_LIST", # accepts SELECT_FROM_LIST, UPLOAD_FILE, INPUT_TEXT
3610
3675
  # keyword_value: "KeywordValue",
3611
3676
  # },
3612
3677
  # source_frequency: "DAILY", # accepts DAILY, WEEKLY, MONTHLY
@@ -3632,7 +3697,7 @@ module Aws::AuditManager
3632
3697
  # resp.control.control_mapping_sources[0].source_description #=> String
3633
3698
  # resp.control.control_mapping_sources[0].source_set_up_option #=> String, one of "System_Controls_Mapping", "Procedural_Controls_Mapping"
3634
3699
  # resp.control.control_mapping_sources[0].source_type #=> String, one of "AWS_Cloudtrail", "AWS_Config", "AWS_Security_Hub", "AWS_API_Call", "MANUAL"
3635
- # resp.control.control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST"
3700
+ # resp.control.control_mapping_sources[0].source_keyword.keyword_input_type #=> String, one of "SELECT_FROM_LIST", "UPLOAD_FILE", "INPUT_TEXT"
3636
3701
  # resp.control.control_mapping_sources[0].source_keyword.keyword_value #=> String
3637
3702
  # resp.control.control_mapping_sources[0].source_frequency #=> String, one of "DAILY", "WEEKLY", "MONTHLY"
3638
3703
  # resp.control.control_mapping_sources[0].troubleshooting_text #=> String
@@ -3659,7 +3724,7 @@ module Aws::AuditManager
3659
3724
  # Manager sends notifications to.
3660
3725
  #
3661
3726
  # @option params [Types::AssessmentReportsDestination] :default_assessment_reports_destination
3662
- # The default storage destination for assessment reports.
3727
+ # The default S3 destination bucket for storing assessment reports.
3663
3728
  #
3664
3729
  # @option params [Array<Types::Role>] :default_process_owners
3665
3730
  # A list of the default audit owners.
@@ -3687,6 +3752,9 @@ module Aws::AuditManager
3687
3752
  # this attribute to determine how your data is handled when you
3688
3753
  # deregister Audit Manager.
3689
3754
  #
3755
+ # @option params [Types::DefaultExportDestination] :default_export_destination
3756
+ # The default S3 destination bucket for storing evidence finder exports.
3757
+ #
3690
3758
  # @return [Types::UpdateSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3691
3759
  #
3692
3760
  # * {Types::UpdateSettingsResponse#settings #settings} => Types::Settings
@@ -3710,6 +3778,10 @@ module Aws::AuditManager
3710
3778
  # deregistration_policy: {
3711
3779
  # delete_resources: "ALL", # accepts ALL, DEFAULT
3712
3780
  # },
3781
+ # default_export_destination: {
3782
+ # destination_type: "S3", # accepts S3
3783
+ # destination: "S3Url",
3784
+ # },
3713
3785
  # })
3714
3786
  #
3715
3787
  # @example Response structure
@@ -3727,6 +3799,8 @@ module Aws::AuditManager
3727
3799
  # resp.settings.evidence_finder_enablement.backfill_status #=> String, one of "NOT_STARTED", "IN_PROGRESS", "COMPLETED"
3728
3800
  # resp.settings.evidence_finder_enablement.error #=> String
3729
3801
  # resp.settings.deregistration_policy.delete_resources #=> String, one of "ALL", "DEFAULT"
3802
+ # resp.settings.default_export_destination.destination_type #=> String, one of "S3"
3803
+ # resp.settings.default_export_destination.destination #=> String
3730
3804
  #
3731
3805
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/UpdateSettings AWS API Documentation
3732
3806
  #
@@ -3788,7 +3862,7 @@ module Aws::AuditManager
3788
3862
  params: params,
3789
3863
  config: config)
3790
3864
  context[:gem_name] = 'aws-sdk-auditmanager'
3791
- context[:gem_version] = '1.32.0'
3865
+ context[:gem_version] = '1.34.0'
3792
3866
  Seahorse::Client::Request.new(handlers, context)
3793
3867
  end
3794
3868
 
@@ -122,6 +122,7 @@ module Aws::AuditManager
122
122
  CreateDelegationRequest = Shapes::StructureShape.new(name: 'CreateDelegationRequest')
123
123
  CreateDelegationRequests = Shapes::ListShape.new(name: 'CreateDelegationRequests')
124
124
  CreatedBy = Shapes::StringShape.new(name: 'CreatedBy')
125
+ DefaultExportDestination = Shapes::StructureShape.new(name: 'DefaultExportDestination')
125
126
  Delegation = Shapes::StructureShape.new(name: 'Delegation')
126
127
  DelegationComment = Shapes::StringShape.new(name: 'DelegationComment')
127
128
  DelegationIds = Shapes::ListShape.new(name: 'DelegationIds')
@@ -162,6 +163,7 @@ module Aws::AuditManager
162
163
  EvidenceInsights = Shapes::StructureShape.new(name: 'EvidenceInsights')
163
164
  EvidenceList = Shapes::ListShape.new(name: 'EvidenceList')
164
165
  EvidenceSources = Shapes::ListShape.new(name: 'EvidenceSources')
166
+ ExportDestinationType = Shapes::StringShape.new(name: 'ExportDestinationType')
165
167
  Filename = Shapes::StringShape.new(name: 'Filename')
166
168
  Framework = Shapes::StructureShape.new(name: 'Framework')
167
169
  FrameworkDescription = Shapes::StringShape.new(name: 'FrameworkDescription')
@@ -186,6 +188,8 @@ module Aws::AuditManager
186
188
  GetDelegationsResponse = Shapes::StructureShape.new(name: 'GetDelegationsResponse')
187
189
  GetEvidenceByEvidenceFolderRequest = Shapes::StructureShape.new(name: 'GetEvidenceByEvidenceFolderRequest')
188
190
  GetEvidenceByEvidenceFolderResponse = Shapes::StructureShape.new(name: 'GetEvidenceByEvidenceFolderResponse')
191
+ GetEvidenceFileUploadUrlRequest = Shapes::StructureShape.new(name: 'GetEvidenceFileUploadUrlRequest')
192
+ GetEvidenceFileUploadUrlResponse = Shapes::StructureShape.new(name: 'GetEvidenceFileUploadUrlResponse')
189
193
  GetEvidenceFolderRequest = Shapes::StructureShape.new(name: 'GetEvidenceFolderRequest')
190
194
  GetEvidenceFolderResponse = Shapes::StructureShape.new(name: 'GetEvidenceFolderResponse')
191
195
  GetEvidenceFoldersByAssessmentControlRequest = Shapes::StructureShape.new(name: 'GetEvidenceFoldersByAssessmentControlRequest')
@@ -242,6 +246,8 @@ module Aws::AuditManager
242
246
  ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
243
247
  ManualEvidence = Shapes::StructureShape.new(name: 'ManualEvidence')
244
248
  ManualEvidenceList = Shapes::ListShape.new(name: 'ManualEvidenceList')
249
+ ManualEvidenceLocalFileName = Shapes::StringShape.new(name: 'ManualEvidenceLocalFileName')
250
+ ManualEvidenceTextResponse = Shapes::StringShape.new(name: 'ManualEvidenceTextResponse')
245
251
  MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
246
252
  NonEmptyString = Shapes::StringShape.new(name: 'NonEmptyString')
247
253
  Notification = Shapes::StructureShape.new(name: 'Notification')
@@ -724,6 +730,10 @@ module Aws::AuditManager
724
730
 
725
731
  CreateDelegationRequests.member = Shapes::ShapeRef.new(shape: CreateDelegationRequest)
726
732
 
733
+ DefaultExportDestination.add_member(:destination_type, Shapes::ShapeRef.new(shape: ExportDestinationType, location_name: "destinationType"))
734
+ DefaultExportDestination.add_member(:destination, Shapes::ShapeRef.new(shape: S3Url, location_name: "destination"))
735
+ DefaultExportDestination.struct_class = Types::DefaultExportDestination
736
+
727
737
  Delegation.add_member(:id, Shapes::ShapeRef.new(shape: UUID, location_name: "id"))
728
738
  Delegation.add_member(:assessment_name, Shapes::ShapeRef.new(shape: AssessmentName, location_name: "assessmentName"))
729
739
  Delegation.add_member(:assessment_id, Shapes::ShapeRef.new(shape: UUID, location_name: "assessmentId"))
@@ -920,6 +930,13 @@ module Aws::AuditManager
920
930
  GetEvidenceByEvidenceFolderResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "nextToken"))
921
931
  GetEvidenceByEvidenceFolderResponse.struct_class = Types::GetEvidenceByEvidenceFolderResponse
922
932
 
933
+ GetEvidenceFileUploadUrlRequest.add_member(:file_name, Shapes::ShapeRef.new(shape: ManualEvidenceLocalFileName, required: true, location: "querystring", location_name: "fileName"))
934
+ GetEvidenceFileUploadUrlRequest.struct_class = Types::GetEvidenceFileUploadUrlRequest
935
+
936
+ GetEvidenceFileUploadUrlResponse.add_member(:evidence_file_name, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "evidenceFileName"))
937
+ GetEvidenceFileUploadUrlResponse.add_member(:upload_url, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "uploadUrl"))
938
+ GetEvidenceFileUploadUrlResponse.struct_class = Types::GetEvidenceFileUploadUrlResponse
939
+
923
940
  GetEvidenceFolderRequest.add_member(:assessment_id, Shapes::ShapeRef.new(shape: UUID, required: true, location: "uri", location_name: "assessmentId"))
924
941
  GetEvidenceFolderRequest.add_member(:control_set_id, Shapes::ShapeRef.new(shape: ControlSetId, required: true, location: "uri", location_name: "controlSetId"))
925
942
  GetEvidenceFolderRequest.add_member(:evidence_folder_id, Shapes::ShapeRef.new(shape: UUID, required: true, location: "uri", location_name: "evidenceFolderId"))
@@ -1113,6 +1130,8 @@ module Aws::AuditManager
1113
1130
  ListTagsForResourceResponse.struct_class = Types::ListTagsForResourceResponse
1114
1131
 
1115
1132
  ManualEvidence.add_member(:s3_resource_path, Shapes::ShapeRef.new(shape: S3Url, location_name: "s3ResourcePath"))
1133
+ ManualEvidence.add_member(:text_response, Shapes::ShapeRef.new(shape: ManualEvidenceTextResponse, location_name: "textResponse"))
1134
+ ManualEvidence.add_member(:evidence_file_name, Shapes::ShapeRef.new(shape: ManualEvidenceLocalFileName, location_name: "evidenceFileName"))
1116
1135
  ManualEvidence.struct_class = Types::ManualEvidence
1117
1136
 
1118
1137
  ManualEvidenceList.member = Shapes::ShapeRef.new(shape: ManualEvidence)
@@ -1183,6 +1202,7 @@ module Aws::AuditManager
1183
1202
  Settings.add_member(:kms_key, Shapes::ShapeRef.new(shape: KmsKey, location_name: "kmsKey"))
1184
1203
  Settings.add_member(:evidence_finder_enablement, Shapes::ShapeRef.new(shape: EvidenceFinderEnablement, location_name: "evidenceFinderEnablement"))
1185
1204
  Settings.add_member(:deregistration_policy, Shapes::ShapeRef.new(shape: DeregistrationPolicy, location_name: "deregistrationPolicy"))
1205
+ Settings.add_member(:default_export_destination, Shapes::ShapeRef.new(shape: DefaultExportDestination, location_name: "defaultExportDestination"))
1186
1206
  Settings.struct_class = Types::Settings
1187
1207
 
1188
1208
  SourceKeyword.add_member(:keyword_input_type, Shapes::ShapeRef.new(shape: KeywordInputType, location_name: "keywordInputType"))
@@ -1302,6 +1322,7 @@ module Aws::AuditManager
1302
1322
  UpdateSettingsRequest.add_member(:kms_key, Shapes::ShapeRef.new(shape: KmsKey, location_name: "kmsKey"))
1303
1323
  UpdateSettingsRequest.add_member(:evidence_finder_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "evidenceFinderEnabled"))
1304
1324
  UpdateSettingsRequest.add_member(:deregistration_policy, Shapes::ShapeRef.new(shape: DeregistrationPolicy, location_name: "deregistrationPolicy"))
1325
+ UpdateSettingsRequest.add_member(:default_export_destination, Shapes::ShapeRef.new(shape: DefaultExportDestination, location_name: "defaultExportDestination"))
1305
1326
  UpdateSettingsRequest.struct_class = Types::UpdateSettingsRequest
1306
1327
 
1307
1328
  UpdateSettingsResponse.add_member(:settings, Shapes::ShapeRef.new(shape: Settings, location_name: "settings"))
@@ -1418,6 +1439,7 @@ module Aws::AuditManager
1418
1439
  o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
1419
1440
  o.errors << Shapes::ShapeRef.new(shape: ValidationException)
1420
1441
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1442
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
1421
1443
  end)
1422
1444
 
1423
1445
  api.add_operation(:create_assessment, Seahorse::Model::Operation.new.tap do |o|
@@ -1689,6 +1711,18 @@ module Aws::AuditManager
1689
1711
  )
1690
1712
  end)
1691
1713
 
1714
+ api.add_operation(:get_evidence_file_upload_url, Seahorse::Model::Operation.new.tap do |o|
1715
+ o.name = "GetEvidenceFileUploadUrl"
1716
+ o.http_method = "GET"
1717
+ o.http_request_uri = "/evidenceFileUploadUrl"
1718
+ o.input = Shapes::ShapeRef.new(shape: GetEvidenceFileUploadUrlRequest)
1719
+ o.output = Shapes::ShapeRef.new(shape: GetEvidenceFileUploadUrlResponse)
1720
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
1721
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
1722
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1723
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
1724
+ end)
1725
+
1692
1726
  api.add_operation(:get_evidence_folder, Seahorse::Model::Operation.new.tap do |o|
1693
1727
  o.name = "GetEvidenceFolder"
1694
1728
  o.http_method = "GET"
@@ -9,6 +9,7 @@
9
9
 
10
10
 
11
11
  module Aws::AuditManager
12
+ # @api private
12
13
  module Endpoints
13
14
 
14
15
  class AssociateAssessmentReportEvidenceFolder
@@ -389,6 +390,20 @@ module Aws::AuditManager
389
390
  end
390
391
  end
391
392
 
393
+ class GetEvidenceFileUploadUrl
394
+ def self.build(context)
395
+ unless context.config.regional_endpoint
396
+ endpoint = context.config.endpoint.to_s
397
+ end
398
+ Aws::AuditManager::EndpointParameters.new(
399
+ region: context.config.region,
400
+ use_dual_stack: context.config.use_dualstack_endpoint,
401
+ use_fips: context.config.use_fips_endpoint,
402
+ endpoint: endpoint,
403
+ )
404
+ end
405
+ end
406
+
392
407
  class GetEvidenceFolder
393
408
  def self.build(context)
394
409
  unless context.config.regional_endpoint
@@ -110,6 +110,8 @@ module Aws::AuditManager
110
110
  Aws::AuditManager::Endpoints::GetEvidence.build(context)
111
111
  when :get_evidence_by_evidence_folder
112
112
  Aws::AuditManager::Endpoints::GetEvidenceByEvidenceFolder.build(context)
113
+ when :get_evidence_file_upload_url
114
+ Aws::AuditManager::Endpoints::GetEvidenceFileUploadUrl.build(context)
113
115
  when :get_evidence_folder
114
116
  Aws::AuditManager::Endpoints::GetEvidenceFolder.build(context)
115
117
  when :get_evidence_folders_by_assessment
@@ -771,7 +771,8 @@ module Aws::AuditManager
771
771
  # @return [String]
772
772
  #
773
773
  # @!attribute [rw] destination
774
- # The destination of the assessment report.
774
+ # The destination bucket where Audit Manager stores assessment
775
+ # reports.
775
776
  # @return [String]
776
777
  #
777
778
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/AssessmentReportsDestination AWS API Documentation
@@ -1124,7 +1125,8 @@ module Aws::AuditManager
1124
1125
  # @return [String]
1125
1126
  #
1126
1127
  # @!attribute [rw] type
1127
- # The type of control, such as a custom control or a standard control.
1128
+ # Specifies whether the control is a standard control or a custom
1129
+ # control.
1128
1130
  # @return [String]
1129
1131
  #
1130
1132
  # @!attribute [rw] name
@@ -1368,8 +1370,14 @@ module Aws::AuditManager
1368
1370
  # @return [String]
1369
1371
  #
1370
1372
  # @!attribute [rw] source_keyword
1371
- # The keyword to search for in CloudTrail logs, Config rules, Security
1372
- # Hub checks, and Amazon Web Services API names.
1373
+ # A keyword that relates to the control data source.
1374
+ #
1375
+ # For manual evidence, this keyword indicates if the manual evidence
1376
+ # is a file or text.
1377
+ #
1378
+ # For automated evidence, this keyword identifies a specific
1379
+ # CloudTrail event, Config rule, Security Hub control, or Amazon Web
1380
+ # Services API name.
1373
1381
  #
1374
1382
  # To learn more about the supported keywords that you can use when
1375
1383
  # mapping a control data source, see the following pages in the *Audit
@@ -1385,14 +1393,15 @@ module Aws::AuditManager
1385
1393
  #
1386
1394
  #
1387
1395
  #
1388
- # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-ash.html
1389
- # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-config.html
1396
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-config.html
1397
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-ash.html
1390
1398
  # [3]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-api.html
1391
1399
  # [4]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-cloudtrail.html
1392
1400
  # @return [Types::SourceKeyword]
1393
1401
  #
1394
1402
  # @!attribute [rw] source_frequency
1395
- # The frequency of evidence collection for the control mapping source.
1403
+ # Specifies how often evidence is collected from the control mapping
1404
+ # source.
1396
1405
  # @return [String]
1397
1406
  #
1398
1407
  # @!attribute [rw] troubleshooting_text
@@ -1707,8 +1716,14 @@ module Aws::AuditManager
1707
1716
  # @return [String]
1708
1717
  #
1709
1718
  # @!attribute [rw] source_keyword
1710
- # The keyword to search for in CloudTrail logs, Config rules, Security
1711
- # Hub checks, and Amazon Web Services API names.
1719
+ # A keyword that relates to the control data source.
1720
+ #
1721
+ # For manual evidence, this keyword indicates if the manual evidence
1722
+ # is a file or text.
1723
+ #
1724
+ # For automated evidence, this keyword identifies a specific
1725
+ # CloudTrail event, Config rule, Security Hub control, or Amazon Web
1726
+ # Services API name.
1712
1727
  #
1713
1728
  # To learn more about the supported keywords that you can use when
1714
1729
  # mapping a control data source, see the following pages in the *Audit
@@ -1724,14 +1739,15 @@ module Aws::AuditManager
1724
1739
  #
1725
1740
  #
1726
1741
  #
1727
- # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-ash.html
1728
- # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-config.html
1742
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-config.html
1743
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-ash.html
1729
1744
  # [3]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-api.html
1730
1745
  # [4]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-cloudtrail.html
1731
1746
  # @return [Types::SourceKeyword]
1732
1747
  #
1733
1748
  # @!attribute [rw] source_frequency
1734
- # The frequency of evidence collection for the control mapping source.
1749
+ # Specifies how often evidence is collected from the control mapping
1750
+ # source.
1735
1751
  # @return [String]
1736
1752
  #
1737
1753
  # @!attribute [rw] troubleshooting_text
@@ -1846,6 +1862,26 @@ module Aws::AuditManager
1846
1862
  include Aws::Structure
1847
1863
  end
1848
1864
 
1865
+ # The default s3 bucket where Audit Manager saves the files that you
1866
+ # export from evidence finder.
1867
+ #
1868
+ # @!attribute [rw] destination_type
1869
+ # The destination type, such as Amazon S3.
1870
+ # @return [String]
1871
+ #
1872
+ # @!attribute [rw] destination
1873
+ # The destination bucket where Audit Manager stores exported files.
1874
+ # @return [String]
1875
+ #
1876
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/DefaultExportDestination AWS API Documentation
1877
+ #
1878
+ class DefaultExportDestination < Struct.new(
1879
+ :destination_type,
1880
+ :destination)
1881
+ SENSITIVE = []
1882
+ include Aws::Structure
1883
+ end
1884
+
1849
1885
  # The assignment of a control set to a delegate for review.
1850
1886
  #
1851
1887
  # @!attribute [rw] id
@@ -2391,13 +2427,13 @@ module Aws::AuditManager
2391
2427
  # @return [String]
2392
2428
  #
2393
2429
  # @!attribute [rw] type
2394
- # The framework type, such as a custom framework or a standard
2430
+ # Specifies whether the framework is a standard framework or a custom
2395
2431
  # framework.
2396
2432
  # @return [String]
2397
2433
  #
2398
2434
  # @!attribute [rw] compliance_type
2399
- # The compliance type that the new custom framework supports, such as
2400
- # CIS or HIPAA.
2435
+ # The compliance type that the framework supports, such as CIS or
2436
+ # HIPAA.
2401
2437
  # @return [String]
2402
2438
  #
2403
2439
  # @!attribute [rw] description
@@ -2409,8 +2445,7 @@ module Aws::AuditManager
2409
2445
  # @return [String]
2410
2446
  #
2411
2447
  # @!attribute [rw] control_sources
2412
- # The sources that Audit Manager collects evidence from for the
2413
- # control.
2448
+ # The control data sources where Audit Manager collects evidence from.
2414
2449
  # @return [String]
2415
2450
  #
2416
2451
  # @!attribute [rw] control_sets
@@ -2656,7 +2691,7 @@ module Aws::AuditManager
2656
2691
  end
2657
2692
 
2658
2693
  # @!attribute [rw] control
2659
- # The name of the control that the `GetControl` API returned.
2694
+ # The details of the control that the `GetControl` API returned.
2660
2695
  # @return [Types::Control]
2661
2696
  #
2662
2697
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetControlResponse AWS API Documentation
@@ -2753,6 +2788,42 @@ module Aws::AuditManager
2753
2788
  include Aws::Structure
2754
2789
  end
2755
2790
 
2791
+ # @!attribute [rw] file_name
2792
+ # The file that you want to upload. For a list of supported file
2793
+ # formats, see [Supported file types for manual evidence][1] in the
2794
+ # *Audit Manager User Guide*.
2795
+ #
2796
+ #
2797
+ #
2798
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#supported-manual-evidence-files
2799
+ # @return [String]
2800
+ #
2801
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetEvidenceFileUploadUrlRequest AWS API Documentation
2802
+ #
2803
+ class GetEvidenceFileUploadUrlRequest < Struct.new(
2804
+ :file_name)
2805
+ SENSITIVE = []
2806
+ include Aws::Structure
2807
+ end
2808
+
2809
+ # @!attribute [rw] evidence_file_name
2810
+ # The name of the uploaded manual evidence file that the presigned URL
2811
+ # was generated for.
2812
+ # @return [String]
2813
+ #
2814
+ # @!attribute [rw] upload_url
2815
+ # The presigned URL that was generated.
2816
+ # @return [String]
2817
+ #
2818
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetEvidenceFileUploadUrlResponse AWS API Documentation
2819
+ #
2820
+ class GetEvidenceFileUploadUrlResponse < Struct.new(
2821
+ :evidence_file_name,
2822
+ :upload_url)
2823
+ SENSITIVE = []
2824
+ include Aws::Structure
2825
+ end
2826
+
2756
2827
  # @!attribute [rw] assessment_id
2757
2828
  # The unique identifier for the assessment.
2758
2829
  # @return [String]
@@ -3320,7 +3391,8 @@ module Aws::AuditManager
3320
3391
  end
3321
3392
 
3322
3393
  # @!attribute [rw] framework_metadata_list
3323
- # The list of metadata objects for the framework.
3394
+ # A list of metadata that the `ListAssessmentFrameworks` API returns
3395
+ # for each framework.
3324
3396
  # @return [Array<Types::AssessmentFrameworkMetadata>]
3325
3397
  #
3326
3398
  # @!attribute [rw] next_token
@@ -3396,7 +3468,8 @@ module Aws::AuditManager
3396
3468
  end
3397
3469
 
3398
3470
  # @!attribute [rw] assessment_metadata
3399
- # The metadata that's associated with the assessment.
3471
+ # The metadata that the `ListAssessments` API returns for each
3472
+ # assessment.
3400
3473
  # @return [Array<Types::AssessmentMetadataItem>]
3401
3474
  #
3402
3475
  # @!attribute [rw] next_token
@@ -3554,8 +3627,8 @@ module Aws::AuditManager
3554
3627
  end
3555
3628
 
3556
3629
  # @!attribute [rw] control_metadata_list
3557
- # The list of control metadata objects that the `ListControls` API
3558
- # returned.
3630
+ # A list of metadata that the `ListControls` API returns for each
3631
+ # control.
3559
3632
  # @return [Array<Types::ControlMetadata>]
3560
3633
  #
3561
3634
  # @!attribute [rw] next_token
@@ -3670,16 +3743,35 @@ module Aws::AuditManager
3670
3743
  include Aws::Structure
3671
3744
  end
3672
3745
 
3673
- # Evidence that's uploaded to Audit Manager manually.
3746
+ # Evidence that's manually added to a control in Audit Manager.
3747
+ # `manualEvidence` can be one of the following: `evidenceFileName`,
3748
+ # `s3ResourcePath`, or `textResponse`.
3674
3749
  #
3675
3750
  # @!attribute [rw] s3_resource_path
3676
- # The Amazon S3 URL that points to a manual evidence object.
3751
+ # The S3 URL of the object that's imported as manual evidence.
3752
+ # @return [String]
3753
+ #
3754
+ # @!attribute [rw] text_response
3755
+ # The plain text response that's entered and saved as manual
3756
+ # evidence.
3757
+ # @return [String]
3758
+ #
3759
+ # @!attribute [rw] evidence_file_name
3760
+ # The name of the file that's uploaded as manual evidence. This name
3761
+ # is populated using the `evidenceFileName` value from the [
3762
+ # `GetEvidenceFileUploadUrl` ][1] API response.
3763
+ #
3764
+ #
3765
+ #
3766
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_GetEvidenceFileUploadUrl.html
3677
3767
  # @return [String]
3678
3768
  #
3679
3769
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/ManualEvidence AWS API Documentation
3680
3770
  #
3681
3771
  class ManualEvidence < Struct.new(
3682
- :s3_resource_path)
3772
+ :s3_resource_path,
3773
+ :text_response,
3774
+ :evidence_file_name)
3683
3775
  SENSITIVE = []
3684
3776
  include Aws::Structure
3685
3777
  end
@@ -3975,7 +4067,7 @@ module Aws::AuditManager
3975
4067
  # @return [String]
3976
4068
  #
3977
4069
  # @!attribute [rw] default_assessment_reports_destination
3978
- # The default storage destination for assessment reports.
4070
+ # The default S3 destination bucket for storing assessment reports.
3979
4071
  # @return [Types::AssessmentReportsDestination]
3980
4072
  #
3981
4073
  # @!attribute [rw] default_process_owners
@@ -3996,6 +4088,11 @@ module Aws::AuditManager
3996
4088
  # deregister Audit Manager.
3997
4089
  # @return [Types::DeregistrationPolicy]
3998
4090
  #
4091
+ # @!attribute [rw] default_export_destination
4092
+ # The default S3 destination bucket for storing evidence finder
4093
+ # exports.
4094
+ # @return [Types::DefaultExportDestination]
4095
+ #
3999
4096
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/Settings AWS API Documentation
4000
4097
  #
4001
4098
  class Settings < Struct.new(
@@ -4005,13 +4102,20 @@ module Aws::AuditManager
4005
4102
  :default_process_owners,
4006
4103
  :kms_key,
4007
4104
  :evidence_finder_enablement,
4008
- :deregistration_policy)
4105
+ :deregistration_policy,
4106
+ :default_export_destination)
4009
4107
  SENSITIVE = []
4010
4108
  include Aws::Structure
4011
4109
  end
4012
4110
 
4013
- # The keyword to search for in CloudTrail logs, Config rules, Security
4014
- # Hub checks, and Amazon Web Services API names.
4111
+ # A keyword that relates to the control data source.
4112
+ #
4113
+ # For manual evidence, this keyword indicates if the manual evidence is
4114
+ # a file or text.
4115
+ #
4116
+ # For automated evidence, this keyword identifies a specific CloudTrail
4117
+ # event, Config rule, Security Hub control, or Amazon Web Services API
4118
+ # name.
4015
4119
  #
4016
4120
  # To learn more about the supported keywords that you can use when
4017
4121
  # mapping a control data source, see the following pages in the *Audit
@@ -4027,13 +4131,33 @@ module Aws::AuditManager
4027
4131
  #
4028
4132
  #
4029
4133
  #
4030
- # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-ash.html
4031
- # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-config.html
4134
+ # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-config.html
4135
+ # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-ash.html
4032
4136
  # [3]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-api.html
4033
4137
  # [4]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-cloudtrail.html
4034
4138
  #
4035
4139
  # @!attribute [rw] keyword_input_type
4036
4140
  # The input method for the keyword.
4141
+ #
4142
+ # * `SELECT_FROM_LIST` is used when mapping a data source for
4143
+ # automated evidence.
4144
+ #
4145
+ # * When `keywordInputType` is `SELECT_FROM_LIST`, a keyword must be
4146
+ # selected to collect automated evidence. For example, this
4147
+ # keyword can be a CloudTrail event name, a rule name for Config,
4148
+ # a Security Hub control, or the name of an Amazon Web Services
4149
+ # API call.
4150
+ #
4151
+ # ^
4152
+ #
4153
+ # * `UPLOAD_FILE` and `INPUT_TEXT` are only used when mapping a data
4154
+ # source for manual evidence.
4155
+ #
4156
+ # * When `keywordInputType` is `UPLOAD_FILE`, a file must be
4157
+ # uploaded as manual evidence.
4158
+ #
4159
+ # * When `keywordInputType` is `INPUT_TEXT`, text must be entered as
4160
+ # manual evidence.
4037
4161
  # @return [String]
4038
4162
  #
4039
4163
  # @!attribute [rw] keyword_value
@@ -4047,7 +4171,13 @@ module Aws::AuditManager
4047
4171
  #
4048
4172
  # * For [managed rules][1], you can use the rule identifier as the
4049
4173
  # `keywordValue`. You can find the rule identifier from the [list of
4050
- # Config managed rules][2].
4174
+ # Config managed rules][2]. For some rules, the rule identifier is
4175
+ # different from the rule name. For example, the rule name
4176
+ # `restricted-ssh` has the following rule identifier:
4177
+ # `INCOMING_SSH_DISABLED`. Make sure to use the rule identifier, not
4178
+ # the rule name.
4179
+ #
4180
+ # Keyword example for managed rules:
4051
4181
  #
4052
4182
  # * Managed rule name: [s3-bucket-acl-prohibited][3]
4053
4183
  #
@@ -4055,7 +4185,9 @@ module Aws::AuditManager
4055
4185
  #
4056
4186
  # * For [custom rules][4], you form the `keywordValue` by adding the
4057
4187
  # `Custom_` prefix to the rule name. This prefix distinguishes the
4058
- # rule from a managed rule.
4188
+ # custom rule from a managed rule.
4189
+ #
4190
+ # Keyword example for custom rules:
4059
4191
  #
4060
4192
  # * Custom rule name: my-custom-config-rule
4061
4193
  #
@@ -4065,6 +4197,8 @@ module Aws::AuditManager
4065
4197
  # adding the `Custom_` prefix to the rule name. In addition, you
4066
4198
  # remove the suffix ID that appears at the end of the rule name.
4067
4199
  #
4200
+ # Keyword examples for service-linked rules:
4201
+ #
4068
4202
  # * Service-linked rule name:
4069
4203
  # CustomRuleForAccount-conformance-pack-szsm1uv0w
4070
4204
  #
@@ -4076,6 +4210,43 @@ module Aws::AuditManager
4076
4210
  # `keywordValue`:
4077
4211
  # `Custom_OrgConfigRule-s3-bucket-versioning-enabled`
4078
4212
  #
4213
+ # The `keywordValue` is case sensitive. If you enter a value
4214
+ # incorrectly, Audit Manager might not recognize the data source
4215
+ # mapping. As a result, you might not successfully collect evidence
4216
+ # from that data source as intended.
4217
+ #
4218
+ # Keep in mind the following requirements, depending on the data
4219
+ # source type that you're using.
4220
+ #
4221
+ # 1. For Config:
4222
+ #
4223
+ # * For managed rules, make sure that the `keywordValue` is the
4224
+ # rule identifier in `ALL_CAPS_WITH_UNDERSCORES`. For example,
4225
+ # `CLOUDWATCH_LOG_GROUP_ENCRYPTED`. For accuracy, we recommend
4226
+ # that you reference the list of [supported Config managed
4227
+ # rules][6].
4228
+ #
4229
+ # * For custom rules, make sure that the `keywordValue` has the
4230
+ # `Custom_` prefix followed by the custom rule name. The format
4231
+ # of the custom rule name itself may vary. For accuracy, we
4232
+ # recommend that you visit the [Config console][7] to verify
4233
+ # your custom rule name.
4234
+ #
4235
+ # 2. For Security Hub: The format varies for Security Hub control
4236
+ # names. For accuracy, we recommend that you reference the list of
4237
+ # [supported Security Hub controls][8].
4238
+ #
4239
+ # 3. For Amazon Web Services API calls: Make sure that the
4240
+ # `keywordValue` is written as `serviceprefix_ActionName`. For
4241
+ # example, `iam_ListGroups`. For accuracy, we recommend that you
4242
+ # reference the list of [supported API calls][9].
4243
+ #
4244
+ # 4. For CloudTrail: Make sure that the `keywordValue` is written as
4245
+ # `serviceprefix_ActionName`. For example,
4246
+ # `cloudtrail_StartLogging`. For accuracy, we recommend that you
4247
+ # review the Amazon Web Service prefix and action names in the
4248
+ # [Service Authorization Reference][10].
4249
+ #
4079
4250
  #
4080
4251
  #
4081
4252
  # [1]: https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_use-managed-rules.html
@@ -4083,6 +4254,11 @@ module Aws::AuditManager
4083
4254
  # [3]: https://docs.aws.amazon.com/config/latest/developerguide/s3-bucket-acl-prohibited.html
4084
4255
  # [4]: https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_develop-rules.html
4085
4256
  # [5]: https://docs.aws.amazon.com/config/latest/developerguide/service-linked-awsconfig-rules.html
4257
+ # [6]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-config.html
4258
+ # [7]: https://console.aws.amazon.com/config/
4259
+ # [8]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-ash.html
4260
+ # [9]: https://docs.aws.amazon.com/audit-manager/latest/userguide/control-data-sources-api.html
4261
+ # [10]: https://docs.aws.amazon.com/service-authorization/latest/reference/reference_policies_actions-resources-contextkeys.html
4086
4262
  # @return [String]
4087
4263
  #
4088
4264
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/SourceKeyword AWS API Documentation
@@ -4543,7 +4719,7 @@ module Aws::AuditManager
4543
4719
  # @return [String]
4544
4720
  #
4545
4721
  # @!attribute [rw] default_assessment_reports_destination
4546
- # The default storage destination for assessment reports.
4722
+ # The default S3 destination bucket for storing assessment reports.
4547
4723
  # @return [Types::AssessmentReportsDestination]
4548
4724
  #
4549
4725
  # @!attribute [rw] default_process_owners
@@ -4576,6 +4752,11 @@ module Aws::AuditManager
4576
4752
  # deregister Audit Manager.
4577
4753
  # @return [Types::DeregistrationPolicy]
4578
4754
  #
4755
+ # @!attribute [rw] default_export_destination
4756
+ # The default S3 destination bucket for storing evidence finder
4757
+ # exports.
4758
+ # @return [Types::DefaultExportDestination]
4759
+ #
4579
4760
  # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/UpdateSettingsRequest AWS API Documentation
4580
4761
  #
4581
4762
  class UpdateSettingsRequest < Struct.new(
@@ -4584,7 +4765,8 @@ module Aws::AuditManager
4584
4765
  :default_process_owners,
4585
4766
  :kms_key,
4586
4767
  :evidence_finder_enabled,
4587
- :deregistration_policy)
4768
+ :deregistration_policy,
4769
+ :default_export_destination)
4588
4770
  SENSITIVE = []
4589
4771
  include Aws::Structure
4590
4772
  end
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-auditmanager/customizations'
52
52
  # @!group service
53
53
  module Aws::AuditManager
54
54
 
55
- GEM_VERSION = '1.32.0'
55
+ GEM_VERSION = '1.34.0'
56
56
 
57
57
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-auditmanager
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.32.0
4
+ version: 1.34.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-05-31 00:00:00.000000000 Z
11
+ date: 2023-06-28 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.174.0
22
+ version: 3.176.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.174.0
32
+ version: 3.176.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement