Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Actions Status Slack NPM version NuGet version Python version PkgGoDev License

Random Provider

The random provider allows the safe use of randomness in a Pulumi program. This allows you to generate resource properties, such as names, that contain randomness in a way that works with Pulumi's goal state oriented approach. Using randomness as usual would not work well with Pulumi, because by definition, each time the program is evaluated, a new random state would be produced, necessitating re-convergence on the goal state. This provider understands how to work with the Pulumi resource lifecycle to accomplish randomness safely and in a way that works as desired.

Installing

This package is available in many languages in the standard packaging formats.

Node.js (Java/TypeScript)

To use from JavaScript or TypeScript in Node.js, install using either npm:

$ npm install @pulumi/random

or yarn:

$ yarn add @pulumi/random

Python

To use from Python, install using pip:

$ pip install pulumi_random

Go

To use from Go, use go get to grab the latest version of the library

$ go get github.com/pulumi/pulumi-random/sdk/v4/go/...

.NET

To use from .NET, install using dotnet add package:

$ dotnet add package Pulumi.Random

Example

For example, to generate a random password, allocate a RandomPassword resource and then use its result output property (of type Output<string>) to pass to another resource.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
import * as random from "@pulumi/random";

const password = new random.RandomPassword("password", {
    length: 16,
    overrideSpecial: "_%@",
    special: true,
});
const example = new aws.rds.Instance("example", {
    password: password.result,
});

Reference

For further information, please visit the random provider docs or for detailed reference documentation, please visit the API docs.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pulumi_random-4.22.0a1787820810.tar.gz (22.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pulumi_random-4.22.0a1787820810-py3-none-any.whl (36.2 kB view details)

Uploaded Python 3

File details

Details for the file pulumi_random-4.22.0a1787820810.tar.gz.

File metadata

File hashes

Hashes for pulumi_random-4.22.0a1787820810.tar.gz
Algorithm Hash digest
SHA256 b190c226db52d16dfe6eb75c998b13092e44daf5db70a0afddd6519485eed35e
MD5 7735a1890f0197754262b14578fe86b3
BLAKE2b-256 602d2c0613dfb106c069bd5b89c489c00c29518b56eddec3b83c906203ba3fec

See more details on using hashes here.

File details

Details for the file pulumi_random-4.22.0a1787820810-py3-none-any.whl.

File metadata

File hashes

Hashes for pulumi_random-4.22.0a1787820810-py3-none-any.whl
Algorithm Hash digest
SHA256 6cfe7e8016591ece84dc16482de4cccbc86be78510d42152a3d8049b12b577ca
MD5 e7989885ee6a34c98c5a054ddb803928
BLAKE2b-256 d9eb6f238b2728dc7b640e9c99f2a88d5240e01eec9809cba2c97904c9b0d338

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

4.22.0a1787820810 This release

2 files

4.21.1

2 files

4.21.0

2 files

4.20.0

2 files

4.19.2

2 files

4.19.1

2 files

4.19.0

2 files

4.18.5

2 files

4.18.4

2 files

4.18.3

2 files

4.18.2

2 files

4.18.1

2 files

4.18.0

2 files

4.17.0

2 files

4.16.8

2 files

4.16.7

2 files

4.16.6

2 files

4.16.5

2 files

4.16.4

2 files

4.16.3

2 files

4.16.2

2 files

4.16.1

2 files

4.16.0

2 files

4.15.1

2 files

4.15.0

2 files

4.14.0

2 files

4.13.4

1 file

4.13.3

2 files

4.13.2

1 file

4.13.1

1 file

4.13.0

1 file

4.12.1

1 file

4.12.0

1 file

4.11.3

1 file

4.11.2

1 file

4.11.1

1 file

4.10.0

1 file

4.9.0

1 file

4.8.2

1 file

4.8.1

1 file

4.8.0

1 file

4.7.0

1 file

4.6.0

1 file

4.5.0

1 file

4.4.2

1 file

4.4.1

1 file

4.4.0

1 file

4.3.1

1 file

4.3.0

1 file

4.2.0

1 file

4.1.1

1 file

4.1.0

1 file

4.0.0

1 file

3.2.0

1 file

3.1.1

1 file

3.1.0

1 file

3.0.3

1 file

3.0.2

1 file

3.0.1

1 file

3.0.0

1 file

2.5.0

1 file

2.4.4

1 file

2.4.3

1 file

2.4.2

1 file

2.4.1

1 file

2.4.0

1 file

2.3.1

1 file

2.3.0

1 file

2.2.0

1 file

2.1.4

1 file

2.1.3

1 file

2.1.2

1 file

2.1.1

1 file

2.1.0

1 file

2.0.0

1 file

1.6.0

1 file

1.5.0

1 file

1.4.0

1 file

1.3.0

1 file

1.2.0

1 file

1.1.0

1 file

1.0.0

1 file

0.5.8

1 file

0.5.7

1 file

0.5.6

1 file

0.5.5

1 file

0.5.4

1 file

0.5.3

1 file

0.5.2

1 file

0.5.1

1 file

0.5.0

1 file

0.4.0

1 file

0.3.0

1 file

0.2.0

1 file

0.0.0

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page