@pulumi/linode
Version:
A Pulumi package for creating and managing linode cloud resources.
925 lines (924 loc) • 41.6 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
import * as inputs from "./types/input";
import * as outputs from "./types/output";
/**
* Provides a Linode PostgreSQL Database resource. This can be used to create, modify, and delete Linode PostgreSQL Databases.
* For more information, see the [Linode APIv4 docs](https://techdocs.akamai.com/linode-api/reference/post-databases-postgre-sql-instances).
*
* Please keep in mind that Managed Databases can take up to half an hour to provision.
*
* ## Example Usage
*
* Creating a simple PostgreSQL database that does not allow connections:
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as linode from "@pulumi/linode";
*
* const foobar = new linode.DatabasePostgresqlV2("foobar", {
* label: "mydatabase",
* engineId: "postgresql/16",
* region: "us-mia",
* type: "g6-nanode-1",
* });
* ```
*
* Creating a simple PostgreSQL database that allows connections from all IPv4 addresses:
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as linode from "@pulumi/linode";
*
* const foobar = new linode.DatabasePostgresqlV2("foobar", {
* label: "mydatabase",
* engineId: "postgresql/16",
* region: "us-mia",
* type: "g6-nanode-1",
* allowLists: ["0.0.0.0/0"],
* });
* ```
*
* Creating a complex PostgreSQL database:
*
* ## Import
*
* Linode PostgreSQL Databases can be imported using the `id`, e.g.
*
* ```sh
* $ pulumi import linode:index/databasePostgresqlV2:DatabasePostgresqlV2 foobar 1234567
* ```
*/
export declare class DatabasePostgresqlV2 extends pulumi.CustomResource {
/**
* Get an existing DatabasePostgresqlV2 resource's state with the given name, ID, and optional extra
* properties used to qualify the lookup.
*
* @param name The _unique_ name of the resulting resource.
* @param id The _unique_ provider ID of the resource to lookup.
* @param state Any extra arguments used during the lookup.
* @param opts Optional settings to control the behavior of the CustomResource.
*/
static get(name: string, id: pulumi.Input<pulumi.ID>, state?: DatabasePostgresqlV2State, opts?: pulumi.CustomResourceOptions): DatabasePostgresqlV2;
/**
* Returns true if the given object is an instance of DatabasePostgresqlV2. This is designed to work even
* when multiple copies of the Pulumi SDK have been loaded into the same process.
*/
static isInstance(obj: any): obj is DatabasePostgresqlV2;
/**
* A list of IP addresses that can access the Managed Database. Each item can be a single IP address or a range in CIDR format. Use `linode.DatabaseAccessControls` to manage your allow list separately.
*/
readonly allowLists: pulumi.Output<string[]>;
/**
* The base64-encoded SSL CA certificate for the Managed Database.
*/
readonly caCert: pulumi.Output<string>;
/**
* The number of Linode Instance nodes deployed to the Managed Database. (default `1`)
*/
readonly clusterSize: pulumi.Output<number>;
/**
* When this Managed Database was created.
*/
readonly created: pulumi.Output<string>;
/**
* Whether the Managed Databases is encrypted.
*/
readonly encrypted: pulumi.Output<boolean>;
/**
* The Managed Database engine. (e.g. `postgresql`)
*/
readonly engine: pulumi.Output<string>;
/**
* Specifies a fraction of the table size to add to autovacuumAnalyzeThreshold when deciding whether to trigger an ANALYZE. The default is 0.2 (20% of table size)
*/
readonly engineConfigPgAutovacuumAnalyzeScaleFactor: pulumi.Output<number>;
/**
* Specifies the minimum number of inserted, updated or deleted tuples needed to trigger an ANALYZE in any one table. The default is 50 tuples.
*/
readonly engineConfigPgAutovacuumAnalyzeThreshold: pulumi.Output<number>;
/**
* Specifies the maximum number of autovacuum processes (other than the autovacuum launcher) that may be running at any one time. The default is three. This parameter can only be set at server start.
*/
readonly engineConfigPgAutovacuumMaxWorkers: pulumi.Output<number>;
/**
* Specifies the minimum delay between autovacuum runs on any given database. The delay is measured in seconds, and the default is one minute
*/
readonly engineConfigPgAutovacuumNaptime: pulumi.Output<number>;
/**
* Specifies the cost delay value that will be used in automatic VACUUM operations. If -1 is specified, the regular vacuumCostDelay value will be used. The default value is 20 milliseconds
*/
readonly engineConfigPgAutovacuumVacuumCostDelay: pulumi.Output<number>;
/**
* Specifies the cost limit value that will be used in automatic VACUUM operations. If -1 is specified (which is the default), the regular vacuumCostLimit value will be used.
*/
readonly engineConfigPgAutovacuumVacuumCostLimit: pulumi.Output<number>;
/**
* Specifies a fraction of the table size to add to autovacuumVacuumThreshold when deciding whether to trigger a VACUUM. The default is 0.2 (20% of table size)
*/
readonly engineConfigPgAutovacuumVacuumScaleFactor: pulumi.Output<number>;
/**
* Specifies the minimum number of updated or deleted tuples needed to trigger a VACUUM in any one table. The default is 50 tuples.
*/
readonly engineConfigPgAutovacuumVacuumThreshold: pulumi.Output<number>;
/**
* Specifies the delay between activity rounds for the background writer in milliseconds. Default is 200.
*/
readonly engineConfigPgBgwriterDelay: pulumi.Output<number>;
/**
* Whenever more than bgwriterFlushAfter bytes have been written by the background writer, attempt to force the OS to issue these writes to the underlying storage. Specified in kilobytes, default is 512. Setting of 0 disables forced writeback.
*/
readonly engineConfigPgBgwriterFlushAfter: pulumi.Output<number>;
/**
* In each round, no more than this many buffers will be written by the background writer. Setting this to zero disables background writing. Default is 100.
*/
readonly engineConfigPgBgwriterLruMaxpages: pulumi.Output<number>;
/**
* The average recent need for new buffers is multiplied by bgwriterLruMultiplier to arrive at an estimate of the number that will be needed during the next round, (up to bgwriter_lru_maxpages). 1.0 represents a “just in time” policy of writing exactly the number of buffers predicted to be needed. Larger values provide some cushion against spikes in demand, while smaller values intentionally leave writes to be done by server processes. The default is 2.0.
*/
readonly engineConfigPgBgwriterLruMultiplier: pulumi.Output<number>;
/**
* This is the amount of time, in milliseconds, to wait on a lock before checking to see if there is a deadlock condition.
*/
readonly engineConfigPgDeadlockTimeout: pulumi.Output<number>;
/**
* Specifies the default TOAST compression method for values of compressible columns (the default is lz4).
*/
readonly engineConfigPgDefaultToastCompression: pulumi.Output<string>;
/**
* Time out sessions with open transactions after this number of milliseconds.
*/
readonly engineConfigPgIdleInTransactionSessionTimeout: pulumi.Output<number>;
/**
* Controls system-wide use of Just-in-Time Compilation (JIT).
*/
readonly engineConfigPgJit: pulumi.Output<boolean>;
/**
* PostgreSQL maximum number of files that can be open per process.
*/
readonly engineConfigPgMaxFilesPerProcess: pulumi.Output<number>;
/**
* PostgreSQL maximum locks per transaction.
*/
readonly engineConfigPgMaxLocksPerTransaction: pulumi.Output<number>;
/**
* PostgreSQL maximum logical replication workers (taken from the pool of max_parallel_workers).
*/
readonly engineConfigPgMaxLogicalReplicationWorkers: pulumi.Output<number>;
/**
* Sets the maximum number of workers that the system can support for parallel queries.
*/
readonly engineConfigPgMaxParallelWorkers: pulumi.Output<number>;
/**
* Sets the maximum number of workers that can be started by a single Gather or Gather Merge node.
*/
readonly engineConfigPgMaxParallelWorkersPerGather: pulumi.Output<number>;
/**
* PostgreSQL maximum predicate locks per transaction.
*/
readonly engineConfigPgMaxPredLocksPerTransaction: pulumi.Output<number>;
/**
* PostgreSQL maximum replication slots.
*/
readonly engineConfigPgMaxReplicationSlots: pulumi.Output<number>;
/**
* PostgreSQL maximum WAL size (MB) reserved for replication slots. Default is -1 (unlimited). walKeepSize minimum WAL size setting takes precedence over this.
*/
readonly engineConfigPgMaxSlotWalKeepSize: pulumi.Output<number>;
/**
* Maximum depth of the stack in bytes.
*/
readonly engineConfigPgMaxStackDepth: pulumi.Output<number>;
/**
* Max standby archive delay in milliseconds.
*/
readonly engineConfigPgMaxStandbyArchiveDelay: pulumi.Output<number>;
/**
* Max standby streaming delay in milliseconds.
*/
readonly engineConfigPgMaxStandbyStreamingDelay: pulumi.Output<number>;
/**
* PostgreSQL maximum WAL senders.
*/
readonly engineConfigPgMaxWalSenders: pulumi.Output<number>;
/**
* Sets the maximum number of background processes that the system can support.
*/
readonly engineConfigPgMaxWorkerProcesses: pulumi.Output<number>;
/**
* Chooses the algorithm for encrypting passwords. (default `md5`)
*/
readonly engineConfigPgPasswordEncryption: pulumi.Output<string>;
/**
* Sets the time interval to run pg_partman's scheduled tasks.
*/
readonly engineConfigPgPgPartmanBgwInterval: pulumi.Output<number>;
/**
* Controls which role to use for pg_partman's scheduled background tasks.
*/
readonly engineConfigPgPgPartmanBgwRole: pulumi.Output<string>;
/**
* Enables or disables query plan monitoring.
*/
readonly engineConfigPgPgStatMonitorPgsmEnableQueryPlan: pulumi.Output<boolean>;
/**
* Sets the maximum number of buckets.
*/
readonly engineConfigPgPgStatMonitorPgsmMaxBuckets: pulumi.Output<number>;
/**
* Controls which statements are counted. Specify top to track top-level statements (those issued directly by clients), all to also track nested statements (such as statements invoked within functions), or none to disable statement statistics collection. The default value is top.
*/
readonly engineConfigPgPgStatStatementsTrack: pulumi.Output<string>;
/**
* Enable the pgStatMonitor extension. Enabling this extension will cause the cluster to be restarted. When this extension is enabled, pgStatStatements results for utility commands are unreliable. (default `false`)
*/
readonly engineConfigPgStatMonitorEnable: pulumi.Output<boolean>;
/**
* PostgreSQL temporary file limit in KiB, -1 for unlimited.
*/
readonly engineConfigPgTempFileLimit: pulumi.Output<number>;
/**
* PostgreSQL service timezone.
*/
readonly engineConfigPgTimezone: pulumi.Output<string>;
/**
* Specifies the number of bytes reserved to track the currently executing command for each active session.
*/
readonly engineConfigPgTrackActivityQuerySize: pulumi.Output<number>;
/**
* Record commit time of transactions.
*/
readonly engineConfigPgTrackCommitTimestamp: pulumi.Output<string>;
/**
* Enables tracking of function call counts and time used.
*/
readonly engineConfigPgTrackFunctions: pulumi.Output<string>;
/**
* Enables timing of database I/O calls. This parameter is off by default, because it will repeatedly query the operating system for the current time, which may cause significant overhead on some platforms.
*/
readonly engineConfigPgTrackIoTiming: pulumi.Output<string>;
/**
* Terminate replication connections that are inactive for longer than this amount of time, in milliseconds. Setting this value to zero disables the timeout.
*/
readonly engineConfigPgWalSenderTimeout: pulumi.Output<number>;
/**
* WAL flush interval in milliseconds. Note that setting this value to lower than the default 200ms may negatively impact performance.
*/
readonly engineConfigPgWalWriterDelay: pulumi.Output<number>;
/**
* Number of seconds of master unavailability before triggering database failover to standby. (default `60`)
*/
readonly engineConfigPglookoutMaxFailoverReplicationTimeLag: pulumi.Output<number>;
/**
* Percentage of total RAM that the database server uses for shared memory buffers. Valid range is 20-60 (float), which corresponds to 20% - 60%. This setting adjusts the sharedBuffers configuration value.
*/
readonly engineConfigSharedBuffersPercentage: pulumi.Output<number>;
/**
* Sets the maximum amount of memory to be used by a query operation (such as a sort or hash table) before writing to temporary disk files, in MB. Default is 1MB + 0.075% of total RAM (up to 32MB).
*/
readonly engineConfigWorkMem: pulumi.Output<number>;
/**
* The Managed Database engine in engine/version format. (e.g. `postgresql/16`)
*/
readonly engineId: pulumi.Output<string>;
/**
* The database timestamp from which it was restored.
*/
readonly forkRestoreTime: pulumi.Output<string>;
/**
* The ID of the database that was forked from.
*
* * `updates` - (Optional) Configuration settings for automated patch update maintenance for the Managed Database.
*/
readonly forkSource: pulumi.Output<number | undefined>;
/**
* The primary host for the Managed Database.
*/
readonly hostPrimary: pulumi.Output<string>;
/**
* The secondary/private host for the managed database.
*/
readonly hostSecondary: pulumi.Output<string>;
/**
* A unique, user-defined string referring to the Managed Database.
*/
readonly label: pulumi.Output<string>;
/**
* A mapping between IP addresses and strings designating them as primary or failover.
*/
readonly members: pulumi.Output<{
[key: string]: string;
}>;
/**
* The oldest time to which a database can be restored.
*/
readonly oldestRestoreTime: pulumi.Output<string>;
/**
* A set of pending updates.
*/
readonly pendingUpdates: pulumi.Output<outputs.DatabasePostgresqlV2PendingUpdate[]>;
/**
* The back-end platform for relational databases used by the service.
*/
readonly platform: pulumi.Output<string>;
/**
* The access port for this Managed Database.
*/
readonly port: pulumi.Output<number>;
/**
* The region to use for the Managed Database.
*/
readonly region: pulumi.Output<string>;
/**
* The randomly-generated root password for the Managed Database instance.
*/
readonly rootPassword: pulumi.Output<string>;
/**
* The root username for the Managed Database instance.
*/
readonly rootUsername: pulumi.Output<string>;
/**
* Whether to require SSL credentials to establish a connection to the Managed Database.
*/
readonly sslConnection: pulumi.Output<boolean>;
/**
* The operating status of the Managed Database.
*/
readonly status: pulumi.Output<string>;
/**
* Whether this Managed Database should be suspended.
*/
readonly suspended: pulumi.Output<boolean>;
readonly timeouts: pulumi.Output<outputs.DatabasePostgresqlV2Timeouts | undefined>;
/**
* The Linode Instance type used for the nodes of the Managed Database.
*
* - - -
*/
readonly type: pulumi.Output<string>;
/**
* When this Managed Database was last updated.
*/
readonly updated: pulumi.Output<string>;
/**
* Configuration settings for automated patch update maintenance for the Managed Database.
*/
readonly updates: pulumi.Output<outputs.DatabasePostgresqlV2Updates>;
/**
* The Managed Database engine version. (e.g. `13.2`)
*/
readonly version: pulumi.Output<string>;
/**
* Create a DatabasePostgresqlV2 resource with the given unique name, arguments, and options.
*
* @param name The _unique_ name of the resource.
* @param args The arguments to use to populate this resource's properties.
* @param opts A bag of options that control this resource's behavior.
*/
constructor(name: string, args: DatabasePostgresqlV2Args, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering DatabasePostgresqlV2 resources.
*/
export interface DatabasePostgresqlV2State {
/**
* A list of IP addresses that can access the Managed Database. Each item can be a single IP address or a range in CIDR format. Use `linode.DatabaseAccessControls` to manage your allow list separately.
*/
allowLists?: pulumi.Input<pulumi.Input<string>[]>;
/**
* The base64-encoded SSL CA certificate for the Managed Database.
*/
caCert?: pulumi.Input<string>;
/**
* The number of Linode Instance nodes deployed to the Managed Database. (default `1`)
*/
clusterSize?: pulumi.Input<number>;
/**
* When this Managed Database was created.
*/
created?: pulumi.Input<string>;
/**
* Whether the Managed Databases is encrypted.
*/
encrypted?: pulumi.Input<boolean>;
/**
* The Managed Database engine. (e.g. `postgresql`)
*/
engine?: pulumi.Input<string>;
/**
* Specifies a fraction of the table size to add to autovacuumAnalyzeThreshold when deciding whether to trigger an ANALYZE. The default is 0.2 (20% of table size)
*/
engineConfigPgAutovacuumAnalyzeScaleFactor?: pulumi.Input<number>;
/**
* Specifies the minimum number of inserted, updated or deleted tuples needed to trigger an ANALYZE in any one table. The default is 50 tuples.
*/
engineConfigPgAutovacuumAnalyzeThreshold?: pulumi.Input<number>;
/**
* Specifies the maximum number of autovacuum processes (other than the autovacuum launcher) that may be running at any one time. The default is three. This parameter can only be set at server start.
*/
engineConfigPgAutovacuumMaxWorkers?: pulumi.Input<number>;
/**
* Specifies the minimum delay between autovacuum runs on any given database. The delay is measured in seconds, and the default is one minute
*/
engineConfigPgAutovacuumNaptime?: pulumi.Input<number>;
/**
* Specifies the cost delay value that will be used in automatic VACUUM operations. If -1 is specified, the regular vacuumCostDelay value will be used. The default value is 20 milliseconds
*/
engineConfigPgAutovacuumVacuumCostDelay?: pulumi.Input<number>;
/**
* Specifies the cost limit value that will be used in automatic VACUUM operations. If -1 is specified (which is the default), the regular vacuumCostLimit value will be used.
*/
engineConfigPgAutovacuumVacuumCostLimit?: pulumi.Input<number>;
/**
* Specifies a fraction of the table size to add to autovacuumVacuumThreshold when deciding whether to trigger a VACUUM. The default is 0.2 (20% of table size)
*/
engineConfigPgAutovacuumVacuumScaleFactor?: pulumi.Input<number>;
/**
* Specifies the minimum number of updated or deleted tuples needed to trigger a VACUUM in any one table. The default is 50 tuples.
*/
engineConfigPgAutovacuumVacuumThreshold?: pulumi.Input<number>;
/**
* Specifies the delay between activity rounds for the background writer in milliseconds. Default is 200.
*/
engineConfigPgBgwriterDelay?: pulumi.Input<number>;
/**
* Whenever more than bgwriterFlushAfter bytes have been written by the background writer, attempt to force the OS to issue these writes to the underlying storage. Specified in kilobytes, default is 512. Setting of 0 disables forced writeback.
*/
engineConfigPgBgwriterFlushAfter?: pulumi.Input<number>;
/**
* In each round, no more than this many buffers will be written by the background writer. Setting this to zero disables background writing. Default is 100.
*/
engineConfigPgBgwriterLruMaxpages?: pulumi.Input<number>;
/**
* The average recent need for new buffers is multiplied by bgwriterLruMultiplier to arrive at an estimate of the number that will be needed during the next round, (up to bgwriter_lru_maxpages). 1.0 represents a “just in time” policy of writing exactly the number of buffers predicted to be needed. Larger values provide some cushion against spikes in demand, while smaller values intentionally leave writes to be done by server processes. The default is 2.0.
*/
engineConfigPgBgwriterLruMultiplier?: pulumi.Input<number>;
/**
* This is the amount of time, in milliseconds, to wait on a lock before checking to see if there is a deadlock condition.
*/
engineConfigPgDeadlockTimeout?: pulumi.Input<number>;
/**
* Specifies the default TOAST compression method for values of compressible columns (the default is lz4).
*/
engineConfigPgDefaultToastCompression?: pulumi.Input<string>;
/**
* Time out sessions with open transactions after this number of milliseconds.
*/
engineConfigPgIdleInTransactionSessionTimeout?: pulumi.Input<number>;
/**
* Controls system-wide use of Just-in-Time Compilation (JIT).
*/
engineConfigPgJit?: pulumi.Input<boolean>;
/**
* PostgreSQL maximum number of files that can be open per process.
*/
engineConfigPgMaxFilesPerProcess?: pulumi.Input<number>;
/**
* PostgreSQL maximum locks per transaction.
*/
engineConfigPgMaxLocksPerTransaction?: pulumi.Input<number>;
/**
* PostgreSQL maximum logical replication workers (taken from the pool of max_parallel_workers).
*/
engineConfigPgMaxLogicalReplicationWorkers?: pulumi.Input<number>;
/**
* Sets the maximum number of workers that the system can support for parallel queries.
*/
engineConfigPgMaxParallelWorkers?: pulumi.Input<number>;
/**
* Sets the maximum number of workers that can be started by a single Gather or Gather Merge node.
*/
engineConfigPgMaxParallelWorkersPerGather?: pulumi.Input<number>;
/**
* PostgreSQL maximum predicate locks per transaction.
*/
engineConfigPgMaxPredLocksPerTransaction?: pulumi.Input<number>;
/**
* PostgreSQL maximum replication slots.
*/
engineConfigPgMaxReplicationSlots?: pulumi.Input<number>;
/**
* PostgreSQL maximum WAL size (MB) reserved for replication slots. Default is -1 (unlimited). walKeepSize minimum WAL size setting takes precedence over this.
*/
engineConfigPgMaxSlotWalKeepSize?: pulumi.Input<number>;
/**
* Maximum depth of the stack in bytes.
*/
engineConfigPgMaxStackDepth?: pulumi.Input<number>;
/**
* Max standby archive delay in milliseconds.
*/
engineConfigPgMaxStandbyArchiveDelay?: pulumi.Input<number>;
/**
* Max standby streaming delay in milliseconds.
*/
engineConfigPgMaxStandbyStreamingDelay?: pulumi.Input<number>;
/**
* PostgreSQL maximum WAL senders.
*/
engineConfigPgMaxWalSenders?: pulumi.Input<number>;
/**
* Sets the maximum number of background processes that the system can support.
*/
engineConfigPgMaxWorkerProcesses?: pulumi.Input<number>;
/**
* Chooses the algorithm for encrypting passwords. (default `md5`)
*/
engineConfigPgPasswordEncryption?: pulumi.Input<string>;
/**
* Sets the time interval to run pg_partman's scheduled tasks.
*/
engineConfigPgPgPartmanBgwInterval?: pulumi.Input<number>;
/**
* Controls which role to use for pg_partman's scheduled background tasks.
*/
engineConfigPgPgPartmanBgwRole?: pulumi.Input<string>;
/**
* Enables or disables query plan monitoring.
*/
engineConfigPgPgStatMonitorPgsmEnableQueryPlan?: pulumi.Input<boolean>;
/**
* Sets the maximum number of buckets.
*/
engineConfigPgPgStatMonitorPgsmMaxBuckets?: pulumi.Input<number>;
/**
* Controls which statements are counted. Specify top to track top-level statements (those issued directly by clients), all to also track nested statements (such as statements invoked within functions), or none to disable statement statistics collection. The default value is top.
*/
engineConfigPgPgStatStatementsTrack?: pulumi.Input<string>;
/**
* Enable the pgStatMonitor extension. Enabling this extension will cause the cluster to be restarted. When this extension is enabled, pgStatStatements results for utility commands are unreliable. (default `false`)
*/
engineConfigPgStatMonitorEnable?: pulumi.Input<boolean>;
/**
* PostgreSQL temporary file limit in KiB, -1 for unlimited.
*/
engineConfigPgTempFileLimit?: pulumi.Input<number>;
/**
* PostgreSQL service timezone.
*/
engineConfigPgTimezone?: pulumi.Input<string>;
/**
* Specifies the number of bytes reserved to track the currently executing command for each active session.
*/
engineConfigPgTrackActivityQuerySize?: pulumi.Input<number>;
/**
* Record commit time of transactions.
*/
engineConfigPgTrackCommitTimestamp?: pulumi.Input<string>;
/**
* Enables tracking of function call counts and time used.
*/
engineConfigPgTrackFunctions?: pulumi.Input<string>;
/**
* Enables timing of database I/O calls. This parameter is off by default, because it will repeatedly query the operating system for the current time, which may cause significant overhead on some platforms.
*/
engineConfigPgTrackIoTiming?: pulumi.Input<string>;
/**
* Terminate replication connections that are inactive for longer than this amount of time, in milliseconds. Setting this value to zero disables the timeout.
*/
engineConfigPgWalSenderTimeout?: pulumi.Input<number>;
/**
* WAL flush interval in milliseconds. Note that setting this value to lower than the default 200ms may negatively impact performance.
*/
engineConfigPgWalWriterDelay?: pulumi.Input<number>;
/**
* Number of seconds of master unavailability before triggering database failover to standby. (default `60`)
*/
engineConfigPglookoutMaxFailoverReplicationTimeLag?: pulumi.Input<number>;
/**
* Percentage of total RAM that the database server uses for shared memory buffers. Valid range is 20-60 (float), which corresponds to 20% - 60%. This setting adjusts the sharedBuffers configuration value.
*/
engineConfigSharedBuffersPercentage?: pulumi.Input<number>;
/**
* Sets the maximum amount of memory to be used by a query operation (such as a sort or hash table) before writing to temporary disk files, in MB. Default is 1MB + 0.075% of total RAM (up to 32MB).
*/
engineConfigWorkMem?: pulumi.Input<number>;
/**
* The Managed Database engine in engine/version format. (e.g. `postgresql/16`)
*/
engineId?: pulumi.Input<string>;
/**
* The database timestamp from which it was restored.
*/
forkRestoreTime?: pulumi.Input<string>;
/**
* The ID of the database that was forked from.
*
* * `updates` - (Optional) Configuration settings for automated patch update maintenance for the Managed Database.
*/
forkSource?: pulumi.Input<number>;
/**
* The primary host for the Managed Database.
*/
hostPrimary?: pulumi.Input<string>;
/**
* The secondary/private host for the managed database.
*/
hostSecondary?: pulumi.Input<string>;
/**
* A unique, user-defined string referring to the Managed Database.
*/
label?: pulumi.Input<string>;
/**
* A mapping between IP addresses and strings designating them as primary or failover.
*/
members?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
/**
* The oldest time to which a database can be restored.
*/
oldestRestoreTime?: pulumi.Input<string>;
/**
* A set of pending updates.
*/
pendingUpdates?: pulumi.Input<pulumi.Input<inputs.DatabasePostgresqlV2PendingUpdate>[]>;
/**
* The back-end platform for relational databases used by the service.
*/
platform?: pulumi.Input<string>;
/**
* The access port for this Managed Database.
*/
port?: pulumi.Input<number>;
/**
* The region to use for the Managed Database.
*/
region?: pulumi.Input<string>;
/**
* The randomly-generated root password for the Managed Database instance.
*/
rootPassword?: pulumi.Input<string>;
/**
* The root username for the Managed Database instance.
*/
rootUsername?: pulumi.Input<string>;
/**
* Whether to require SSL credentials to establish a connection to the Managed Database.
*/
sslConnection?: pulumi.Input<boolean>;
/**
* The operating status of the Managed Database.
*/
status?: pulumi.Input<string>;
/**
* Whether this Managed Database should be suspended.
*/
suspended?: pulumi.Input<boolean>;
timeouts?: pulumi.Input<inputs.DatabasePostgresqlV2Timeouts>;
/**
* The Linode Instance type used for the nodes of the Managed Database.
*
* - - -
*/
type?: pulumi.Input<string>;
/**
* When this Managed Database was last updated.
*/
updated?: pulumi.Input<string>;
/**
* Configuration settings for automated patch update maintenance for the Managed Database.
*/
updates?: pulumi.Input<inputs.DatabasePostgresqlV2Updates>;
/**
* The Managed Database engine version. (e.g. `13.2`)
*/
version?: pulumi.Input<string>;
}
/**
* The set of arguments for constructing a DatabasePostgresqlV2 resource.
*/
export interface DatabasePostgresqlV2Args {
/**
* A list of IP addresses that can access the Managed Database. Each item can be a single IP address or a range in CIDR format. Use `linode.DatabaseAccessControls` to manage your allow list separately.
*/
allowLists?: pulumi.Input<pulumi.Input<string>[]>;
/**
* The number of Linode Instance nodes deployed to the Managed Database. (default `1`)
*/
clusterSize?: pulumi.Input<number>;
/**
* Specifies a fraction of the table size to add to autovacuumAnalyzeThreshold when deciding whether to trigger an ANALYZE. The default is 0.2 (20% of table size)
*/
engineConfigPgAutovacuumAnalyzeScaleFactor?: pulumi.Input<number>;
/**
* Specifies the minimum number of inserted, updated or deleted tuples needed to trigger an ANALYZE in any one table. The default is 50 tuples.
*/
engineConfigPgAutovacuumAnalyzeThreshold?: pulumi.Input<number>;
/**
* Specifies the maximum number of autovacuum processes (other than the autovacuum launcher) that may be running at any one time. The default is three. This parameter can only be set at server start.
*/
engineConfigPgAutovacuumMaxWorkers?: pulumi.Input<number>;
/**
* Specifies the minimum delay between autovacuum runs on any given database. The delay is measured in seconds, and the default is one minute
*/
engineConfigPgAutovacuumNaptime?: pulumi.Input<number>;
/**
* Specifies the cost delay value that will be used in automatic VACUUM operations. If -1 is specified, the regular vacuumCostDelay value will be used. The default value is 20 milliseconds
*/
engineConfigPgAutovacuumVacuumCostDelay?: pulumi.Input<number>;
/**
* Specifies the cost limit value that will be used in automatic VACUUM operations. If -1 is specified (which is the default), the regular vacuumCostLimit value will be used.
*/
engineConfigPgAutovacuumVacuumCostLimit?: pulumi.Input<number>;
/**
* Specifies a fraction of the table size to add to autovacuumVacuumThreshold when deciding whether to trigger a VACUUM. The default is 0.2 (20% of table size)
*/
engineConfigPgAutovacuumVacuumScaleFactor?: pulumi.Input<number>;
/**
* Specifies the minimum number of updated or deleted tuples needed to trigger a VACUUM in any one table. The default is 50 tuples.
*/
engineConfigPgAutovacuumVacuumThreshold?: pulumi.Input<number>;
/**
* Specifies the delay between activity rounds for the background writer in milliseconds. Default is 200.
*/
engineConfigPgBgwriterDelay?: pulumi.Input<number>;
/**
* Whenever more than bgwriterFlushAfter bytes have been written by the background writer, attempt to force the OS to issue these writes to the underlying storage. Specified in kilobytes, default is 512. Setting of 0 disables forced writeback.
*/
engineConfigPgBgwriterFlushAfter?: pulumi.Input<number>;
/**
* In each round, no more than this many buffers will be written by the background writer. Setting this to zero disables background writing. Default is 100.
*/
engineConfigPgBgwriterLruMaxpages?: pulumi.Input<number>;
/**
* The average recent need for new buffers is multiplied by bgwriterLruMultiplier to arrive at an estimate of the number that will be needed during the next round, (up to bgwriter_lru_maxpages). 1.0 represents a “just in time” policy of writing exactly the number of buffers predicted to be needed. Larger values provide some cushion against spikes in demand, while smaller values intentionally leave writes to be done by server processes. The default is 2.0.
*/
engineConfigPgBgwriterLruMultiplier?: pulumi.Input<number>;
/**
* This is the amount of time, in milliseconds, to wait on a lock before checking to see if there is a deadlock condition.
*/
engineConfigPgDeadlockTimeout?: pulumi.Input<number>;
/**
* Specifies the default TOAST compression method for values of compressible columns (the default is lz4).
*/
engineConfigPgDefaultToastCompression?: pulumi.Input<string>;
/**
* Time out sessions with open transactions after this number of milliseconds.
*/
engineConfigPgIdleInTransactionSessionTimeout?: pulumi.Input<number>;
/**
* Controls system-wide use of Just-in-Time Compilation (JIT).
*/
engineConfigPgJit?: pulumi.Input<boolean>;
/**
* PostgreSQL maximum number of files that can be open per process.
*/
engineConfigPgMaxFilesPerProcess?: pulumi.Input<number>;
/**
* PostgreSQL maximum locks per transaction.
*/
engineConfigPgMaxLocksPerTransaction?: pulumi.Input<number>;
/**
* PostgreSQL maximum logical replication workers (taken from the pool of max_parallel_workers).
*/
engineConfigPgMaxLogicalReplicationWorkers?: pulumi.Input<number>;
/**
* Sets the maximum number of workers that the system can support for parallel queries.
*/
engineConfigPgMaxParallelWorkers?: pulumi.Input<number>;
/**
* Sets the maximum number of workers that can be started by a single Gather or Gather Merge node.
*/
engineConfigPgMaxParallelWorkersPerGather?: pulumi.Input<number>;
/**
* PostgreSQL maximum predicate locks per transaction.
*/
engineConfigPgMaxPredLocksPerTransaction?: pulumi.Input<number>;
/**
* PostgreSQL maximum replication slots.
*/
engineConfigPgMaxReplicationSlots?: pulumi.Input<number>;
/**
* PostgreSQL maximum WAL size (MB) reserved for replication slots. Default is -1 (unlimited). walKeepSize minimum WAL size setting takes precedence over this.
*/
engineConfigPgMaxSlotWalKeepSize?: pulumi.Input<number>;
/**
* Maximum depth of the stack in bytes.
*/
engineConfigPgMaxStackDepth?: pulumi.Input<number>;
/**
* Max standby archive delay in milliseconds.
*/
engineConfigPgMaxStandbyArchiveDelay?: pulumi.Input<number>;
/**
* Max standby streaming delay in milliseconds.
*/
engineConfigPgMaxStandbyStreamingDelay?: pulumi.Input<number>;
/**
* PostgreSQL maximum WAL senders.
*/
engineConfigPgMaxWalSenders?: pulumi.Input<number>;
/**
* Sets the maximum number of background processes that the system can support.
*/
engineConfigPgMaxWorkerProcesses?: pulumi.Input<number>;
/**
* Chooses the algorithm for encrypting passwords. (default `md5`)
*/
engineConfigPgPasswordEncryption?: pulumi.Input<string>;
/**
* Sets the time interval to run pg_partman's scheduled tasks.
*/
engineConfigPgPgPartmanBgwInterval?: pulumi.Input<number>;
/**
* Controls which role to use for pg_partman's scheduled background tasks.
*/
engineConfigPgPgPartmanBgwRole?: pulumi.Input<string>;
/**
* Enables or disables query plan monitoring.
*/
engineConfigPgPgStatMonitorPgsmEnableQueryPlan?: pulumi.Input<boolean>;
/**
* Sets the maximum number of buckets.
*/
engineConfigPgPgStatMonitorPgsmMaxBuckets?: pulumi.Input<number>;
/**
* Controls which statements are counted. Specify top to track top-level statements (those issued directly by clients), all to also track nested statements (such as statements invoked within functions), or none to disable statement statistics collection. The default value is top.
*/
engineConfigPgPgStatStatementsTrack?: pulumi.Input<string>;
/**
* Enable the pgStatMonitor extension. Enabling this extension will cause the cluster to be restarted. When this extension is enabled, pgStatStatements results for utility commands are unreliable. (default `false`)
*/
engineConfigPgStatMonitorEnable?: pulumi.Input<boolean>;
/**
* PostgreSQL temporary file limit in KiB, -1 for unlimited.
*/
engineConfigPgTempFileLimit?: pulumi.Input<number>;
/**
* PostgreSQL service timezone.
*/
engineConfigPgTimezone?: pulumi.Input<string>;
/**
* Specifies the number of bytes reserved to track the currently executing command for each active session.
*/
engineConfigPgTrackActivityQuerySize?: pulumi.Input<number>;
/**
* Record commit time of transactions.
*/
engineConfigPgTrackCommitTimestamp?: pulumi.Input<string>;
/**
* Enables tracking of function call counts and time used.
*/
engineConfigPgTrackFunctions?: pulumi.Input<string>;
/**
* Enables timing of database I/O calls. This parameter is off by default, because it will repeatedly query the operating system for the current time, which may cause significant overhead on some platforms.
*/
engineConfigPgTrackIoTiming?: pulumi.Input<string>;
/**
* Terminate replication connections that are inactive for longer than this amount of time, in milliseconds. Setting this value to zero disables the timeout.
*/
engineConfigPgWalSenderTimeout?: pulumi.Input<number>;
/**
* WAL flush interval in milliseconds. Note that setting this value to lower than the default 200ms may negatively impact performance.
*/
engineConfigPgWalWriterDelay?: pulumi.Input<number>;
/**
* Number of seconds of master unavailability before triggering database failover to standby. (default `60`)
*/
engineConfigPglookoutMaxFailoverReplicationTimeLag?: pulumi.Input<number>;
/**
* Percentage of total RAM that the database server uses for shared memory buffers. Valid range is 20-60 (float), which corresponds to 20% - 60%. This setting adjusts the sharedBuffers configuration value.
*/
engineConfigSharedBuffersPercentage?: pulumi.Input<number>;
/**
* Sets the maximum amount of memory to be used by a query operation (such as a sort or hash table) before writing to temporary disk files, in MB. Default is 1MB + 0.075% of total RAM (up to 32MB).
*/
engineConfigWorkMem?: pulumi.Input<number>;
/**
* The Managed Database engine in engine/version format. (e.g. `postgresql/16`)
*/
engineId: pulumi.Input<string>;
/**
* The database timestamp from which it was restored.
*/
forkRestoreTime?: pulumi.Input<string>;
/**
* The ID of the database that was forked from.
*
* * `updates` - (Optional) Configuration settings for automated patch update maintenance for the Managed Database.
*/
forkSource?: pulumi.Input<number>;
/**
* A unique, user-defined string referring to the Managed Database.
*/
label: pulumi.Input<string>;
/**
* The region to use for the Managed Database.
*/
region: pulumi.Input<string>;
/**
* Whether this Managed Database should be suspended.
*/
suspended?: pulumi.Input<boolean>;
timeouts?: pulumi.Input<inputs.DatabasePostgresqlV2Timeouts>;
/**
* The Linode Instance type used for the nodes of the Managed Database.
*
* - - -
*/
type: pulumi.Input<string>;
/**
* Configuration settings for automated patch update maintenance for the Managed Database.
*/
updates?: pulumi.Input<inputs.DatabasePostgresqlV2Updates>;
}