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.

Release files for pulumi-random 4.21.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pulumi-random 4.21.2
File	Size	Uploaded
pulumi_random-4.21.2.tar.gz	22.8 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pulumi-random 4.21.2
File	Interpreter	ABI	Platform	Reset
pulumi_random-4.21.2-py3-none-any.whl 36.1 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 58.8 kB

Release files / pulumi_random-4.21.2.tar.gz

Download URL	pulumi_random-4.21.2.tar.gz
Size	22.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`90ebcab17de5401b8c5dabfef6349d0d9ed0e32be4598dd147b627fe4722f01d`
BLAKE2b-256 checksum How to use checksums	`80698788f884a4fcffa72ee29376db688890c6a5040f8d04d57109d4b5d32c60`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`

Release files / pulumi_random-4.21.2-py3-none-any.whl

Download URL	pulumi_random-4.21.2-py3-none-any.whl
Size	36.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d070453fc962217866a6bbfc8f19d59ec127b24dede3376beaab6eae5cbc1294`
BLAKE2b-256 checksum How to use checksums	`df8971b35c6fecb31e5ec4bb71bfe40df0525dd8e7ae5ca43289bb15517fa7ee`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.15`