/
api_op_CreateGameServerGroup.go
278 lines (253 loc) · 12.8 KB
/
api_op_CreateGameServerGroup.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
// Code generated by smithy-go-codegen DO NOT EDIT.
package gamelift
import (
"context"
"fmt"
awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
"github.com/aws/aws-sdk-go-v2/service/gamelift/types"
"github.com/aws/smithy-go/middleware"
smithyhttp "github.com/aws/smithy-go/transport/http"
)
// This operation is used with the Amazon GameLift FleetIQ solution and game
// server groups. Creates a Amazon GameLift FleetIQ game server group for managing
// game hosting on a collection of Amazon Elastic Compute Cloud instances for game
// hosting. This operation creates the game server group, creates an Auto Scaling
// group in your Amazon Web Services account, and establishes a link between the
// two groups. You can view the status of your game server groups in the Amazon
// GameLift console. Game server group metrics and events are emitted to Amazon
// CloudWatch. Before creating a new game server group, you must have the
// following:
// - An Amazon Elastic Compute Cloud launch template that specifies how to
// launch Amazon Elastic Compute Cloud instances with your game server build. For
// more information, see Launching an Instance from a Launch Template (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html)
// in the Amazon Elastic Compute Cloud User Guide.
// - An IAM role that extends limited access to your Amazon Web Services account
// to allow Amazon GameLift FleetIQ to create and interact with the Auto Scaling
// group. For more information, see Create IAM roles for cross-service
// interaction (https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-iam-permissions-roles.html)
// in the Amazon GameLift FleetIQ Developer Guide.
//
// To create a new game server group, specify a unique group name, IAM role and
// Amazon Elastic Compute Cloud launch template, and provide a list of instance
// types that can be used in the group. You must also set initial maximum and
// minimum limits on the group's instance count. You can optionally set an Auto
// Scaling policy with target tracking based on a Amazon GameLift FleetIQ metric.
// Once the game server group and corresponding Auto Scaling group are created, you
// have full access to change the Auto Scaling group's configuration as needed.
// Several properties that are set when creating a game server group, including
// maximum/minimum size and auto-scaling policy settings, must be updated directly
// in the Auto Scaling group. Keep in mind that some Auto Scaling group properties
// are periodically updated by Amazon GameLift FleetIQ as part of its balancing
// activities to optimize for availability and cost. Learn more Amazon GameLift
// FleetIQ Guide (https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html)
func (c *Client) CreateGameServerGroup(ctx context.Context, params *CreateGameServerGroupInput, optFns ...func(*Options)) (*CreateGameServerGroupOutput, error) {
if params == nil {
params = &CreateGameServerGroupInput{}
}
result, metadata, err := c.invokeOperation(ctx, "CreateGameServerGroup", params, optFns, c.addOperationCreateGameServerGroupMiddlewares)
if err != nil {
return nil, err
}
out := result.(*CreateGameServerGroupOutput)
out.ResultMetadata = metadata
return out, nil
}
type CreateGameServerGroupInput struct {
// An identifier for the new game server group. This value is used to generate
// unique ARN identifiers for the Amazon EC2 Auto Scaling group and the Amazon
// GameLift FleetIQ game server group. The name must be unique per Region per
// Amazon Web Services account.
//
// This member is required.
GameServerGroupName *string
// The Amazon EC2 instance types and sizes to use in the Auto Scaling group. The
// instance definitions must specify at least two different instance types that are
// supported by Amazon GameLift FleetIQ. For more information on instance types,
// see EC2 Instance Types (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)
// in the Amazon Elastic Compute Cloud User Guide. You can optionally specify
// capacity weighting for each instance type. If no weight value is specified for
// an instance type, it is set to the default value "1". For more information about
// capacity weighting, see Instance Weighting for Amazon EC2 Auto Scaling (https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-weighting.html)
// in the Amazon EC2 Auto Scaling User Guide.
//
// This member is required.
InstanceDefinitions []types.InstanceDefinition
// The Amazon EC2 launch template that contains configuration settings and game
// server code to be deployed to all instances in the game server group. You can
// specify the template using either the template name or ID. For help with
// creating a launch template, see Creating a Launch Template for an Auto Scaling
// Group (https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html)
// in the Amazon Elastic Compute Cloud Auto Scaling User Guide. After the Auto
// Scaling group is created, update this value directly in the Auto Scaling group
// using the Amazon Web Services console or APIs. If you specify network interfaces
// in your launch template, you must explicitly set the property
// AssociatePublicIpAddress to "true". If no network interface is specified in the
// launch template, Amazon GameLift FleetIQ uses your account's default VPC.
//
// This member is required.
LaunchTemplate *types.LaunchTemplateSpecification
// The maximum number of instances allowed in the Amazon EC2 Auto Scaling group.
// During automatic scaling events, Amazon GameLift FleetIQ and EC2 do not scale up
// the group above this maximum. After the Auto Scaling group is created, update
// this value directly in the Auto Scaling group using the Amazon Web Services
// console or APIs.
//
// This member is required.
MaxSize *int32
// The minimum number of instances allowed in the Amazon EC2 Auto Scaling group.
// During automatic scaling events, Amazon GameLift FleetIQ and Amazon EC2 do not
// scale down the group below this minimum. In production, this value should be set
// to at least 1. After the Auto Scaling group is created, update this value
// directly in the Auto Scaling group using the Amazon Web Services console or
// APIs.
//
// This member is required.
MinSize *int32
// The Amazon Resource Name ( ARN (https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html)
// ) for an IAM role that allows Amazon GameLift to access your Amazon EC2 Auto
// Scaling groups.
//
// This member is required.
RoleArn *string
// Configuration settings to define a scaling policy for the Auto Scaling group
// that is optimized for game hosting. The scaling policy uses the metric
// "PercentUtilizedGameServers" to maintain a buffer of idle game servers that can
// immediately accommodate new games and players. After the Auto Scaling group is
// created, update this value directly in the Auto Scaling group using the Amazon
// Web Services console or APIs.
AutoScalingPolicy *types.GameServerGroupAutoScalingPolicy
// Indicates how Amazon GameLift FleetIQ balances the use of Spot Instances and
// On-Demand Instances in the game server group. Method options include the
// following:
// - SPOT_ONLY - Only Spot Instances are used in the game server group. If Spot
// Instances are unavailable or not viable for game hosting, the game server group
// provides no hosting capacity until Spot Instances can again be used. Until then,
// no new instances are started, and the existing nonviable Spot Instances are
// terminated (after current gameplay ends) and are not replaced.
// - SPOT_PREFERRED - (default value) Spot Instances are used whenever available
// in the game server group. If Spot Instances are unavailable, the game server
// group continues to provide hosting capacity by falling back to On-Demand
// Instances. Existing nonviable Spot Instances are terminated (after current
// gameplay ends) and are replaced with new On-Demand Instances.
// - ON_DEMAND_ONLY - Only On-Demand Instances are used in the game server group.
// No Spot Instances are used, even when available, while this balancing strategy
// is in force.
BalancingStrategy types.BalancingStrategy
// A flag that indicates whether instances in the game server group are protected
// from early termination. Unprotected instances that have active game servers
// running might be terminated during a scale-down event, causing players to be
// dropped from the game. Protected instances cannot be terminated while there are
// active game servers running except in the event of a forced game server group
// deletion (see ). An exception to this is with Spot Instances, which can be
// terminated by Amazon Web Services regardless of protection status. This property
// is set to NO_PROTECTION by default.
GameServerProtectionPolicy types.GameServerProtectionPolicy
// A list of labels to assign to the new game server group resource. Tags are
// developer-defined key-value pairs. Tagging Amazon Web Services resources is
// useful for resource management, access management, and cost allocation. For more
// information, see Tagging Amazon Web Services Resources (https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)
// in the Amazon Web Services General Reference.
Tags []types.Tag
// A list of virtual private cloud (VPC) subnets to use with instances in the game
// server group. By default, all Amazon GameLift FleetIQ-supported Availability
// Zones are used. You can use this parameter to specify VPCs that you've set up.
// This property cannot be updated after the game server group is created, and the
// corresponding Auto Scaling group will always use the property value that is set
// with this request, even if the Auto Scaling group is updated directly.
VpcSubnets []string
noSmithyDocumentSerde
}
type CreateGameServerGroupOutput struct {
// The newly created game server group object, including the new ARN value for the
// Amazon GameLift FleetIQ game server group and the object's status. The Amazon
// EC2 Auto Scaling group ARN is initially null, since the group has not yet been
// created. This value is added once the game server group status reaches ACTIVE .
GameServerGroup *types.GameServerGroup
// Metadata pertaining to the operation's result.
ResultMetadata middleware.Metadata
noSmithyDocumentSerde
}
func (c *Client) addOperationCreateGameServerGroupMiddlewares(stack *middleware.Stack, options Options) (err error) {
if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil {
return err
}
err = stack.Serialize.Add(&awsAwsjson11_serializeOpCreateGameServerGroup{}, middleware.After)
if err != nil {
return err
}
err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpCreateGameServerGroup{}, middleware.After)
if err != nil {
return err
}
if err := addProtocolFinalizerMiddlewares(stack, options, "CreateGameServerGroup"); 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 = addOpCreateGameServerGroupValidationMiddleware(stack); err != nil {
return err
}
if err = stack.Initialize.Add(newServiceMetadataMiddleware_opCreateGameServerGroup(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_opCreateGameServerGroup(region string) *awsmiddleware.RegisterServiceMetadata {
return &awsmiddleware.RegisterServiceMetadata{
Region: region,
ServiceID: ServiceID,
OperationName: "CreateGameServerGroup",
}
}