diff --git a/manifests/db.pp b/manifests/db.pp
index f3dfef4..56cf4b2 100644
--- a/manifests/db.pp
+++ b/manifests/db.pp
@@ -13,7 +13,7 @@
 #   Set to -1 to specify an infinite retry count.
 #   Defaults to $::os_service_default.
 #
-# [*database_idle_timeout*]
+# [*database_connection_recycle_time*]
 #   (Optional) Timeout before idle SQL connections are reaped.
 #   Defaults to $::os_service_default.
 #
@@ -42,43 +42,56 @@
 #   before error is raised. Set to -1 to specify an infinite retry count.
 #   Defaults to $::os_service_default
 #
+# DEPRECATED PARAMETERS
+#
+# [*database_idle_timeout*]
+#   Timeout when db connections should be reaped.
+#   Defaults to undef.
+#
 class murano::db (
-  $database_connection     = 'mysql+pymysql://murano:secrete@localhost:3306/murano',
-  $database_idle_timeout   = $::os_service_default,
-  $database_min_pool_size  = $::os_service_default,
-  $database_max_pool_size  = $::os_service_default,
-  $database_max_retries    = $::os_service_default,
-  $database_retry_interval = $::os_service_default,
-  $database_max_overflow   = $::os_service_default,
-  $database_pool_timeout   = $::os_service_default,
-  $database_db_max_retries = $::os_service_default,
+  $database_connection              = 'mysql+pymysql://murano:secrete@localhost:3306/murano',
+  $database_connection_recycle_time = $::os_service_default,
+  $database_min_pool_size           = $::os_service_default,
+  $database_max_pool_size           = $::os_service_default,
+  $database_max_retries             = $::os_service_default,
+  $database_retry_interval          = $::os_service_default,
+  $database_max_overflow            = $::os_service_default,
+  $database_pool_timeout            = $::os_service_default,
+  $database_db_max_retries          = $::os_service_default,
+  # DEPRECATED PARAMETERS
+  $database_idle_timeout            = undef,
 ) {
 
   include ::murano::deps
 
+  if $database_idle_timeout {
+    warning('The database_idle_timeout parameter is deprecated. Please use \
+database_connection_recycle_time instead.')
+  }
+
   # NOTE(aderyugin): In order to keep backward compatibility we rely on the pick function
   # to use murano::<myparam> if murano::db::<myparam> isn't specified.
-  $database_connection_real     = pick($::murano::database_connection, $database_connection)
-  $database_idle_timeout_real   = pick($::murano::database_idle_timeout, $database_idle_timeout)
-  $database_min_pool_size_real  = pick($::murano::database_min_pool_size, $database_min_pool_size)
-  $database_max_pool_size_real  = pick($::murano::database_max_pool_size, $database_max_pool_size)
-  $database_max_retries_real    = pick($::murano::database_max_retries, $database_max_retries)
-  $database_retry_interval_real = pick($::murano::database_retry_interval, $database_retry_interval)
-  $database_max_overflow_real   = pick($::murano::database_max_overflow, $database_max_overflow)
+  $database_connection_real              = pick($::murano::database_connection, $database_connection)
+  $database_connection_recycle_time_real = pick($::murano::database_idle_timeout, $database_idle_timeout, $database_connection_recycle_time)
+  $database_min_pool_size_real           = pick($::murano::database_min_pool_size, $database_min_pool_size)
+  $database_max_pool_size_real           = pick($::murano::database_max_pool_size, $database_max_pool_size)
+  $database_max_retries_real             = pick($::murano::database_max_retries, $database_max_retries)
+  $database_retry_interval_real          = pick($::murano::database_retry_interval, $database_retry_interval)
+  $database_max_overflow_real            = pick($::murano::database_max_overflow, $database_max_overflow)
 
   validate_legacy(Oslo::Dbconn, 'validate_re', $database_connection_real,
     ['^(mysql(\+pymysql)?|postgresql):\/\/(\S+:\S+@\S+\/\S+)?'])
 
   oslo::db { 'murano_config':
-    connection     => $database_connection_real,
-    idle_timeout   => $database_idle_timeout_real,
-    min_pool_size  => $database_min_pool_size_real,
-    max_pool_size  => $database_max_pool_size_real,
-    max_retries    => $database_max_retries_real,
-    retry_interval => $database_retry_interval_real,
-    max_overflow   => $database_max_overflow_real,
-    pool_timeout   => $database_pool_timeout,
-    db_max_retries => $database_db_max_retries,
+    connection              => $database_connection_real,
+    connection_recycle_time => $database_connection_recycle_time_real,
+    min_pool_size           => $database_min_pool_size_real,
+    max_pool_size           => $database_max_pool_size_real,
+    max_retries             => $database_max_retries_real,
+    retry_interval          => $database_retry_interval_real,
+    max_overflow            => $database_max_overflow_real,
+    pool_timeout            => $database_pool_timeout,
+    db_max_retries          => $database_db_max_retries,
   }
 
 }
diff --git a/releasenotes/notes/deprecate_idle_timeout_parameter-8c712cd276bfb5f8.yaml b/releasenotes/notes/deprecate_idle_timeout_parameter-8c712cd276bfb5f8.yaml
new file mode 100644
index 0000000..09e76c4
--- /dev/null
+++ b/releasenotes/notes/deprecate_idle_timeout_parameter-8c712cd276bfb5f8.yaml
@@ -0,0 +1,4 @@
+---
+deprecations:
+  - database_idle_timeout is deprecated and will be removed in a future
+    release. Please use database_connection_recycle_time instead.
diff --git a/spec/classes/murano_db_spec.rb b/spec/classes/murano_db_spec.rb
index 7aa5617..855d530 100644
--- a/spec/classes/murano_db_spec.rb
+++ b/spec/classes/murano_db_spec.rb
@@ -4,43 +4,43 @@ describe 'murano::db' do
   shared_examples 'murano::db' do
     context 'with default parameters' do
       it { should contain_oslo__db('murano_config').with(
-        :db_max_retries => '<SERVICE DEFAULT>',
-        :connection     => 'mysql+pymysql://murano:secrete@localhost:3306/murano',
-        :idle_timeout   => '<SERVICE DEFAULT>',
-        :min_pool_size  => '<SERVICE DEFAULT>',
-        :max_pool_size  => '<SERVICE DEFAULT>',
-        :max_retries    => '<SERVICE DEFAULT>',
-        :retry_interval => '<SERVICE DEFAULT>',
-        :max_overflow   => '<SERVICE DEFAULT>',
-        :pool_timeout   => '<SERVICE DEFAULT>',
+        :db_max_retries          => '<SERVICE DEFAULT>',
+        :connection              => 'mysql+pymysql://murano:secrete@localhost:3306/murano',
+        :connection_recycle_time => '<SERVICE DEFAULT>',
+        :min_pool_size           => '<SERVICE DEFAULT>',
+        :max_pool_size           => '<SERVICE DEFAULT>',
+        :max_retries             => '<SERVICE DEFAULT>',
+        :retry_interval          => '<SERVICE DEFAULT>',
+        :max_overflow            => '<SERVICE DEFAULT>',
+        :pool_timeout            => '<SERVICE DEFAULT>',
       )}
     end
 
     context 'with specific parameters' do
       let :params do
         {
-          :database_connection       => 'mysql+pymysql://murano:murano@localhost/murano',
-          :database_idle_timeout     => '3601',
-          :database_min_pool_size    => '2',
-          :database_max_retries      => '11',
-          :database_retry_interval   => '11',
-          :database_max_pool_size    => '11',
-          :database_max_overflow     => '21',
-          :database_pool_timeout     => '21',
-          :database_db_max_retries   => '-1',
+          :database_connection              => 'mysql+pymysql://murano:murano@localhost/murano',
+          :database_connection_recycle_time => '3601',
+          :database_min_pool_size           => '2',
+          :database_max_retries             => '11',
+          :database_retry_interval          => '11',
+          :database_max_pool_size           => '11',
+          :database_max_overflow            => '21',
+          :database_pool_timeout            => '21',
+          :database_db_max_retries          => '-1',
         }
       end
 
       it { should contain_oslo__db('murano_config').with(
-        :db_max_retries => '-1',
-        :connection     => 'mysql+pymysql://murano:murano@localhost/murano',
-        :idle_timeout   => '3601',
-        :min_pool_size  => '2',
-        :max_pool_size  => '11',
-        :max_retries    => '11',
-        :retry_interval => '11',
-        :max_overflow   => '21',
-        :pool_timeout   => '21',
+        :db_max_retries          => '-1',
+        :connection              => 'mysql+pymysql://murano:murano@localhost/murano',
+        :connection_recycle_time => '3601',
+        :min_pool_size           => '2',
+        :max_pool_size           => '11',
+        :max_retries             => '11',
+        :retry_interval          => '11',
+        :max_overflow            => '21',
+        :pool_timeout            => '21',
       )}
     end
   end