aws-sdk-timestreaminfluxdb 1.30.0 → 1.32.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.
@@ -92,7 +92,7 @@ module Aws::TimestreamInfluxDB
92
92
  #
93
93
  # Valid Values: 1024-65535
94
94
  #
95
- # Default: 8086
95
+ # Default: 8086 for InfluxDB v2, 8181 for InfluxDB v3
96
96
  #
97
97
  # Constraints: The value can't be 2375-2376, 7788-7799, 8090, or
98
98
  # 51678-51680
@@ -228,7 +228,7 @@ module Aws::TimestreamInfluxDB
228
228
  # @return [String]
229
229
  #
230
230
  # @!attribute [rw] password
231
- # The password of the initial admin user created in InfluxDB. This
231
+ # The password of the initial admin user created in InfluxDB v2. This
232
232
  # password will allow you to access the InfluxDB UI to perform various
233
233
  # administrative tasks and also use the InfluxDB CLI to create an
234
234
  # operator token. These attributes will be stored in a Secret created
@@ -445,6 +445,10 @@ module Aws::TimestreamInfluxDB
445
445
  # Specifies the DbInstance's role in the cluster.
446
446
  # @return [String]
447
447
  #
448
+ # @!attribute [rw] instance_modes
449
+ # Specifies the DbInstance's roles in the cluster.
450
+ # @return [Array<String>]
451
+ #
448
452
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/CreateDbInstanceOutput AWS API Documentation
449
453
  #
450
454
  class CreateDbInstanceOutput < Struct.new(
@@ -468,7 +472,8 @@ module Aws::TimestreamInfluxDB
468
472
  :log_delivery_configuration,
469
473
  :influx_auth_parameters_secret_arn,
470
474
  :db_cluster_id,
471
- :instance_mode)
475
+ :instance_mode,
476
+ :instance_modes)
472
477
  SENSITIVE = []
473
478
  include Aws::Structure
474
479
  end
@@ -591,6 +596,10 @@ module Aws::TimestreamInfluxDB
591
596
  # gibibytes).
592
597
  # @return [Integer]
593
598
  #
599
+ # @!attribute [rw] engine_type
600
+ # The engine type of your DB cluster.
601
+ # @return [String]
602
+ #
594
603
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/DbClusterSummary AWS API Documentation
595
604
  #
596
605
  class DbClusterSummary < Struct.new(
@@ -605,7 +614,8 @@ module Aws::TimestreamInfluxDB
605
614
  :db_instance_type,
606
615
  :network_type,
607
616
  :db_storage_type,
608
- :allocated_storage)
617
+ :allocated_storage,
618
+ :engine_type)
609
619
  SENSITIVE = []
610
620
  include Aws::Structure
611
621
  end
@@ -665,6 +675,10 @@ module Aws::TimestreamInfluxDB
665
675
  # Specifies the DB instance's role in the cluster.
666
676
  # @return [String]
667
677
  #
678
+ # @!attribute [rw] instance_modes
679
+ # Specifies the DB instance's roles in the cluster.
680
+ # @return [Array<String>]
681
+ #
668
682
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/DbInstanceForClusterSummary AWS API Documentation
669
683
  #
670
684
  class DbInstanceForClusterSummary < Struct.new(
@@ -679,7 +693,8 @@ module Aws::TimestreamInfluxDB
679
693
  :db_storage_type,
680
694
  :allocated_storage,
681
695
  :deployment_type,
682
- :instance_mode)
696
+ :instance_mode,
697
+ :instance_modes)
683
698
  SENSITIVE = []
684
699
  include Aws::Structure
685
700
  end
@@ -916,6 +931,10 @@ module Aws::TimestreamInfluxDB
916
931
  # Specifies the DbInstance's role in the cluster.
917
932
  # @return [String]
918
933
  #
934
+ # @!attribute [rw] instance_modes
935
+ # Specifies the DbInstance's roles in the cluster.
936
+ # @return [Array<String>]
937
+ #
919
938
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/DeleteDbInstanceOutput AWS API Documentation
920
939
  #
921
940
  class DeleteDbInstanceOutput < Struct.new(
@@ -939,7 +958,8 @@ module Aws::TimestreamInfluxDB
939
958
  :log_delivery_configuration,
940
959
  :influx_auth_parameters_secret_arn,
941
960
  :db_cluster_id,
942
- :instance_mode)
961
+ :instance_mode,
962
+ :instance_modes)
943
963
  SENSITIVE = []
944
964
  include Aws::Structure
945
965
  end
@@ -1029,6 +1049,10 @@ module Aws::TimestreamInfluxDB
1029
1049
  # gibibytes).
1030
1050
  # @return [Integer]
1031
1051
  #
1052
+ # @!attribute [rw] engine_type
1053
+ # The engine type of your DB cluster.
1054
+ # @return [String]
1055
+ #
1032
1056
  # @!attribute [rw] publicly_accessible
1033
1057
  # Indicates if the DB cluster has a public IP to facilitate access
1034
1058
  # from outside the VPC.
@@ -1077,6 +1101,7 @@ module Aws::TimestreamInfluxDB
1077
1101
  :network_type,
1078
1102
  :db_storage_type,
1079
1103
  :allocated_storage,
1104
+ :engine_type,
1080
1105
  :publicly_accessible,
1081
1106
  :db_parameter_group_identifier,
1082
1107
  :log_delivery_configuration,
@@ -1197,6 +1222,10 @@ module Aws::TimestreamInfluxDB
1197
1222
  # Specifies the DbInstance's role in the cluster.
1198
1223
  # @return [String]
1199
1224
  #
1225
+ # @!attribute [rw] instance_modes
1226
+ # Specifies the DbInstance's roles in the cluster.
1227
+ # @return [Array<String>]
1228
+ #
1200
1229
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/GetDbInstanceOutput AWS API Documentation
1201
1230
  #
1202
1231
  class GetDbInstanceOutput < Struct.new(
@@ -1220,7 +1249,8 @@ module Aws::TimestreamInfluxDB
1220
1249
  :log_delivery_configuration,
1221
1250
  :influx_auth_parameters_secret_arn,
1222
1251
  :db_cluster_id,
1223
- :instance_mode)
1252
+ :instance_mode,
1253
+ :instance_modes)
1224
1254
  SENSITIVE = []
1225
1255
  include Aws::Structure
1226
1256
  end
@@ -1582,6 +1612,701 @@ module Aws::TimestreamInfluxDB
1582
1612
  include Aws::Structure
1583
1613
  end
1584
1614
 
1615
+ # All the customer-modifiable InfluxDB v3 Core parameters in Timestream
1616
+ # for InfluxDB.
1617
+ #
1618
+ # @!attribute [rw] query_file_limit
1619
+ # Limits the number of Parquet files a query can access. If a query
1620
+ # attempts to read more than this limit, InfluxDB 3 returns an error.
1621
+ #
1622
+ # Default: 432
1623
+ # @return [Integer]
1624
+ #
1625
+ # @!attribute [rw] query_log_size
1626
+ # Defines the size of the query log. Up to this many queries remain in
1627
+ # the log before older queries are evicted to make room for new ones.
1628
+ #
1629
+ # Default: 1000
1630
+ # @return [Integer]
1631
+ #
1632
+ # @!attribute [rw] log_filter
1633
+ # Sets the filter directive for logs.
1634
+ # @return [String]
1635
+ #
1636
+ # @!attribute [rw] log_format
1637
+ # Defines the message format for logs.
1638
+ #
1639
+ # Default: full
1640
+ # @return [String]
1641
+ #
1642
+ # @!attribute [rw] data_fusion_num_threads
1643
+ # Sets the maximum number of DataFusion runtime threads to use.
1644
+ # @return [Integer]
1645
+ #
1646
+ # @!attribute [rw] data_fusion_runtime_type
1647
+ # Specifies the DataFusion tokio runtime type.
1648
+ #
1649
+ # Default: multi-thread
1650
+ # @return [String]
1651
+ #
1652
+ # @!attribute [rw] data_fusion_runtime_disable_lifo_slot
1653
+ # Disables the LIFO slot of the DataFusion runtime.
1654
+ # @return [Boolean]
1655
+ #
1656
+ # @!attribute [rw] data_fusion_runtime_event_interval
1657
+ # Sets the number of scheduler ticks after which the scheduler of the
1658
+ # DataFusion tokio runtime polls for external events–for example:
1659
+ # timers, I/O.
1660
+ # @return [Integer]
1661
+ #
1662
+ # @!attribute [rw] data_fusion_runtime_global_queue_interval
1663
+ # Sets the number of scheduler ticks after which the scheduler of the
1664
+ # DataFusion runtime polls the global task queue.
1665
+ # @return [Integer]
1666
+ #
1667
+ # @!attribute [rw] data_fusion_runtime_max_blocking_threads
1668
+ # Specifies the limit for additional threads spawned by the DataFusion
1669
+ # runtime.
1670
+ # @return [Integer]
1671
+ #
1672
+ # @!attribute [rw] data_fusion_runtime_max_io_events_per_tick
1673
+ # Configures the maximum number of events processed per tick by the
1674
+ # tokio DataFusion runtime.
1675
+ # @return [Integer]
1676
+ #
1677
+ # @!attribute [rw] data_fusion_runtime_thread_keep_alive
1678
+ # Sets a custom timeout for a thread in the blocking pool of the tokio
1679
+ # DataFusion runtime.
1680
+ # @return [Types::Duration]
1681
+ #
1682
+ # @!attribute [rw] data_fusion_runtime_thread_priority
1683
+ # Sets the thread priority for tokio DataFusion runtime workers.
1684
+ #
1685
+ # Default: 10
1686
+ # @return [Integer]
1687
+ #
1688
+ # @!attribute [rw] data_fusion_max_parquet_fanout
1689
+ # When multiple parquet files are required in a sorted way
1690
+ # (deduplication for example), specifies the maximum fanout.
1691
+ #
1692
+ # Default: 1000
1693
+ # @return [Integer]
1694
+ #
1695
+ # @!attribute [rw] data_fusion_use_cached_parquet_loader
1696
+ # Uses a cached parquet loader when reading parquet files from the
1697
+ # object store.
1698
+ # @return [Boolean]
1699
+ #
1700
+ # @!attribute [rw] data_fusion_config
1701
+ # Provides custom configuration to DataFusion as a comma-separated
1702
+ # list of key:value pairs.
1703
+ # @return [String]
1704
+ #
1705
+ # @!attribute [rw] max_http_request_size
1706
+ # Specifies the maximum size of HTTP requests.
1707
+ #
1708
+ # Default: 10485760
1709
+ # @return [Integer]
1710
+ #
1711
+ # @!attribute [rw] force_snapshot_mem_threshold
1712
+ # Specifies the threshold for the internal memory buffer. Supports
1713
+ # either a percentage (portion of available memory) or absolute value
1714
+ # in MB–for example: 70% or 100
1715
+ #
1716
+ # Default: 70%
1717
+ # @return [Types::PercentOrAbsoluteLong]
1718
+ #
1719
+ # @!attribute [rw] wal_snapshot_size
1720
+ # Defines the number of WAL files to attempt to remove in a snapshot.
1721
+ # This, multiplied by the interval, determines how often snapshots are
1722
+ # taken.
1723
+ #
1724
+ # Default: 600
1725
+ # @return [Integer]
1726
+ #
1727
+ # @!attribute [rw] wal_max_write_buffer_size
1728
+ # Specifies the maximum number of write requests that can be buffered
1729
+ # before a flush must be executed and succeed.
1730
+ #
1731
+ # Default: 100000
1732
+ # @return [Integer]
1733
+ #
1734
+ # @!attribute [rw] snapshotted_wal_files_to_keep
1735
+ # Specifies the number of snapshotted WAL files to retain in the
1736
+ # object store. Flushing the WAL files does not clear the WAL files
1737
+ # immediately; they are deleted when the number of snapshotted WAL
1738
+ # files exceeds this number.
1739
+ #
1740
+ # Default: 300
1741
+ # @return [Integer]
1742
+ #
1743
+ # @!attribute [rw] preemptive_cache_age
1744
+ # Specifies the interval to prefetch into the Parquet cache during
1745
+ # compaction.
1746
+ #
1747
+ # Default: 3d
1748
+ # @return [Types::Duration]
1749
+ #
1750
+ # @!attribute [rw] parquet_mem_cache_prune_percentage
1751
+ # Specifies the percentage of entries to prune during a prune
1752
+ # operation on the in-memory Parquet cache.
1753
+ #
1754
+ # Default: 0.1
1755
+ # @return [Float]
1756
+ #
1757
+ # @!attribute [rw] parquet_mem_cache_prune_interval
1758
+ # Sets the interval to check if the in-memory Parquet cache needs to
1759
+ # be pruned.
1760
+ #
1761
+ # Default: 1s
1762
+ # @return [Types::Duration]
1763
+ #
1764
+ # @!attribute [rw] disable_parquet_mem_cache
1765
+ # Disables the in-memory Parquet cache. By default, the cache is
1766
+ # enabled.
1767
+ # @return [Boolean]
1768
+ #
1769
+ # @!attribute [rw] parquet_mem_cache_query_path_duration
1770
+ # Specifies the time window for caching recent Parquet files in
1771
+ # memory.
1772
+ #
1773
+ # Default: 5h
1774
+ # @return [Types::Duration]
1775
+ #
1776
+ # @!attribute [rw] last_cache_eviction_interval
1777
+ # Specifies the interval to evict expired entries from the
1778
+ # Last-N-Value cache, expressed as a human-readable duration–for
1779
+ # example: 20s, 1m, 1h.
1780
+ #
1781
+ # Default: 10s
1782
+ # @return [Types::Duration]
1783
+ #
1784
+ # @!attribute [rw] distinct_cache_eviction_interval
1785
+ # Specifies the interval to evict expired entries from the distinct
1786
+ # value cache, expressed as a human-readable duration–for example:
1787
+ # 20s, 1m, 1h.
1788
+ #
1789
+ # Default: 10s
1790
+ # @return [Types::Duration]
1791
+ #
1792
+ # @!attribute [rw] gen1_duration
1793
+ # Specifies the duration that Parquet files are arranged into. Data
1794
+ # timestamps land each row into a file of this duration. Supported
1795
+ # durations are 1m, 5m, and 10m. These files are known as “generation
1796
+ # 1” files that the compactor in InfluxDB 3 Enterprise can merge into
1797
+ # larger generations.
1798
+ #
1799
+ # Default: 10m
1800
+ # @return [Types::Duration]
1801
+ #
1802
+ # @!attribute [rw] exec_mem_pool_bytes
1803
+ # Specifies the size of memory pool used during query execution. Can
1804
+ # be given as absolute value in bytes or as a percentage of the total
1805
+ # available memory–for example: 8000000000 or 10%.
1806
+ #
1807
+ # Default: 20%
1808
+ # @return [Types::PercentOrAbsoluteLong]
1809
+ #
1810
+ # @!attribute [rw] parquet_mem_cache_size
1811
+ # Specifies the size of the in-memory Parquet cache in megabytes or
1812
+ # percentage of total available memory.
1813
+ #
1814
+ # Default: 20%
1815
+ # @return [Types::PercentOrAbsoluteLong]
1816
+ #
1817
+ # @!attribute [rw] wal_replay_fail_on_error
1818
+ # Determines whether WAL replay should fail when encountering errors.
1819
+ #
1820
+ # Default: false
1821
+ # @return [Boolean]
1822
+ #
1823
+ # @!attribute [rw] wal_replay_concurrency_limit
1824
+ # Concurrency limit during WAL replay. Setting this number too high
1825
+ # can lead to OOM. The default is dynamically determined.
1826
+ #
1827
+ # Default: max(num\_cpus, 10)
1828
+ # @return [Integer]
1829
+ #
1830
+ # @!attribute [rw] table_index_cache_max_entries
1831
+ # Specifies the maximum number of entries in the table index cache.
1832
+ #
1833
+ # Default: 1000
1834
+ # @return [Integer]
1835
+ #
1836
+ # @!attribute [rw] table_index_cache_concurrency_limit
1837
+ # Limits the concurrency level for table index cache operations.
1838
+ #
1839
+ # Default: 8
1840
+ # @return [Integer]
1841
+ #
1842
+ # @!attribute [rw] gen1_lookback_duration
1843
+ # Specifies how far back to look when creating generation 1 Parquet
1844
+ # files.
1845
+ #
1846
+ # Default: 24h
1847
+ # @return [Types::Duration]
1848
+ #
1849
+ # @!attribute [rw] retention_check_interval
1850
+ # The interval at which retention policies are checked and enforced.
1851
+ # Enter as a human-readable time–for example: 30m or 1h.
1852
+ #
1853
+ # Default: 30m
1854
+ # @return [Types::Duration]
1855
+ #
1856
+ # @!attribute [rw] delete_grace_period
1857
+ # Specifies the grace period before permanently deleting data.
1858
+ #
1859
+ # Default: 24h
1860
+ # @return [Types::Duration]
1861
+ #
1862
+ # @!attribute [rw] hard_delete_default_duration
1863
+ # Sets the default duration for hard deletion of data.
1864
+ #
1865
+ # Default: 90d
1866
+ # @return [Types::Duration]
1867
+ #
1868
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/InfluxDBv3CoreParameters AWS API Documentation
1869
+ #
1870
+ class InfluxDBv3CoreParameters < Struct.new(
1871
+ :query_file_limit,
1872
+ :query_log_size,
1873
+ :log_filter,
1874
+ :log_format,
1875
+ :data_fusion_num_threads,
1876
+ :data_fusion_runtime_type,
1877
+ :data_fusion_runtime_disable_lifo_slot,
1878
+ :data_fusion_runtime_event_interval,
1879
+ :data_fusion_runtime_global_queue_interval,
1880
+ :data_fusion_runtime_max_blocking_threads,
1881
+ :data_fusion_runtime_max_io_events_per_tick,
1882
+ :data_fusion_runtime_thread_keep_alive,
1883
+ :data_fusion_runtime_thread_priority,
1884
+ :data_fusion_max_parquet_fanout,
1885
+ :data_fusion_use_cached_parquet_loader,
1886
+ :data_fusion_config,
1887
+ :max_http_request_size,
1888
+ :force_snapshot_mem_threshold,
1889
+ :wal_snapshot_size,
1890
+ :wal_max_write_buffer_size,
1891
+ :snapshotted_wal_files_to_keep,
1892
+ :preemptive_cache_age,
1893
+ :parquet_mem_cache_prune_percentage,
1894
+ :parquet_mem_cache_prune_interval,
1895
+ :disable_parquet_mem_cache,
1896
+ :parquet_mem_cache_query_path_duration,
1897
+ :last_cache_eviction_interval,
1898
+ :distinct_cache_eviction_interval,
1899
+ :gen1_duration,
1900
+ :exec_mem_pool_bytes,
1901
+ :parquet_mem_cache_size,
1902
+ :wal_replay_fail_on_error,
1903
+ :wal_replay_concurrency_limit,
1904
+ :table_index_cache_max_entries,
1905
+ :table_index_cache_concurrency_limit,
1906
+ :gen1_lookback_duration,
1907
+ :retention_check_interval,
1908
+ :delete_grace_period,
1909
+ :hard_delete_default_duration)
1910
+ SENSITIVE = []
1911
+ include Aws::Structure
1912
+ end
1913
+
1914
+ # All the customer-modifiable InfluxDB v3 Enterprise parameters in
1915
+ # Timestream for InfluxDB.
1916
+ #
1917
+ # @!attribute [rw] query_file_limit
1918
+ # Limits the number of Parquet files a query can access. If a query
1919
+ # attempts to read more than this limit, InfluxDB 3 returns an error.
1920
+ #
1921
+ # Default: 432
1922
+ # @return [Integer]
1923
+ #
1924
+ # @!attribute [rw] query_log_size
1925
+ # Defines the size of the query log. Up to this many queries remain in
1926
+ # the log before older queries are evicted to make room for new ones.
1927
+ #
1928
+ # Default: 1000
1929
+ # @return [Integer]
1930
+ #
1931
+ # @!attribute [rw] log_filter
1932
+ # Sets the filter directive for logs.
1933
+ # @return [String]
1934
+ #
1935
+ # @!attribute [rw] log_format
1936
+ # Defines the message format for logs.
1937
+ #
1938
+ # Default: full
1939
+ # @return [String]
1940
+ #
1941
+ # @!attribute [rw] data_fusion_num_threads
1942
+ # Sets the maximum number of DataFusion runtime threads to use.
1943
+ # @return [Integer]
1944
+ #
1945
+ # @!attribute [rw] data_fusion_runtime_type
1946
+ # Specifies the DataFusion tokio runtime type.
1947
+ #
1948
+ # Default: multi-thread
1949
+ # @return [String]
1950
+ #
1951
+ # @!attribute [rw] data_fusion_runtime_disable_lifo_slot
1952
+ # Disables the LIFO slot of the DataFusion runtime.
1953
+ # @return [Boolean]
1954
+ #
1955
+ # @!attribute [rw] data_fusion_runtime_event_interval
1956
+ # Sets the number of scheduler ticks after which the scheduler of the
1957
+ # DataFusion tokio runtime polls for external events–for example:
1958
+ # timers, I/O.
1959
+ # @return [Integer]
1960
+ #
1961
+ # @!attribute [rw] data_fusion_runtime_global_queue_interval
1962
+ # Sets the number of scheduler ticks after which the scheduler of the
1963
+ # DataFusion runtime polls the global task queue.
1964
+ # @return [Integer]
1965
+ #
1966
+ # @!attribute [rw] data_fusion_runtime_max_blocking_threads
1967
+ # Specifies the limit for additional threads spawned by the DataFusion
1968
+ # runtime.
1969
+ # @return [Integer]
1970
+ #
1971
+ # @!attribute [rw] data_fusion_runtime_max_io_events_per_tick
1972
+ # Configures the maximum number of events processed per tick by the
1973
+ # tokio DataFusion runtime.
1974
+ # @return [Integer]
1975
+ #
1976
+ # @!attribute [rw] data_fusion_runtime_thread_keep_alive
1977
+ # Sets a custom timeout for a thread in the blocking pool of the tokio
1978
+ # DataFusion runtime.
1979
+ # @return [Types::Duration]
1980
+ #
1981
+ # @!attribute [rw] data_fusion_runtime_thread_priority
1982
+ # Sets the thread priority for tokio DataFusion runtime workers.
1983
+ #
1984
+ # Default: 10
1985
+ # @return [Integer]
1986
+ #
1987
+ # @!attribute [rw] data_fusion_max_parquet_fanout
1988
+ # When multiple parquet files are required in a sorted way
1989
+ # (deduplication for example), specifies the maximum fanout.
1990
+ #
1991
+ # Default: 1000
1992
+ # @return [Integer]
1993
+ #
1994
+ # @!attribute [rw] data_fusion_use_cached_parquet_loader
1995
+ # Uses a cached parquet loader when reading parquet files from the
1996
+ # object store.
1997
+ # @return [Boolean]
1998
+ #
1999
+ # @!attribute [rw] data_fusion_config
2000
+ # Provides custom configuration to DataFusion as a comma-separated
2001
+ # list of key:value pairs.
2002
+ # @return [String]
2003
+ #
2004
+ # @!attribute [rw] max_http_request_size
2005
+ # Specifies the maximum size of HTTP requests.
2006
+ #
2007
+ # Default: 10485760
2008
+ # @return [Integer]
2009
+ #
2010
+ # @!attribute [rw] force_snapshot_mem_threshold
2011
+ # Specifies the threshold for the internal memory buffer. Supports
2012
+ # either a percentage (portion of available memory) or absolute value
2013
+ # in MB–for example: 70% or 100
2014
+ #
2015
+ # Default: 70%
2016
+ # @return [Types::PercentOrAbsoluteLong]
2017
+ #
2018
+ # @!attribute [rw] wal_snapshot_size
2019
+ # Defines the number of WAL files to attempt to remove in a snapshot.
2020
+ # This, multiplied by the interval, determines how often snapshots are
2021
+ # taken.
2022
+ #
2023
+ # Default: 600
2024
+ # @return [Integer]
2025
+ #
2026
+ # @!attribute [rw] wal_max_write_buffer_size
2027
+ # Specifies the maximum number of write requests that can be buffered
2028
+ # before a flush must be executed and succeed.
2029
+ #
2030
+ # Default: 100000
2031
+ # @return [Integer]
2032
+ #
2033
+ # @!attribute [rw] snapshotted_wal_files_to_keep
2034
+ # Specifies the number of snapshotted WAL files to retain in the
2035
+ # object store. Flushing the WAL files does not clear the WAL files
2036
+ # immediately; they are deleted when the number of snapshotted WAL
2037
+ # files exceeds this number.
2038
+ #
2039
+ # Default: 300
2040
+ # @return [Integer]
2041
+ #
2042
+ # @!attribute [rw] preemptive_cache_age
2043
+ # Specifies the interval to prefetch into the Parquet cache during
2044
+ # compaction.
2045
+ #
2046
+ # Default: 3d
2047
+ # @return [Types::Duration]
2048
+ #
2049
+ # @!attribute [rw] parquet_mem_cache_prune_percentage
2050
+ # Specifies the percentage of entries to prune during a prune
2051
+ # operation on the in-memory Parquet cache.
2052
+ #
2053
+ # Default: 0.1
2054
+ # @return [Float]
2055
+ #
2056
+ # @!attribute [rw] parquet_mem_cache_prune_interval
2057
+ # Sets the interval to check if the in-memory Parquet cache needs to
2058
+ # be pruned.
2059
+ #
2060
+ # Default: 1s
2061
+ # @return [Types::Duration]
2062
+ #
2063
+ # @!attribute [rw] disable_parquet_mem_cache
2064
+ # Disables the in-memory Parquet cache. By default, the cache is
2065
+ # enabled.
2066
+ # @return [Boolean]
2067
+ #
2068
+ # @!attribute [rw] parquet_mem_cache_query_path_duration
2069
+ # Specifies the time window for caching recent Parquet files in
2070
+ # memory.
2071
+ #
2072
+ # Default: 5h
2073
+ # @return [Types::Duration]
2074
+ #
2075
+ # @!attribute [rw] last_cache_eviction_interval
2076
+ # Specifies the interval to evict expired entries from the
2077
+ # Last-N-Value cache, expressed as a human-readable duration–for
2078
+ # example: 20s, 1m, 1h.
2079
+ #
2080
+ # Default: 10s
2081
+ # @return [Types::Duration]
2082
+ #
2083
+ # @!attribute [rw] distinct_cache_eviction_interval
2084
+ # Specifies the interval to evict expired entries from the distinct
2085
+ # value cache, expressed as a human-readable duration–for example:
2086
+ # 20s, 1m, 1h.
2087
+ #
2088
+ # Default: 10s
2089
+ # @return [Types::Duration]
2090
+ #
2091
+ # @!attribute [rw] gen1_duration
2092
+ # Specifies the duration that Parquet files are arranged into. Data
2093
+ # timestamps land each row into a file of this duration. Supported
2094
+ # durations are 1m, 5m, and 10m. These files are known as “generation
2095
+ # 1” files, which the compactor can merge into larger generations.
2096
+ #
2097
+ # Default: 10m
2098
+ # @return [Types::Duration]
2099
+ #
2100
+ # @!attribute [rw] exec_mem_pool_bytes
2101
+ # Specifies the size of memory pool used during query execution. Can
2102
+ # be given as absolute value in bytes or as a percentage of the total
2103
+ # available memory–for example: 8000000000 or 10%.
2104
+ #
2105
+ # Default: 20%
2106
+ # @return [Types::PercentOrAbsoluteLong]
2107
+ #
2108
+ # @!attribute [rw] parquet_mem_cache_size
2109
+ # Specifies the size of the in-memory Parquet cache in megabytes or
2110
+ # percentage of total available memory.
2111
+ #
2112
+ # Default: 20%
2113
+ # @return [Types::PercentOrAbsoluteLong]
2114
+ #
2115
+ # @!attribute [rw] wal_replay_fail_on_error
2116
+ # Determines whether WAL replay should fail when encountering errors.
2117
+ #
2118
+ # Default: false
2119
+ # @return [Boolean]
2120
+ #
2121
+ # @!attribute [rw] wal_replay_concurrency_limit
2122
+ # Concurrency limit during WAL replay. Setting this number too high
2123
+ # can lead to OOM. The default is dynamically determined.
2124
+ #
2125
+ # Default: max(num\_cpus, 10)
2126
+ # @return [Integer]
2127
+ #
2128
+ # @!attribute [rw] table_index_cache_max_entries
2129
+ # Specifies the maximum number of entries in the table index cache.
2130
+ #
2131
+ # Default: 1000
2132
+ # @return [Integer]
2133
+ #
2134
+ # @!attribute [rw] table_index_cache_concurrency_limit
2135
+ # Limits the concurrency level for table index cache operations.
2136
+ #
2137
+ # Default: 8
2138
+ # @return [Integer]
2139
+ #
2140
+ # @!attribute [rw] gen1_lookback_duration
2141
+ # Specifies how far back to look when creating generation 1 Parquet
2142
+ # files.
2143
+ #
2144
+ # Default: 24h
2145
+ # @return [Types::Duration]
2146
+ #
2147
+ # @!attribute [rw] retention_check_interval
2148
+ # The interval at which retention policies are checked and enforced.
2149
+ # Enter as a human-readable time–for example: 30m or 1h.
2150
+ #
2151
+ # Default: 30m
2152
+ # @return [Types::Duration]
2153
+ #
2154
+ # @!attribute [rw] delete_grace_period
2155
+ # Specifies the grace period before permanently deleting data.
2156
+ #
2157
+ # Default: 24h
2158
+ # @return [Types::Duration]
2159
+ #
2160
+ # @!attribute [rw] hard_delete_default_duration
2161
+ # Sets the default duration for hard deletion of data.
2162
+ #
2163
+ # Default: 90d
2164
+ # @return [Types::Duration]
2165
+ #
2166
+ # @!attribute [rw] ingest_query_instances
2167
+ # Specifies number of instances in the DbCluster which can both ingest
2168
+ # and query.
2169
+ # @return [Integer]
2170
+ #
2171
+ # @!attribute [rw] query_only_instances
2172
+ # Specifies number of instances in the DbCluster which can only query.
2173
+ # @return [Integer]
2174
+ #
2175
+ # @!attribute [rw] dedicated_compactor
2176
+ # Specifies if the compactor instance should be a standalone instance
2177
+ # or not.
2178
+ # @return [Boolean]
2179
+ #
2180
+ # @!attribute [rw] compaction_row_limit
2181
+ # Specifies the soft limit for the number of rows per file that the
2182
+ # compactor writes. The compactor may write more rows than this limit.
2183
+ #
2184
+ # Default: 1000000
2185
+ # @return [Integer]
2186
+ #
2187
+ # @!attribute [rw] compaction_max_num_files_per_plan
2188
+ # Sets the maximum number of files included in any compaction plan.
2189
+ #
2190
+ # Default: 500
2191
+ # @return [Integer]
2192
+ #
2193
+ # @!attribute [rw] compaction_gen_2_duration
2194
+ # Specifies the duration of the first level of compaction (gen2).
2195
+ # Later levels of compaction are multiples of this duration. This
2196
+ # value should be equal to or greater than the gen1 duration.
2197
+ #
2198
+ # Default: 20m
2199
+ # @return [Types::Duration]
2200
+ #
2201
+ # @!attribute [rw] compaction_multipliers
2202
+ # Specifies a comma-separated list of multiples defining the duration
2203
+ # of each level of compaction. The number of elements in the list
2204
+ # determines the number of compaction levels. The first element
2205
+ # specifies the duration of the first level (gen3); subsequent levels
2206
+ # are multiples of the previous level.
2207
+ #
2208
+ # Default: 3,4,6,5
2209
+ # @return [String]
2210
+ #
2211
+ # @!attribute [rw] compaction_cleanup_wait
2212
+ # Specifies the amount of time that the compactor waits after
2213
+ # finishing a compaction run to delete files marked as needing
2214
+ # deletion during that compaction run.
2215
+ #
2216
+ # Default: 10m
2217
+ # @return [Types::Duration]
2218
+ #
2219
+ # @!attribute [rw] compaction_check_interval
2220
+ # Specifies how often the compactor checks for new compaction work to
2221
+ # perform.
2222
+ #
2223
+ # Default: 10s
2224
+ # @return [Types::Duration]
2225
+ #
2226
+ # @!attribute [rw] last_value_cache_disable_from_history
2227
+ # Disables populating the last-N-value cache from historical data. If
2228
+ # disabled, the cache is still populated with data from the
2229
+ # write-ahead log (WAL).
2230
+ # @return [Boolean]
2231
+ #
2232
+ # @!attribute [rw] distinct_value_cache_disable_from_history
2233
+ # Disables populating the distinct value cache from historical data.
2234
+ # If disabled, the cache is still populated with data from the
2235
+ # write-ahead log (WAL).
2236
+ # @return [Boolean]
2237
+ #
2238
+ # @!attribute [rw] replication_interval
2239
+ # Specifies the interval at which data replication occurs between
2240
+ # cluster nodes.
2241
+ #
2242
+ # Default: 250ms
2243
+ # @return [Types::Duration]
2244
+ #
2245
+ # @!attribute [rw] catalog_sync_interval
2246
+ # Defines how often the catalog synchronizes across cluster nodes.
2247
+ #
2248
+ # Default: 10s
2249
+ # @return [Types::Duration]
2250
+ #
2251
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/InfluxDBv3EnterpriseParameters AWS API Documentation
2252
+ #
2253
+ class InfluxDBv3EnterpriseParameters < Struct.new(
2254
+ :query_file_limit,
2255
+ :query_log_size,
2256
+ :log_filter,
2257
+ :log_format,
2258
+ :data_fusion_num_threads,
2259
+ :data_fusion_runtime_type,
2260
+ :data_fusion_runtime_disable_lifo_slot,
2261
+ :data_fusion_runtime_event_interval,
2262
+ :data_fusion_runtime_global_queue_interval,
2263
+ :data_fusion_runtime_max_blocking_threads,
2264
+ :data_fusion_runtime_max_io_events_per_tick,
2265
+ :data_fusion_runtime_thread_keep_alive,
2266
+ :data_fusion_runtime_thread_priority,
2267
+ :data_fusion_max_parquet_fanout,
2268
+ :data_fusion_use_cached_parquet_loader,
2269
+ :data_fusion_config,
2270
+ :max_http_request_size,
2271
+ :force_snapshot_mem_threshold,
2272
+ :wal_snapshot_size,
2273
+ :wal_max_write_buffer_size,
2274
+ :snapshotted_wal_files_to_keep,
2275
+ :preemptive_cache_age,
2276
+ :parquet_mem_cache_prune_percentage,
2277
+ :parquet_mem_cache_prune_interval,
2278
+ :disable_parquet_mem_cache,
2279
+ :parquet_mem_cache_query_path_duration,
2280
+ :last_cache_eviction_interval,
2281
+ :distinct_cache_eviction_interval,
2282
+ :gen1_duration,
2283
+ :exec_mem_pool_bytes,
2284
+ :parquet_mem_cache_size,
2285
+ :wal_replay_fail_on_error,
2286
+ :wal_replay_concurrency_limit,
2287
+ :table_index_cache_max_entries,
2288
+ :table_index_cache_concurrency_limit,
2289
+ :gen1_lookback_duration,
2290
+ :retention_check_interval,
2291
+ :delete_grace_period,
2292
+ :hard_delete_default_duration,
2293
+ :ingest_query_instances,
2294
+ :query_only_instances,
2295
+ :dedicated_compactor,
2296
+ :compaction_row_limit,
2297
+ :compaction_max_num_files_per_plan,
2298
+ :compaction_gen_2_duration,
2299
+ :compaction_multipliers,
2300
+ :compaction_cleanup_wait,
2301
+ :compaction_check_interval,
2302
+ :last_value_cache_disable_from_history,
2303
+ :distinct_value_cache_disable_from_history,
2304
+ :replication_interval,
2305
+ :catalog_sync_interval)
2306
+ SENSITIVE = []
2307
+ include Aws::Structure
2308
+ end
2309
+
1585
2310
  # The request processing has failed because of an unknown error,
1586
2311
  # exception or failure.
1587
2312
  #
@@ -1812,19 +2537,62 @@ module Aws::TimestreamInfluxDB
1812
2537
  # InfluxDB.
1813
2538
  # @return [Types::InfluxDBv2Parameters]
1814
2539
  #
2540
+ # @!attribute [rw] influx_d_bv_3_core
2541
+ # All the customer-modifiable InfluxDB v3 Core parameters in
2542
+ # Timestream for InfluxDB.
2543
+ # @return [Types::InfluxDBv3CoreParameters]
2544
+ #
2545
+ # @!attribute [rw] influx_d_bv_3_enterprise
2546
+ # All the customer-modifiable InfluxDB v3 Enterprise parameters in
2547
+ # Timestream for InfluxDB.
2548
+ # @return [Types::InfluxDBv3EnterpriseParameters]
2549
+ #
1815
2550
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/Parameters AWS API Documentation
1816
2551
  #
1817
2552
  class Parameters < Struct.new(
1818
2553
  :influx_d_bv_2,
2554
+ :influx_d_bv_3_core,
2555
+ :influx_d_bv_3_enterprise,
1819
2556
  :unknown)
1820
2557
  SENSITIVE = []
1821
2558
  include Aws::Structure
1822
2559
  include Aws::Structure::Union
1823
2560
 
1824
2561
  class InfluxDBv2 < Parameters; end
2562
+ class InfluxDBv3Core < Parameters; end
2563
+ class InfluxDBv3Enterprise < Parameters; end
1825
2564
  class Unknown < Parameters; end
1826
2565
  end
1827
2566
 
2567
+ # Percent or Absolute Long for InfluxDB parameters
2568
+ #
2569
+ # @note PercentOrAbsoluteLong is a union - when making an API calls you must set exactly one of the members.
2570
+ #
2571
+ # @note PercentOrAbsoluteLong is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of PercentOrAbsoluteLong corresponding to the set member.
2572
+ #
2573
+ # @!attribute [rw] percent
2574
+ # Percent for InfluxDB parameters.
2575
+ # @return [String]
2576
+ #
2577
+ # @!attribute [rw] absolute
2578
+ # Absolute long for InfluxDB parameters.
2579
+ # @return [Integer]
2580
+ #
2581
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/PercentOrAbsoluteLong AWS API Documentation
2582
+ #
2583
+ class PercentOrAbsoluteLong < Struct.new(
2584
+ :percent,
2585
+ :absolute,
2586
+ :unknown)
2587
+ SENSITIVE = []
2588
+ include Aws::Structure
2589
+ include Aws::Structure::Union
2590
+
2591
+ class Percent < PercentOrAbsoluteLong; end
2592
+ class Absolute < PercentOrAbsoluteLong; end
2593
+ class Unknown < PercentOrAbsoluteLong; end
2594
+ end
2595
+
1828
2596
  # The requested resource was not found or does not exist.
1829
2597
  #
1830
2598
  # @!attribute [rw] message
@@ -2143,6 +2911,10 @@ module Aws::TimestreamInfluxDB
2143
2911
  # Specifies the DbInstance's role in the cluster.
2144
2912
  # @return [String]
2145
2913
  #
2914
+ # @!attribute [rw] instance_modes
2915
+ # Specifies the DbInstance's roles in the cluster.
2916
+ # @return [Array<String>]
2917
+ #
2146
2918
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-influxdb-2023-01-27/UpdateDbInstanceOutput AWS API Documentation
2147
2919
  #
2148
2920
  class UpdateDbInstanceOutput < Struct.new(
@@ -2166,7 +2938,8 @@ module Aws::TimestreamInfluxDB
2166
2938
  :log_delivery_configuration,
2167
2939
  :influx_auth_parameters_secret_arn,
2168
2940
  :db_cluster_id,
2169
- :instance_mode)
2941
+ :instance_mode,
2942
+ :instance_modes)
2170
2943
  SENSITIVE = []
2171
2944
  include Aws::Structure
2172
2945
  end