import * as pulumi from "@pulumi/pulumi"; import * as inputs from "./types/input"; import * as outputs from "./types/output"; /** * > **DEPRECATION NOTICE:** This resource has been deprecated. Please use linode.DatabasePostgresqlV2 for all future implementations. * * 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 an hour to provision. * * ## Example Usage * * Creating a simple PostgreSQL database instance: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as linode from "@pulumi/linode"; * * const foobar = new linode.DatabasePostgresql("foobar", { * label: "mydatabase", * engineId: "postgresql/13.2", * region: "us-southeast", * type: "g6-nanode-1", * }); * ``` * * Creating a complex PostgreSQL database instance: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as linode from "@pulumi/linode"; * * const foobar = new linode.DatabasePostgresql("foobar", { * label: "mydatabase", * engineId: "postgresql/13.2", * region: "us-southeast", * type: "g6-nanode-1", * allowLists: ["0.0.0.0/0"], * clusterSize: 3, * encrypted: true, * replicationType: "semi_synch", * replicationCommitType: "remote_write", * sslConnection: true, * updates: { * dayOfWeek: "saturday", * duration: 1, * frequency: "monthly", * hourOfDay: 22, * weekOfMonth: 2, * }, * }); * ``` * * ## updates * * The following arguments are supported in the `updates` specification block: * * * `dayOfWeek` - (Required) The day to perform maintenance. (`monday`, `tuesday`, ...) * * * `duration` - (Required) The maximum maintenance window time in hours. (`1`..`3`) * * * `frequency` - (Required) Whether maintenance occurs on a weekly or monthly basis. (`weekly`, `monthly`) * * * `hourOfDay` - (Required) The hour to begin maintenance based in UTC time. (`0`..`23`) * * * `weekOfMonth` - (Optional) The week of the month to perform monthly frequency updates. Required for `monthly` frequency updates. (`1`..`4`) * * ## Import * * Linode PostgreSQL Databases can be imported using the `id`, e.g. * * ```sh * $ pulumi import linode:index/databasePostgresql:DatabasePostgresql foobar 1234567 * ``` */ export declare class DatabasePostgresql extends pulumi.CustomResource { /** * Get an existing DatabasePostgresql 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, state?: DatabasePostgresqlState, opts?: pulumi.CustomResourceOptions): DatabasePostgresql; /** * Returns true if the given object is an instance of DatabasePostgresql. 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 DatabasePostgresql; /** * 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; /** * The base64-encoded SSL CA certificate for the Managed Database instance. */ readonly caCert: pulumi.Output; /** * The number of Linode Instance nodes deployed to the Managed Database. (default `1`) */ readonly clusterSize: pulumi.Output; /** * When this Managed Database was created. */ readonly created: pulumi.Output; /** * Whether the Managed Databases is encrypted. (default `false`) */ readonly encrypted: pulumi.Output; /** * The Managed Database engine. (e.g. `postgresql`) */ readonly engine: pulumi.Output; /** * The Managed Database engine in engine/version format. (e.g. `postgresql/13.2`) */ readonly engineId: pulumi.Output; /** * The primary host for the Managed Database. */ readonly hostPrimary: pulumi.Output; /** * The secondary/private network host for the Managed Database. */ readonly hostSecondary: pulumi.Output; /** * A unique, user-defined string referring to the Managed Database. */ readonly label: pulumi.Output; /** * The access port for this Managed Database. */ readonly port: pulumi.Output; /** * The region to use for the Managed Database. */ readonly region: pulumi.Output; /** * The synchronization level of the replicating server. (`on`, `local`, `remoteWrite`, `remoteApply`, `off`; default `off`) * * * Must be `local` or `off` for the `asynch` replication type. * * * Must be `on`, `remoteWrite`, or `remoteApply` for the `semiSynch` replication type. */ readonly replicationCommitType: pulumi.Output; /** * The replication method used for the Managed Database. (`none`, `asynch`, `semiSynch`; default `none`) * * * Must be `none` for a single node cluster. * * * Must be `asynch` or `semiSynch` for a high availability cluster. */ readonly replicationType: pulumi.Output; /** * The randomly-generated root password for the Managed Database instance. */ readonly rootPassword: pulumi.Output; /** * The root username for the Managed Database instance. */ readonly rootUsername: pulumi.Output; /** * Whether to require SSL credentials to establish a connection to the Managed Database. (default `false`) * * * `updates` - (Optional) Configuration settings for automated patch update maintenance for the Managed Database. */ readonly sslConnection: pulumi.Output; /** * The operating status of the Managed Database. */ readonly status: pulumi.Output; /** * The Linode Instance type used for the nodes of the Managed Database instance. * * - - - */ readonly type: pulumi.Output; /** * When this Managed Database was last updated. */ readonly updated: pulumi.Output; /** * Configuration settings for automated patch update maintenance for the Managed Database. */ readonly updates: pulumi.Output; /** * The Managed Database engine version. (e.g. `13.2`) */ readonly version: pulumi.Output; /** * Create a DatabasePostgresql 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: DatabasePostgresqlArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering DatabasePostgresql resources. */ export interface DatabasePostgresqlState { /** * 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[]>; /** * The base64-encoded SSL CA certificate for the Managed Database instance. */ caCert?: pulumi.Input; /** * The number of Linode Instance nodes deployed to the Managed Database. (default `1`) */ clusterSize?: pulumi.Input; /** * When this Managed Database was created. */ created?: pulumi.Input; /** * Whether the Managed Databases is encrypted. (default `false`) */ encrypted?: pulumi.Input; /** * The Managed Database engine. (e.g. `postgresql`) */ engine?: pulumi.Input; /** * The Managed Database engine in engine/version format. (e.g. `postgresql/13.2`) */ engineId?: pulumi.Input; /** * The primary host for the Managed Database. */ hostPrimary?: pulumi.Input; /** * The secondary/private network host for the Managed Database. */ hostSecondary?: pulumi.Input; /** * A unique, user-defined string referring to the Managed Database. */ label?: pulumi.Input; /** * The access port for this Managed Database. */ port?: pulumi.Input; /** * The region to use for the Managed Database. */ region?: pulumi.Input; /** * The synchronization level of the replicating server. (`on`, `local`, `remoteWrite`, `remoteApply`, `off`; default `off`) * * * Must be `local` or `off` for the `asynch` replication type. * * * Must be `on`, `remoteWrite`, or `remoteApply` for the `semiSynch` replication type. */ replicationCommitType?: pulumi.Input; /** * The replication method used for the Managed Database. (`none`, `asynch`, `semiSynch`; default `none`) * * * Must be `none` for a single node cluster. * * * Must be `asynch` or `semiSynch` for a high availability cluster. */ replicationType?: pulumi.Input; /** * The randomly-generated root password for the Managed Database instance. */ rootPassword?: pulumi.Input; /** * The root username for the Managed Database instance. */ rootUsername?: pulumi.Input; /** * Whether to require SSL credentials to establish a connection to the Managed Database. (default `false`) * * * `updates` - (Optional) Configuration settings for automated patch update maintenance for the Managed Database. */ sslConnection?: pulumi.Input; /** * The operating status of the Managed Database. */ status?: pulumi.Input; /** * The Linode Instance type used for the nodes of the Managed Database instance. * * - - - */ type?: pulumi.Input; /** * When this Managed Database was last updated. */ updated?: pulumi.Input; /** * Configuration settings for automated patch update maintenance for the Managed Database. */ updates?: pulumi.Input; /** * The Managed Database engine version. (e.g. `13.2`) */ version?: pulumi.Input; } /** * The set of arguments for constructing a DatabasePostgresql resource. */ export interface DatabasePostgresqlArgs { /** * 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[]>; /** * The number of Linode Instance nodes deployed to the Managed Database. (default `1`) */ clusterSize?: pulumi.Input; /** * Whether the Managed Databases is encrypted. (default `false`) */ encrypted?: pulumi.Input; /** * The Managed Database engine in engine/version format. (e.g. `postgresql/13.2`) */ engineId: pulumi.Input; /** * A unique, user-defined string referring to the Managed Database. */ label: pulumi.Input; /** * The region to use for the Managed Database. */ region: pulumi.Input; /** * The synchronization level of the replicating server. (`on`, `local`, `remoteWrite`, `remoteApply`, `off`; default `off`) * * * Must be `local` or `off` for the `asynch` replication type. * * * Must be `on`, `remoteWrite`, or `remoteApply` for the `semiSynch` replication type. */ replicationCommitType?: pulumi.Input; /** * The replication method used for the Managed Database. (`none`, `asynch`, `semiSynch`; default `none`) * * * Must be `none` for a single node cluster. * * * Must be `asynch` or `semiSynch` for a high availability cluster. */ replicationType?: pulumi.Input; /** * Whether to require SSL credentials to establish a connection to the Managed Database. (default `false`) * * * `updates` - (Optional) Configuration settings for automated patch update maintenance for the Managed Database. */ sslConnection?: pulumi.Input; /** * The Linode Instance type used for the nodes of the Managed Database instance. * * - - - */ type: pulumi.Input; /** * Configuration settings for automated patch update maintenance for the Managed Database. */ updates?: pulumi.Input; }