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
|
// Code generated by smithy-go-codegen DO NOT EDIT.
package lightsail
import (
"context"
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
"github.com/aws/aws-sdk-go-v2/service/lightsail/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
)
// Creates one or more Amazon Lightsail instances. The create instances operation
// supports tag-based access control via request tags. For more information, see
// the Lightsail Developer Guide
// (https://lightsail.aws.amazon.com/ls/docs/en_us/articles/amazon-lightsail-controlling-access-using-tags).
func (c *Client) CreateInstances(ctx context.Context, params *CreateInstancesInput, optFns ...func(*Options)) (*CreateInstancesOutput, error) {
if params == nil {
params = &CreateInstancesInput{}
}
result, metadata, err := c.invokeOperation(ctx, "CreateInstances", params, optFns, c.addOperationCreateInstancesMiddlewares)
if err != nil {
return nil, err
}
out := result.(*CreateInstancesOutput)
out.ResultMetadata = metadata
return out, nil
}
type CreateInstancesInput struct {
// The Availability Zone in which to create your instance. Use the following
// format: us-east-2a (case sensitive). You can get a list of Availability Zones by
// using the get regions
// (http://docs.aws.amazon.com/lightsail/2016-11-28/api-reference/API_GetRegions.html)
// operation. Be sure to add the include Availability Zones parameter to your
// request.
//
// This member is required.
AvailabilityZone *string
// The ID for a virtual private server image (e.g., app_wordpress_4_4 or
// app_lamp_7_0). Use the get blueprints operation to return a list of available
// images (or blueprints). Use active blueprints when creating new instances.
// Inactive blueprints are listed to support customers with existing instances and
// are not necessarily available to create new instances. Blueprints are marked
// inactive when they become outdated due to operating system updates or new
// application releases.
//
// This member is required.
BlueprintId *string
// The bundle of specification information for your virtual private server (or
// instance), including the pricing plan (e.g., micro_1_0).
//
// This member is required.
BundleId *string
// The names to use for your new Lightsail instances. Separate multiple values
// using quotation marks and commas, for example:
// ["MyFirstInstance","MySecondInstance"]
//
// This member is required.
InstanceNames []string
// An array of objects representing the add-ons to enable for the new instance.
AddOns []types.AddOnRequest
// (Deprecated) The name for your custom image. In releases prior to June 12, 2017,
// this parameter was ignored by the API. It is now deprecated.
//
// Deprecated: This member has been deprecated.
CustomImageName *string
// The IP address type for the instance. The possible values are ipv4 for IPv4
// only, and dualstack for IPv4 and IPv6. The default value is dualstack.
IpAddressType types.IpAddressType
// The name of your key pair.
KeyPairName *string
// The tag keys and optional values to add to the resource during create. Use the
// TagResource action to tag a resource after it's created.
Tags []types.Tag
// A launch script you can create that configures a server with additional user
// data. For example, you might want to run apt-get -y update. Depending on the
// machine image you choose, the command to get software on your instance varies.
// Amazon Linux and CentOS use yum, Debian and Ubuntu use apt-get, and FreeBSD uses
// pkg. For a complete list, see the Amazon Lightsail Developer Guide
// (https://lightsail.aws.amazon.com/ls/docs/en_us/articles/compare-options-choose-lightsail-instance-image).
UserData *string
noSmithyDocumentSerde
}
type CreateInstancesOutput struct {
// An array of objects that describe the result of the action, such as the status
// of the request, the timestamp of the request, and the resources affected by the
// request.
Operations []types.Operation
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationCreateInstancesMiddlewares(stack *middleware.Stack, options Options) (err error) {
err = stack.Serialize.Add(&awsAwsjson11_serializeOpCreateInstances{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpCreateInstances{}, middleware.After)
if err != nil {
return err
}
if err = addSetLoggerMiddleware(stack, options); err != nil {
return err
}
if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
return err
}
if err = addResolveEndpointMiddleware(stack, options); err != nil {
return err
}
if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
return err
}
if err = addRetryMiddlewares(stack, options); err != nil {
return err
}
if err = addHTTPSignerV4Middleware(stack, options); err != nil {
return err
}
if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
return err
}
if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
return err
}
if err = addClientUserAgent(stack); err != nil {
return err
}
if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
return err
}
if err = addOpCreateInstancesValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateInstances(options.Region), middleware.Before); 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
}
return nil
}
func newServiceMetadataMiddleware_opCreateInstances(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
SigningName: "lightsail",
OperationName: "CreateInstances",
}
}
|
