-
Notifications
You must be signed in to change notification settings - Fork 597
/
api_op_CreateStack.go
392 lines (359 loc) · 16.1 KB
/
api_op_CreateStack.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
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
// Code generated by smithy-go-codegen DO NOT EDIT.
package opsworks
import (
"context"
"fmt"
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
"github.com/aws/aws-sdk-go-v2/service/opsworks/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
)
// Creates a new stack. For more information, see [Create a New Stack].
//
// Required Permissions: To use this action, an IAM user must have an attached
// policy that explicitly grants permissions. For more information about user
// permissions, see [Managing User Permissions].
//
// [Create a New Stack]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-edit.html
// [Managing User Permissions]: https://docs.aws.amazon.com/opsworks/latest/userguide/opsworks-security-users.html
func (c *Client) CreateStack(ctx context.Context, params *CreateStackInput, optFns ...func(*Options)) (*CreateStackOutput, error) {
if params == nil {
params = &CreateStackInput{}
}
result, metadata, err := c.invokeOperation(ctx, "CreateStack", params, optFns, c.addOperationCreateStackMiddlewares)
if err != nil {
return nil, err
}
out := result.(*CreateStackOutput)
out.ResultMetadata = metadata
return out, nil
}
type CreateStackInput struct {
// The Amazon Resource Name (ARN) of an IAM profile that is the default profile
// for all of the stack's EC2 instances. For more information about IAM ARNs, see [Using Identifiers].
//
// [Using Identifiers]: https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html
//
// This member is required.
DefaultInstanceProfileArn *string
// The stack name.
//
// This member is required.
Name *string
// The stack's AWS region, such as ap-south-1 . For more information about Amazon
// regions, see [Regions and Endpoints].
//
// In the AWS CLI, this API maps to the --stack-region parameter. If the
// --stack-region parameter and the AWS CLI common parameter --region are set to
// the same value, the stack uses a regional endpoint. If the --stack-region
// parameter is not set, but the AWS CLI --region parameter is, this also results
// in a stack with a regional endpoint. However, if the --region parameter is set
// to us-east-1 , and the --stack-region parameter is set to one of the following,
// then the stack uses a legacy or classic region: us-west-1, us-west-2,
// sa-east-1, eu-central-1, eu-west-1, ap-northeast-1, ap-southeast-1,
// ap-southeast-2 . In this case, the actual API endpoint of the stack is in
// us-east-1 . Only the preceding regions are supported as classic regions in the
// us-east-1 API endpoint. Because it is a best practice to choose the regional
// endpoint that is closest to where you manage AWS, we recommend that you use
// regional endpoints for new stacks. The AWS CLI common --region parameter always
// specifies a regional API endpoint; it cannot be used to specify a classic AWS
// OpsWorks Stacks region.
//
// [Regions and Endpoints]: https://docs.aws.amazon.com/general/latest/gr/rande.html
//
// This member is required.
Region *string
// The stack's AWS Identity and Access Management (IAM) role, which allows AWS
// OpsWorks Stacks to work with AWS resources on your behalf. You must set this
// parameter to the Amazon Resource Name (ARN) for an existing IAM role. For more
// information about IAM ARNs, see [Using Identifiers].
//
// [Using Identifiers]: https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html
//
// This member is required.
ServiceRoleArn *string
// The default AWS OpsWorks Stacks agent version. You have the following options:
//
// - Auto-update - Set this parameter to LATEST . AWS OpsWorks Stacks
// automatically installs new agent versions on the stack's instances as soon as
// they are available.
//
// - Fixed version - Set this parameter to your preferred agent version. To
// update the agent version, you must edit the stack configuration and specify a
// new version. AWS OpsWorks Stacks then automatically installs that version on the
// stack's instances.
//
// The default setting is the most recent release of the agent. To specify an
// agent version, you must use the complete version number, not the abbreviated
// number shown on the console. For a list of available agent version numbers, call
// DescribeAgentVersions. AgentVersion cannot be set to Chef 12.2.
//
// You can also specify an agent version when you create or update an instance,
// which overrides the stack's default setting.
AgentVersion *string
// One or more user-defined key-value pairs to be added to the stack attributes.
Attributes map[string]string
// A ChefConfiguration object that specifies whether to enable Berkshelf and the
// Berkshelf version on Chef 11.10 stacks. For more information, see [Create a New Stack].
//
// [Create a New Stack]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html
ChefConfiguration *types.ChefConfiguration
// The configuration manager. When you create a stack we recommend that you use
// the configuration manager to specify the Chef version: 12, 11.10, or 11.4 for
// Linux stacks, or 12.2 for Windows stacks. The default value for Linux stacks is
// currently 12.
ConfigurationManager *types.StackConfigurationManager
// Contains the information required to retrieve an app or cookbook from a
// repository. For more information, see [Adding Apps]or [Cookbooks and Recipes].
//
// [Cookbooks and Recipes]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingcookbook.html
// [Adding Apps]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-creating.html
CustomCookbooksSource *types.Source
// A string that contains user-defined, custom JSON. It can be used to override
// the corresponding default stack configuration attribute values or to pass data
// to recipes. The string should be in the following format:
//
// "{\"key1\": \"value1\", \"key2\": \"value2\",...}"
//
// For more information about custom JSON, see [Use Custom JSON to Modify the Stack Configuration Attributes].
//
// [Use Custom JSON to Modify the Stack Configuration Attributes]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-json.html
CustomJson *string
// The stack's default Availability Zone, which must be in the specified region.
// For more information, see [Regions and Endpoints]. If you also specify a value for DefaultSubnetId ,
// the subnet must be in the same zone. For more information, see the VpcId
// parameter description.
//
// [Regions and Endpoints]: https://docs.aws.amazon.com/general/latest/gr/rande.html
DefaultAvailabilityZone *string
// The stack's default operating system, which is installed on every instance
// unless you specify a different operating system when you create the instance.
// You can specify one of the following.
//
// - A supported Linux operating system: An Amazon Linux version, such as Amazon
// Linux 2018.03 , Amazon Linux 2017.09 , Amazon Linux 2017.03 , Amazon Linux
// 2016.09 , Amazon Linux 2016.03 , Amazon Linux 2015.09 , or Amazon Linux
// 2015.03 .
//
// - A supported Ubuntu operating system, such as Ubuntu 16.04 LTS , Ubuntu
// 14.04 LTS , or Ubuntu 12.04 LTS .
//
// - CentOS Linux 7
//
// - Red Hat Enterprise Linux 7
//
// - A supported Windows operating system, such as Microsoft Windows Server 2012
// R2 Base , Microsoft Windows Server 2012 R2 with SQL Server Express ,
// Microsoft Windows Server 2012 R2 with SQL Server Standard , or Microsoft
// Windows Server 2012 R2 with SQL Server Web .
//
// - A custom AMI: Custom . You specify the custom AMI you want to use when you
// create instances. For more information, see [Using Custom AMIs].
//
// The default option is the current Amazon Linux version. For more information
// about supported operating systems, see [AWS OpsWorks Stacks Operating Systems].
//
// [AWS OpsWorks Stacks Operating Systems]: https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-os.html
// [Using Custom AMIs]: https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-custom-ami.html
DefaultOs *string
// The default root device type. This value is the default for all instances in
// the stack, but you can override it when you create an instance. The default
// option is instance-store . For more information, see [Storage for the Root Device].
//
// [Storage for the Root Device]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device
DefaultRootDeviceType types.RootDeviceType
// A default Amazon EC2 key pair name. The default value is none. If you specify a
// key pair name, AWS OpsWorks installs the public key on the instance and you can
// use the private key with an SSH client to log in to the instance. For more
// information, see [Using SSH to Communicate with an Instance]and [Managing SSH Access]. You can override this setting by specifying a different
// key pair, or no key pair, when you [create an instance].
//
// [Using SSH to Communicate with an Instance]: https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-ssh.html
// [Managing SSH Access]: https://docs.aws.amazon.com/opsworks/latest/userguide/security-ssh-access.html
// [create an instance]: https://docs.aws.amazon.com/opsworks/latest/userguide/workinginstances-add.html
DefaultSshKeyName *string
// The stack's default VPC subnet ID. This parameter is required if you specify a
// value for the VpcId parameter. All instances are launched into this subnet
// unless you specify otherwise when you create the instance. If you also specify a
// value for DefaultAvailabilityZone , the subnet must be in that zone. For
// information on default values and when this parameter is required, see the VpcId
// parameter description.
DefaultSubnetId *string
// The stack's host name theme, with spaces replaced by underscores. The theme is
// used to generate host names for the stack's instances. By default, HostnameTheme
// is set to Layer_Dependent , which creates host names by appending integers to
// the layer's short name. The other themes are:
//
// - Baked_Goods
//
// - Clouds
//
// - Europe_Cities
//
// - Fruits
//
// - Greek_Deities_and_Titans
//
// - Legendary_creatures_from_Japan
//
// - Planets_and_Moons
//
// - Roman_Deities
//
// - Scottish_Islands
//
// - US_Cities
//
// - Wild_Cats
//
// To obtain a generated host name, call GetHostNameSuggestion , which returns a
// host name based on the current theme.
HostnameTheme *string
// Whether the stack uses custom cookbooks.
UseCustomCookbooks *bool
// Whether to associate the AWS OpsWorks Stacks built-in security groups with the
// stack's layers.
//
// AWS OpsWorks Stacks provides a standard set of built-in security groups, one
// for each layer, which are associated with layers by default. With
// UseOpsworksSecurityGroups you can instead provide your own custom security
// groups. UseOpsworksSecurityGroups has the following settings:
//
// - True - AWS OpsWorks Stacks automatically associates the appropriate
// built-in security group with each layer (default setting). You can associate
// additional security groups with a layer after you create it, but you cannot
// delete the built-in security group.
//
// - False - AWS OpsWorks Stacks does not associate built-in security groups
// with layers. You must create appropriate EC2 security groups and associate a
// security group with each layer that you create. However, you can still manually
// associate a built-in security group with a layer on creation; custom security
// groups are required only for those layers that need custom settings.
//
// For more information, see [Create a New Stack].
//
// [Create a New Stack]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-creating.html
UseOpsworksSecurityGroups *bool
// The ID of the VPC that the stack is to be launched into. The VPC must be in the
// stack's region. All instances are launched into this VPC. You cannot change the
// ID later.
//
// - If your account supports EC2-Classic, the default value is no VPC .
//
// - If your account does not support EC2-Classic, the default value is the
// default VPC for the specified region.
//
// If the VPC ID corresponds to a default VPC and you have specified either the
// DefaultAvailabilityZone or the DefaultSubnetId parameter only, AWS OpsWorks
// Stacks infers the value of the other parameter. If you specify neither
// parameter, AWS OpsWorks Stacks sets these parameters to the first valid
// Availability Zone for the specified region and the corresponding default VPC
// subnet ID, respectively.
//
// If you specify a nondefault VPC ID, note the following:
//
// - It must belong to a VPC in your account that is in the specified region.
//
// - You must specify a value for DefaultSubnetId .
//
// For more information about how to use AWS OpsWorks Stacks with a VPC, see [Running a Stack in a VPC]. For
// more information about default VPC and EC2-Classic, see [Supported Platforms].
//
// [Supported Platforms]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-supported-platforms.html
// [Running a Stack in a VPC]: https://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-vpc.html
VpcId *string
noSmithyDocumentSerde
}
// Contains the response to a CreateStack request.
type CreateStackOutput struct {
// The stack ID, which is an opaque string that you use to identify the stack when
// performing actions such as DescribeStacks .
StackId *string
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationCreateStackMiddlewares(stack *middleware.Stack, options Options) (err error) {
if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil {
return err
}
err = stack.Serialize.Add(&awsAwsjson11_serializeOpCreateStack{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpCreateStack{}, middleware.After)
if err != nil {
return err
}
if err := addProtocolFinalizerMiddlewares(stack, options, "CreateStack"); err != nil {
return fmt.Errorf("add protocol finalizers: %v", err)
}
if err = addlegacyEndpointContextSetter(stack, options); err != nil {
return err
}
if err = addSetLoggerMiddleware(stack, options); err != nil {
return err
}
if err = addClientRequestID(stack); err != nil {
return err
}
if err = addComputeContentLength(stack); err != nil {
return err
}
if err = addResolveEndpointMiddleware(stack, options); err != nil {
return err
}
if err = addComputePayloadSHA256(stack); err != nil {
return err
}
if err = addRetry(stack, options); err != nil {
return err
}
if err = addRawResponseToMetadata(stack); err != nil {
return err
}
if err = addRecordResponseTiming(stack); err != nil {
return err
}
if err = addClientUserAgent(stack, options); err != nil {
return err
}
if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = addSetLegacyContextSigningOptionsMiddleware(stack); err != nil {
return err
}
if err = addOpCreateStackValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateStack(options.Region), middleware.Before); err != nil {
return err
}
if err = addRecursionDetection(stack); err != nil {
return err
}
if err = addRequestIDRetrieverMiddleware(stack); err != nil {
return err
}
if err = addResponseErrorMiddleware(stack); err != nil {
return err
}
if err = addRequestResponseLogging(stack, options); err != nil {
return err
}
if err = addDisableHTTPSMiddleware(stack, options); err != nil {
return err
}
return nil
}
func newServiceMetadataMiddleware_opCreateStack(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
OperationName: "CreateStack",
}
}