import * as pulumi from "@pulumi/pulumi"; import * as inputs from "./types/input"; import * as outputs from "./types/output"; /** * Creates and manages Scaleway Redis™ clusters. * For more information, see the [API documentation](https://www.scaleway.com/en/developers/api/managed-database-redis). * * > **Security Best Practice:** * For enhanced security, we recommend using the `passwordWo` write-only argument instead of the regular `password` argument. This ensures your sensitive credentials are never stored in Terraform state files, providing superior protection against accidental exposure. Write-Only arguments are supported in Terraform 1.11.0 and later. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as scaleway from "@pulumiverse/scaleway"; * * //## Basic Redis cluster creation * const main = new scaleway.redis.Cluster("main", { * name: "test_redis_basic", * version: "6.2.7", * nodeType: "RED1-MICRO", * userName: "my_initial_user", * password: "thiZ_is_v&ry_s3cret", * tags: [ * "test", * "redis", * ], * clusterSize: 1, * tlsEnabled: true, * acls: [{ * ip: "0.0.0.0/0", * description: "Allow all", * }], * }); * ``` * * ## Import * * Redis™ cluster can be imported using the `{zone}/{id}`, e.g. * * ```sh * $ pulumi import scaleway:index/redisCluster:RedisCluster main fr-par-1/11111111-1111-1111-1111-111111111111 * ``` * * @deprecated scaleway.index/rediscluster.RedisCluster has been deprecated in favor of scaleway.redis/cluster.Cluster */ export declare class RedisCluster extends pulumi.CustomResource { /** * Get an existing RedisCluster 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?: RedisClusterState, opts?: pulumi.CustomResourceOptions): RedisCluster; /** * Returns true if the given object is an instance of RedisCluster. 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 RedisCluster; /** * List of acl rules, this is cluster's authorized IPs. More details on the ACL section. */ readonly acls: pulumi.Output; /** * The PEM of the certificate used by redis, only when `tlsEnabled` is true */ readonly certificate: pulumi.Output; /** * The number of nodes in the Redis™ cluster. * * > **Important:** * * - Cluster_size = 1 for Standalone mode (single node). * * - Cluster_size = 2 for High Availability (HA) mode, with 1 main node and 1 standby node. * * - Cluster_size >= 3 for Cluster mode, which requires a minimum of 1 main node and 2 secondary nodes. * * > **Important:** If you are using the cluster mode (>=3 nodes), you can set a bigger `clusterSize` than you initially * did, it will migrate the Redis™ cluster but keep in mind that you cannot downgrade a Redis™ cluster, so setting a smaller * `clusterSize` will destroy and recreate your cluster. * * > **Important:** If you are using the Standalone mode (1 node), setting a bigger `clusterSize` will destroy and * recreate your cluster as you will be switching to the cluster mode. */ readonly clusterSize: pulumi.Output; /** * Redis connection URI for the first reachable endpoint (public is preferred over private). Uses scheme `rediss` when TLS is enabled. Database index is always `0`. When a password is available in state, userinfo includes `userName` and the password (Redis ACL). When `passwordWo` is used, the password is omitted because it is not stored in state. */ readonly connectionString: pulumi.Output; /** * The date and time of creation of the Redis™ cluster. */ readonly createdAt: pulumi.Output; /** * The name of the Redis™ cluster. */ readonly name: pulumi.Output; /** * The type of Redis™ cluster you want to create (e.g. `RED1-M`). * * > **Important:** Updates to `nodeType` will migrate the Redis™ cluster to the desired `nodeType`. Keep in mind that * you cannot downgrade a Redis™ cluster. */ readonly nodeType: pulumi.Output; /** * Password for the first user of the Redis™ cluster. Only one of `password` or `passwordWo` should be specified. */ readonly password: pulumi.Output; /** * **NOTE:** This field is write-only and its value will not be updated in state as part of read operations. * Password for the first user of the Redis™ cluster in write-only mode. Only one of `password` or `passwordWo` should be specified. `passwordWo` will not be set in the Terraform state. To update the `passwordWo`, you must also update the `passwordWoVersion`. */ readonly passwordWo: pulumi.Output; /** * The version of the write-only password. To update the `passwordWo`, you must also update the `passwordWoVersion`. */ readonly passwordWoVersion: pulumi.Output; /** * The list of private IPv4 addresses associated with the resource. */ readonly privateIps: pulumi.Output; /** * Describes the Private Network you want to connect to your cluster. If not set, a public * network will be provided. More details on the Private Network section */ readonly privateNetworks: pulumi.Output; /** * `projectId`) The ID of the project the Redis™ cluster is * associated with. */ readonly projectId: pulumi.Output; /** * (Optional) Public network details. Only one of `privateNetwork` and `publicNetwork` may be set. The `publicNetwork` block exports: */ readonly publicNetwork: pulumi.Output; /** * Map of settings for Redis™ cluster. Available settings can be found by listing Redis™ versions * with scaleway API or CLI */ readonly settings: pulumi.Output<{ [key: string]: string; } | undefined>; /** * The tags associated with the Redis™ cluster. */ readonly tags: pulumi.Output; /** * Whether TLS is enabled or not. * * > The changes on `tlsEnabled` will force the resource creation. */ readonly tlsEnabled: pulumi.Output; /** * The date and time of the last update of the Redis™ cluster. */ readonly updatedAt: pulumi.Output; /** * Identifier for the first user of the Redis™ cluster. */ readonly userName: pulumi.Output; /** * Redis™ cluster's version (e.g. `6.2.7`). * * > **Important:** Updates to `version` will migrate the Redis™ cluster to the desired `version`. Keep in mind that you * cannot downgrade a Redis™ cluster. */ readonly version: pulumi.Output; /** * `zone`) The zone in which the * Redis™ cluster should be created. */ readonly zone: pulumi.Output; /** * Create a RedisCluster 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. */ /** @deprecated scaleway.index/rediscluster.RedisCluster has been deprecated in favor of scaleway.redis/cluster.Cluster */ constructor(name: string, args: RedisClusterArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering RedisCluster resources. */ export interface RedisClusterState { /** * List of acl rules, this is cluster's authorized IPs. More details on the ACL section. */ acls?: pulumi.Input[] | undefined>; /** * The PEM of the certificate used by redis, only when `tlsEnabled` is true */ certificate?: pulumi.Input; /** * The number of nodes in the Redis™ cluster. * * > **Important:** * * - Cluster_size = 1 for Standalone mode (single node). * * - Cluster_size = 2 for High Availability (HA) mode, with 1 main node and 1 standby node. * * - Cluster_size >= 3 for Cluster mode, which requires a minimum of 1 main node and 2 secondary nodes. * * > **Important:** If you are using the cluster mode (>=3 nodes), you can set a bigger `clusterSize` than you initially * did, it will migrate the Redis™ cluster but keep in mind that you cannot downgrade a Redis™ cluster, so setting a smaller * `clusterSize` will destroy and recreate your cluster. * * > **Important:** If you are using the Standalone mode (1 node), setting a bigger `clusterSize` will destroy and * recreate your cluster as you will be switching to the cluster mode. */ clusterSize?: pulumi.Input; /** * Redis connection URI for the first reachable endpoint (public is preferred over private). Uses scheme `rediss` when TLS is enabled. Database index is always `0`. When a password is available in state, userinfo includes `userName` and the password (Redis ACL). When `passwordWo` is used, the password is omitted because it is not stored in state. */ connectionString?: pulumi.Input; /** * The date and time of creation of the Redis™ cluster. */ createdAt?: pulumi.Input; /** * The name of the Redis™ cluster. */ name?: pulumi.Input; /** * The type of Redis™ cluster you want to create (e.g. `RED1-M`). * * > **Important:** Updates to `nodeType` will migrate the Redis™ cluster to the desired `nodeType`. Keep in mind that * you cannot downgrade a Redis™ cluster. */ nodeType?: pulumi.Input; /** * Password for the first user of the Redis™ cluster. Only one of `password` or `passwordWo` should be specified. */ password?: pulumi.Input; /** * **NOTE:** This field is write-only and its value will not be updated in state as part of read operations. * Password for the first user of the Redis™ cluster in write-only mode. Only one of `password` or `passwordWo` should be specified. `passwordWo` will not be set in the Terraform state. To update the `passwordWo`, you must also update the `passwordWoVersion`. */ passwordWo?: pulumi.Input; /** * The version of the write-only password. To update the `passwordWo`, you must also update the `passwordWoVersion`. */ passwordWoVersion?: pulumi.Input; /** * The list of private IPv4 addresses associated with the resource. */ privateIps?: pulumi.Input[] | undefined>; /** * Describes the Private Network you want to connect to your cluster. If not set, a public * network will be provided. More details on the Private Network section */ privateNetworks?: pulumi.Input[] | undefined>; /** * `projectId`) The ID of the project the Redis™ cluster is * associated with. */ projectId?: pulumi.Input; /** * (Optional) Public network details. Only one of `privateNetwork` and `publicNetwork` may be set. The `publicNetwork` block exports: */ publicNetwork?: pulumi.Input; /** * Map of settings for Redis™ cluster. Available settings can be found by listing Redis™ versions * with scaleway API or CLI */ settings?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The tags associated with the Redis™ cluster. */ tags?: pulumi.Input[] | undefined>; /** * Whether TLS is enabled or not. * * > The changes on `tlsEnabled` will force the resource creation. */ tlsEnabled?: pulumi.Input; /** * The date and time of the last update of the Redis™ cluster. */ updatedAt?: pulumi.Input; /** * Identifier for the first user of the Redis™ cluster. */ userName?: pulumi.Input; /** * Redis™ cluster's version (e.g. `6.2.7`). * * > **Important:** Updates to `version` will migrate the Redis™ cluster to the desired `version`. Keep in mind that you * cannot downgrade a Redis™ cluster. */ version?: pulumi.Input; /** * `zone`) The zone in which the * Redis™ cluster should be created. */ zone?: pulumi.Input; } /** * The set of arguments for constructing a RedisCluster resource. */ export interface RedisClusterArgs { /** * List of acl rules, this is cluster's authorized IPs. More details on the ACL section. */ acls?: pulumi.Input[] | undefined>; /** * The number of nodes in the Redis™ cluster. * * > **Important:** * * - Cluster_size = 1 for Standalone mode (single node). * * - Cluster_size = 2 for High Availability (HA) mode, with 1 main node and 1 standby node. * * - Cluster_size >= 3 for Cluster mode, which requires a minimum of 1 main node and 2 secondary nodes. * * > **Important:** If you are using the cluster mode (>=3 nodes), you can set a bigger `clusterSize` than you initially * did, it will migrate the Redis™ cluster but keep in mind that you cannot downgrade a Redis™ cluster, so setting a smaller * `clusterSize` will destroy and recreate your cluster. * * > **Important:** If you are using the Standalone mode (1 node), setting a bigger `clusterSize` will destroy and * recreate your cluster as you will be switching to the cluster mode. */ clusterSize?: pulumi.Input; /** * The name of the Redis™ cluster. */ name?: pulumi.Input; /** * The type of Redis™ cluster you want to create (e.g. `RED1-M`). * * > **Important:** Updates to `nodeType` will migrate the Redis™ cluster to the desired `nodeType`. Keep in mind that * you cannot downgrade a Redis™ cluster. */ nodeType: pulumi.Input; /** * Password for the first user of the Redis™ cluster. Only one of `password` or `passwordWo` should be specified. */ password?: pulumi.Input; /** * **NOTE:** This field is write-only and its value will not be updated in state as part of read operations. * Password for the first user of the Redis™ cluster in write-only mode. Only one of `password` or `passwordWo` should be specified. `passwordWo` will not be set in the Terraform state. To update the `passwordWo`, you must also update the `passwordWoVersion`. */ passwordWo?: pulumi.Input; /** * The version of the write-only password. To update the `passwordWo`, you must also update the `passwordWoVersion`. */ passwordWoVersion?: pulumi.Input; /** * The list of private IPv4 addresses associated with the resource. */ privateIps?: pulumi.Input[] | undefined>; /** * Describes the Private Network you want to connect to your cluster. If not set, a public * network will be provided. More details on the Private Network section */ privateNetworks?: pulumi.Input[] | undefined>; /** * `projectId`) The ID of the project the Redis™ cluster is * associated with. */ projectId?: pulumi.Input; /** * (Optional) Public network details. Only one of `privateNetwork` and `publicNetwork` may be set. The `publicNetwork` block exports: */ publicNetwork?: pulumi.Input; /** * Map of settings for Redis™ cluster. Available settings can be found by listing Redis™ versions * with scaleway API or CLI */ settings?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The tags associated with the Redis™ cluster. */ tags?: pulumi.Input[] | undefined>; /** * Whether TLS is enabled or not. * * > The changes on `tlsEnabled` will force the resource creation. */ tlsEnabled?: pulumi.Input; /** * Identifier for the first user of the Redis™ cluster. */ userName: pulumi.Input; /** * Redis™ cluster's version (e.g. `6.2.7`). * * > **Important:** Updates to `version` will migrate the Redis™ cluster to the desired `version`. Keep in mind that you * cannot downgrade a Redis™ cluster. */ version: pulumi.Input; /** * `zone`) The zone in which the * Redis™ cluster should be created. */ zone?: pulumi.Input; } //# sourceMappingURL=redisCluster.d.ts.map