/
CfnOutput.go
364 lines (327 loc) · 8.91 KB
/
CfnOutput.go
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
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
package awscdk
import (
_init_ "github.com/aws/aws-cdk-go/awscdk/v2/jsii"
_jsii_ "github.com/aws/jsii-runtime-go/runtime"
"github.com/aws/constructs-go/constructs/v10"
)
// Example:
// var cluster cluster
//
// // add service account
// serviceAccount := cluster.addServiceAccount(jsii.String("MyServiceAccount"))
//
// bucket := s3.NewBucket(this, jsii.String("Bucket"))
// bucket.GrantReadWrite(serviceAccount)
//
// mypod := cluster.addManifest(jsii.String("mypod"), map[string]interface{}{
// "apiVersion": jsii.String("v1"),
// "kind": jsii.String("Pod"),
// "metadata": map[string]*string{
// "name": jsii.String("mypod"),
// },
// "spec": map[string]interface{}{
// "serviceAccountName": serviceAccount.serviceAccountName,
// "containers": []map[string]interface{}{
// map[string]interface{}{
// "name": jsii.String("hello"),
// "image": jsii.String("paulbouwer/hello-kubernetes:1.5"),
// "ports": []map[string]*f64{
// map[string]*f64{
// "containerPort": jsii.Number(8080),
// },
// },
// },
// },
// },
// })
//
// // create the resource after the service account.
// mypod.Node.AddDependency(serviceAccount)
//
// // print the IAM role arn for this service account
// // print the IAM role arn for this service account
// awscdk.NewCfnOutput(this, jsii.String("ServiceAccountIamRole"), &CfnOutputProps{
// Value: serviceAccount.Role.RoleArn,
// })
//
type CfnOutput interface {
CfnElement
// A condition to associate with this output value.
//
// If the condition evaluates
// to `false`, this output value will not be included in the stack.
// Default: - No condition is associated with the output.
//
Condition() CfnCondition
SetCondition(val CfnCondition)
// Returns: the stack trace of the point where this Resource was created from, sourced
// from the +metadata+ entry typed +aws:cdk:logicalId+, and with the bottom-most
// node +internal+ entries filtered.
CreationStack() *[]*string
// A String type that describes the output value.
//
// The description can be a maximum of 4 K in length.
// Default: - No description.
//
Description() *string
SetDescription(val *string)
// The name used to export the value of this output across stacks.
//
// To use the value in another stack, pass the value of
// `output.importValue` to it.
// Default: - the output is not exported.
//
ExportName() *string
SetExportName(val *string)
// Return the `Fn.importValue` expression to import this value into another stack.
//
// The returned value should not be used in the same stack, but in a
// different one. It must be deployed to the same environment, as
// CloudFormation exports can only be imported in the same Region and
// account.
//
// The is no automatic registration of dependencies between stacks when using
// this mechanism, so you should make sure to deploy them in the right order
// yourself.
//
// You can use this mechanism to share values across Stacks in different
// Stages. If you intend to share the value to another Stack inside the same
// Stage, the automatic cross-stack referencing mechanism is more convenient.
ImportValue() *string
// The logical ID for this CloudFormation stack element.
//
// The logical ID of the element
// is calculated from the path of the resource node in the construct tree.
//
// To override this value, use `overrideLogicalId(newLogicalId)`.
//
// Returns: the logical ID as a stringified token. This value will only get
// resolved during synthesis.
LogicalId() *string
// The tree node.
Node() constructs.Node
// The stack in which this element is defined.
//
// CfnElements must be defined within a stack scope (directly or indirectly).
Stack() Stack
// The value of the property returned by the aws cloudformation describe-stacks command.
//
// The value of an output can include literals, parameter references, pseudo-parameters,
// a mapping value, or intrinsic functions.
Value() interface{}
SetValue(val interface{})
// Overrides the auto-generated logical ID with a specific ID.
OverrideLogicalId(newLogicalId *string)
// Returns a string representation of this construct.
ToString() *string
}
// The jsii proxy struct for CfnOutput
type jsiiProxy_CfnOutput struct {
jsiiProxy_CfnElement
}
func (j *jsiiProxy_CfnOutput) Condition() CfnCondition {
var returns CfnCondition
_jsii_.Get(
j,
"condition",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) CreationStack() *[]*string {
var returns *[]*string
_jsii_.Get(
j,
"creationStack",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) Description() *string {
var returns *string
_jsii_.Get(
j,
"description",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) ExportName() *string {
var returns *string
_jsii_.Get(
j,
"exportName",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) ImportValue() *string {
var returns *string
_jsii_.Get(
j,
"importValue",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) LogicalId() *string {
var returns *string
_jsii_.Get(
j,
"logicalId",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) Node() constructs.Node {
var returns constructs.Node
_jsii_.Get(
j,
"node",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) Stack() Stack {
var returns Stack
_jsii_.Get(
j,
"stack",
&returns,
)
return returns
}
func (j *jsiiProxy_CfnOutput) Value() interface{} {
var returns interface{}
_jsii_.Get(
j,
"value",
&returns,
)
return returns
}
// Creates an CfnOutput value for this stack.
func NewCfnOutput(scope constructs.Construct, id *string, props *CfnOutputProps) CfnOutput {
_init_.Initialize()
if err := validateNewCfnOutputParameters(scope, id, props); err != nil {
panic(err)
}
j := jsiiProxy_CfnOutput{}
_jsii_.Create(
"aws-cdk-lib.CfnOutput",
[]interface{}{scope, id, props},
&j,
)
return &j
}
// Creates an CfnOutput value for this stack.
func NewCfnOutput_Override(c CfnOutput, scope constructs.Construct, id *string, props *CfnOutputProps) {
_init_.Initialize()
_jsii_.Create(
"aws-cdk-lib.CfnOutput",
[]interface{}{scope, id, props},
c,
)
}
func (j *jsiiProxy_CfnOutput)SetCondition(val CfnCondition) {
_jsii_.Set(
j,
"condition",
val,
)
}
func (j *jsiiProxy_CfnOutput)SetDescription(val *string) {
_jsii_.Set(
j,
"description",
val,
)
}
func (j *jsiiProxy_CfnOutput)SetExportName(val *string) {
_jsii_.Set(
j,
"exportName",
val,
)
}
func (j *jsiiProxy_CfnOutput)SetValue(val interface{}) {
if err := j.validateSetValueParameters(val); err != nil {
panic(err)
}
_jsii_.Set(
j,
"value",
val,
)
}
// Returns `true` if a construct is a stack element (i.e. part of the synthesized cloudformation template).
//
// Uses duck-typing instead of `instanceof` to allow stack elements from different
// versions of this library to be included in the same stack.
//
// Returns: The construct as a stack element or undefined if it is not a stack element.
func CfnOutput_IsCfnElement(x interface{}) *bool {
_init_.Initialize()
if err := validateCfnOutput_IsCfnElementParameters(x); err != nil {
panic(err)
}
var returns *bool
_jsii_.StaticInvoke(
"aws-cdk-lib.CfnOutput",
"isCfnElement",
[]interface{}{x},
&returns,
)
return returns
}
// Checks if `x` is a construct.
//
// Use this method instead of `instanceof` to properly detect `Construct`
// instances, even when the construct library is symlinked.
//
// Explanation: in JavaScript, multiple copies of the `constructs` library on
// disk are seen as independent, completely different libraries. As a
// consequence, the class `Construct` in each copy of the `constructs` library
// is seen as a different class, and an instance of one class will not test as
// `instanceof` the other class. `npm install` will not create installations
// like this, but users may manually symlink construct libraries together or
// use a monorepo tool: in those cases, multiple copies of the `constructs`
// library can be accidentally installed, and `instanceof` will behave
// unpredictably. It is safest to avoid using `instanceof`, and using
// this type-testing method instead.
//
// Returns: true if `x` is an object created from a class which extends `Construct`.
func CfnOutput_IsConstruct(x interface{}) *bool {
_init_.Initialize()
if err := validateCfnOutput_IsConstructParameters(x); err != nil {
panic(err)
}
var returns *bool
_jsii_.StaticInvoke(
"aws-cdk-lib.CfnOutput",
"isConstruct",
[]interface{}{x},
&returns,
)
return returns
}
func (c *jsiiProxy_CfnOutput) OverrideLogicalId(newLogicalId *string) {
if err := c.validateOverrideLogicalIdParameters(newLogicalId); err != nil {
panic(err)
}
_jsii_.InvokeVoid(
c,
"overrideLogicalId",
[]interface{}{newLogicalId},
)
}
func (c *jsiiProxy_CfnOutput) ToString() *string {
var returns *string
_jsii_.Invoke(
c,
"toString",
nil, // no parameters
&returns,
)
return returns
}