Skip to content

Commit 357c5bf

Browse files
author
awstools
committed
docs(client-batch): This documentation-only update corrects some typos.
1 parent bfd1030 commit 357c5bf

File tree

3 files changed

+67
-67
lines changed

3 files changed

+67
-67
lines changed

clients/client-batch/src/commands/SubmitJobCommand.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ export interface SubmitJobCommandOutput extends SubmitJobResponse, __MetadataBea
3535
* parameters in a <code>resourceRequirements</code> object that's included in the
3636
* <code>containerOverrides</code> parameter.</p>
3737
* <note>
38-
* <p>Job queues with a scheduling policy are limited to 500 active fair share identifiers at
38+
* <p>Job queues with a scheduling policy are limited to 500 active share identifiers at
3939
* a time. </p>
4040
* </note>
4141
* <important>

clients/client-batch/src/models/models_0.ts

+39-39
Original file line numberDiff line numberDiff line change
@@ -1002,8 +1002,8 @@ export interface CreateComputeEnvironmentRequest {
10021002

10031003
/**
10041004
* <p>The maximum number of vCPUs for an unmanaged compute environment. This parameter is only
1005-
* used for fair share scheduling to reserve vCPU capacity for new share identifiers. If this
1006-
* parameter isn't provided for a fair share job queue, no vCPU capacity is reserved.</p>
1005+
* used for fair-share scheduling to reserve vCPU capacity for new share identifiers. If this
1006+
* parameter isn't provided for a fair-share job queue, no vCPU capacity is reserved.</p>
10071007
* <note>
10081008
* <p>This parameter is only supported when the <code>type</code> parameter is set to
10091009
* <code>UNMANAGED</code>.</p>
@@ -1214,13 +1214,13 @@ export interface CreateJobQueueRequest {
12141214
state?: JQState | undefined;
12151215

12161216
/**
1217-
* <p>The Amazon Resource Name (ARN) of the fair share scheduling policy. Job queues that don't have a scheduling policy are scheduled in a first-in, first-out (FIFO) model. After a job queue has a scheduling policy, it can be replaced but can't be removed.</p>
1217+
* <p>The Amazon Resource Name (ARN) of the fair-share scheduling policy. Job queues that don't have a fair-share scheduling policy are scheduled in a first-in, first-out (FIFO) model. After a job queue has a fair-share scheduling policy, it can be replaced but can't be removed.</p>
12181218
* <p>The format is
12191219
* <code>aws:<i>Partition</i>:batch:<i>Region</i>:<i>Account</i>:scheduling-policy/<i>Name</i>
12201220
* </code>.</p>
12211221
* <p>An example is
12221222
* <code>aws:aws:batch:us-west-2:123456789012:scheduling-policy/MySchedulingPolicy</code>.</p>
1223-
* <p>A job queue without a scheduling policy is scheduled as a FIFO job queue and can't have a scheduling policy added. Jobs queues with a scheduling policy can have a maximum of 500 active fair share identifiers. When the limit has been reached, submissions of any jobs that add a new fair share identifier fail.</p>
1223+
* <p>A job queue without a fair-share scheduling policy is scheduled as a FIFO job queue and can't have a fair-share scheduling policy added. Jobs queues with a fair-share scheduling policy can have a maximum of 500 active share identifiers. When the limit has been reached, submissions of any jobs that add a new share identifier fail.</p>
12241224
* @public
12251225
*/
12261226
schedulingPolicyArn?: string | undefined;
@@ -1287,26 +1287,26 @@ export interface CreateJobQueueResponse {
12871287
}
12881288

12891289
/**
1290-
* <p>Specifies the weights for the fair share identifiers for the fair share policy. Fair share
1290+
* <p>Specifies the weights for the share identifiers for the fair-share policy. Share
12911291
* identifiers that aren't included have a default weight of <code>1.0</code>.</p>
12921292
* @public
12931293
*/
12941294
export interface ShareAttributes {
12951295
/**
1296-
* <p>A fair share identifier or fair share identifier prefix. If the string ends with an asterisk
1297-
* (*), this entry specifies the weight factor to use for fair share identifiers that start with
1298-
* that prefix. The list of fair share identifiers in a fair share policy can't overlap. For
1296+
* <p>A share identifier or share identifier prefix. If the string ends with an asterisk
1297+
* (*), this entry specifies the weight factor to use for share identifiers that start with
1298+
* that prefix. The list of share identifiers in a fair-share policy can't overlap. For
12991299
* example, you can't have one that specifies a <code>shareIdentifier</code> of <code>UserA*</code>
13001300
* and another that specifies a <code>shareIdentifier</code> of <code>UserA-1</code>.</p>
1301-
* <p>There can be no more than 500 fair share identifiers active in a job queue.</p>
1301+
* <p>There can be no more than 500 share identifiers active in a job queue.</p>
13021302
* <p>The string is limited to 255 alphanumeric characters, and can be followed by an asterisk
13031303
* (*).</p>
13041304
* @public
13051305
*/
13061306
shareIdentifier: string | undefined;
13071307

13081308
/**
1309-
* <p>The weight factor for the fair share identifier. The default value is 1.0. A lower value has
1309+
* <p>The weight factor for the share identifier. The default value is 1.0. A lower value has
13101310
* a higher priority for compute resources. For example, jobs that use a share identifier with a
13111311
* weight factor of 0.125 (1/8) get 8 times the compute resources of jobs that use a share
13121312
* identifier with a weight factor of 1.</p>
@@ -1317,12 +1317,12 @@ export interface ShareAttributes {
13171317
}
13181318

13191319
/**
1320-
* <p>The fair share policy for a scheduling policy.</p>
1320+
* <p>The fair-share scheduling policy details.</p>
13211321
* @public
13221322
*/
13231323
export interface FairsharePolicy {
13241324
/**
1325-
* <p>The amount of time (in seconds) to use to calculate a fair share percentage for each fair
1325+
* <p>The amount of time (in seconds) to use to calculate a fair-share percentage for each
13261326
* share identifier in use. A value of zero (0) indicates the default minimum time window (600 seconds).
13271327
* The maximum supported value is 604800 (1 week).</p>
13281328
* <p>The decay allows for more recently run jobs to have more weight than jobs that ran earlier.
@@ -1334,29 +1334,29 @@ export interface FairsharePolicy {
13341334
shareDecaySeconds?: number | undefined;
13351335

13361336
/**
1337-
* <p>A value used to reserve some of the available maximum vCPU for fair share identifiers that
1337+
* <p>A value used to reserve some of the available maximum vCPU for share identifiers that
13381338
* aren't already used.</p>
13391339
* <p>The reserved ratio is
13401340
* <code>(<i>computeReservation</i>/100)^<i>ActiveFairShares</i>
13411341
* </code>
13421342
* where <code>
13431343
* <i>ActiveFairShares</i>
1344-
* </code> is the number of active fair share
1344+
* </code> is the number of active share
13451345
* identifiers.</p>
13461346
* <p>For example, a <code>computeReservation</code> value of 50 indicates that Batch reserves
1347-
* 50% of the maximum available vCPU if there's only one fair share identifier. It reserves 25% if
1348-
* there are two fair share identifiers. It reserves 12.5% if there are three fair share
1347+
* 50% of the maximum available vCPU if there's only one share identifier. It reserves 25% if
1348+
* there are two share identifiers. It reserves 12.5% if there are three share
13491349
* identifiers. A <code>computeReservation</code> value of 25 indicates that Batch should reserve
1350-
* 25% of the maximum available vCPU if there's only one fair share identifier, 6.25% if there are
1351-
* two fair share identifiers, and 1.56% if there are three fair share identifiers.</p>
1350+
* 25% of the maximum available vCPU if there's only one share identifier, 6.25% if there are
1351+
* two fair share identifiers, and 1.56% if there are three share identifiers.</p>
13521352
* <p>The minimum value is 0 and the maximum value is 99.</p>
13531353
* @public
13541354
*/
13551355
computeReservation?: number | undefined;
13561356

13571357
/**
1358-
* <p>An array of <code>SharedIdentifier</code> objects that contain the weights for the fair
1359-
* share identifiers for the fair share policy. Fair share identifiers that aren't included have a
1358+
* <p>An array of <code>SharedIdentifier</code> objects that contain the weights for the
1359+
* share identifiers for the fair-share policy. Share identifiers that aren't included have a
13601360
* default weight of <code>1.0</code>.</p>
13611361
* @public
13621362
*/
@@ -1369,14 +1369,14 @@ export interface FairsharePolicy {
13691369
*/
13701370
export interface CreateSchedulingPolicyRequest {
13711371
/**
1372-
* <p>The name of the scheduling policy. It can be up to 128 letters long. It can contain
1372+
* <p>The name of the fair-share scheduling policy. It can be up to 128 letters long. It can contain
13731373
* uppercase and lowercase letters, numbers, hyphens (-), and underscores (_).</p>
13741374
* @public
13751375
*/
13761376
name: string | undefined;
13771377

13781378
/**
1379-
* <p>The fair share policy of the scheduling policy.</p>
1379+
* <p>The fair-share scheduling policy details.</p>
13801380
* @public
13811381
*/
13821382
fairsharePolicy?: FairsharePolicy | undefined;
@@ -1980,7 +1980,7 @@ export interface LinuxParameters {
19801980
* <p>If a <code>maxSwap</code> value of <code>0</code> is specified, the container doesn't use
19811981
* swap. Accepted values are <code>0</code> or any positive integer. If the <code>maxSwap</code>
19821982
* parameter is omitted, the container doesn't use the swap configuration for the container instance
1983-
* that it's running on. A <code>maxSwap</code> value must be set for the <code>swappiness</code>
1983+
* on which it runs. A <code>maxSwap</code> value must be set for the <code>swappiness</code>
19841984
* parameter to be used.</p>
19851985
* <note>
19861986
* <p>This parameter isn't applicable to jobs that are running on Fargate resources. Don't
@@ -4236,7 +4236,7 @@ export interface JobDefinition {
42364236

42374237
/**
42384238
* <p>The scheduling priority of the job definition. This only affects jobs in job queues with a
4239-
* fair share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower
4239+
* fair-share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower
42404240
* scheduling priority.</p>
42414241
* @public
42424242
*/
@@ -5593,7 +5593,7 @@ export interface JobDetail {
55935593

55945594
/**
55955595
* <p>The scheduling policy of the job definition. This only affects jobs in job queues with a
5596-
* fair share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower
5596+
* fair-share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower
55975597
* scheduling priority.</p>
55985598
* @public
55995599
*/
@@ -5804,7 +5804,7 @@ export interface DescribeSchedulingPoliciesRequest {
58045804
*/
58055805
export interface SchedulingPolicyDetail {
58065806
/**
5807-
* <p>The name of the scheduling policy.</p>
5807+
* <p>The name of the fair-share scheduling policy.</p>
58085808
* @public
58095809
*/
58105810
name: string | undefined;
@@ -5818,13 +5818,13 @@ export interface SchedulingPolicyDetail {
58185818
arn: string | undefined;
58195819

58205820
/**
5821-
* <p>The fair share policy for the scheduling policy.</p>
5821+
* <p>The fair-share scheduling policy details.</p>
58225822
* @public
58235823
*/
58245824
fairsharePolicy?: FairsharePolicy | undefined;
58255825

58265826
/**
5827-
* <p>The tags that you apply to the scheduling policy to categorize and organize your resources.
5827+
* <p>The tags that you apply to the fair-share scheduling policy to categorize and organize your resources.
58285828
* Each tag consists of a key and an optional value. For more information, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a> in
58295829
* <i>Amazon Web Services General Reference</i>.</p>
58305830
* @public
@@ -5878,7 +5878,7 @@ export interface FrontOfQueueJobSummary {
58785878
*/
58795879
export interface FrontOfQueueDetail {
58805880
/**
5881-
* <p>The Amazon Resource Names (ARNs) of the first 100 <code>RUNNABLE</code> jobs in a named job queue. For first-in-first-out (FIFO) job queues, jobs are ordered based on their submission time. For fair share scheduling (FSS) job queues, jobs are ordered based on their job priority and share usage.</p>
5881+
* <p>The Amazon Resource Names (ARNs) of the first 100 <code>RUNNABLE</code> jobs in a named job queue. For first-in-first-out (FIFO) job queues, jobs are ordered based on their submission time. For fair-share scheduling (FSS) job queues, jobs are ordered based on their job priority and share usage.</p>
58825882
* @public
58835883
*/
58845884
jobs?: FrontOfQueueJobSummary[] | undefined;
@@ -5895,7 +5895,7 @@ export interface FrontOfQueueDetail {
58955895
*/
58965896
export interface GetJobQueueSnapshotResponse {
58975897
/**
5898-
* <p>The list of the first 100 <code>RUNNABLE</code> jobs in each job queue. For first-in-first-out (FIFO) job queues, jobs are ordered based on their submission time. For fair share scheduling (FSS) job queues, jobs are ordered based on their job priority and share usage.</p>
5898+
* <p>The list of the first 100 <code>RUNNABLE</code> jobs in each job queue. For first-in-first-out (FIFO) job queues, jobs are ordered based on their submission time. For fair-share scheduling (FSS) job queues, jobs are ordered based on their job priority and share usage.</p>
58995899
* @public
59005900
*/
59015901
frontOfQueue?: FrontOfQueueDetail | undefined;
@@ -6340,7 +6340,7 @@ export interface RegisterJobDefinitionRequest {
63406340

63416341
/**
63426342
* <p>The scheduling priority for jobs that are submitted with this job definition. This only
6343-
* affects jobs in job queues with a fair share policy. Jobs with a higher scheduling priority
6343+
* affects jobs in job queues with a fair-share policy. Jobs with a higher scheduling priority
63446344
* are scheduled before jobs with a lower scheduling priority.</p>
63456345
* <p>The minimum supported value is 0 and the maximum supported value is 9999.</p>
63466346
* @public
@@ -6692,7 +6692,7 @@ export interface EksPodPropertiesOverride {
66926692

66936693
/**
66946694
* <p>The overrides for the <code>initContainers</code> defined in the Amazon EKS pod. These containers run before
6695-
* application containers, always runs to completion, and must complete successfully before the next
6695+
* application containers, always run to completion, and must complete successfully before the next
66966696
* container starts. These containers are registered with the Amazon EKS Connector agent and persists the
66976697
* registration information in the Kubernetes backend data store. For more information, see <a href="https://kubernetes.io/docs/concepts/workloads/pods/init-containers/">Init
66986698
* Containers</a> in the <i>Kubernetes documentation</i>.</p>
@@ -6823,7 +6823,7 @@ export interface SubmitJobRequest {
68236823

68246824
/**
68256825
* <p>The share identifier for the job. Don't specify this parameter if the job queue doesn't
6826-
* have a scheduling policy. If the job queue has a scheduling policy, then this parameter must
6826+
* have a fair-share scheduling policy. If the job queue has a fair-share scheduling policy, then this parameter must
68276827
* be specified.</p>
68286828
* <p>This string is limited to 255 alphanumeric characters, and can be followed by an asterisk
68296829
* (*).</p>
@@ -6832,8 +6832,8 @@ export interface SubmitJobRequest {
68326832
shareIdentifier?: string | undefined;
68336833

68346834
/**
6835-
* <p>The scheduling priority for the job. This only affects jobs in job queues with a fair
6836-
* share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower
6835+
* <p>The scheduling priority for the job. This only affects jobs in job queues with a
6836+
* fair-share policy. Jobs with a higher scheduling priority are scheduled before jobs with a lower
68376837
* scheduling priority. This overrides any scheduling priority in the job definition and works only
68386838
* within a single share identifier.</p>
68396839
* <p>The minimum supported value is 0 and the maximum supported value is 9999.</p>
@@ -7443,8 +7443,8 @@ export interface UpdateComputeEnvironmentRequest {
74437443
/**
74447444
* <p>The maximum number of vCPUs expected to be used for an unmanaged compute environment.
74457445
* Don't specify this parameter for a managed compute environment. This parameter is only used
7446-
* for fair share scheduling to reserve vCPU capacity for new share identifiers. If this
7447-
* parameter isn't provided for a fair share job queue, no vCPU capacity is reserved.</p>
7446+
* for fair-share scheduling to reserve vCPU capacity for new share identifiers. If this
7447+
* parameter isn't provided for a fair-share job queue, no vCPU capacity is reserved.</p>
74487448
* @public
74497449
*/
74507450
unmanagedvCpus?: number | undefined;
@@ -7535,7 +7535,7 @@ export interface UpdateJobQueueRequest {
75357535
state?: JQState | undefined;
75367536

75377537
/**
7538-
* <p>Amazon Resource Name (ARN) of the fair share scheduling policy. Once a job queue is created, the fair share
7538+
* <p>Amazon Resource Name (ARN) of the fair-share scheduling policy. Once a job queue is created, the fair-share
75397539
* scheduling policy can be replaced but not removed. The format is
75407540
* <code>aws:<i>Partition</i>:batch:<i>Region</i>:<i>Account</i>:scheduling-policy/<i>Name</i>
75417541
* </code>.
@@ -7609,7 +7609,7 @@ export interface UpdateSchedulingPolicyRequest {
76097609
arn: string | undefined;
76107610

76117611
/**
7612-
* <p>The fair share policy.</p>
7612+
* <p>The fair-share policy scheduling details.</p>
76137613
* @public
76147614
*/
76157615
fairsharePolicy?: FairsharePolicy | undefined;

0 commit comments

Comments
 (0)