aws-sdk-configservice 1.121.0 → 1.123.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -436,6 +436,113 @@ module Aws::ConfigService
436
436
  include Aws::Structure
437
437
  end
438
438
 
439
+ # An object to filter the configuration recorders based on the resource
440
+ # types in scope for recording.
441
+ #
442
+ # @!attribute [rw] type
443
+ # The type of resource type filter to apply. `INCLUDE` specifies that
444
+ # the list of resource types in the `Value` field will be aggregated
445
+ # and no other resource types will be filtered.
446
+ # @return [String]
447
+ #
448
+ # @!attribute [rw] value
449
+ # Comma-separate list of resource types to filter your aggregated
450
+ # configuration recorders.
451
+ # @return [Array<String>]
452
+ #
453
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/AggregatorFilterResourceType AWS API Documentation
454
+ #
455
+ class AggregatorFilterResourceType < Struct.new(
456
+ :type,
457
+ :value)
458
+ SENSITIVE = []
459
+ include Aws::Structure
460
+ end
461
+
462
+ # An object to filter service-linked configuration recorders in an
463
+ # aggregator based on the linked Amazon Web Services service.
464
+ #
465
+ # @!attribute [rw] type
466
+ # The type of service principal filter to apply. `INCLUDE` specifies
467
+ # that the list of service principals in the `Value` field will be
468
+ # aggregated and no other service principals will be filtered.
469
+ # @return [String]
470
+ #
471
+ # @!attribute [rw] value
472
+ # Comma-separated list of service principals for the linked Amazon Web
473
+ # Services services to filter your aggregated service-linked
474
+ # configuration recorders.
475
+ # @return [Array<String>]
476
+ #
477
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/AggregatorFilterServicePrincipal AWS API Documentation
478
+ #
479
+ class AggregatorFilterServicePrincipal < Struct.new(
480
+ :type,
481
+ :value)
482
+ SENSITIVE = []
483
+ include Aws::Structure
484
+ end
485
+
486
+ # An object to filter the data you specify for an aggregator.
487
+ #
488
+ # @!attribute [rw] resource_type
489
+ # An object to filter the configuration recorders based on the
490
+ # resource types in scope for recording.
491
+ # @return [Types::AggregatorFilterResourceType]
492
+ #
493
+ # @!attribute [rw] service_principal
494
+ # An object to filter service-linked configuration recorders in an
495
+ # aggregator based on the linked Amazon Web Services service.
496
+ # @return [Types::AggregatorFilterServicePrincipal]
497
+ #
498
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/AggregatorFilters AWS API Documentation
499
+ #
500
+ class AggregatorFilters < Struct.new(
501
+ :resource_type,
502
+ :service_principal)
503
+ SENSITIVE = []
504
+ include Aws::Structure
505
+ end
506
+
507
+ # @!attribute [rw] configuration_recorder_arn
508
+ # The Amazon Resource Name (ARN) of the specified configuration
509
+ # recorder.
510
+ # @return [String]
511
+ #
512
+ # @!attribute [rw] resource_types
513
+ # The list of resource types you want to add to the recording group of
514
+ # the specified configuration recorder.
515
+ # @return [Array<String>]
516
+ #
517
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/AssociateResourceTypesRequest AWS API Documentation
518
+ #
519
+ class AssociateResourceTypesRequest < Struct.new(
520
+ :configuration_recorder_arn,
521
+ :resource_types)
522
+ SENSITIVE = []
523
+ include Aws::Structure
524
+ end
525
+
526
+ # @!attribute [rw] configuration_recorder
527
+ # Records configuration changes to the resource types in scope.
528
+ #
529
+ # For more information about the configuration recorder, see [
530
+ # **Working with the Configuration Recorder** ][1] in the *Config
531
+ # Developer Guide*.
532
+ #
533
+ #
534
+ #
535
+ # [1]: https://docs.aws.amazon.com/config/latest/developerguide/stop-start-recorder.html
536
+ # @return [Types::ConfigurationRecorder]
537
+ #
538
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/AssociateResourceTypesResponse AWS API Documentation
539
+ #
540
+ class AssociateResourceTypesResponse < Struct.new(
541
+ :configuration_recorder)
542
+ SENSITIVE = []
543
+ include Aws::Structure
544
+ end
545
+
439
546
  # The detailed configurations of a specified resource.
440
547
  #
441
548
  # @!attribute [rw] version
@@ -1041,7 +1148,7 @@ module Aws::ConfigService
1041
1148
  # the rule ran, the last time it failed, and the related error for the
1042
1149
  # last failure.
1043
1150
  #
1044
- # This action does not return status information about Config Custom
1151
+ # This operation does not return status information about Config Custom
1045
1152
  # Lambda rules.
1046
1153
  #
1047
1154
  # @!attribute [rw] config_rule_name
@@ -1263,6 +1370,10 @@ module Aws::ConfigService
1263
1370
  # aggregator.
1264
1371
  # @return [String]
1265
1372
  #
1373
+ # @!attribute [rw] aggregator_filters
1374
+ # An object to filter the data you specify for an aggregator.
1375
+ # @return [Types::AggregatorFilters]
1376
+ #
1266
1377
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ConfigurationAggregator AWS API Documentation
1267
1378
  #
1268
1379
  class ConfigurationAggregator < Struct.new(
@@ -1272,7 +1383,8 @@ module Aws::ConfigService
1272
1383
  :organization_aggregation_source,
1273
1384
  :creation_time,
1274
1385
  :last_updated_time,
1275
- :created_by)
1386
+ :created_by,
1387
+ :aggregator_filters)
1276
1388
  SENSITIVE = []
1277
1389
  include Aws::Structure
1278
1390
  end
@@ -1437,67 +1549,100 @@ module Aws::ConfigService
1437
1549
  include Aws::Structure
1438
1550
  end
1439
1551
 
1440
- # Records configuration changes to your specified resource types. For
1441
- # more information about the configuration recorder, see [ **Managing
1442
- # the Configuration Recorder** ][1] in the *Config Developer Guide*.
1552
+ # Records configuration changes to the resource types in scope.
1553
+ #
1554
+ # For more information about the configuration recorder, see [ **Working
1555
+ # with the Configuration Recorder** ][1] in the *Config Developer
1556
+ # Guide*.
1443
1557
  #
1444
1558
  #
1445
1559
  #
1446
1560
  # [1]: https://docs.aws.amazon.com/config/latest/developerguide/stop-start-recorder.html
1447
1561
  #
1562
+ # @!attribute [rw] arn
1563
+ # The Amazon Resource Name (ARN) of the specified configuration
1564
+ # recorder.
1565
+ # @return [String]
1566
+ #
1448
1567
  # @!attribute [rw] name
1449
- # The name of the configuration recorder. Config automatically assigns
1450
- # the name of "default" when creating the configuration recorder.
1568
+ # The name of the configuration recorder.
1569
+ #
1570
+ # For customer managed configuration recorders, Config automatically
1571
+ # assigns the name of "default" when creating a configuration
1572
+ # recorder if you do not specify a name at creation time.
1451
1573
  #
1452
- # <note markdown="1"> You cannot change the name of the configuration recorder after it
1453
- # has been created. To change the configuration recorder name, you
1454
- # must delete it and create a new configuration recorder with a new
1455
- # name.
1574
+ # For service-linked configuration recorders, Config automatically
1575
+ # assigns a name that has the prefix "`AWS`" to a new service-linked
1576
+ # configuration recorder.
1577
+ #
1578
+ # <note markdown="1"> **Changing the name of a configuration recorder**
1579
+ #
1580
+ # To change the name of the customer managed configuration recorder,
1581
+ # you must delete it and create a new customer managed configuration
1582
+ # recorder with a new name.
1583
+ #
1584
+ # You cannot change the name of a service-linked configuration
1585
+ # recorder.
1456
1586
  #
1457
1587
  # </note>
1458
1588
  # @return [String]
1459
1589
  #
1460
1590
  # @!attribute [rw] role_arn
1461
- # Amazon Resource Name (ARN) of the IAM role assumed by Config and
1462
- # used by the configuration recorder.
1591
+ # The Amazon Resource Name (ARN) of the IAM role assumed by Config and
1592
+ # used by the specified configuration recorder.
1593
+ #
1594
+ # <note markdown="1"> **The server will reject a request without a defined `roleARN` for
1595
+ # the configuration recorder**
1463
1596
  #
1464
- # <note markdown="1"> While the API model does not require this field, the server will
1597
+ # While the API model does not require this field, the server will
1465
1598
  # reject a request without a defined `roleARN` for the configuration
1466
1599
  # recorder.
1467
1600
  #
1468
- # </note>
1601
+ # **Policies and compliance results**
1602
+ #
1603
+ # [IAM policies][1] and [other policies managed in Organizations][2]
1604
+ # can impact whether Config has permissions to record configuration
1605
+ # changes for your resources. Additionally, rules directly evaluate
1606
+ # the configuration of a resource and rules don't take into account
1607
+ # these policies when running evaluations. Make sure that the policies
1608
+ # in effect align with how you intend to use Config.
1469
1609
  #
1470
- # <note markdown="1"> **Pre-existing Config role**
1610
+ # **Keep Minimum Permisions When Reusing an IAM role**
1471
1611
  #
1472
- # If you have used an Amazon Web Services service that uses Config,
1473
- # such as Security Hub or Control Tower, and an Config role has
1474
- # already been created, make sure that the IAM role that you use when
1475
- # setting up Config keeps the same minimum permissions as the already
1476
- # created Config role. You must do this so that the other Amazon Web
1477
- # Services service continues to run as expected.
1612
+ # If you use an Amazon Web Services service that uses Config, such as
1613
+ # Security Hub or Control Tower, and an IAM role has already been
1614
+ # created, make sure that the IAM role that you use when setting up
1615
+ # Config keeps the same minimum permissions as the pre-existing IAM
1616
+ # role. You must do this to ensure that the other Amazon Web Services
1617
+ # service continues to run as expected.
1478
1618
  #
1479
1619
  # For example, if Control Tower has an IAM role that allows Config to
1480
- # read Amazon Simple Storage Service (Amazon S3) objects, make sure
1481
- # that the same permissions are granted within the IAM role you use
1482
- # when setting up Config. Otherwise, it may interfere with how Control
1483
- # Tower operates. For more information about IAM roles for Config, see
1484
- # [ **Identity and Access Management for Config** ][1] in the *Config
1485
- # Developer Guide*.
1620
+ # read S3 objects, make sure that the same permissions are granted to
1621
+ # the IAM role you use when setting up Config. Otherwise, it may
1622
+ # interfere with how Control Tower operates.
1623
+ #
1624
+ # **The service-linked IAM role for Config must be used for
1625
+ # service-linked configuration recorders**
1626
+ #
1627
+ # For service-linked configuration recorders, you must use the
1628
+ # service-linked IAM role for Config: [AWSServiceRoleForConfig][3].
1486
1629
  #
1487
1630
  # </note>
1488
1631
  #
1489
1632
  #
1490
1633
  #
1491
- # [1]: https://docs.aws.amazon.com/config/latest/developerguide/security-iam.html
1634
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html
1635
+ # [2]: https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies.html
1636
+ # [3]: https://docs.aws.amazon.com/config/latest/developerguide/using-service-linked-roles.html
1492
1637
  # @return [String]
1493
1638
  #
1494
1639
  # @!attribute [rw] recording_group
1495
- # Specifies which resource types Config records for configuration
1496
- # changes.
1640
+ # Specifies which resource types are in scope for the configuration
1641
+ # recorder to record.
1497
1642
  #
1498
1643
  # <note markdown="1"> <b> High Number of Config Evaluations</b>
1499
1644
  #
1500
- # You may notice increased activity in your account during your
1645
+ # You might notice increased activity in your account during your
1501
1646
  # initial month recording with Config when compared to subsequent
1502
1647
  # months. During the initial bootstrapping process, Config runs
1503
1648
  # evaluations on all the resources in your account that you have
@@ -1508,19 +1653,21 @@ module Aws::ConfigService
1508
1653
  # with creating and deleting these temporary resources. An *ephemeral
1509
1654
  # workload* is a temporary use of computing resources that are loaded
1510
1655
  # and run when needed. Examples include Amazon Elastic Compute Cloud
1511
- # (Amazon EC2) Spot Instances, Amazon EMR jobs, and Auto Scaling. If
1512
- # you want to avoid the increased activity from running ephemeral
1513
- # workloads, you can run these types of workloads in a separate
1514
- # account with Config turned off to avoid increased configuration
1515
- # recording and rule evaluations.
1656
+ # (Amazon EC2) Spot Instances, Amazon EMR jobs, and Auto Scaling.
1657
+ #
1658
+ # If you want to avoid the increased activity from running ephemeral
1659
+ # workloads, you can set up the configuration recorder to exclude
1660
+ # these resource types from being recorded, or run these types of
1661
+ # workloads in a separate account with Config turned off to avoid
1662
+ # increased configuration recording and rule evaluations.
1516
1663
  #
1517
1664
  # </note>
1518
1665
  # @return [Types::RecordingGroup]
1519
1666
  #
1520
1667
  # @!attribute [rw] recording_mode
1521
- # Specifies the default recording frequency that Config uses to record
1522
- # configuration changes. Config supports *Continuous recording* and
1523
- # *Daily recording*.
1668
+ # Specifies the default recording frequency for the configuration
1669
+ # recorder. Config supports *Continuous recording* and *Daily
1670
+ # recording*.
1524
1671
  #
1525
1672
  # * Continuous recording allows you to record configuration changes
1526
1673
  # continuously whenever a change occurs.
@@ -1530,7 +1677,9 @@ module Aws::ConfigService
1530
1677
  # 24-hour period, only if it’s different from the previous CI
1531
1678
  # recorded.
1532
1679
  #
1533
- # <note markdown="1"> Firewall Manager depends on continuous recording to monitor your
1680
+ # <note markdown="1"> **Some resource types require continuous recording**
1681
+ #
1682
+ # Firewall Manager depends on continuous recording to monitor your
1534
1683
  # resources. If you are using Firewall Manager, it is recommended that
1535
1684
  # you set the recording frequency to Continuous.
1536
1685
  #
@@ -1540,23 +1689,74 @@ module Aws::ConfigService
1540
1689
  # types.
1541
1690
  # @return [Types::RecordingMode]
1542
1691
  #
1692
+ # @!attribute [rw] recording_scope
1693
+ # Specifies whether the [ConfigurationItems][1] in scope for the
1694
+ # specified configuration recorder are recorded for free (`INTERNAL`)
1695
+ # or if it impacts the costs to your bill (`PAID`).
1696
+ #
1697
+ #
1698
+ #
1699
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_ConfigurationItem.html
1700
+ # @return [String]
1701
+ #
1702
+ # @!attribute [rw] service_principal
1703
+ # For service-linked configuration recorders, specifies the linked
1704
+ # Amazon Web Services service for the configuration recorder.
1705
+ # @return [String]
1706
+ #
1543
1707
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ConfigurationRecorder AWS API Documentation
1544
1708
  #
1545
1709
  class ConfigurationRecorder < Struct.new(
1710
+ :arn,
1546
1711
  :name,
1547
1712
  :role_arn,
1548
1713
  :recording_group,
1549
- :recording_mode)
1714
+ :recording_mode,
1715
+ :recording_scope,
1716
+ :service_principal)
1717
+ SENSITIVE = []
1718
+ include Aws::Structure
1719
+ end
1720
+
1721
+ # Filters configuration recorders by recording scope.
1722
+ #
1723
+ # @!attribute [rw] filter_name
1724
+ # The name of the type of filter. Currently, only `recordingScope` is
1725
+ # supported.
1726
+ # @return [String]
1727
+ #
1728
+ # @!attribute [rw] filter_value
1729
+ # The value of the filter. For `recordingScope`, valid values include:
1730
+ # `INTERNAL` and `PAID`.
1731
+ #
1732
+ # `INTERNAL` indicates that the [ConfigurationItems][1] in scope for
1733
+ # the configuration recorder are recorded for free.
1734
+ #
1735
+ # `PAID` indicates that the [ConfigurationItems][1] in scope for the
1736
+ # configuration recorder impact the costs to your bill.
1737
+ #
1738
+ #
1739
+ #
1740
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_ConfigurationItem.html
1741
+ # @return [Array<String>]
1742
+ #
1743
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ConfigurationRecorderFilter AWS API Documentation
1744
+ #
1745
+ class ConfigurationRecorderFilter < Struct.new(
1746
+ :filter_name,
1747
+ :filter_value)
1550
1748
  SENSITIVE = []
1551
1749
  include Aws::Structure
1552
1750
  end
1553
1751
 
1554
1752
  # The current status of the configuration recorder.
1555
1753
  #
1556
- # <note markdown="1"> For a detailed status of recording events over time, add your Config
1754
+ # For a detailed status of recording events over time, add your Config
1557
1755
  # events to CloudWatch metrics and use CloudWatch metrics.
1558
1756
  #
1559
- # </note>
1757
+ # @!attribute [rw] arn
1758
+ # The Amazon Resource Name (ARN) of the configuration recorder.
1759
+ # @return [String]
1560
1760
  #
1561
1761
  # @!attribute [rw] name
1562
1762
  # The name of the configuration recorder.
@@ -1591,9 +1791,15 @@ module Aws::ConfigService
1591
1791
  # processed by the recorder.
1592
1792
  # @return [Time]
1593
1793
  #
1794
+ # @!attribute [rw] service_principal
1795
+ # For service-linked configuration recorders, the service principal of
1796
+ # the linked Amazon Web Services service.
1797
+ # @return [String]
1798
+ #
1594
1799
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ConfigurationRecorderStatus AWS API Documentation
1595
1800
  #
1596
1801
  class ConfigurationRecorderStatus < Struct.new(
1802
+ :arn,
1597
1803
  :name,
1598
1804
  :last_start_time,
1599
1805
  :last_stop_time,
@@ -1601,11 +1807,86 @@ module Aws::ConfigService
1601
1807
  :last_status,
1602
1808
  :last_error_code,
1603
1809
  :last_error_message,
1604
- :last_status_change_time)
1810
+ :last_status_change_time,
1811
+ :service_principal)
1605
1812
  SENSITIVE = []
1606
1813
  include Aws::Structure
1607
1814
  end
1608
1815
 
1816
+ # A summary of a configuration recorder, including the `arn`, `name`,
1817
+ # `servicePrincipal`, and `recordingScope`.
1818
+ #
1819
+ # @!attribute [rw] arn
1820
+ # The Amazon Resource Name (ARN) of the configuration recorder.
1821
+ # @return [String]
1822
+ #
1823
+ # @!attribute [rw] name
1824
+ # The name of the configuration recorder.
1825
+ # @return [String]
1826
+ #
1827
+ # @!attribute [rw] service_principal
1828
+ # For service-linked configuration recorders, indicates which Amazon
1829
+ # Web Services service the configuration recorder is linked to.
1830
+ # @return [String]
1831
+ #
1832
+ # @!attribute [rw] recording_scope
1833
+ # Indicates whether the [ConfigurationItems][1] in scope for the
1834
+ # configuration recorder are recorded for free (`INTERNAL`) or if you
1835
+ # are charged a service fee for recording (`PAID`).
1836
+ #
1837
+ #
1838
+ #
1839
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_ConfigurationItem.html
1840
+ # @return [String]
1841
+ #
1842
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ConfigurationRecorderSummary AWS API Documentation
1843
+ #
1844
+ class ConfigurationRecorderSummary < Struct.new(
1845
+ :arn,
1846
+ :name,
1847
+ :service_principal,
1848
+ :recording_scope)
1849
+ SENSITIVE = []
1850
+ include Aws::Structure
1851
+ end
1852
+
1853
+ # For [PutServiceLinkedConfigurationRecorder][1], you cannot create a
1854
+ # service-linked recorder because a service-linked recorder already
1855
+ # exists for the specified service.
1856
+ #
1857
+ # For [DeleteServiceLinkedConfigurationRecorder][2], you cannot delete
1858
+ # the service-linked recorder because it is currently in use by the
1859
+ # linked Amazon Web Services service.
1860
+ #
1861
+ # For [DeleteDeliveryChannel][3], you cannot delete the specified
1862
+ # delivery channel because the customer managed configuration recorder
1863
+ # is running. Use the [StopConfigurationRecorder][4] operation to stop
1864
+ # the customer managed configuration recorder.
1865
+ #
1866
+ # For [AssociateResourceTypes][5] and [DisassociateResourceTypes][6],
1867
+ # one of the following errors:
1868
+ #
1869
+ # * For service-linked configuration recorders, the configuration
1870
+ # recorder is not in use by the service. No association or
1871
+ # dissociation of resource types is permitted.
1872
+ #
1873
+ # * For service-linked configuration recorders, your requested change to
1874
+ # the configuration recorder has been denied by its linked Amazon Web
1875
+ # Services service.
1876
+ #
1877
+ #
1878
+ #
1879
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutServiceLinkedConfigurationRecorder.html
1880
+ # [2]: https://docs.aws.amazon.com/config/latest/APIReference/API_DeleteServiceLinkedConfigurationRecorder.html
1881
+ # [3]: https://docs.aws.amazon.com/config/latest/APIReference/API_DeleteDeliveryChannel.html
1882
+ # [4]: https://docs.aws.amazon.com/config/latest/APIReference/API_StopConfigurationRecorder.html
1883
+ # [5]: https://docs.aws.amazon.com/config/latest/APIReference/API_AssociateResourceTypes.html
1884
+ # [6]: https://docs.aws.amazon.com/config/latest/APIReference/API_DisassociateResourceTypes.html
1885
+ #
1886
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ConflictException AWS API Documentation
1887
+ #
1888
+ class ConflictException < Aws::EmptyStructure; end
1889
+
1609
1890
  # Filters the conformance pack by compliance types and Config rule
1610
1891
  # names.
1611
1892
  #
@@ -2045,12 +2326,17 @@ module Aws::ConfigService
2045
2326
  include Aws::Structure
2046
2327
  end
2047
2328
 
2048
- # The request object for the `DeleteConfigurationRecorder` action.
2329
+ # The request object for the `DeleteConfigurationRecorder` operation.
2049
2330
  #
2050
2331
  # @!attribute [rw] configuration_recorder_name
2051
- # The name of the configuration recorder to be deleted. You can
2052
- # retrieve the name of your configuration recorder by using the
2053
- # `DescribeConfigurationRecorders` action.
2332
+ # The name of the customer managed configuration recorder that you
2333
+ # want to delete. You can retrieve the name of your configuration
2334
+ # recorders by using the [DescribeConfigurationRecorders][1]
2335
+ # operation.
2336
+ #
2337
+ #
2338
+ #
2339
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_DescribeConfigurationRecorders.html
2054
2340
  # @return [String]
2055
2341
  #
2056
2342
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DeleteConfigurationRecorderRequest AWS API Documentation
@@ -2077,7 +2363,7 @@ module Aws::ConfigService
2077
2363
  # following data, in JSON format.
2078
2364
  #
2079
2365
  # @!attribute [rw] delivery_channel_name
2080
- # The name of the delivery channel to delete.
2366
+ # The name of the delivery channel that you want to delete.
2081
2367
  # @return [String]
2082
2368
  #
2083
2369
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DeleteDeliveryChannelRequest AWS API Documentation
@@ -2234,6 +2520,37 @@ module Aws::ConfigService
2234
2520
  include Aws::Structure
2235
2521
  end
2236
2522
 
2523
+ # @!attribute [rw] service_principal
2524
+ # The service principal of the Amazon Web Services service for the
2525
+ # service-linked configuration recorder that you want to delete.
2526
+ # @return [String]
2527
+ #
2528
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DeleteServiceLinkedConfigurationRecorderRequest AWS API Documentation
2529
+ #
2530
+ class DeleteServiceLinkedConfigurationRecorderRequest < Struct.new(
2531
+ :service_principal)
2532
+ SENSITIVE = []
2533
+ include Aws::Structure
2534
+ end
2535
+
2536
+ # @!attribute [rw] arn
2537
+ # The Amazon Resource Name (ARN) of the specified configuration
2538
+ # recorder.
2539
+ # @return [String]
2540
+ #
2541
+ # @!attribute [rw] name
2542
+ # The name of the specified configuration recorder.
2543
+ # @return [String]
2544
+ #
2545
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DeleteServiceLinkedConfigurationRecorderResponse AWS API Documentation
2546
+ #
2547
+ class DeleteServiceLinkedConfigurationRecorderResponse < Struct.new(
2548
+ :arn,
2549
+ :name)
2550
+ SENSITIVE = []
2551
+ include Aws::Structure
2552
+ end
2553
+
2237
2554
  # @!attribute [rw] query_name
2238
2555
  # The name of the query that you want to delete.
2239
2556
  # @return [String]
@@ -2560,7 +2877,7 @@ module Aws::ConfigService
2560
2877
  # @!attribute [rw] resource_type
2561
2878
  # The types of Amazon Web Services resources for which you want
2562
2879
  # compliance information (for example, `AWS::EC2::Instance`). For this
2563
- # action, you can specify that the resource type is an Amazon Web
2880
+ # operation, you can specify that the resource type is an Amazon Web
2564
2881
  # Services account by specifying `AWS::::Account`.
2565
2882
  # @return [String]
2566
2883
  #
@@ -2840,15 +3157,34 @@ module Aws::ConfigService
2840
3157
  # The input for the DescribeConfigurationRecorderStatus action.
2841
3158
  #
2842
3159
  # @!attribute [rw] configuration_recorder_names
2843
- # The name(s) of the configuration recorder. If the name is not
2844
- # specified, the action returns the current status of all the
2845
- # configuration recorders associated with the account.
3160
+ # The name of the configuration recorder. If the name is not
3161
+ # specified, the opertation returns the status for the customer
3162
+ # managed configuration recorder configured for the account, if
3163
+ # applicable.
3164
+ #
3165
+ # <note markdown="1"> When making a request to this operation, you can only specify one
3166
+ # configuration recorder.
3167
+ #
3168
+ # </note>
2846
3169
  # @return [Array<String>]
2847
3170
  #
3171
+ # @!attribute [rw] service_principal
3172
+ # For service-linked configuration recorders, you can use the service
3173
+ # principal of the linked Amazon Web Services service to specify the
3174
+ # configuration recorder.
3175
+ # @return [String]
3176
+ #
3177
+ # @!attribute [rw] arn
3178
+ # The Amazon Resource Name (ARN) of the configuration recorder that
3179
+ # you want to specify.
3180
+ # @return [String]
3181
+ #
2848
3182
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DescribeConfigurationRecorderStatusRequest AWS API Documentation
2849
3183
  #
2850
3184
  class DescribeConfigurationRecorderStatusRequest < Struct.new(
2851
- :configuration_recorder_names)
3185
+ :configuration_recorder_names,
3186
+ :service_principal,
3187
+ :arn)
2852
3188
  SENSITIVE = []
2853
3189
  include Aws::Structure
2854
3190
  end
@@ -2871,13 +3207,27 @@ module Aws::ConfigService
2871
3207
  # The input for the DescribeConfigurationRecorders action.
2872
3208
  #
2873
3209
  # @!attribute [rw] configuration_recorder_names
2874
- # A list of configuration recorder names.
3210
+ # A list of names of the configuration recorders that you want to
3211
+ # specify.
2875
3212
  # @return [Array<String>]
2876
3213
  #
3214
+ # @!attribute [rw] service_principal
3215
+ # For service-linked configuration recorders, you can use the service
3216
+ # principal of the linked Amazon Web Services service to specify the
3217
+ # configuration recorder.
3218
+ # @return [String]
3219
+ #
3220
+ # @!attribute [rw] arn
3221
+ # The Amazon Resource Name (ARN) of the configuration recorder that
3222
+ # you want to specify.
3223
+ # @return [String]
3224
+ #
2877
3225
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DescribeConfigurationRecordersRequest AWS API Documentation
2878
3226
  #
2879
3227
  class DescribeConfigurationRecordersRequest < Struct.new(
2880
- :configuration_recorder_names)
3228
+ :configuration_recorder_names,
3229
+ :service_principal,
3230
+ :arn)
2881
3231
  SENSITIVE = []
2882
3232
  include Aws::Structure
2883
3233
  end
@@ -3382,7 +3732,7 @@ module Aws::ConfigService
3382
3732
  end
3383
3733
 
3384
3734
  # @!attribute [rw] config_rule_name
3385
- # A list of Config rule names.
3735
+ # The name of the Config rule.
3386
3736
  # @return [String]
3387
3737
  #
3388
3738
  # @!attribute [rw] resource_keys
@@ -3474,6 +3824,45 @@ module Aws::ConfigService
3474
3824
  include Aws::Structure
3475
3825
  end
3476
3826
 
3827
+ # @!attribute [rw] configuration_recorder_arn
3828
+ # The Amazon Resource Name (ARN) of the specified configuration
3829
+ # recorder.
3830
+ # @return [String]
3831
+ #
3832
+ # @!attribute [rw] resource_types
3833
+ # The list of resource types you want to remove from the recording
3834
+ # group of the specified configuration recorder.
3835
+ # @return [Array<String>]
3836
+ #
3837
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DisassociateResourceTypesRequest AWS API Documentation
3838
+ #
3839
+ class DisassociateResourceTypesRequest < Struct.new(
3840
+ :configuration_recorder_arn,
3841
+ :resource_types)
3842
+ SENSITIVE = []
3843
+ include Aws::Structure
3844
+ end
3845
+
3846
+ # @!attribute [rw] configuration_recorder
3847
+ # Records configuration changes to the resource types in scope.
3848
+ #
3849
+ # For more information about the configuration recorder, see [
3850
+ # **Working with the Configuration Recorder** ][1] in the *Config
3851
+ # Developer Guide*.
3852
+ #
3853
+ #
3854
+ #
3855
+ # [1]: https://docs.aws.amazon.com/config/latest/developerguide/stop-start-recorder.html
3856
+ # @return [Types::ConfigurationRecorder]
3857
+ #
3858
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/DisassociateResourceTypesResponse AWS API Documentation
3859
+ #
3860
+ class DisassociateResourceTypesResponse < Struct.new(
3861
+ :configuration_recorder)
3862
+ SENSITIVE = []
3863
+ include Aws::Structure
3864
+ end
3865
+
3477
3866
  # Identifies an Amazon Web Services resource and indicates whether it
3478
3867
  # complies with the Config rule that it was evaluated against.
3479
3868
  #
@@ -3719,28 +4108,15 @@ module Aws::ConfigService
3719
4108
  # recorded in the Region where you set up the configuration recorder if
3720
4109
  # that is a Region where Config was available before February 2022. You
3721
4110
  # cannot be record the global IAM resouce types in Regions supported by
3722
- # Config after February 2022. This list where you cannot record the
3723
- # global IAM resource types includes the following Regions:
3724
- #
3725
- # * Asia Pacific (Hyderabad)
3726
- #
3727
- # * Asia Pacific (Melbourne)
3728
- #
3729
- # * Canada West (Calgary)
3730
- #
3731
- # * Europe (Spain)
3732
- #
3733
- # * Europe (Zurich)
3734
- #
3735
- # * Israel (Tel Aviv)
3736
- #
3737
- # * Middle East (UAE)
4111
+ # Config after February 2022. For a list of those Regions, see
4112
+ # [Recording Amazon Web Services Resources \| Global Resources][2].
3738
4113
  #
3739
4114
  # </note>
3740
4115
  #
3741
4116
  #
3742
4117
  #
3743
4118
  # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_RecordingStrategy.html
4119
+ # [2]: https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html#select-resources-all
3744
4120
  #
3745
4121
  # @!attribute [rw] resource_types
3746
4122
  # A comma-separated list of resource types to exclude from recording
@@ -4848,7 +5224,7 @@ module Aws::ConfigService
4848
5224
  include Aws::Structure
4849
5225
  end
4850
5226
 
4851
- # Your Amazon S3 bucket policy does not permit Config to write to it.
5227
+ # Your Amazon S3 bucket policy does not allow Config to write to it.
4852
5228
  #
4853
5229
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/InsufficientDeliveryPolicyException AWS API Documentation
4854
5230
  #
@@ -4856,19 +5232,19 @@ module Aws::ConfigService
4856
5232
 
4857
5233
  # Indicates one of the following errors:
4858
5234
  #
4859
- # * For PutConfigRule, the rule cannot be created because the IAM role
4860
- # assigned to Config lacks permissions to perform the config:Put*
4861
- # action.
5235
+ # * For [PutConfigRule][1], the rule cannot be created because the IAM
5236
+ # role assigned to Config lacks permissions to perform the
5237
+ # config:Put* action.
4862
5238
  #
4863
- # * For PutConfigRule, the Lambda function cannot be invoked. Check the
4864
- # function ARN, and check the function's permissions.
5239
+ # * For [PutConfigRule][1], the Lambda function cannot be invoked. Check
5240
+ # the function ARN, and check the function's permissions.
4865
5241
  #
4866
- # * For PutOrganizationConfigRule, organization Config rule cannot be
4867
- # created because you do not have permissions to call IAM `GetRole`
5242
+ # * For [PutOrganizationConfigRule][2], organization Config rule cannot
5243
+ # be created because you do not have permissions to call IAM `GetRole`
4868
5244
  # action or create a service-linked role.
4869
5245
  #
4870
- # * For PutConformancePack and PutOrganizationConformancePack, a
4871
- # conformance pack cannot be created because you do not have the
5246
+ # * For [PutConformancePack][3] and [PutOrganizationConformancePack][4],
5247
+ # a conformance pack cannot be created because you do not have the
4872
5248
  # following permissions:
4873
5249
  #
4874
5250
  # * You do not have permission to call IAM `GetRole` action or create
@@ -4876,13 +5252,24 @@ module Aws::ConfigService
4876
5252
  #
4877
5253
  # * You do not have permission to read Amazon S3 bucket or call
4878
5254
  # SSM:GetDocument.
5255
+ # * For [PutServiceLinkedConfigurationRecorder][5], a service-linked
5256
+ # configuration recorder cannot be created because you do not have the
5257
+ # following permissions: IAM `CreateServiceLinkedRole`.
5258
+ #
5259
+ #
5260
+ #
5261
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutConfigRule.html
5262
+ # [2]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutOrganizationConfigRule.html
5263
+ # [3]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutConformancePack.html
5264
+ # [4]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutOrganizationConformancePack.html
5265
+ # [5]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutServiceLinkedConfigurationRecorder.html
4879
5266
  #
4880
5267
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/InsufficientPermissionsException AWS API Documentation
4881
5268
  #
4882
5269
  class InsufficientPermissionsException < Aws::EmptyStructure; end
4883
5270
 
4884
- # You have provided a name for the configuration recorder that is not
4885
- # valid.
5271
+ # You have provided a name for the customer managed configuration
5272
+ # recorder that is not valid.
4886
5273
  #
4887
5274
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/InvalidConfigurationRecorderNameException AWS API Documentation
4888
5275
  #
@@ -4921,7 +5308,7 @@ module Aws::ConfigService
4921
5308
  #
4922
5309
  class InvalidParameterValueException < Aws::EmptyStructure; end
4923
5310
 
4924
- # Indicates one of the following errors:
5311
+ # One of the following errors:
4925
5312
  #
4926
5313
  # * You have provided a combination of parameter values that is not
4927
5314
  # valid. For example:
@@ -4933,7 +5320,6 @@ module Aws::ConfigService
4933
5320
  # * Setting the `allSupported` field of [RecordingGroup][1] to `true`,
4934
5321
  # but also setting the `useOnly` field of [RecordingStrategy][2] to
4935
5322
  # `EXCLUSION_BY_RESOURCE_TYPES`.
4936
- #
4937
5323
  # * Every parameter is either null, false, or empty.
4938
5324
  #
4939
5325
  # * You have reached the limit of the number of resource types you can
@@ -4958,7 +5344,8 @@ module Aws::ConfigService
4958
5344
  class InvalidResultTokenException < Aws::EmptyStructure; end
4959
5345
 
4960
5346
  # You have provided a null or empty Amazon Resource Name (ARN) for the
4961
- # IAM role assumed by Config and used by the configuration recorder.
5347
+ # IAM role assumed by Config and used by the customer managed
5348
+ # configuration recorder.
4962
5349
  #
4963
5350
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/InvalidRoleException AWS API Documentation
4964
5351
  #
@@ -4990,12 +5377,16 @@ module Aws::ConfigService
4990
5377
  class InvalidTimeRangeException < Aws::EmptyStructure; end
4991
5378
 
4992
5379
  # You cannot delete the delivery channel you specified because the
4993
- # configuration recorder is running.
5380
+ # customer managed configuration recorder is running.
4994
5381
  #
4995
5382
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/LastDeliveryChannelDeleteFailedException AWS API Documentation
4996
5383
  #
4997
5384
  class LastDeliveryChannelDeleteFailedException < Aws::EmptyStructure; end
4998
5385
 
5386
+ # For `PutServiceLinkedConfigurationRecorder` API, this exception is
5387
+ # thrown if the number of service-linked roles in the account exceeds
5388
+ # the limit.
5389
+ #
4999
5390
  # For `StartConfigRulesEvaluation` API, this exception is thrown if an
5000
5391
  # evaluation is in progress or if you call the
5001
5392
  # StartConfigRulesEvaluation API more than once per minute.
@@ -5060,6 +5451,48 @@ module Aws::ConfigService
5060
5451
  include Aws::Structure
5061
5452
  end
5062
5453
 
5454
+ # @!attribute [rw] filters
5455
+ # Filters the results based on a list of `ConfigurationRecorderFilter`
5456
+ # objects that you specify.
5457
+ # @return [Array<Types::ConfigurationRecorderFilter>]
5458
+ #
5459
+ # @!attribute [rw] max_results
5460
+ # The maximum number of results to include in the response.
5461
+ # @return [Integer]
5462
+ #
5463
+ # @!attribute [rw] next_token
5464
+ # The `NextToken` string returned on a previous page that you use to
5465
+ # get the next page of results in a paginated response.
5466
+ # @return [String]
5467
+ #
5468
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ListConfigurationRecordersRequest AWS API Documentation
5469
+ #
5470
+ class ListConfigurationRecordersRequest < Struct.new(
5471
+ :filters,
5472
+ :max_results,
5473
+ :next_token)
5474
+ SENSITIVE = []
5475
+ include Aws::Structure
5476
+ end
5477
+
5478
+ # @!attribute [rw] configuration_recorder_summaries
5479
+ # A list of `ConfigurationRecorderSummary` objects that includes.
5480
+ # @return [Array<Types::ConfigurationRecorderSummary>]
5481
+ #
5482
+ # @!attribute [rw] next_token
5483
+ # The `NextToken` string returned on a previous page that you use to
5484
+ # get the next page of results in a paginated response.
5485
+ # @return [String]
5486
+ #
5487
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ListConfigurationRecordersResponse AWS API Documentation
5488
+ #
5489
+ class ListConfigurationRecordersResponse < Struct.new(
5490
+ :configuration_recorder_summaries,
5491
+ :next_token)
5492
+ SENSITIVE = []
5493
+ include Aws::Structure
5494
+ end
5495
+
5063
5496
  # @!attribute [rw] filters
5064
5497
  # Filters the results based on the
5065
5498
  # `ConformancePackComplianceScoresFilters`.
@@ -5268,7 +5701,7 @@ module Aws::ConfigService
5268
5701
  # If the previous paginated request didn't return all of the
5269
5702
  # remaining results, the response object's `NextToken` parameter
5270
5703
  # value is set to a token. To retrieve the next set of results, call
5271
- # this action again and assign that token to the request object's
5704
+ # this operation again and assign that token to the request object's
5272
5705
  # `NextToken` parameter. If there are no remaining results, the
5273
5706
  # previous response object's `NextToken` parameter is set to `null`.
5274
5707
  # @return [String]
@@ -5284,9 +5717,23 @@ module Aws::ConfigService
5284
5717
 
5285
5718
  # @!attribute [rw] resource_arn
5286
5719
  # The Amazon Resource Name (ARN) that identifies the resource for
5287
- # which to list the tags. Currently, the supported resources are
5288
- # `ConfigRule`, `ConfigurationAggregator` and
5289
- # `AggregatorAuthorization`.
5720
+ # which to list the tags. The following resources are supported:
5721
+ #
5722
+ # * `ConfigurationRecorder`
5723
+ #
5724
+ # * `ConfigRule`
5725
+ #
5726
+ # * `OrganizationConfigRule`
5727
+ #
5728
+ # * `ConformancePack`
5729
+ #
5730
+ # * `OrganizationConformancePack`
5731
+ #
5732
+ # * `ConfigurationAggregator`
5733
+ #
5734
+ # * `AggregationAuthorization`
5735
+ #
5736
+ # * `StoredQuery`
5290
5737
  # @return [String]
5291
5738
  #
5292
5739
  # @!attribute [rw] limit
@@ -5484,8 +5931,13 @@ module Aws::ConfigService
5484
5931
  include Aws::Structure
5485
5932
  end
5486
5933
 
5487
- # There are no configuration recorders available to provide the role
5488
- # needed to describe your resources. Create a configuration recorder.
5934
+ # There are no customer managed configuration recorders available to
5935
+ # record your resources. Use the [PutConfigurationRecorder][1] operation
5936
+ # to create the customer managed configuration recorder.
5937
+ #
5938
+ #
5939
+ #
5940
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutConfigurationRecorder.html
5489
5941
  #
5490
5942
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/NoAvailableConfigurationRecorderException AWS API Documentation
5491
5943
  #
@@ -5608,7 +6060,7 @@ module Aws::ConfigService
5608
6060
  # * You are not a registered delegated administrator for Config with
5609
6061
  # permissions to call `ListDelegatedAdministrators` API. Ensure that
5610
6062
  # the management account registers delagated administrator for Config
5611
- # service principle name before the delegated administrator creates an
6063
+ # service principal name before the delegated administrator creates an
5612
6064
  # aggregator.
5613
6065
  #
5614
6066
  # For all `OrganizationConfigRule` and `OrganizationConformancePack`
@@ -6492,13 +6944,19 @@ module Aws::ConfigService
6492
6944
  # An array of tag object.
6493
6945
  # @return [Array<Types::Tag>]
6494
6946
  #
6947
+ # @!attribute [rw] aggregator_filters
6948
+ # An object to filter configuration recorders in an aggregator. Either
6949
+ # `ResourceType` or `ServicePrincipal` is required.
6950
+ # @return [Types::AggregatorFilters]
6951
+ #
6495
6952
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/PutConfigurationAggregatorRequest AWS API Documentation
6496
6953
  #
6497
6954
  class PutConfigurationAggregatorRequest < Struct.new(
6498
6955
  :configuration_aggregator_name,
6499
6956
  :account_aggregation_sources,
6500
6957
  :organization_aggregation_source,
6501
- :tags)
6958
+ :tags,
6959
+ :aggregator_filters)
6502
6960
  SENSITIVE = []
6503
6961
  include Aws::Structure
6504
6962
  end
@@ -6518,14 +6976,20 @@ module Aws::ConfigService
6518
6976
  # The input for the PutConfigurationRecorder action.
6519
6977
  #
6520
6978
  # @!attribute [rw] configuration_recorder
6521
- # An object for the configuration recorder to record configuration
6522
- # changes for specified resource types.
6979
+ # An object for the configuration recorder. A configuration recorder
6980
+ # records configuration changes for the resource types in scope.
6523
6981
  # @return [Types::ConfigurationRecorder]
6524
6982
  #
6983
+ # @!attribute [rw] tags
6984
+ # The tags for the customer managed configuration recorder. Each tag
6985
+ # consists of a key and an optional value, both of which you define.
6986
+ # @return [Array<Types::Tag>]
6987
+ #
6525
6988
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/PutConfigurationRecorderRequest AWS API Documentation
6526
6989
  #
6527
6990
  class PutConfigurationRecorderRequest < Struct.new(
6528
- :configuration_recorder)
6991
+ :configuration_recorder,
6992
+ :tags)
6529
6993
  SENSITIVE = []
6530
6994
  include Aws::Structure
6531
6995
  end
@@ -6620,9 +7084,8 @@ module Aws::ConfigService
6620
7084
  # The input for the PutDeliveryChannel action.
6621
7085
  #
6622
7086
  # @!attribute [rw] delivery_channel
6623
- # The configuration delivery channel object that delivers the
6624
- # configuration information to an Amazon S3 bucket and to an Amazon
6625
- # SNS topic.
7087
+ # An object for the delivery channel. A delivery channel sends
7088
+ # notifications and updated configuration states.
6626
7089
  # @return [Types::DeliveryChannel]
6627
7090
  #
6628
7091
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/PutDeliveryChannelRequest AWS API Documentation
@@ -6993,6 +7456,47 @@ module Aws::ConfigService
6993
7456
  include Aws::Structure
6994
7457
  end
6995
7458
 
7459
+ # @!attribute [rw] service_principal
7460
+ # The service principal of the Amazon Web Services service for the
7461
+ # service-linked configuration recorder that you want to create.
7462
+ # @return [String]
7463
+ #
7464
+ # @!attribute [rw] tags
7465
+ # The tags for a service-linked configuration recorder. Each tag
7466
+ # consists of a key and an optional value, both of which you define.
7467
+ # @return [Array<Types::Tag>]
7468
+ #
7469
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/PutServiceLinkedConfigurationRecorderRequest AWS API Documentation
7470
+ #
7471
+ class PutServiceLinkedConfigurationRecorderRequest < Struct.new(
7472
+ :service_principal,
7473
+ :tags)
7474
+ SENSITIVE = []
7475
+ include Aws::Structure
7476
+ end
7477
+
7478
+ # @!attribute [rw] arn
7479
+ # The Amazon Resource Name (ARN) of the specified configuration
7480
+ # recorder.
7481
+ # @return [String]
7482
+ #
7483
+ # @!attribute [rw] name
7484
+ # The name of the specified configuration recorder.
7485
+ #
7486
+ # For service-linked configuration recorders, Config automatically
7487
+ # assigns a name that has the prefix "`AWS`" to the new
7488
+ # service-linked configuration recorder.
7489
+ # @return [String]
7490
+ #
7491
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/PutServiceLinkedConfigurationRecorderResponse AWS API Documentation
7492
+ #
7493
+ class PutServiceLinkedConfigurationRecorderResponse < Struct.new(
7494
+ :arn,
7495
+ :name)
7496
+ SENSITIVE = []
7497
+ include Aws::Structure
7498
+ end
7499
+
6996
7500
  # @!attribute [rw] stored_query
6997
7501
  # A list of `StoredQuery` objects. The mandatory fields are
6998
7502
  # `QueryName` and `Expression`.
@@ -7119,22 +7623,9 @@ module Aws::ConfigService
7119
7623
  # policies. These global IAM resource types can only be recorded by
7120
7624
  # Config in Regions where Config was available before February 2022.
7121
7625
  # You cannot be record the global IAM resouce types in Regions
7122
- # supported by Config after February 2022. This list where you cannot
7123
- # record the global IAM resource types includes the following Regions:
7124
- #
7125
- # * Asia Pacific (Hyderabad)
7126
- #
7127
- # * Asia Pacific (Melbourne)
7128
- #
7129
- # * Canada West (Calgary)
7130
- #
7131
- # * Europe (Spain)
7132
- #
7133
- # * Europe (Zurich)
7134
- #
7135
- # * Israel (Tel Aviv)
7136
- #
7137
- # * Middle East (UAE)
7626
+ # supported by Config after February 2022. For a list of those
7627
+ # Regions, see [Recording Amazon Web Services Resources \| Global
7628
+ # Resources][1].
7138
7629
  #
7139
7630
  # **Aurora global clusters are recorded in all enabled Regions**
7140
7631
  #
@@ -7338,22 +7829,9 @@ module Aws::ConfigService
7338
7829
  # recorded in the Region where you set up the configuration recorder
7339
7830
  # if that is a Region where Config was available before February 2022.
7340
7831
  # You cannot be record the global IAM resouce types in Regions
7341
- # supported by Config after February 2022. This list where you cannot
7342
- # record the global IAM resource types includes the following Regions:
7343
- #
7344
- # * Asia Pacific (Hyderabad)
7345
- #
7346
- # * Asia Pacific (Melbourne)
7347
- #
7348
- # * Canada West (Calgary)
7349
- #
7350
- # * Europe (Spain)
7351
- #
7352
- # * Europe (Zurich)
7353
- #
7354
- # * Israel (Tel Aviv)
7355
- #
7356
- # * Middle East (UAE)
7832
+ # supported by Config after February 2022. For a list of those
7833
+ # Regions, see [Recording Amazon Web Services Resources \| Global
7834
+ # Resources][4].
7357
7835
  #
7358
7836
  # </note>
7359
7837
  #
@@ -7362,6 +7840,7 @@ module Aws::ConfigService
7362
7840
  # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_RecordingStrategy.html
7363
7841
  # [2]: https://docs.aws.amazon.com/config/latest/APIReference/API_RecordingGroup.html
7364
7842
  # [3]: https://docs.aws.amazon.com/config/latest/APIReference/API_ExclusionByResourceTypes.html
7843
+ # [4]: https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html#select-resources-all
7365
7844
  # @return [Types::RecordingStrategy]
7366
7845
  #
7367
7846
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/RecordingGroup AWS API Documentation
@@ -7401,7 +7880,8 @@ module Aws::ConfigService
7401
7880
  # The default recording frequency that Config uses to record
7402
7881
  # configuration changes.
7403
7882
  #
7404
- # Daily recording is not supported for the following resource types:
7883
+ # Daily recording cannot be specified for the following resource
7884
+ # types:
7405
7885
  #
7406
7886
  # * `AWS::Config::ResourceCompliance`
7407
7887
  #
@@ -7440,7 +7920,8 @@ module Aws::ConfigService
7440
7920
  # A comma-separated list that specifies which resource types Config
7441
7921
  # includes in the override.
7442
7922
  #
7443
- # Daily recording is not supported for the following resource types:
7923
+ # Daily recording cannot be specified for the following resource
7924
+ # types:
7444
7925
  #
7445
7926
  # * `AWS::Config::ResourceCompliance`
7446
7927
  #
@@ -8505,11 +8986,11 @@ module Aws::ConfigService
8505
8986
  #
8506
8987
  class StartConfigRulesEvaluationResponse < Aws::EmptyStructure; end
8507
8988
 
8508
- # The input for the StartConfigurationRecorder action.
8989
+ # The input for the StartConfigurationRecorder operation.
8509
8990
  #
8510
8991
  # @!attribute [rw] configuration_recorder_name
8511
- # The name of the recorder object that records each configuration
8512
- # change made to the resources.
8992
+ # The name of the customer managed configuration recorder that you
8993
+ # want to start.
8513
8994
  # @return [String]
8514
8995
  #
8515
8996
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/StartConfigurationRecorderRequest AWS API Documentation
@@ -8690,11 +9171,11 @@ module Aws::ConfigService
8690
9171
  include Aws::Structure
8691
9172
  end
8692
9173
 
8693
- # The input for the StopConfigurationRecorder action.
9174
+ # The input for the StopConfigurationRecorder operation.
8694
9175
  #
8695
9176
  # @!attribute [rw] configuration_recorder_name
8696
- # The name of the recorder object that records each configuration
8697
- # change made to the resources.
9177
+ # The name of the customer managed configuration recorder that you
9178
+ # want to stop.
8698
9179
  # @return [String]
8699
9180
  #
8700
9181
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/StopConfigurationRecorderRequest AWS API Documentation
@@ -8802,9 +9283,23 @@ module Aws::ConfigService
8802
9283
 
8803
9284
  # @!attribute [rw] resource_arn
8804
9285
  # The Amazon Resource Name (ARN) that identifies the resource for
8805
- # which to list the tags. Currently, the supported resources are
8806
- # `ConfigRule`, `ConfigurationAggregator` and
8807
- # `AggregatorAuthorization`.
9286
+ # which to list the tags. The following resources are supported:
9287
+ #
9288
+ # * `ConfigurationRecorder`
9289
+ #
9290
+ # * `ConfigRule`
9291
+ #
9292
+ # * `OrganizationConfigRule`
9293
+ #
9294
+ # * `ConformancePack`
9295
+ #
9296
+ # * `OrganizationConformancePack`
9297
+ #
9298
+ # * `ConfigurationAggregator`
9299
+ #
9300
+ # * `AggregationAuthorization`
9301
+ #
9302
+ # * `StoredQuery`
8808
9303
  # @return [String]
8809
9304
  #
8810
9305
  # @!attribute [rw] tags
@@ -8891,11 +9386,59 @@ module Aws::ConfigService
8891
9386
  #
8892
9387
  class TooManyTagsException < Aws::EmptyStructure; end
8893
9388
 
9389
+ # The requested operation is not valid.
9390
+ #
9391
+ # For [PutConfigurationRecorder][1], you will see this exception because
9392
+ # you cannot use this operation to create a service-linked configuration
9393
+ # recorder. Use the [PutServiceLinkedConfigurationRecorder][2] operation
9394
+ # to create a service-linked configuration recorder.
9395
+ #
9396
+ # For [DeleteConfigurationRecorder][3], you will see this exception
9397
+ # because you cannot use this operation to delete a service-linked
9398
+ # configuration recorder. Use the
9399
+ # [DeleteServiceLinkedConfigurationRecorder][4] operation to delete a
9400
+ # service-linked configuration recorder.
9401
+ #
9402
+ # For [StartConfigurationRecorder][5] and
9403
+ # [StopConfigurationRecorder][6], you will see this exception because
9404
+ # these operations do not affect service-linked configuration recorders.
9405
+ # Service-linked configuration recorders are always recording. To stop
9406
+ # recording, you must delete the service-linked configuration recorder.
9407
+ # Use the [DeleteServiceLinkedConfigurationRecorder][4] operation to
9408
+ # delete a service-linked configuration recorder.
9409
+ #
9410
+ #
9411
+ #
9412
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutConfigurationRecorder.html
9413
+ # [2]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutServiceLinkedConfigurationRecorder.html
9414
+ # [3]: https://docs.aws.amazon.com/config/latest/APIReference/API_DeleteConfigurationRecorder.html
9415
+ # [4]: https://docs.aws.amazon.com/config/latest/APIReference/API_DeleteServiceLinkedConfigurationRecorder.html
9416
+ # [5]: https://docs.aws.amazon.com/config/latest/APIReference/API_StartConfigurationRecorder.html
9417
+ # [6]: https://docs.aws.amazon.com/config/latest/APIReference/API_StopConfigurationRecorder.html
9418
+ #
9419
+ # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/UnmodifiableEntityException AWS API Documentation
9420
+ #
9421
+ class UnmodifiableEntityException < Aws::EmptyStructure; end
9422
+
8894
9423
  # @!attribute [rw] resource_arn
8895
9424
  # The Amazon Resource Name (ARN) that identifies the resource for
8896
- # which to list the tags. Currently, the supported resources are
8897
- # `ConfigRule`, `ConfigurationAggregator` and
8898
- # `AggregatorAuthorization`.
9425
+ # which to list the tags. The following resources are supported:
9426
+ #
9427
+ # * `ConfigurationRecorder`
9428
+ #
9429
+ # * `ConfigRule`
9430
+ #
9431
+ # * `OrganizationConfigRule`
9432
+ #
9433
+ # * `ConformancePack`
9434
+ #
9435
+ # * `OrganizationConformancePack`
9436
+ #
9437
+ # * `ConfigurationAggregator`
9438
+ #
9439
+ # * `AggregationAuthorization`
9440
+ #
9441
+ # * `StoredQuery`
8899
9442
  # @return [String]
8900
9443
  #
8901
9444
  # @!attribute [rw] tag_keys
@@ -8911,15 +9454,46 @@ module Aws::ConfigService
8911
9454
  include Aws::Structure
8912
9455
  end
8913
9456
 
8914
- # The requested action is not valid.
9457
+ # The requested operation is not valid. You will see this exception if
9458
+ # there are missing required fields or if the input value fails the
9459
+ # validation.
9460
+ #
9461
+ # For [PutStoredQuery][1], one of the following errors:
9462
+ #
9463
+ # * There are missing required fields.
9464
+ #
9465
+ # * The input value fails the validation.
9466
+ #
9467
+ # * You are trying to create more than 300 queries.
9468
+ #
9469
+ # For [DescribeConfigurationRecorders][2] and
9470
+ # [DescribeConfigurationRecorderStatus][3], one of the following errors:
9471
+ #
9472
+ # * You have specified more than one configuration recorder.
9473
+ #
9474
+ # * You have provided a service principal for service-linked
9475
+ # configuration recorder that is not valid.
9476
+ #
9477
+ # For [AssociateResourceTypes][4] and [DisassociateResourceTypes][5],
9478
+ # one of the following errors:
9479
+ #
9480
+ # * Your configuraiton recorder has a recording strategy that does not
9481
+ # allow the association or disassociation of resource types.
9482
+ #
9483
+ # * One or more of the specified resource types are already associated
9484
+ # or disassociated with the configuration recorder.
9485
+ #
9486
+ # * For service-linked configuration recorders, the configuration
9487
+ # recorder does not record one or more of the specified resource
9488
+ # types.
9489
+ #
8915
9490
  #
8916
- # For PutStoredQuery, you will see this exception if there are missing
8917
- # required fields or if the input value fails the validation, or if you
8918
- # are trying to create more than 300 queries.
8919
9491
  #
8920
- # For GetStoredQuery, ListStoredQuery, and DeleteStoredQuery you will
8921
- # see this exception if there are missing required fields or if the
8922
- # input value fails the validation.
9492
+ # [1]: https://docs.aws.amazon.com/config/latest/APIReference/API_PutStoredQuery.html
9493
+ # [2]: https://docs.aws.amazon.com/config/latest/APIReference/API_DescribeConfigurationRecorders.html
9494
+ # [3]: https://docs.aws.amazon.com/config/latest/APIReference/API_DescribeConfigurationRecorderStatus.html
9495
+ # [4]: https://docs.aws.amazon.com/config/latest/APIReference/API_AssociateResourceTypes.html
9496
+ # [5]: https://docs.aws.amazon.com/config/latest/APIReference/API_DisassociateResourceTypes.html
8923
9497
  #
8924
9498
  # @see http://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ValidationException AWS API Documentation
8925
9499
  #