-
Notifications
You must be signed in to change notification settings - Fork 623
/
api_op_CreateInstances.go
197 lines (163 loc) · 6.64 KB
/
api_op_CreateInstances.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
// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.
package lightsail
import (
"context"
"fmt"
"github.com/aws/aws-sdk-go-v2/aws"
"github.com/aws/aws-sdk-go-v2/internal/awsutil"
)
type CreateInstancesInput struct {
_ struct{} `type:"structure"`
// An array of objects representing the add-ons to enable for the new instance.
AddOns []AddOnRequest `locationName:"addOns" type:"list"`
// 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.
//
// AvailabilityZone is a required field
AvailabilityZone *string `locationName:"availabilityZone" type:"string" required:"true"`
// 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.
//
// BlueprintId is a required field
BlueprintId *string `locationName:"blueprintId" type:"string" required:"true"`
// The bundle of specification information for your virtual private server (or
// instance), including the pricing plan (e.g., micro_1_0).
//
// BundleId is a required field
BundleId *string `locationName:"bundleId" type:"string" required:"true"`
// (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.
CustomImageName *string `locationName:"customImageName" deprecated:"true" type:"string"`
// The names to use for your new Lightsail instances. Separate multiple values
// using quotation marks and commas, for example: ["MyFirstInstance","MySecondInstance"]
//
// InstanceNames is a required field
InstanceNames []string `locationName:"instanceNames" type:"list" required:"true"`
// The name of your key pair.
KeyPairName *string `locationName:"keyPairName" type:"string"`
// The tag keys and optional values to add to the resource during create.
//
// To tag a resource after it has been created, see the tag resource operation.
Tags []Tag `locationName:"tags" type:"list"`
// 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 Dev Guide
// (https://lightsail.aws.amazon.com/ls/docs/getting-started/article/compare-options-choose-lightsail-instance-image).
UserData *string `locationName:"userData" type:"string"`
}
// String returns the string representation
func (s CreateInstancesInput) String() string {
return awsutil.Prettify(s)
}
// Validate inspects the fields of the type to determine if they are valid.
func (s *CreateInstancesInput) Validate() error {
invalidParams := aws.ErrInvalidParams{Context: "CreateInstancesInput"}
if s.AvailabilityZone == nil {
invalidParams.Add(aws.NewErrParamRequired("AvailabilityZone"))
}
if s.BlueprintId == nil {
invalidParams.Add(aws.NewErrParamRequired("BlueprintId"))
}
if s.BundleId == nil {
invalidParams.Add(aws.NewErrParamRequired("BundleId"))
}
if s.InstanceNames == nil {
invalidParams.Add(aws.NewErrParamRequired("InstanceNames"))
}
if s.AddOns != nil {
for i, v := range s.AddOns {
if err := v.Validate(); err != nil {
invalidParams.AddNested(fmt.Sprintf("%s[%v]", "AddOns", i), err.(aws.ErrInvalidParams))
}
}
}
if invalidParams.Len() > 0 {
return invalidParams
}
return nil
}
type CreateInstancesOutput struct {
_ struct{} `type:"structure"`
// An array of objects that describe the result of the action, such as the status
// of the request, the time stamp of the request, and the resources affected
// by the request.
Operations []Operation `locationName:"operations" type:"list"`
}
// String returns the string representation
func (s CreateInstancesOutput) String() string {
return awsutil.Prettify(s)
}
const opCreateInstances = "CreateInstances"
// CreateInstancesRequest returns a request value for making API operation for
// Amazon Lightsail.
//
// 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 Dev Guide (https://lightsail.aws.amazon.com/ls/docs/en/articles/amazon-lightsail-controlling-access-using-tags).
//
// // Example sending a request using CreateInstancesRequest.
// req := client.CreateInstancesRequest(params)
// resp, err := req.Send(context.TODO())
// if err == nil {
// fmt.Println(resp)
// }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lightsail-2016-11-28/CreateInstances
func (c *Client) CreateInstancesRequest(input *CreateInstancesInput) CreateInstancesRequest {
op := &aws.Operation{
Name: opCreateInstances,
HTTPMethod: "POST",
HTTPPath: "/",
}
if input == nil {
input = &CreateInstancesInput{}
}
req := c.newRequest(op, input, &CreateInstancesOutput{})
return CreateInstancesRequest{Request: req, Input: input, Copy: c.CreateInstancesRequest}
}
// CreateInstancesRequest is the request type for the
// CreateInstances API operation.
type CreateInstancesRequest struct {
*aws.Request
Input *CreateInstancesInput
Copy func(*CreateInstancesInput) CreateInstancesRequest
}
// Send marshals and sends the CreateInstances API request.
func (r CreateInstancesRequest) Send(ctx context.Context) (*CreateInstancesResponse, error) {
r.Request.SetContext(ctx)
err := r.Request.Send()
if err != nil {
return nil, err
}
resp := &CreateInstancesResponse{
CreateInstancesOutput: r.Request.Data.(*CreateInstancesOutput),
response: &aws.Response{Request: r.Request},
}
return resp, nil
}
// CreateInstancesResponse is the response type for the
// CreateInstances API operation.
type CreateInstancesResponse struct {
*CreateInstancesOutput
response *aws.Response
}
// SDKResponseMetdata returns the response metadata for the
// CreateInstances request.
func (r *CreateInstancesResponse) SDKResponseMetdata() *aws.Response {
return r.response
}