aws-cdk-lib.aws_batch.CfnSchedulingPolicy.FairsharePolicyProperty

interface FairsharePolicyProperty

LanguageType name
.NETAmazon.CDK.AWS.Batch.CfnSchedulingPolicy.FairsharePolicyProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsbatch#CfnSchedulingPolicy_FairsharePolicyProperty
Javasoftware.amazon.awscdk.services.batch.CfnSchedulingPolicy.FairsharePolicyProperty
Pythonaws_cdk.aws_batch.CfnSchedulingPolicy.FairsharePolicyProperty
TypeScript aws-cdk-lib » aws_batch » CfnSchedulingPolicy » FairsharePolicyProperty

The fair share policy for a scheduling policy.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_batch as batch } from 'aws-cdk-lib';
const fairsharePolicyProperty: batch.CfnSchedulingPolicy.FairsharePolicyProperty = {
  computeReservation: 123,
  shareDecaySeconds: 123,
  shareDistribution: [{
    shareIdentifier: 'shareIdentifier',
    weightFactor: 123,
  }],
};

Properties

NameTypeDescription
computeReservation?numberA value used to reserve some of the available maximum vCPU for fair share identifiers that aren't already used.
shareDecaySeconds?numberThe amount of time (in seconds) to use to calculate a fair share percentage for each fair share identifier in use.
shareDistribution?IResolvable | IResolvable | ShareAttributesProperty[]An array of SharedIdentifier objects that contain the weights for the fair share identifiers for the fair share policy.

computeReservation?

Type: number (optional)

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* where *ActiveFairShares* is the number of active fair share identifiers.

For example, a computeReservation value of 50 indicates that AWS 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. A computeReservation value of 25 indicates that AWS 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.


shareDecaySeconds?

Type: number (optional)

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).


shareDistribution?

Type: IResolvable | IResolvable | ShareAttributesProperty[] (optional)

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 of 1.0 .