-
Notifications
You must be signed in to change notification settings - Fork 6
/
randomId.ts
216 lines (207 loc) · 8.48 KB
/
randomId.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
// *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***
import * as pulumi from "@pulumi/pulumi";
import * as utilities from "./utilities";
/**
* The resource `random..RandomId` generates random numbers that are intended to be
* used as unique identifiers for other resources.
*
* This resource *does* use a cryptographic random number generator in order
* to minimize the chance of collisions, making the results of this resource
* when a 16-byte identifier is requested of equivalent uniqueness to a
* type-4 UUID.
*
* This resource can be used in conjunction with resources that have
* the `createBeforeDestroy` lifecycle flag set to avoid conflicts with
* unique names during the brief period where both the old and new resources
* exist concurrently.
*
* ## Example Usage
*
* The following example shows how to generate a unique name for an AWS EC2
* instance that changes each time a new AMI id is selected.
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as aws from "@pulumi/aws";
* import * as random from "@pulumi/random";
*
* const serverRandomId = new random.RandomId("server", {
* byteLength: 8,
* keepers: {
* // Generate a new id each time we switch to a new AMI id
* ami_id: var_ami_id,
* },
* });
* const serverInstance = new aws.ec2.Instance("server", {
* ami: serverRandomId.keepers.apply(keepers => keepers.amiId),
* tags: {
* Name: pulumi.interpolate`web-server ${serverRandomId.hex}`,
* },
* });
* ```
*
* > This content is derived from https://github.com/terraform-providers/terraform-provider-random/blob/master/website/docs/r/id.html.markdown.
*/
export class RandomId extends pulumi.CustomResource {
/**
* Get an existing RandomId 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.
*/
public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: RandomIdState, opts?: pulumi.CustomResourceOptions): RandomId {
return new RandomId(name, <any>state, { ...opts, id: id });
}
/** @internal */
public static readonly __pulumiType = 'random:index/randomId:RandomId';
/**
* Returns true if the given object is an instance of RandomId. This is designed to work even
* when multiple copies of the Pulumi SDK have been loaded into the same process.
*/
public static isInstance(obj: any): obj is RandomId {
if (obj === undefined || obj === null) {
return false;
}
return obj['__pulumiType'] === RandomId.__pulumiType;
}
public /*out*/ readonly b64!: pulumi.Output<string>;
/**
* The generated id presented in base64 without additional transformations.
*/
public /*out*/ readonly b64Std!: pulumi.Output<string>;
/**
* The generated id presented in base64, using the URL-friendly character set: case-sensitive letters, digits and the characters `_` and `-`.
*/
public /*out*/ readonly b64Url!: pulumi.Output<string>;
/**
* The number of random bytes to produce. The
* minimum value is 1, which produces eight bits of randomness.
*/
public readonly byteLength!: pulumi.Output<number>;
/**
* The generated id presented in non-padded decimal digits.
*/
public /*out*/ readonly dec!: pulumi.Output<string>;
/**
* The generated id presented in padded hexadecimal digits. This result will always be twice as long as the requested byte length.
*/
public /*out*/ readonly hex!: pulumi.Output<string>;
/**
* Arbitrary map of values that, when changed, will
* trigger a new id to be generated. See
* the main provider documentation for more information.
*/
public readonly keepers!: pulumi.Output<{[key: string]: any} | undefined>;
/**
* Arbitrary string to prefix the output value with. This
* string is supplied as-is, meaning it is not guaranteed to be URL-safe or
* base64 encoded.
*/
public readonly prefix!: pulumi.Output<string | undefined>;
/**
* Create a RandomId 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: RandomIdArgs, opts?: pulumi.CustomResourceOptions)
constructor(name: string, argsOrState?: RandomIdArgs | RandomIdState, opts?: pulumi.CustomResourceOptions) {
let inputs: pulumi.Inputs = {};
if (opts && opts.id) {
const state = argsOrState as RandomIdState | undefined;
inputs["b64"] = state ? state.b64 : undefined;
inputs["b64Std"] = state ? state.b64Std : undefined;
inputs["b64Url"] = state ? state.b64Url : undefined;
inputs["byteLength"] = state ? state.byteLength : undefined;
inputs["dec"] = state ? state.dec : undefined;
inputs["hex"] = state ? state.hex : undefined;
inputs["keepers"] = state ? state.keepers : undefined;
inputs["prefix"] = state ? state.prefix : undefined;
} else {
const args = argsOrState as RandomIdArgs | undefined;
if (!args || args.byteLength === undefined) {
throw new Error("Missing required property 'byteLength'");
}
inputs["byteLength"] = args ? args.byteLength : undefined;
inputs["keepers"] = args ? args.keepers : undefined;
inputs["prefix"] = args ? args.prefix : undefined;
inputs["b64"] = undefined /*out*/;
inputs["b64Std"] = undefined /*out*/;
inputs["b64Url"] = undefined /*out*/;
inputs["dec"] = undefined /*out*/;
inputs["hex"] = undefined /*out*/;
}
if (!opts) {
opts = {}
}
if (!opts.version) {
opts.version = utilities.getVersion();
}
super(RandomId.__pulumiType, name, inputs, opts);
}
}
/**
* Input properties used for looking up and filtering RandomId resources.
*/
export interface RandomIdState {
readonly b64?: pulumi.Input<string>;
/**
* The generated id presented in base64 without additional transformations.
*/
readonly b64Std?: pulumi.Input<string>;
/**
* The generated id presented in base64, using the URL-friendly character set: case-sensitive letters, digits and the characters `_` and `-`.
*/
readonly b64Url?: pulumi.Input<string>;
/**
* The number of random bytes to produce. The
* minimum value is 1, which produces eight bits of randomness.
*/
readonly byteLength?: pulumi.Input<number>;
/**
* The generated id presented in non-padded decimal digits.
*/
readonly dec?: pulumi.Input<string>;
/**
* The generated id presented in padded hexadecimal digits. This result will always be twice as long as the requested byte length.
*/
readonly hex?: pulumi.Input<string>;
/**
* Arbitrary map of values that, when changed, will
* trigger a new id to be generated. See
* the main provider documentation for more information.
*/
readonly keepers?: pulumi.Input<{[key: string]: any}>;
/**
* Arbitrary string to prefix the output value with. This
* string is supplied as-is, meaning it is not guaranteed to be URL-safe or
* base64 encoded.
*/
readonly prefix?: pulumi.Input<string>;
}
/**
* The set of arguments for constructing a RandomId resource.
*/
export interface RandomIdArgs {
/**
* The number of random bytes to produce. The
* minimum value is 1, which produces eight bits of randomness.
*/
readonly byteLength: pulumi.Input<number>;
/**
* Arbitrary map of values that, when changed, will
* trigger a new id to be generated. See
* the main provider documentation for more information.
*/
readonly keepers?: pulumi.Input<{[key: string]: any}>;
/**
* Arbitrary string to prefix the output value with. This
* string is supplied as-is, meaning it is not guaranteed to be URL-safe or
* base64 encoded.
*/
readonly prefix?: pulumi.Input<string>;
}