appwrite 28.4.0 → 30.0.0

data/lib/appwrite/services/postgresql.rb

@@ -9,15 +9,18 @@ module Appwrite
         # List all dedicated databases. Results support pagination.
         #
         # @param [Array] queries Array of query strings.
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
         #
         # @return [DedicatedDatabaseList]
         def list(
-            queries: nil
+            queries: nil,
+            total: nil
         )
             api_path = '/postgresql'
 
             api_params = {
                 queries: queries,
+                total: total,
             }
 
             api_headers = {
@@ -50,7 +53,7 @@ module Appwrite
         # @param [Integer] pitr_retention_days Number of days to retain PITR data.
         # @param [] storage_autoscaling Enable automatic storage expansion when usage exceeds threshold.
         # @param [Integer] storage_autoscaling_threshold_percent Storage usage percentage (50-95) that triggers automatic expansion.
-        # @param [Integer] storage_autoscaling_max_gb Maximum storage size in GB for autoscaling. 0 means no limit.
+        # @param [Integer] storage_autoscaling_max_gb Maximum storage size in GB for autoscaling. Defaults to 3 times the specification's storage. 0 means no limit.
         #
         # @return [DedicatedDatabase]
         def create(
@@ -69,8 +72,6 @@ module Appwrite
             storage_autoscaling_threshold_percent: nil,
             storage_autoscaling_max_gb: nil
         )
-            api_path = '/postgresql'
-
             if database_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
@@ -79,6 +80,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/postgresql'
+
             api_params = {
                 databaseId: database_id,
                 name: name,
@@ -112,8 +115,8 @@ module Appwrite
         end
 
         # List the dedicated database specifications available on the current plan.
-        # Each specification reports its resource limits, pricing, and whether it is
-        # enabled for the organization.
+        # Each specification reports its resource limits, its own prices and overage
+        # rates, and whether it is enabled for the organization.
         #
         #
         # @return [DedicatedDatabaseSpecificationList]
@@ -145,13 +148,13 @@ module Appwrite
         def get(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -219,13 +222,13 @@ module Appwrite
             sql_api_max_bytes: nil,
             sql_api_timeout_seconds: nil
         )
-            api_path = '/postgresql/{databaseId}'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 name: name,
                 status: status,
@@ -275,13 +278,13 @@ module Appwrite
         def delete(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -303,21 +306,24 @@ module Appwrite
         #
         # @param [String] database_id Database ID.
         # @param [Array] queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: status, type, databaseId
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
         #
         # @return [DedicatedDatabaseBackupList]
         def list_backups(
             database_id:,
-            queries: nil
+            queries: nil,
+            total: nil
         )
-            api_path = '/postgresql/{databaseId}/backups'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 queries: queries,
+                total: total,
             }
 
             api_headers = {
@@ -345,13 +351,13 @@ module Appwrite
             database_id:,
             type: nil
         )
-            api_path = '/postgresql/{databaseId}/backups'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 type: type,
             }
@@ -375,21 +381,24 @@ module Appwrite
         #
         # @param [String] database_id Database ID.
         # @param [Array] queries Array of query strings generated using the Query class provided by the SDK.
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
         #
         # @return [BackupPolicyList]
         def list_backup_policies(
             database_id:,
-            queries: nil
+            queries: nil,
+            total: nil
         )
-            api_path = '/postgresql/{databaseId}/backups/policies'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/policies'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 queries: queries,
+                total: total,
             }
 
             api_headers = {
@@ -426,10 +435,7 @@ module Appwrite
             type: nil,
             enabled: nil
         )
-            api_path = '/postgresql/{databaseId}/backups/policies'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
@@ -449,6 +455,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "retention"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/policies'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 policyId: policy_id,
                 name: name,
@@ -483,18 +492,18 @@ module Appwrite
             database_id:,
             policy_id:
         )
-            api_path = '/postgresql/{databaseId}/backups/policies/{policyId}'
-                .gsub('{databaseId}', database_id)
-                .gsub('{policyId}', policy_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if policy_id.nil?
+            if policy_id.nil? || policy_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "policyId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/policies/{policyId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{policyId}', policy_id)
+
             api_params = {}
 
             api_headers = {
@@ -529,18 +538,18 @@ module Appwrite
             retention: nil,
             enabled: nil
         )
-            api_path = '/postgresql/{databaseId}/backups/policies/{policyId}'
-                .gsub('{databaseId}', database_id)
-                .gsub('{policyId}', policy_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if policy_id.nil?
+            if policy_id.nil? || policy_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "policyId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/policies/{policyId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{policyId}', policy_id)
+
             api_params = {
                 name: name,
                 schedule: schedule,
@@ -574,18 +583,18 @@ module Appwrite
             database_id:,
             policy_id:
         )
-            api_path = '/postgresql/{databaseId}/backups/policies/{policyId}'
-                .gsub('{databaseId}', database_id)
-                .gsub('{policyId}', policy_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if policy_id.nil?
+            if policy_id.nil? || policy_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "policyId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/policies/{policyId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{policyId}', policy_id)
+
             api_params = {}
 
             api_headers = {
@@ -626,10 +635,7 @@ module Appwrite
             prefix: nil,
             endpoint: nil
         )
-            api_path = '/postgresql/{databaseId}/backups/storage'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
@@ -649,6 +655,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "secretKey"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/storage'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 provider: provider,
                 bucket: bucket,
@@ -685,18 +694,18 @@ module Appwrite
             database_id:,
             backup_id:
         )
-            api_path = '/postgresql/{databaseId}/backups/{backupId}'
-                .gsub('{databaseId}', database_id)
-                .gsub('{backupId}', backup_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if backup_id.nil?
+            if backup_id.nil? || backup_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "backupId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/{backupId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{backupId}', backup_id)
+
             api_params = {}
 
             api_headers = {
@@ -724,18 +733,18 @@ module Appwrite
             database_id:,
             backup_id:
         )
-            api_path = '/postgresql/{databaseId}/backups/{backupId}'
-                .gsub('{databaseId}', database_id)
-                .gsub('{backupId}', backup_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if backup_id.nil?
+            if backup_id.nil? || backup_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "backupId"')
             end
 
+            api_path = '/postgresql/{databaseId}/backups/{backupId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{backupId}', backup_id)
+
             api_params = {}
 
             api_headers = {
@@ -761,13 +770,13 @@ module Appwrite
         def list_branches(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}/branches'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/branches'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -800,13 +809,13 @@ module Appwrite
             branch_id: nil,
             ttl: nil
         )
-            api_path = '/postgresql/{databaseId}/branches'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/branches'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 branchId: branch_id,
                 ttl: ttl,
@@ -839,18 +848,18 @@ module Appwrite
             database_id:,
             branch_id:
         )
-            api_path = '/postgresql/{databaseId}/branches/{branchId}'
-                .gsub('{databaseId}', database_id)
-                .gsub('{branchId}', branch_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if branch_id.nil?
+            if branch_id.nil? || branch_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "branchId"')
             end
 
+            api_path = '/postgresql/{databaseId}/branches/{branchId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{branchId}', branch_id)
+
             api_params = {}
 
             api_headers = {
@@ -879,13 +888,13 @@ module Appwrite
         def update_credentials(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}/credentials'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/credentials'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -912,11 +921,15 @@ module Appwrite
         # without a per-query cloud round-trip. The statement type must be on the
         # database's configured allow-list. Use bound parameters for any
         # user-supplied values — the API does not interpolate raw strings.
+        # Long-running statements (for example CREATE INDEX) can outlive the HTTP
+        # request: if the request ends before a result is returned, check the
+        # database before retrying, and prefer a direct connection for work that may
+        # take minutes.
         #
         # @param [String] database_id Database ID.
         # @param [String] sql SQL statement to execute. Exactly one statement per request.
         # @param [Hash] bindings Optional bound parameters. Pass either a positional list or a name => value map matching the placeholder style used in the SQL.
-        # @param [Integer] timeout_seconds Per-call execution timeout override. Must be less than or equal to the database's configured sqlApiTimeoutSeconds.
+        # @param [Integer] timeout_seconds Per-call execution timeout override. Must be less than or equal to the database's configured sqlApiTimeoutSeconds. Statements that may exceed this — or the HTTP request timeout in front of Cloud — should use a direct connection instead.
         #
         # @return [DedicatedDatabaseExecution]
         def create_execution(
@@ -925,10 +938,7 @@ module Appwrite
             bindings: nil,
             timeout_seconds: nil
         )
-            api_path = '/postgresql/{databaseId}/executions'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
@@ -936,6 +946,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "sql"')
             end
 
+            api_path = '/postgresql/{databaseId}/executions'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 sql: sql,
                 bindings: bindings,
@@ -965,13 +978,13 @@ module Appwrite
         def list_extensions(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}/extensions'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/extensions'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -999,10 +1012,7 @@ module Appwrite
             database_id:,
             name:
         )
-            api_path = '/postgresql/{databaseId}/extensions'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
@@ -1010,6 +1020,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/postgresql/{databaseId}/extensions'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 name: name,
             }
@@ -1040,18 +1053,18 @@ module Appwrite
             database_id:,
             extension_name:
         )
-            api_path = '/postgresql/{databaseId}/extensions/{extensionName}'
-                .gsub('{databaseId}', database_id)
-                .gsub('{extensionName}', extension_name)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if extension_name.nil?
+            if extension_name.nil? || extension_name == ''
                 raise Appwrite::Exception.new('Missing required parameter: "extensionName"')
             end
 
+            api_path = '/postgresql/{databaseId}/extensions/{extensionName}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{extensionName}', extension_name)
+
             api_params = {}
 
             api_headers = {
@@ -1087,13 +1100,13 @@ module Appwrite
             database_id:,
             target_replica_id: nil
         )
-            api_path = '/postgresql/{databaseId}/failovers'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/failovers'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 targetReplicaId: target_replica_id,
             }
@@ -1127,10 +1140,7 @@ module Appwrite
             day:,
             hour_utc:
         )
-            api_path = '/postgresql/{databaseId}/maintenance'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
@@ -1142,6 +1152,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "hourUtc"')
             end
 
+            api_path = '/postgresql/{databaseId}/maintenance'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 day: day,
                 hourUtc: hour_utc,
@@ -1177,10 +1190,7 @@ module Appwrite
             target_type:,
             specification: nil
         )
-            api_path = '/postgresql/{databaseId}/migrations'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
@@ -1188,6 +1198,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "targetType"')
             end
 
+            api_path = '/postgresql/{databaseId}/migrations'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 targetType: target_type,
                 specification: specification,
@@ -1225,13 +1238,13 @@ module Appwrite
             limit: nil,
             offset: nil
         )
-            api_path = '/postgresql/{databaseId}/operations'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/operations'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 status: status,
                 limit: limit,
@@ -1261,13 +1274,13 @@ module Appwrite
         def get_pitr(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}/pitr'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/pitr'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -1293,13 +1306,13 @@ module Appwrite
         def get_pooler(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}/pooler'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/pooler'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -1323,7 +1336,7 @@ module Appwrite
         # @param [String] mode Connection pool mode. Allowed values: transaction, session. Transaction mode returns connections to the pool after each transaction; session mode holds connections for the entire session lifetime.
         # @param [Integer] max_connections Client-connection ceiling the pooler accepts. Supported on MySQL and MariaDB only; the PostgreSQL pooler has no client cap, so set networkMaxConnections on the database instead.
         # @param [Integer] default_pool_size Default pool size per user.
-        # @param [] read_write_splitting Route SELECTs to HA replicas, writes and locked reads to the primary. Defaults to true when HA is enabled.
+        # @param [] read_write_splitting Route SELECTs to HA replicas, writes and locked reads to the primary. Off by default, and only takes effect while HA is enabled. Replication is asynchronous, so a read issued immediately after a write may not observe it.
         # @param [String] pooler_cpu_request Pooler sidecar CPU request override (Kubernetes quantity, e.g. "250m" or "1"). Leave null for the proportional default (5% of DB CPU, floor 100m).
         # @param [String] pooler_cpu_limit Pooler sidecar CPU limit override (Kubernetes quantity, e.g. "500m" or "1"). Leave null for the proportional default (10% of DB CPU, floor 200m). Changing this field rolls the database pod.
         # @param [String] pooler_memory_request Pooler sidecar memory request override (Kubernetes quantity, e.g. "128Mi" or "1Gi"). Leave null for the proportional default (7.5% of DB memory, floor 64Mi).
@@ -1341,13 +1354,13 @@ module Appwrite
             pooler_memory_request: nil,
             pooler_memory_limit: nil
         )
-            api_path = '/postgresql/{databaseId}/pooler'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/pooler'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 mode: mode,
                 maxConnections: max_connections,
@@ -1383,13 +1396,13 @@ module Appwrite
         def get_replicas(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}/replicas'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/replicas'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -1423,13 +1436,13 @@ module Appwrite
             limit: nil,
             offset: nil
         )
-            api_path = '/postgresql/{databaseId}/restorations'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/restorations'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 status: status,
                 type: type,
@@ -1456,11 +1469,25 @@ module Appwrite
         # an ISO 8601 datetime. PITR requires the database to have PITR enabled and
         # is only available for enterprise databases.
         #
+        # By default the backup is replayed over the database it was taken from. Pass
+        # `restoreMode` as `clone` to recover it onto a second workload beside this
+        # database instead: this database keeps serving its own data while the clone
+        # is filled, and the switch happens as soon as the clone is ready, on the
+        # endpoint and credentials it already had. Pass `autoPromote` as false to
+        # hold the clone until you promote it yourself. Pass `restoreMode` as `copy`
+        # to recover onto a separate database with its own endpoint, either one you
+        # name with `targetDatabaseId` or one provisioned as a copy of this
+        # database's engine, version, specification and replicas. Neither mode is
+        # available for a point-in-time recovery or an incremental backup.
+        #
         # @param [String] database_id Database ID.
         # @param [String] type Restoration type. Allowed values: backup, pitr. Use "backup" to restore from a specific backup, or "pitr" for point-in-time recovery.
         # @param [String] backup_id Backup ID to restore from (required for backup type).
-        # @param [String] target_database_id Existing database ID to restore into. The target must be distinct, ready, and use the same engine and version.
+        # @param [String] target_database_id Existing database ID to restore into. The target must be distinct, ready, and use the same engine and version. Omit it on a copy restoration to have one provisioned. Not accepted for a clone, which is recovered inside this database.
         # @param [String] target_time Target time for PITR (required for pitr type) as an [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) datetime.
+        # @param [String] restore_mode Where the backup is restored. Allowed values: in_place, clone, copy. Use "clone" to recover onto a second workload beside this database and leave it serving until you promote — the endpoint and credentials do not change. Use "copy" to recover onto a separate database with its own endpoint, either one you name with targetDatabaseId or one Cloud provisions. Use "in_place" to replay the backup over this database. Defaults to "copy" when a targetDatabaseId is given, "in_place" otherwise.
+        # @param [String] target_name Display name for the database a copy restoration provisions. Defaults to this database's name followed by "(restored)". Max length: 128 chars.
+        # @param [] auto_promote Whether a clone restoration switches the database over as soon as the recovery is ready. Default true: the restore finishes with the database serving the recovery point on the endpoint it already had, and the side it replaced kept briefly so the switch can be reversed. Pass false to hold the recovery until you call the promotion endpoint yourself.
         #
         # @return [DedicatedDatabaseRestoration]
         def create_restoration(
@@ -1468,20 +1495,26 @@ module Appwrite
             type: nil,
             backup_id: nil,
             target_database_id: nil,
-            target_time: nil
+            target_time: nil,
+            restore_mode: nil,
+            target_name: nil,
+            auto_promote: nil
         )
-            api_path = '/postgresql/{databaseId}/restorations'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/restorations'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 type: type,
                 backupId: backup_id,
                 targetDatabaseId: target_database_id,
                 targetTime: target_time,
+                restoreMode: restore_mode,
+                targetName: target_name,
+                autoPromote: auto_promote,
             }
 
             api_headers = {
@@ -1510,27 +1543,71 @@ module Appwrite
             database_id:,
             restoration_id:
         )
+            if database_id.nil? || database_id == ''
+                raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if restoration_id.nil? || restoration_id == ''
+                raise Appwrite::Exception.new('Missing required parameter: "restorationId"')
+            end
+
             api_path = '/postgresql/{databaseId}/restorations/{restorationId}'
                 .gsub('{databaseId}', database_id)
                 .gsub('{restorationId}', restoration_id)
 
-            if database_id.nil?
+            api_params = {}
+
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'GET',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DedicatedDatabaseRestoration
+            )
+        end
+
+        # Switch the database over to the clone a restoration recovered. The database
+        # keeps
+        # its endpoint and credentials; clients reconnect once. Writes made after the
+        # recovery point are discarded, and the side being replaced is retained
+        # briefly so
+        # the switch can be reversed.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] restoration_id Restoration ID.
+        #
+        # @return [DedicatedDatabaseRestoration]
+        def promote_restoration(
+            database_id:,
+            restoration_id:
+        )
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
-            if restoration_id.nil?
+            if restoration_id.nil? || restoration_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "restorationId"')
             end
 
+            api_path = '/postgresql/{databaseId}/restorations/{restorationId}/promotions'
+                .gsub('{databaseId}', database_id)
+                .gsub('{restorationId}', restoration_id)
+
             api_params = {}
 
             api_headers = {
                 "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
                 "accept": 'application/json',
             }
 
             @client.call(
-                method: 'GET',
+                method: 'POST',
                 path: api_path,
                 headers: api_headers,
                 params: api_params,
@@ -1548,13 +1625,13 @@ module Appwrite
         def get_status(
             database_id:
         )
-            api_path = '/postgresql/{databaseId}/status'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
+            api_path = '/postgresql/{databaseId}/status'
+                .gsub('{databaseId}', database_id)
+
             api_params = {}
 
             api_headers = {
@@ -1582,10 +1659,7 @@ module Appwrite
             database_id:,
             target_version:
         )
-            api_path = '/postgresql/{databaseId}/upgrades'
-                .gsub('{databaseId}', database_id)
-
-            if database_id.nil?
+            if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
             end
 
@@ -1593,6 +1667,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "targetVersion"')
             end
 
+            api_path = '/postgresql/{databaseId}/upgrades'
+                .gsub('{databaseId}', database_id)
+
             api_params = {
                 targetVersion: target_version,
             }