AWS SDK for C++  1.8.129
AWS SDK for C++
Public Member Functions | List of all members
Aws::GameLift::Model::ScalingPolicy Class Reference

#include <ScalingPolicy.h>

Public Member Functions

 ScalingPolicy ()
 
 ScalingPolicy (Aws::Utils::Json::JsonView jsonValue)
 
ScalingPolicyoperator= (Aws::Utils::Json::JsonView jsonValue)
 
Aws::Utils::Json::JsonValue Jsonize () const
 
const Aws::StringGetFleetId () const
 
bool FleetIdHasBeenSet () const
 
void SetFleetId (const Aws::String &value)
 
void SetFleetId (Aws::String &&value)
 
void SetFleetId (const char *value)
 
ScalingPolicyWithFleetId (const Aws::String &value)
 
ScalingPolicyWithFleetId (Aws::String &&value)
 
ScalingPolicyWithFleetId (const char *value)
 
const Aws::StringGetName () const
 
bool NameHasBeenSet () const
 
void SetName (const Aws::String &value)
 
void SetName (Aws::String &&value)
 
void SetName (const char *value)
 
ScalingPolicyWithName (const Aws::String &value)
 
ScalingPolicyWithName (Aws::String &&value)
 
ScalingPolicyWithName (const char *value)
 
const ScalingStatusTypeGetStatus () const
 
bool StatusHasBeenSet () const
 
void SetStatus (const ScalingStatusType &value)
 
void SetStatus (ScalingStatusType &&value)
 
ScalingPolicyWithStatus (const ScalingStatusType &value)
 
ScalingPolicyWithStatus (ScalingStatusType &&value)
 
int GetScalingAdjustment () const
 
bool ScalingAdjustmentHasBeenSet () const
 
void SetScalingAdjustment (int value)
 
ScalingPolicyWithScalingAdjustment (int value)
 
const ScalingAdjustmentTypeGetScalingAdjustmentType () const
 
bool ScalingAdjustmentTypeHasBeenSet () const
 
void SetScalingAdjustmentType (const ScalingAdjustmentType &value)
 
void SetScalingAdjustmentType (ScalingAdjustmentType &&value)
 
ScalingPolicyWithScalingAdjustmentType (const ScalingAdjustmentType &value)
 
ScalingPolicyWithScalingAdjustmentType (ScalingAdjustmentType &&value)
 
const ComparisonOperatorTypeGetComparisonOperator () const
 
bool ComparisonOperatorHasBeenSet () const
 
void SetComparisonOperator (const ComparisonOperatorType &value)
 
void SetComparisonOperator (ComparisonOperatorType &&value)
 
ScalingPolicyWithComparisonOperator (const ComparisonOperatorType &value)
 
ScalingPolicyWithComparisonOperator (ComparisonOperatorType &&value)
 
double GetThreshold () const
 
bool ThresholdHasBeenSet () const
 
void SetThreshold (double value)
 
ScalingPolicyWithThreshold (double value)
 
int GetEvaluationPeriods () const
 
bool EvaluationPeriodsHasBeenSet () const
 
void SetEvaluationPeriods (int value)
 
ScalingPolicyWithEvaluationPeriods (int value)
 
const MetricNameGetMetricName () const
 
bool MetricNameHasBeenSet () const
 
void SetMetricName (const MetricName &value)
 
void SetMetricName (MetricName &&value)
 
ScalingPolicyWithMetricName (const MetricName &value)
 
ScalingPolicyWithMetricName (MetricName &&value)
 
const PolicyTypeGetPolicyType () const
 
bool PolicyTypeHasBeenSet () const
 
void SetPolicyType (const PolicyType &value)
 
void SetPolicyType (PolicyType &&value)
 
ScalingPolicyWithPolicyType (const PolicyType &value)
 
ScalingPolicyWithPolicyType (PolicyType &&value)
 
const TargetConfigurationGetTargetConfiguration () const
 
bool TargetConfigurationHasBeenSet () const
 
void SetTargetConfiguration (const TargetConfiguration &value)
 
void SetTargetConfiguration (TargetConfiguration &&value)
 
ScalingPolicyWithTargetConfiguration (const TargetConfiguration &value)
 
ScalingPolicyWithTargetConfiguration (TargetConfiguration &&value)
 

Detailed Description

Rule that controls how a fleet is scaled. Scaling policies are uniquely identified by the combination of name and fleet ID.

See Also:

AWS API Reference

Definition at line 45 of file ScalingPolicy.h.

Constructor & Destructor Documentation

◆ ScalingPolicy() [1/2]

Aws::GameLift::Model::ScalingPolicy::ScalingPolicy ( )

◆ ScalingPolicy() [2/2]

Aws::GameLift::Model::ScalingPolicy::ScalingPolicy ( Aws::Utils::Json::JsonView  jsonValue)

Member Function Documentation

◆ ComparisonOperatorHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::ComparisonOperatorHasBeenSet ( ) const
inline

Comparison operator to use when measuring a metric against the threshold value.

Definition at line 365 of file ScalingPolicy.h.

◆ EvaluationPeriodsHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::EvaluationPeriodsHasBeenSet ( ) const
inline

Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.

Definition at line 423 of file ScalingPolicy.h.

◆ FleetIdHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::FleetIdHasBeenSet ( ) const
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 64 of file ScalingPolicy.h.

◆ GetComparisonOperator()

const ComparisonOperatorType& Aws::GameLift::Model::ScalingPolicy::GetComparisonOperator ( ) const
inline

Comparison operator to use when measuring a metric against the threshold value.

Definition at line 359 of file ScalingPolicy.h.

◆ GetEvaluationPeriods()

int Aws::GameLift::Model::ScalingPolicy::GetEvaluationPeriods ( ) const
inline

Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.

Definition at line 417 of file ScalingPolicy.h.

◆ GetFleetId()

const Aws::String& Aws::GameLift::Model::ScalingPolicy::GetFleetId ( ) const
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 58 of file ScalingPolicy.h.

◆ GetMetricName()

const MetricName& Aws::GameLift::Model::ScalingPolicy::GetMetricName ( ) const
inline

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions – Game sessions in the process of being created.

  • ActiveGameSessions – Game sessions that are currently running.

  • ActiveInstances – Fleet instances that are currently running at least one game session.

  • AvailableGameSessions – Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions – Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessionsPlayer slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances – Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions – Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances – Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth – Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime – Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

Definition at line 466 of file ScalingPolicy.h.

◆ GetName()

const Aws::String& Aws::GameLift::Model::ScalingPolicy::GetName ( ) const
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 107 of file ScalingPolicy.h.

◆ GetPolicyType()

const PolicyType& Aws::GameLift::Model::ScalingPolicy::GetPolicyType ( ) const
inline

The type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

Definition at line 627 of file ScalingPolicy.h.

◆ GetScalingAdjustment()

int Aws::GameLift::Model::ScalingPolicy::GetScalingAdjustment ( ) const
inline

Amount of adjustment to make, based on the scaling adjustment type.

Definition at line 264 of file ScalingPolicy.h.

◆ GetScalingAdjustmentType()

const ScalingAdjustmentType& Aws::GameLift::Model::ScalingPolicy::GetScalingAdjustmentType ( ) const
inline

The type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity – set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.

Definition at line 292 of file ScalingPolicy.h.

◆ GetStatus()

const ScalingStatusType& Aws::GameLift::Model::ScalingPolicy::GetStatus ( ) const
inline

Current status of the scaling policy. The scaling policy can be in force only when in an ACTIVE status. Scaling policies can be suspended for individual fleets (see StopFleetActions; if suspended for a fleet, the policy status does not change. View a fleet's stopped actions by calling DescribeFleetCapacity.

  • ACTIVE – The scaling policy can be used for auto-scaling a fleet.

  • UPDATE_REQUESTED – A request to update the scaling policy has been received.

  • UPDATING – A change is being made to the scaling policy.

  • DELETE_REQUESTED – A request to delete the scaling policy has been received.

  • DELETING – The scaling policy is being deleted.

  • DELETED – The scaling policy has been deleted.

  • ERROR – An error occurred in creating the policy. It should be removed and recreated.

Definition at line 168 of file ScalingPolicy.h.

◆ GetTargetConfiguration()

const TargetConfiguration& Aws::GameLift::Model::ScalingPolicy::GetTargetConfiguration ( ) const
inline

The settings for a target-based scaling policy.

Definition at line 683 of file ScalingPolicy.h.

◆ GetThreshold()

double Aws::GameLift::Model::ScalingPolicy::GetThreshold ( ) const
inline

Metric value used to trigger a scaling event.

Definition at line 395 of file ScalingPolicy.h.

◆ Jsonize()

Aws::Utils::Json::JsonValue Aws::GameLift::Model::ScalingPolicy::Jsonize ( ) const

◆ MetricNameHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::MetricNameHasBeenSet ( ) const
inline

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions – Game sessions in the process of being created.

  • ActiveGameSessions – Game sessions that are currently running.

  • ActiveInstances – Fleet instances that are currently running at least one game session.

  • AvailableGameSessions – Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions – Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessionsPlayer slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances – Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions – Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances – Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth – Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime – Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

Definition at line 496 of file ScalingPolicy.h.

◆ NameHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::NameHasBeenSet ( ) const
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 113 of file ScalingPolicy.h.

◆ operator=()

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::operator= ( Aws::Utils::Json::JsonView  jsonValue)

◆ PolicyTypeHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::PolicyTypeHasBeenSet ( ) const
inline

The type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

Definition at line 637 of file ScalingPolicy.h.

◆ ScalingAdjustmentHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::ScalingAdjustmentHasBeenSet ( ) const
inline

Amount of adjustment to make, based on the scaling adjustment type.

Definition at line 269 of file ScalingPolicy.h.

◆ ScalingAdjustmentTypeHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::ScalingAdjustmentTypeHasBeenSet ( ) const
inline

The type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity – set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.

Definition at line 304 of file ScalingPolicy.h.

◆ SetComparisonOperator() [1/2]

void Aws::GameLift::Model::ScalingPolicy::SetComparisonOperator ( ComparisonOperatorType &&  value)
inline

Comparison operator to use when measuring a metric against the threshold value.

Definition at line 377 of file ScalingPolicy.h.

◆ SetComparisonOperator() [2/2]

void Aws::GameLift::Model::ScalingPolicy::SetComparisonOperator ( const ComparisonOperatorType value)
inline

Comparison operator to use when measuring a metric against the threshold value.

Definition at line 371 of file ScalingPolicy.h.

◆ SetEvaluationPeriods()

void Aws::GameLift::Model::ScalingPolicy::SetEvaluationPeriods ( int  value)
inline

Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.

Definition at line 429 of file ScalingPolicy.h.

◆ SetFleetId() [1/3]

void Aws::GameLift::Model::ScalingPolicy::SetFleetId ( Aws::String &&  value)
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 76 of file ScalingPolicy.h.

◆ SetFleetId() [2/3]

void Aws::GameLift::Model::ScalingPolicy::SetFleetId ( const Aws::String value)
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 70 of file ScalingPolicy.h.

◆ SetFleetId() [3/3]

void Aws::GameLift::Model::ScalingPolicy::SetFleetId ( const char *  value)
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 82 of file ScalingPolicy.h.

◆ SetMetricName() [1/2]

void Aws::GameLift::Model::ScalingPolicy::SetMetricName ( const MetricName value)
inline

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions – Game sessions in the process of being created.

  • ActiveGameSessions – Game sessions that are currently running.

  • ActiveInstances – Fleet instances that are currently running at least one game session.

  • AvailableGameSessions – Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions – Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessionsPlayer slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances – Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions – Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances – Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth – Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime – Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

Definition at line 526 of file ScalingPolicy.h.

◆ SetMetricName() [2/2]

void Aws::GameLift::Model::ScalingPolicy::SetMetricName ( MetricName &&  value)
inline

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions – Game sessions in the process of being created.

  • ActiveGameSessions – Game sessions that are currently running.

  • ActiveInstances – Fleet instances that are currently running at least one game session.

  • AvailableGameSessions – Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions – Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessionsPlayer slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances – Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions – Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances – Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth – Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime – Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

Definition at line 556 of file ScalingPolicy.h.

◆ SetName() [1/3]

void Aws::GameLift::Model::ScalingPolicy::SetName ( Aws::String &&  value)
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 125 of file ScalingPolicy.h.

◆ SetName() [2/3]

void Aws::GameLift::Model::ScalingPolicy::SetName ( const Aws::String value)
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 119 of file ScalingPolicy.h.

◆ SetName() [3/3]

void Aws::GameLift::Model::ScalingPolicy::SetName ( const char *  value)
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 131 of file ScalingPolicy.h.

◆ SetPolicyType() [1/2]

void Aws::GameLift::Model::ScalingPolicy::SetPolicyType ( const PolicyType value)
inline

The type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

Definition at line 647 of file ScalingPolicy.h.

◆ SetPolicyType() [2/2]

void Aws::GameLift::Model::ScalingPolicy::SetPolicyType ( PolicyType &&  value)
inline

The type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

Definition at line 657 of file ScalingPolicy.h.

◆ SetScalingAdjustment()

void Aws::GameLift::Model::ScalingPolicy::SetScalingAdjustment ( int  value)
inline

Amount of adjustment to make, based on the scaling adjustment type.

Definition at line 274 of file ScalingPolicy.h.

◆ SetScalingAdjustmentType() [1/2]

void Aws::GameLift::Model::ScalingPolicy::SetScalingAdjustmentType ( const ScalingAdjustmentType value)
inline

The type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity – set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.

Definition at line 316 of file ScalingPolicy.h.

◆ SetScalingAdjustmentType() [2/2]

void Aws::GameLift::Model::ScalingPolicy::SetScalingAdjustmentType ( ScalingAdjustmentType &&  value)
inline

The type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity – set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.

Definition at line 328 of file ScalingPolicy.h.

◆ SetStatus() [1/2]

void Aws::GameLift::Model::ScalingPolicy::SetStatus ( const ScalingStatusType value)
inline

Current status of the scaling policy. The scaling policy can be in force only when in an ACTIVE status. Scaling policies can be suspended for individual fleets (see StopFleetActions; if suspended for a fleet, the policy status does not change. View a fleet's stopped actions by calling DescribeFleetCapacity.

  • ACTIVE – The scaling policy can be used for auto-scaling a fleet.

  • UPDATE_REQUESTED – A request to update the scaling policy has been received.

  • UPDATING – A change is being made to the scaling policy.

  • DELETE_REQUESTED – A request to delete the scaling policy has been received.

  • DELETING – The scaling policy is being deleted.

  • DELETED – The scaling policy has been deleted.

  • ERROR – An error occurred in creating the policy. It should be removed and recreated.

Definition at line 204 of file ScalingPolicy.h.

◆ SetStatus() [2/2]

void Aws::GameLift::Model::ScalingPolicy::SetStatus ( ScalingStatusType &&  value)
inline

Current status of the scaling policy. The scaling policy can be in force only when in an ACTIVE status. Scaling policies can be suspended for individual fleets (see StopFleetActions; if suspended for a fleet, the policy status does not change. View a fleet's stopped actions by calling DescribeFleetCapacity.

  • ACTIVE – The scaling policy can be used for auto-scaling a fleet.

  • UPDATE_REQUESTED – A request to update the scaling policy has been received.

  • UPDATING – A change is being made to the scaling policy.

  • DELETE_REQUESTED – A request to delete the scaling policy has been received.

  • DELETING – The scaling policy is being deleted.

  • DELETED – The scaling policy has been deleted.

  • ERROR – An error occurred in creating the policy. It should be removed and recreated.

Definition at line 222 of file ScalingPolicy.h.

◆ SetTargetConfiguration() [1/2]

void Aws::GameLift::Model::ScalingPolicy::SetTargetConfiguration ( const TargetConfiguration value)
inline

The settings for a target-based scaling policy.

Definition at line 693 of file ScalingPolicy.h.

◆ SetTargetConfiguration() [2/2]

void Aws::GameLift::Model::ScalingPolicy::SetTargetConfiguration ( TargetConfiguration &&  value)
inline

The settings for a target-based scaling policy.

Definition at line 698 of file ScalingPolicy.h.

◆ SetThreshold()

void Aws::GameLift::Model::ScalingPolicy::SetThreshold ( double  value)
inline

Metric value used to trigger a scaling event.

Definition at line 405 of file ScalingPolicy.h.

◆ StatusHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::StatusHasBeenSet ( ) const
inline

Current status of the scaling policy. The scaling policy can be in force only when in an ACTIVE status. Scaling policies can be suspended for individual fleets (see StopFleetActions; if suspended for a fleet, the policy status does not change. View a fleet's stopped actions by calling DescribeFleetCapacity.

  • ACTIVE – The scaling policy can be used for auto-scaling a fleet.

  • UPDATE_REQUESTED – A request to update the scaling policy has been received.

  • UPDATING – A change is being made to the scaling policy.

  • DELETE_REQUESTED – A request to delete the scaling policy has been received.

  • DELETING – The scaling policy is being deleted.

  • DELETED – The scaling policy has been deleted.

  • ERROR – An error occurred in creating the policy. It should be removed and recreated.

Definition at line 186 of file ScalingPolicy.h.

◆ TargetConfigurationHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::TargetConfigurationHasBeenSet ( ) const
inline

The settings for a target-based scaling policy.

Definition at line 688 of file ScalingPolicy.h.

◆ ThresholdHasBeenSet()

bool Aws::GameLift::Model::ScalingPolicy::ThresholdHasBeenSet ( ) const
inline

Metric value used to trigger a scaling event.

Definition at line 400 of file ScalingPolicy.h.

◆ WithComparisonOperator() [1/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithComparisonOperator ( ComparisonOperatorType &&  value)
inline

Comparison operator to use when measuring a metric against the threshold value.

Definition at line 389 of file ScalingPolicy.h.

◆ WithComparisonOperator() [2/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithComparisonOperator ( const ComparisonOperatorType value)
inline

Comparison operator to use when measuring a metric against the threshold value.

Definition at line 383 of file ScalingPolicy.h.

◆ WithEvaluationPeriods()

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithEvaluationPeriods ( int  value)
inline

Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.

Definition at line 435 of file ScalingPolicy.h.

◆ WithFleetId() [1/3]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithFleetId ( Aws::String &&  value)
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 94 of file ScalingPolicy.h.

◆ WithFleetId() [2/3]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithFleetId ( const Aws::String value)
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 88 of file ScalingPolicy.h.

◆ WithFleetId() [3/3]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithFleetId ( const char *  value)
inline

A unique identifier for a fleet that is associated with this scaling policy.

Definition at line 100 of file ScalingPolicy.h.

◆ WithMetricName() [1/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithMetricName ( const MetricName value)
inline

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions – Game sessions in the process of being created.

  • ActiveGameSessions – Game sessions that are currently running.

  • ActiveInstances – Fleet instances that are currently running at least one game session.

  • AvailableGameSessions – Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions – Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessionsPlayer slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances – Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions – Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances – Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth – Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime – Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

Definition at line 586 of file ScalingPolicy.h.

◆ WithMetricName() [2/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithMetricName ( MetricName &&  value)
inline

Name of the Amazon GameLift-defined metric that is used to trigger a scaling adjustment. For detailed descriptions of fleet metrics, see Monitor Amazon GameLift with Amazon CloudWatch.

  • ActivatingGameSessions – Game sessions in the process of being created.

  • ActiveGameSessions – Game sessions that are currently running.

  • ActiveInstances – Fleet instances that are currently running at least one game session.

  • AvailableGameSessions – Additional game sessions that fleet could host simultaneously, given current capacity.

  • AvailablePlayerSessions – Empty player slots in currently active game sessions. This includes game sessions that are not currently accepting players. Reserved player slots are not included.

  • CurrentPlayerSessionsPlayer slots in active game sessions that are being used by a player or are reserved for a player.

  • IdleInstances – Active instances that are currently hosting zero game sessions.

  • PercentAvailableGameSessions – Unused percentage of the total number of game sessions that a fleet could host simultaneously, given current capacity. Use this metric for a target-based scaling policy.

  • PercentIdleInstances – Percentage of the total number of active instances that are hosting zero game sessions.

  • QueueDepth – Pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

  • WaitTime – Current wait time for pending game session placement requests, in any queue, where the current fleet is the top-priority destination.

Definition at line 616 of file ScalingPolicy.h.

◆ WithName() [1/3]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithName ( Aws::String &&  value)
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 143 of file ScalingPolicy.h.

◆ WithName() [2/3]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithName ( const Aws::String value)
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 137 of file ScalingPolicy.h.

◆ WithName() [3/3]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithName ( const char *  value)
inline

A descriptive label that is associated with a scaling policy. Policy names do not need to be unique.

Definition at line 149 of file ScalingPolicy.h.

◆ WithPolicyType() [1/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithPolicyType ( const PolicyType value)
inline

The type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

Definition at line 667 of file ScalingPolicy.h.

◆ WithPolicyType() [2/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithPolicyType ( PolicyType &&  value)
inline

The type of scaling policy to create. For a target-based policy, set the parameter MetricName to 'PercentAvailableGameSessions' and specify a TargetConfiguration. For a rule-based policy set the following parameters: MetricName, ComparisonOperator, Threshold, EvaluationPeriods, ScalingAdjustmentType, and ScalingAdjustment.

Definition at line 677 of file ScalingPolicy.h.

◆ WithScalingAdjustment()

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithScalingAdjustment ( int  value)
inline

Amount of adjustment to make, based on the scaling adjustment type.

Definition at line 279 of file ScalingPolicy.h.

◆ WithScalingAdjustmentType() [1/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithScalingAdjustmentType ( const ScalingAdjustmentType value)
inline

The type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity – set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.

Definition at line 340 of file ScalingPolicy.h.

◆ WithScalingAdjustmentType() [2/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithScalingAdjustmentType ( ScalingAdjustmentType &&  value)
inline

The type of adjustment to make to a fleet's instance count (see FleetCapacity):

  • ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down.

  • ExactCapacity – set the instance count to the scaling adjustment value.

  • PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.

Definition at line 352 of file ScalingPolicy.h.

◆ WithStatus() [1/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithStatus ( const ScalingStatusType value)
inline

Current status of the scaling policy. The scaling policy can be in force only when in an ACTIVE status. Scaling policies can be suspended for individual fleets (see StopFleetActions; if suspended for a fleet, the policy status does not change. View a fleet's stopped actions by calling DescribeFleetCapacity.

  • ACTIVE – The scaling policy can be used for auto-scaling a fleet.

  • UPDATE_REQUESTED – A request to update the scaling policy has been received.

  • UPDATING – A change is being made to the scaling policy.

  • DELETE_REQUESTED – A request to delete the scaling policy has been received.

  • DELETING – The scaling policy is being deleted.

  • DELETED – The scaling policy has been deleted.

  • ERROR – An error occurred in creating the policy. It should be removed and recreated.

Definition at line 240 of file ScalingPolicy.h.

◆ WithStatus() [2/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithStatus ( ScalingStatusType &&  value)
inline

Current status of the scaling policy. The scaling policy can be in force only when in an ACTIVE status. Scaling policies can be suspended for individual fleets (see StopFleetActions; if suspended for a fleet, the policy status does not change. View a fleet's stopped actions by calling DescribeFleetCapacity.

  • ACTIVE – The scaling policy can be used for auto-scaling a fleet.

  • UPDATE_REQUESTED – A request to update the scaling policy has been received.

  • UPDATING – A change is being made to the scaling policy.

  • DELETE_REQUESTED – A request to delete the scaling policy has been received.

  • DELETING – The scaling policy is being deleted.

  • DELETED – The scaling policy has been deleted.

  • ERROR – An error occurred in creating the policy. It should be removed and recreated.

Definition at line 258 of file ScalingPolicy.h.

◆ WithTargetConfiguration() [1/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithTargetConfiguration ( const TargetConfiguration value)
inline

The settings for a target-based scaling policy.

Definition at line 703 of file ScalingPolicy.h.

◆ WithTargetConfiguration() [2/2]

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithTargetConfiguration ( TargetConfiguration &&  value)
inline

The settings for a target-based scaling policy.

Definition at line 708 of file ScalingPolicy.h.

◆ WithThreshold()

ScalingPolicy& Aws::GameLift::Model::ScalingPolicy::WithThreshold ( double  value)
inline

Metric value used to trigger a scaling event.

Definition at line 410 of file ScalingPolicy.h.


The documentation for this class was generated from the following file: