AWS::Batch::SchedulingPolicy FairsharePolicy
The fair share policy for a scheduling policy.
Syntax
To declare this entity in your Amazon CloudFormation template, use the following syntax:
JSON
{ "ComputeReservation" :
Number
, "ShareDecaySeconds" :Number
, "ShareDistribution" :[ ShareAttributes, ... ]
}
YAML
ComputeReservation:
Number
ShareDecaySeconds:Number
ShareDistribution:- ShareAttributes
Properties
-
A value used to reserve some of the available maximum vCPU for fair share identifiers that aren't already used.
The reserved ratio is
(computeReservation/100)^ActiveFairShares
whereActiveFairShares
is the number of active fair share identifiers.For example, a
computeReservation
value of 50 indicates that Amazon Batch reserves 50% of the maximum available vCPU if there's only one fair share identifier. It reserves 25% if there are two fair share identifiers. It reserves 12.5% if there are three fair share identifiers. AcomputeReservation
value of 25 indicates that Amazon Batch should reserve 25% of the maximum available vCPU if there's only one fair share identifier, 6.25% if there are two fair share identifiers, and 1.56% if there are three fair share identifiers.The minimum value is 0 and the maximum value is 99.
Required: No
Type: Number
Minimum:
0
Maximum:
99
Update requires: No interruption
-
The amount of time (in seconds) to use to calculate a fair share percentage for each fair share identifier in use. A value of zero (0) indicates that only current usage is measured. The decay allows for more recently run jobs to have more weight than jobs that ran earlier. The maximum supported value is 604800 (1 week).
Required: No
Type: Number
Minimum:
0
Maximum:
604800
Update requires: No interruption
-
An array of
SharedIdentifier
objects that contain the weights for the fair share identifiers for the fair share policy. Fair share identifiers that aren't included have a default weight of1.0
.Required: No
Type: Array of ShareAttributes
Update requires: No interruption
See also
-
FairsharePolicy in the Amazon Batch API Reference .