aws-sdk-auditmanager 1.15.0 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: c5b7351e0e69ebce85959b72d006afc249bd7f61416cd183d559576b9e5b67af
4
- data.tar.gz: b01ad2dfc29a4fcf0a5205d82a83e788eb32d53d8eba082bb5b5238d98722cf2
3
+ metadata.gz: '08c91fb1bace7166fe100d644892763707d1c664e4a21874d87cf6e5857656e4'
4
+ data.tar.gz: b2829eac7bdd395303df5e016c02a4610b863c63ac680d15d6140f0668f8348d
5
5
  SHA512:
6
- metadata.gz: 0211ab5a95a8ce4582cfaeec253304f49ef6cd453e701f9a0199acad10cf2f02624c2e054b97e80e0e6b781da50d968653ffd7da3e0663a7f4475e7835242f3c
7
- data.tar.gz: 23c6c4731a72e34af20772535fced18588ce5174a27b77c131278e3e0a61ce09399e1d90c49f5bcd0b9e155de21c970d4a619397eb9ae0c74c50abdde54acf82
6
+ metadata.gz: f52c4111b30b4061757371cbdc828459f868516985073c4adccc7de198f850f22dfd8eff1f44210fca031fccd7a91d58ab55e4baea0bf4b250a245f5b089b1c7
7
+ data.tar.gz: 5cb6d0aa5f40d694f0f35483bb660b6a2b6d3bcd695d3c25d3540b056c4bdf926c13a8ca0f30b55b1624d5d2ecb654d79deb86cdcb545577de59cb4d6dcf78c4
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.19.0 (2022-02-03)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.18.0 (2021-12-21)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.17.0 (2021-11-30)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.16.0 (2021-11-18)
20
+ ------------------
21
+
22
+ * Feature - This release introduces a new feature for Audit Manager: Dashboard views. You can now view insights data for your active assessments, and quickly identify non-compliant evidence that needs to be remediated.
23
+
4
24
  1.15.0 (2021-11-04)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.15.0
1
+ 1.19.0
@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
31
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
30
32
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
33
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
32
34
 
@@ -73,6 +75,8 @@ module Aws::AuditManager
73
75
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
74
76
  add_plugin(Aws::Plugins::TransferEncoding)
75
77
  add_plugin(Aws::Plugins::HttpChecksum)
78
+ add_plugin(Aws::Plugins::DefaultsMode)
79
+ add_plugin(Aws::Plugins::RecursionDetection)
76
80
  add_plugin(Aws::Plugins::SignatureV4)
77
81
  add_plugin(Aws::Plugins::Protocols::RestJson)
78
82
 
@@ -119,7 +123,9 @@ module Aws::AuditManager
119
123
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
124
  # are very aggressive. Construct and pass an instance of
121
125
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
- # enable retries and extended timeouts.
126
+ # enable retries and extended timeouts. Instance profile credential
127
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
128
+ # to true.
123
129
  #
124
130
  # @option options [required, String] :region
125
131
  # The AWS region to connect to. The configured `:region` is
@@ -173,6 +179,10 @@ module Aws::AuditManager
173
179
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
174
180
  # a clock skew correction and retry requests with skewed client clocks.
175
181
  #
182
+ # @option options [String] :defaults_mode ("legacy")
183
+ # See {Aws::DefaultsModeConfiguration} for a list of the
184
+ # accepted modes and the configuration defaults that are included.
185
+ #
176
186
  # @option options [Boolean] :disable_host_prefix_injection (false)
177
187
  # Set to true to disable SDK automatically adding host prefix
178
188
  # to default service endpoint when available.
@@ -295,7 +305,7 @@ module Aws::AuditManager
295
305
  # seconds to wait when opening a HTTP session before raising a
296
306
  # `Timeout::Error`.
297
307
  #
298
- # @option options [Integer] :http_read_timeout (60) The default
308
+ # @option options [Float] :http_read_timeout (60) The default
299
309
  # number of seconds to wait for response data. This value can
300
310
  # safely be set per-request on the session.
301
311
  #
@@ -311,6 +321,9 @@ module Aws::AuditManager
311
321
  # disables this behaviour. This value can safely be set per
312
322
  # request on the session.
313
323
  #
324
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
325
+ # in seconds.
326
+ #
314
327
  # @option options [Boolean] :http_wire_trace (false) When `true`,
315
328
  # HTTP debug output will be sent to the `:logger`.
316
329
  #
@@ -1002,7 +1015,7 @@ module Aws::AuditManager
1002
1015
  # Deletes a custom framework in Audit Manager.
1003
1016
  #
1004
1017
  # @option params [required, String] :framework_id
1005
- # The identifier for the framework.
1018
+ # The identifier for the custom framework.
1006
1019
  #
1007
1020
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1008
1021
  #
@@ -1051,7 +1064,7 @@ module Aws::AuditManager
1051
1064
  # Deletes an assessment report from an assessment in Audit Manager.
1052
1065
  #
1053
1066
  # @option params [required, String] :assessment_id
1054
- # The identifier for the assessment.
1067
+ # The unique identifier for the assessment.
1055
1068
  #
1056
1069
  # @option params [required, String] :assessment_report_id
1057
1070
  # The unique identifier for the assessment report.
@@ -1077,7 +1090,7 @@ module Aws::AuditManager
1077
1090
  # Deletes a custom control in Audit Manager.
1078
1091
  #
1079
1092
  # @option params [required, String] :control_id
1080
- # The identifier for the control.
1093
+ # The unique identifier for the control.
1081
1094
  #
1082
1095
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1083
1096
  #
@@ -1149,10 +1162,10 @@ module Aws::AuditManager
1149
1162
  # in Audit Manager.
1150
1163
  #
1151
1164
  # @option params [required, String] :assessment_id
1152
- # The identifier for the assessment.
1165
+ # The unique identifier for the assessment.
1153
1166
  #
1154
1167
  # @option params [required, String] :evidence_folder_id
1155
- # The identifier for the folder in which evidence is stored.
1168
+ # The unique identifier for the folder that the evidence is stored in.
1156
1169
  #
1157
1170
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1158
1171
  #
@@ -1194,7 +1207,7 @@ module Aws::AuditManager
1194
1207
  # Returns an assessment from Audit Manager.
1195
1208
  #
1196
1209
  # @option params [required, String] :assessment_id
1197
- # The identifier for the assessment.
1210
+ # The unique identifier for the assessment.
1198
1211
  #
1199
1212
  # @return [Types::GetAssessmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1200
1213
  #
@@ -1371,10 +1384,10 @@ module Aws::AuditManager
1371
1384
  # Returns the URL of an assessment report in Audit Manager.
1372
1385
  #
1373
1386
  # @option params [required, String] :assessment_report_id
1374
- # The identifier for the assessment report.
1387
+ # The unique identifier for the assessment report.
1375
1388
  #
1376
1389
  # @option params [required, String] :assessment_id
1377
- # The identifier for the assessment.
1390
+ # The unique identifier for the assessment.
1378
1391
  #
1379
1392
  # @return [Types::GetAssessmentReportUrlResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1380
1393
  #
@@ -1404,13 +1417,13 @@ module Aws::AuditManager
1404
1417
  # Returns a list of changelogs from Audit Manager.
1405
1418
  #
1406
1419
  # @option params [required, String] :assessment_id
1407
- # The identifier for the assessment.
1420
+ # The unique identifier for the assessment.
1408
1421
  #
1409
1422
  # @option params [String] :control_set_id
1410
- # The identifier for the control set.
1423
+ # The unique identifier for the control set.
1411
1424
  #
1412
1425
  # @option params [String] :control_id
1413
- # The identifier for the control.
1426
+ # The unique identifier for the control.
1414
1427
  #
1415
1428
  # @option params [String] :next_token
1416
1429
  # The pagination token that's used to fetch the next set of results.
@@ -1554,16 +1567,16 @@ module Aws::AuditManager
1554
1567
  # Returns evidence from Audit Manager.
1555
1568
  #
1556
1569
  # @option params [required, String] :assessment_id
1557
- # The identifier for the assessment.
1570
+ # The unique identifier for the assessment.
1558
1571
  #
1559
1572
  # @option params [required, String] :control_set_id
1560
- # The identifier for the control set.
1573
+ # The unique identifier for the control set.
1561
1574
  #
1562
1575
  # @option params [required, String] :evidence_folder_id
1563
- # The identifier for the folder that the evidence is stored in.
1576
+ # The unique identifier for the folder that the evidence is stored in.
1564
1577
  #
1565
1578
  # @option params [required, String] :evidence_id
1566
- # The identifier for the evidence.
1579
+ # The unique identifier for the evidence.
1567
1580
  #
1568
1581
  # @return [Types::GetEvidenceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1569
1582
  #
@@ -1680,13 +1693,13 @@ module Aws::AuditManager
1680
1693
  # Manager.
1681
1694
  #
1682
1695
  # @option params [required, String] :assessment_id
1683
- # The identifier for the assessment.
1696
+ # The unique identifier for the assessment.
1684
1697
  #
1685
1698
  # @option params [required, String] :control_set_id
1686
- # The identifier for the control set.
1699
+ # The unique identifier for the control set.
1687
1700
  #
1688
1701
  # @option params [required, String] :evidence_folder_id
1689
- # The identifier for the folder that the evidence is stored in.
1702
+ # The unique identifier for the folder that the evidence is stored in.
1690
1703
  #
1691
1704
  # @return [Types::GetEvidenceFolderResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1692
1705
  #
@@ -1734,7 +1747,7 @@ module Aws::AuditManager
1734
1747
  # Manager.
1735
1748
  #
1736
1749
  # @option params [required, String] :assessment_id
1737
- # The identifier for the assessment.
1750
+ # The unique identifier for the assessment.
1738
1751
  #
1739
1752
  # @option params [String] :next_token
1740
1753
  # The pagination token that's used to fetch the next set of results.
@@ -1858,6 +1871,65 @@ module Aws::AuditManager
1858
1871
  req.send_request(options)
1859
1872
  end
1860
1873
 
1874
+ # Gets the latest analytics data for all your current active
1875
+ # assessments.
1876
+ #
1877
+ # @return [Types::GetInsightsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1878
+ #
1879
+ # * {Types::GetInsightsResponse#insights #insights} => Types::Insights
1880
+ #
1881
+ # @example Response structure
1882
+ #
1883
+ # resp.insights.active_assessments_count #=> Integer
1884
+ # resp.insights.noncompliant_evidence_count #=> Integer
1885
+ # resp.insights.compliant_evidence_count #=> Integer
1886
+ # resp.insights.inconclusive_evidence_count #=> Integer
1887
+ # resp.insights.assessment_controls_count_by_noncompliant_evidence #=> Integer
1888
+ # resp.insights.total_assessment_controls_count #=> Integer
1889
+ # resp.insights.last_updated #=> Time
1890
+ #
1891
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetInsights AWS API Documentation
1892
+ #
1893
+ # @overload get_insights(params = {})
1894
+ # @param [Hash] params ({})
1895
+ def get_insights(params = {}, options = {})
1896
+ req = build_request(:get_insights, params)
1897
+ req.send_request(options)
1898
+ end
1899
+
1900
+ # Gets the latest analytics data for a specific active assessment.
1901
+ #
1902
+ # @option params [required, String] :assessment_id
1903
+ # The unique identifier for the assessment.
1904
+ #
1905
+ # @return [Types::GetInsightsByAssessmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1906
+ #
1907
+ # * {Types::GetInsightsByAssessmentResponse#insights #insights} => Types::InsightsByAssessment
1908
+ #
1909
+ # @example Request syntax with placeholder values
1910
+ #
1911
+ # resp = client.get_insights_by_assessment({
1912
+ # assessment_id: "UUID", # required
1913
+ # })
1914
+ #
1915
+ # @example Response structure
1916
+ #
1917
+ # resp.insights.noncompliant_evidence_count #=> Integer
1918
+ # resp.insights.compliant_evidence_count #=> Integer
1919
+ # resp.insights.inconclusive_evidence_count #=> Integer
1920
+ # resp.insights.assessment_controls_count_by_noncompliant_evidence #=> Integer
1921
+ # resp.insights.total_assessment_controls_count #=> Integer
1922
+ # resp.insights.last_updated #=> Time
1923
+ #
1924
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/GetInsightsByAssessment AWS API Documentation
1925
+ #
1926
+ # @overload get_insights_by_assessment(params = {})
1927
+ # @param [Hash] params ({})
1928
+ def get_insights_by_assessment(params = {}, options = {})
1929
+ req = build_request(:get_insights_by_assessment, params)
1930
+ req.send_request(options)
1931
+ end
1932
+
1861
1933
  # Returns the name of the delegated Amazon Web Services administrator
1862
1934
  # account for the organization.
1863
1935
  #
@@ -1939,6 +2011,67 @@ module Aws::AuditManager
1939
2011
  req.send_request(options)
1940
2012
  end
1941
2013
 
2014
+ # Lists the latest analytics data for controls within a specific control
2015
+ # domain and a specific active assessment.
2016
+ #
2017
+ # <note markdown="1"> Control insights are listed only if the control belongs to the control
2018
+ # domain and assessment that was specified. Moreover, the control must
2019
+ # have collected evidence on the `lastUpdated` date of
2020
+ # `controlInsightsByAssessment`. If neither of these conditions are met,
2021
+ # no data is listed for that control.
2022
+ #
2023
+ # </note>
2024
+ #
2025
+ # @option params [required, String] :control_domain_id
2026
+ # The unique identifier for the control domain.
2027
+ #
2028
+ # @option params [required, String] :assessment_id
2029
+ # The unique identifier for the active assessment.
2030
+ #
2031
+ # @option params [String] :next_token
2032
+ # The pagination token that's used to fetch the next set of results.
2033
+ #
2034
+ # @option params [Integer] :max_results
2035
+ # Represents the maximum number of results on a page or for an API
2036
+ # request call.
2037
+ #
2038
+ # @return [Types::ListAssessmentControlInsightsByControlDomainResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2039
+ #
2040
+ # * {Types::ListAssessmentControlInsightsByControlDomainResponse#control_insights_by_assessment #control_insights_by_assessment} => Array&lt;Types::ControlInsightsMetadataByAssessmentItem&gt;
2041
+ # * {Types::ListAssessmentControlInsightsByControlDomainResponse#next_token #next_token} => String
2042
+ #
2043
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2044
+ #
2045
+ # @example Request syntax with placeholder values
2046
+ #
2047
+ # resp = client.list_assessment_control_insights_by_control_domain({
2048
+ # control_domain_id: "UUID", # required
2049
+ # assessment_id: "UUID", # required
2050
+ # next_token: "Token",
2051
+ # max_results: 1,
2052
+ # })
2053
+ #
2054
+ # @example Response structure
2055
+ #
2056
+ # resp.control_insights_by_assessment #=> Array
2057
+ # resp.control_insights_by_assessment[0].name #=> String
2058
+ # resp.control_insights_by_assessment[0].id #=> String
2059
+ # resp.control_insights_by_assessment[0].evidence_insights.noncompliant_evidence_count #=> Integer
2060
+ # resp.control_insights_by_assessment[0].evidence_insights.compliant_evidence_count #=> Integer
2061
+ # resp.control_insights_by_assessment[0].evidence_insights.inconclusive_evidence_count #=> Integer
2062
+ # resp.control_insights_by_assessment[0].control_set_name #=> String
2063
+ # resp.control_insights_by_assessment[0].last_updated #=> Time
2064
+ # resp.next_token #=> String
2065
+ #
2066
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/ListAssessmentControlInsightsByControlDomain AWS API Documentation
2067
+ #
2068
+ # @overload list_assessment_control_insights_by_control_domain(params = {})
2069
+ # @param [Hash] params ({})
2070
+ def list_assessment_control_insights_by_control_domain(params = {}, options = {})
2071
+ req = build_request(:list_assessment_control_insights_by_control_domain, params)
2072
+ req.send_request(options)
2073
+ end
2074
+
1942
2075
  # Returns a list of sent or received share requests for custom
1943
2076
  # frameworks in Audit Manager.
1944
2077
  #
@@ -2098,6 +2231,9 @@ module Aws::AuditManager
2098
2231
 
2099
2232
  # Returns a list of current and past assessments from Audit Manager.
2100
2233
  #
2234
+ # @option params [String] :status
2235
+ # The current status of the assessment.
2236
+ #
2101
2237
  # @option params [String] :next_token
2102
2238
  # The pagination token that's used to fetch the next set of results.
2103
2239
  #
@@ -2115,6 +2251,7 @@ module Aws::AuditManager
2115
2251
  # @example Request syntax with placeholder values
2116
2252
  #
2117
2253
  # resp = client.list_assessments({
2254
+ # status: "ACTIVE", # accepts ACTIVE, INACTIVE
2118
2255
  # next_token: "Token",
2119
2256
  # max_results: 1,
2120
2257
  # })
@@ -2154,6 +2291,171 @@ module Aws::AuditManager
2154
2291
  req.send_request(options)
2155
2292
  end
2156
2293
 
2294
+ # Lists the latest analytics data for control domains across all of your
2295
+ # active assessments.
2296
+ #
2297
+ # <note markdown="1"> A control domain is listed only if at least one of the controls within
2298
+ # that domain collected evidence on the `lastUpdated` date of
2299
+ # `controlDomainInsights`. If this condition isn’t met, no data is
2300
+ # listed for that control domain.
2301
+ #
2302
+ # </note>
2303
+ #
2304
+ # @option params [String] :next_token
2305
+ # The pagination token that's used to fetch the next set of results.
2306
+ #
2307
+ # @option params [Integer] :max_results
2308
+ # Represents the maximum number of results on a page or for an API
2309
+ # request call.
2310
+ #
2311
+ # @return [Types::ListControlDomainInsightsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2312
+ #
2313
+ # * {Types::ListControlDomainInsightsResponse#control_domain_insights #control_domain_insights} => Array&lt;Types::ControlDomainInsights&gt;
2314
+ # * {Types::ListControlDomainInsightsResponse#next_token #next_token} => String
2315
+ #
2316
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2317
+ #
2318
+ # @example Request syntax with placeholder values
2319
+ #
2320
+ # resp = client.list_control_domain_insights({
2321
+ # next_token: "Token",
2322
+ # max_results: 1,
2323
+ # })
2324
+ #
2325
+ # @example Response structure
2326
+ #
2327
+ # resp.control_domain_insights #=> Array
2328
+ # resp.control_domain_insights[0].name #=> String
2329
+ # resp.control_domain_insights[0].id #=> String
2330
+ # resp.control_domain_insights[0].controls_count_by_noncompliant_evidence #=> Integer
2331
+ # resp.control_domain_insights[0].total_controls_count #=> Integer
2332
+ # resp.control_domain_insights[0].evidence_insights.noncompliant_evidence_count #=> Integer
2333
+ # resp.control_domain_insights[0].evidence_insights.compliant_evidence_count #=> Integer
2334
+ # resp.control_domain_insights[0].evidence_insights.inconclusive_evidence_count #=> Integer
2335
+ # resp.control_domain_insights[0].last_updated #=> Time
2336
+ # resp.next_token #=> String
2337
+ #
2338
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/ListControlDomainInsights AWS API Documentation
2339
+ #
2340
+ # @overload list_control_domain_insights(params = {})
2341
+ # @param [Hash] params ({})
2342
+ def list_control_domain_insights(params = {}, options = {})
2343
+ req = build_request(:list_control_domain_insights, params)
2344
+ req.send_request(options)
2345
+ end
2346
+
2347
+ # Lists analytics data for control domains within a specified active
2348
+ # assessment.
2349
+ #
2350
+ # <note markdown="1"> A control domain is listed only if at least one of the controls within
2351
+ # that domain collected evidence on the `lastUpdated` date of
2352
+ # `controlDomainInsights`. If this condition isn’t met, no data is
2353
+ # listed for that domain.
2354
+ #
2355
+ # </note>
2356
+ #
2357
+ # @option params [required, String] :assessment_id
2358
+ # The unique identifier for the active assessment.
2359
+ #
2360
+ # @option params [String] :next_token
2361
+ # The pagination token that's used to fetch the next set of results.
2362
+ #
2363
+ # @option params [Integer] :max_results
2364
+ # Represents the maximum number of results on a page or for an API
2365
+ # request call.
2366
+ #
2367
+ # @return [Types::ListControlDomainInsightsByAssessmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2368
+ #
2369
+ # * {Types::ListControlDomainInsightsByAssessmentResponse#control_domain_insights #control_domain_insights} => Array&lt;Types::ControlDomainInsights&gt;
2370
+ # * {Types::ListControlDomainInsightsByAssessmentResponse#next_token #next_token} => String
2371
+ #
2372
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2373
+ #
2374
+ # @example Request syntax with placeholder values
2375
+ #
2376
+ # resp = client.list_control_domain_insights_by_assessment({
2377
+ # assessment_id: "UUID", # required
2378
+ # next_token: "Token",
2379
+ # max_results: 1,
2380
+ # })
2381
+ #
2382
+ # @example Response structure
2383
+ #
2384
+ # resp.control_domain_insights #=> Array
2385
+ # resp.control_domain_insights[0].name #=> String
2386
+ # resp.control_domain_insights[0].id #=> String
2387
+ # resp.control_domain_insights[0].controls_count_by_noncompliant_evidence #=> Integer
2388
+ # resp.control_domain_insights[0].total_controls_count #=> Integer
2389
+ # resp.control_domain_insights[0].evidence_insights.noncompliant_evidence_count #=> Integer
2390
+ # resp.control_domain_insights[0].evidence_insights.compliant_evidence_count #=> Integer
2391
+ # resp.control_domain_insights[0].evidence_insights.inconclusive_evidence_count #=> Integer
2392
+ # resp.control_domain_insights[0].last_updated #=> Time
2393
+ # resp.next_token #=> String
2394
+ #
2395
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/ListControlDomainInsightsByAssessment AWS API Documentation
2396
+ #
2397
+ # @overload list_control_domain_insights_by_assessment(params = {})
2398
+ # @param [Hash] params ({})
2399
+ def list_control_domain_insights_by_assessment(params = {}, options = {})
2400
+ req = build_request(:list_control_domain_insights_by_assessment, params)
2401
+ req.send_request(options)
2402
+ end
2403
+
2404
+ # Lists the latest analytics data for controls within a specific control
2405
+ # domain across all active assessments.
2406
+ #
2407
+ # <note markdown="1"> Control insights are listed only if the control belongs to the control
2408
+ # domain that was specified and the control collected evidence on the
2409
+ # `lastUpdated` date of `controlInsightsMetadata`. If neither of these
2410
+ # conditions are met, no data is listed for that control.
2411
+ #
2412
+ # </note>
2413
+ #
2414
+ # @option params [required, String] :control_domain_id
2415
+ # The unique identifier for the control domain.
2416
+ #
2417
+ # @option params [String] :next_token
2418
+ # The pagination token that's used to fetch the next set of results.
2419
+ #
2420
+ # @option params [Integer] :max_results
2421
+ # Represents the maximum number of results on a page or for an API
2422
+ # request call.
2423
+ #
2424
+ # @return [Types::ListControlInsightsByControlDomainResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2425
+ #
2426
+ # * {Types::ListControlInsightsByControlDomainResponse#control_insights_metadata #control_insights_metadata} => Array&lt;Types::ControlInsightsMetadataItem&gt;
2427
+ # * {Types::ListControlInsightsByControlDomainResponse#next_token #next_token} => String
2428
+ #
2429
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2430
+ #
2431
+ # @example Request syntax with placeholder values
2432
+ #
2433
+ # resp = client.list_control_insights_by_control_domain({
2434
+ # control_domain_id: "UUID", # required
2435
+ # next_token: "Token",
2436
+ # max_results: 1,
2437
+ # })
2438
+ #
2439
+ # @example Response structure
2440
+ #
2441
+ # resp.control_insights_metadata #=> Array
2442
+ # resp.control_insights_metadata[0].name #=> String
2443
+ # resp.control_insights_metadata[0].id #=> String
2444
+ # resp.control_insights_metadata[0].evidence_insights.noncompliant_evidence_count #=> Integer
2445
+ # resp.control_insights_metadata[0].evidence_insights.compliant_evidence_count #=> Integer
2446
+ # resp.control_insights_metadata[0].evidence_insights.inconclusive_evidence_count #=> Integer
2447
+ # resp.control_insights_metadata[0].last_updated #=> Time
2448
+ # resp.next_token #=> String
2449
+ #
2450
+ # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/ListControlInsightsByControlDomain AWS API Documentation
2451
+ #
2452
+ # @overload list_control_insights_by_control_domain(params = {})
2453
+ # @param [Hash] params ({})
2454
+ def list_control_insights_by_control_domain(params = {}, options = {})
2455
+ req = build_request(:list_control_insights_by_control_domain, params)
2456
+ req.send_request(options)
2457
+ end
2458
+
2157
2459
  # Returns a list of controls from Audit Manager.
2158
2460
  #
2159
2461
  # @option params [required, String] :control_type
@@ -2509,7 +2811,7 @@ module Aws::AuditManager
2509
2811
  # Edits an Audit Manager assessment.
2510
2812
  #
2511
2813
  # @option params [required, String] :assessment_id
2512
- # The identifier for the assessment.
2814
+ # The unique identifier for the assessment.
2513
2815
  #
2514
2816
  # @option params [String] :assessment_name
2515
2817
  # The name of the assessment to be updated.
@@ -2655,13 +2957,13 @@ module Aws::AuditManager
2655
2957
  # Updates a control within an assessment in Audit Manager.
2656
2958
  #
2657
2959
  # @option params [required, String] :assessment_id
2658
- # The identifier for the assessment.
2960
+ # The unique identifier for the assessment.
2659
2961
  #
2660
2962
  # @option params [required, String] :control_set_id
2661
- # The identifier for the control set.
2963
+ # The unique identifier for the control set.
2662
2964
  #
2663
2965
  # @option params [required, String] :control_id
2664
- # The identifier for the control.
2966
+ # The unique identifier for the control.
2665
2967
  #
2666
2968
  # @option params [String] :control_status
2667
2969
  # The status of the control.
@@ -2711,10 +3013,10 @@ module Aws::AuditManager
2711
3013
  # Updates the status of a control set in an Audit Manager assessment.
2712
3014
  #
2713
3015
  # @option params [required, String] :assessment_id
2714
- # The identifier for the assessment.
3016
+ # The unique identifier for the assessment.
2715
3017
  #
2716
3018
  # @option params [required, String] :control_set_id
2717
- # The identifier for the control set.
3019
+ # The unique identifier for the control set.
2718
3020
  #
2719
3021
  # @option params [required, String] :status
2720
3022
  # The status of the control set that's being updated.
@@ -2784,7 +3086,7 @@ module Aws::AuditManager
2784
3086
  # Updates a custom framework in Audit Manager.
2785
3087
  #
2786
3088
  # @option params [required, String] :framework_id
2787
- # The identifier for the framework.
3089
+ # The unique identifier for the framework.
2788
3090
  #
2789
3091
  # @option params [required, String] :name
2790
3092
  # The name of the framework to be updated.
@@ -2932,7 +3234,7 @@ module Aws::AuditManager
2932
3234
  # Updates the status of an assessment in Audit Manager.
2933
3235
  #
2934
3236
  # @option params [required, String] :assessment_id
2935
- # The identifier for the assessment.
3237
+ # The unique identifier for the assessment.
2936
3238
  #
2937
3239
  # @option params [required, String] :status
2938
3240
  # The current status of the assessment.
@@ -3234,7 +3536,7 @@ module Aws::AuditManager
3234
3536
  params: params,
3235
3537
  config: config)
3236
3538
  context[:gem_name] = 'aws-sdk-auditmanager'
3237
- context[:gem_version] = '1.15.0'
3539
+ context[:gem_version] = '1.19.0'
3238
3540
  Seahorse::Client::Request.new(handlers, context)
3239
3541
  end
3240
3542