Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Updates capacity settings for a fleet. For fleets with multiple locations, use this operation to manage capacity settings in each location individually. Fleet capacity determines the number of game sessions and players that can be hosted based on the fleet configuration. Use this operation to set the following fleet capacity properties:
- Minimum/maximum size: Set hard limits on fleet capacity. GameLift cannot set the fleet's capacity to a value outside of this range, whether the capacity is changed manually or through automatic scaling.
- Desired capacity: Manually set the number of Amazon EC2 instances to be maintained in a fleet location. Before changing a fleet's desired capacity, you may want to call DescribeEC2InstanceLimits to get the maximum capacity of the fleet's Amazon EC2 instance type. Alternatively, consider using automatic scaling to adjust capacity based on player demand.
This operation can be used in the following ways:
- To update capacity for a fleet's home Region, or if the fleet has
no remote locations, omit the
Location
parameter. The fleet must be inACTIVE
status. - To update capacity for a fleet's remote location, include the
Location
parameter set to the location to be updated. The location must be inACTIVE
status.
If successful, capacity settings are updated immediately. In response a
change in desired capacity, GameLift initiates steps to start new
instances or terminate existing instances in the requested fleet
location. This continues until the location's active instance count
matches the new desired instance count. You can track a fleet's current
capacity by calling
DescribeFleetCapacity
or
DescribeFleetLocationCapacity.
If the requested desired instance count is higher than the instance
type's limit, the LimitExceeded
exception occurs.
Learn more
Synopsis
- data UpdateFleetCapacity = UpdateFleetCapacity' {}
- newUpdateFleetCapacity :: Text -> UpdateFleetCapacity
- updateFleetCapacity_desiredInstances :: Lens' UpdateFleetCapacity (Maybe Natural)
- updateFleetCapacity_location :: Lens' UpdateFleetCapacity (Maybe Text)
- updateFleetCapacity_maxSize :: Lens' UpdateFleetCapacity (Maybe Natural)
- updateFleetCapacity_minSize :: Lens' UpdateFleetCapacity (Maybe Natural)
- updateFleetCapacity_fleetId :: Lens' UpdateFleetCapacity Text
- data UpdateFleetCapacityResponse = UpdateFleetCapacityResponse' {}
- newUpdateFleetCapacityResponse :: Int -> UpdateFleetCapacityResponse
- updateFleetCapacityResponse_fleetArn :: Lens' UpdateFleetCapacityResponse (Maybe Text)
- updateFleetCapacityResponse_fleetId :: Lens' UpdateFleetCapacityResponse (Maybe Text)
- updateFleetCapacityResponse_location :: Lens' UpdateFleetCapacityResponse (Maybe Text)
- updateFleetCapacityResponse_httpStatus :: Lens' UpdateFleetCapacityResponse Int
Creating a Request
data UpdateFleetCapacity Source #
See: newUpdateFleetCapacity
smart constructor.
UpdateFleetCapacity' | |
|
Instances
newUpdateFleetCapacity Source #
Create a value of UpdateFleetCapacity
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:desiredInstances:UpdateFleetCapacity'
, updateFleetCapacity_desiredInstances
- The number of Amazon EC2 instances you want to maintain in the specified
fleet location. This value must fall between the minimum and maximum
size limits.
UpdateFleetCapacity
, updateFleetCapacity_location
- The name of a remote location to update fleet capacity settings for, in
the form of an Amazon Web Services Region code such as us-west-2
.
$sel:maxSize:UpdateFleetCapacity'
, updateFleetCapacity_maxSize
- The maximum number of instances that are allowed in the specified fleet
location. If this parameter is not set, the default is 1.
$sel:minSize:UpdateFleetCapacity'
, updateFleetCapacity_minSize
- The minimum number of instances that are allowed in the specified fleet
location. If this parameter is not set, the default is 0.
UpdateFleetCapacity
, updateFleetCapacity_fleetId
- A unique identifier for the fleet to update capacity settings for. You
can use either the fleet ID or ARN value.
Request Lenses
updateFleetCapacity_desiredInstances :: Lens' UpdateFleetCapacity (Maybe Natural) Source #
The number of Amazon EC2 instances you want to maintain in the specified fleet location. This value must fall between the minimum and maximum size limits.
updateFleetCapacity_location :: Lens' UpdateFleetCapacity (Maybe Text) Source #
The name of a remote location to update fleet capacity settings for, in
the form of an Amazon Web Services Region code such as us-west-2
.
updateFleetCapacity_maxSize :: Lens' UpdateFleetCapacity (Maybe Natural) Source #
The maximum number of instances that are allowed in the specified fleet location. If this parameter is not set, the default is 1.
updateFleetCapacity_minSize :: Lens' UpdateFleetCapacity (Maybe Natural) Source #
The minimum number of instances that are allowed in the specified fleet location. If this parameter is not set, the default is 0.
updateFleetCapacity_fleetId :: Lens' UpdateFleetCapacity Text Source #
A unique identifier for the fleet to update capacity settings for. You can use either the fleet ID or ARN value.
Destructuring the Response
data UpdateFleetCapacityResponse Source #
See: newUpdateFleetCapacityResponse
smart constructor.
UpdateFleetCapacityResponse' | |
|
Instances
newUpdateFleetCapacityResponse Source #
Create a value of UpdateFleetCapacityResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
UpdateFleetCapacityResponse
, updateFleetCapacityResponse_fleetArn
- The Amazon Resource Name
(ARN)
that is assigned to a GameLift fleet resource and uniquely identifies
it. ARNs are unique across all Regions. Format is
arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912
.
UpdateFleetCapacity
, updateFleetCapacityResponse_fleetId
- A unique identifier for the fleet that was updated.
UpdateFleetCapacity
, updateFleetCapacityResponse_location
- The remote location being updated, expressed as an Amazon Web Services
Region code, such as us-west-2
.
$sel:httpStatus:UpdateFleetCapacityResponse'
, updateFleetCapacityResponse_httpStatus
- The response's http status code.
Response Lenses
updateFleetCapacityResponse_fleetArn :: Lens' UpdateFleetCapacityResponse (Maybe Text) Source #
The Amazon Resource Name
(ARN)
that is assigned to a GameLift fleet resource and uniquely identifies
it. ARNs are unique across all Regions. Format is
arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912
.
updateFleetCapacityResponse_fleetId :: Lens' UpdateFleetCapacityResponse (Maybe Text) Source #
A unique identifier for the fleet that was updated.
updateFleetCapacityResponse_location :: Lens' UpdateFleetCapacityResponse (Maybe Text) Source #
The remote location being updated, expressed as an Amazon Web Services
Region code, such as us-west-2
.
updateFleetCapacityResponse_httpStatus :: Lens' UpdateFleetCapacityResponse Int Source #
The response's http status code.