@aws-sdk/client-batch 3.521.0 → 3.524.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist-cjs/index.js +96 -3
- package/dist-es/protocols/Aws_restJson1.js +105 -4
- package/dist-types/commands/CreateComputeEnvironmentCommand.d.ts +59 -45
- package/dist-types/commands/CreateJobQueueCommand.d.ts +7 -6
- package/dist-types/commands/DeleteComputeEnvironmentCommand.d.ts +6 -3
- package/dist-types/commands/DeleteJobQueueCommand.d.ts +5 -3
- package/dist-types/commands/DeregisterJobDefinitionCommand.d.ts +2 -1
- package/dist-types/commands/DescribeComputeEnvironmentsCommand.d.ts +3 -3
- package/dist-types/commands/DescribeJobDefinitionsCommand.d.ts +121 -2
- package/dist-types/commands/DescribeJobsCommand.d.ts +133 -0
- package/dist-types/commands/ListJobsCommand.d.ts +2 -2
- package/dist-types/commands/RegisterJobDefinitionCommand.d.ts +119 -0
- package/dist-types/commands/SubmitJobCommand.d.ts +65 -15
- package/dist-types/commands/TagResourceCommand.d.ts +4 -3
- package/dist-types/commands/TerminateJobCommand.d.ts +4 -3
- package/dist-types/models/models_0.d.ts +1394 -448
- package/dist-types/ts3.4/models/models_0.d.ts +103 -0
- package/package.json +34 -34
package/dist-cjs/index.js
CHANGED
|
@@ -665,9 +665,10 @@ var se_RegisterJobDefinitionCommand = /* @__PURE__ */ __name(async (input, conte
|
|
|
665
665
|
body = JSON.stringify(
|
|
666
666
|
(0, import_smithy_client.take)(input, {
|
|
667
667
|
containerProperties: (_) => (0, import_smithy_client._json)(_),
|
|
668
|
+
ecsProperties: (_) => (0, import_smithy_client._json)(_),
|
|
668
669
|
eksProperties: (_) => (0, import_smithy_client._json)(_),
|
|
669
670
|
jobDefinitionName: [],
|
|
670
|
-
nodeProperties: (_) => (
|
|
671
|
+
nodeProperties: (_) => se_NodeProperties(_, context),
|
|
671
672
|
parameters: (_) => (0, import_smithy_client._json)(_),
|
|
672
673
|
platformCapabilities: (_) => (0, import_smithy_client._json)(_),
|
|
673
674
|
propagateTags: [],
|
|
@@ -693,6 +694,7 @@ var se_SubmitJobCommand = /* @__PURE__ */ __name(async (input, context) => {
|
|
|
693
694
|
arrayProperties: (_) => (0, import_smithy_client._json)(_),
|
|
694
695
|
containerOverrides: (_) => (0, import_smithy_client._json)(_),
|
|
695
696
|
dependsOn: (_) => (0, import_smithy_client._json)(_),
|
|
697
|
+
ecsPropertiesOverride: (_) => (0, import_smithy_client._json)(_),
|
|
696
698
|
eksPropertiesOverride: (_) => (0, import_smithy_client._json)(_),
|
|
697
699
|
jobDefinition: [],
|
|
698
700
|
jobName: [],
|
|
@@ -931,7 +933,7 @@ var de_DescribeJobDefinitionsCommand = /* @__PURE__ */ __name(async (output, con
|
|
|
931
933
|
});
|
|
932
934
|
const data = (0, import_smithy_client.expectNonNull)((0, import_smithy_client.expectObject)(await parseBody(output.body, context)), "body");
|
|
933
935
|
const doc = (0, import_smithy_client.take)(data, {
|
|
934
|
-
jobDefinitions:
|
|
936
|
+
jobDefinitions: (_) => de_JobDefinitionList(_, context),
|
|
935
937
|
nextToken: import_smithy_client.expectString
|
|
936
938
|
});
|
|
937
939
|
Object.assign(contents, doc);
|
|
@@ -961,7 +963,7 @@ var de_DescribeJobsCommand = /* @__PURE__ */ __name(async (output, context) => {
|
|
|
961
963
|
});
|
|
962
964
|
const data = (0, import_smithy_client.expectNonNull)((0, import_smithy_client.expectObject)(await parseBody(output.body, context)), "body");
|
|
963
965
|
const doc = (0, import_smithy_client.take)(data, {
|
|
964
|
-
jobs:
|
|
966
|
+
jobs: (_) => de_JobDetailList(_, context)
|
|
965
967
|
});
|
|
966
968
|
Object.assign(contents, doc);
|
|
967
969
|
return contents;
|
|
@@ -1182,6 +1184,18 @@ var se_FairsharePolicy = /* @__PURE__ */ __name((input, context) => {
|
|
|
1182
1184
|
shareDistribution: (_) => se_ShareAttributesList(_, context)
|
|
1183
1185
|
});
|
|
1184
1186
|
}, "se_FairsharePolicy");
|
|
1187
|
+
var se_NodeProperties = /* @__PURE__ */ __name((input, context) => {
|
|
1188
|
+
return (0, import_smithy_client.take)(input, {
|
|
1189
|
+
mainNode: [],
|
|
1190
|
+
nodeRangeProperties: (_) => se_NodeRangeProperties(_, context),
|
|
1191
|
+
numNodes: []
|
|
1192
|
+
});
|
|
1193
|
+
}, "se_NodeProperties");
|
|
1194
|
+
var se_NodeRangeProperties = /* @__PURE__ */ __name((input, context) => {
|
|
1195
|
+
return input.filter((e) => e != null).map((entry) => {
|
|
1196
|
+
return (0, import_smithy_client._json)(entry);
|
|
1197
|
+
});
|
|
1198
|
+
}, "se_NodeRangeProperties");
|
|
1185
1199
|
var se_ShareAttributes = /* @__PURE__ */ __name((input, context) => {
|
|
1186
1200
|
return (0, import_smithy_client.take)(input, {
|
|
1187
1201
|
shareIdentifier: [],
|
|
@@ -1200,6 +1214,85 @@ var de_FairsharePolicy = /* @__PURE__ */ __name((output, context) => {
|
|
|
1200
1214
|
shareDistribution: (_) => de_ShareAttributesList(_, context)
|
|
1201
1215
|
});
|
|
1202
1216
|
}, "de_FairsharePolicy");
|
|
1217
|
+
var de_JobDefinition = /* @__PURE__ */ __name((output, context) => {
|
|
1218
|
+
return (0, import_smithy_client.take)(output, {
|
|
1219
|
+
containerOrchestrationType: import_smithy_client.expectString,
|
|
1220
|
+
containerProperties: import_smithy_client._json,
|
|
1221
|
+
ecsProperties: import_smithy_client._json,
|
|
1222
|
+
eksProperties: import_smithy_client._json,
|
|
1223
|
+
jobDefinitionArn: import_smithy_client.expectString,
|
|
1224
|
+
jobDefinitionName: import_smithy_client.expectString,
|
|
1225
|
+
nodeProperties: (_) => de_NodeProperties(_, context),
|
|
1226
|
+
parameters: import_smithy_client._json,
|
|
1227
|
+
platformCapabilities: import_smithy_client._json,
|
|
1228
|
+
propagateTags: import_smithy_client.expectBoolean,
|
|
1229
|
+
retryStrategy: import_smithy_client._json,
|
|
1230
|
+
revision: import_smithy_client.expectInt32,
|
|
1231
|
+
schedulingPriority: import_smithy_client.expectInt32,
|
|
1232
|
+
status: import_smithy_client.expectString,
|
|
1233
|
+
tags: import_smithy_client._json,
|
|
1234
|
+
timeout: import_smithy_client._json,
|
|
1235
|
+
type: import_smithy_client.expectString
|
|
1236
|
+
});
|
|
1237
|
+
}, "de_JobDefinition");
|
|
1238
|
+
var de_JobDefinitionList = /* @__PURE__ */ __name((output, context) => {
|
|
1239
|
+
const retVal = (output || []).filter((e) => e != null).map((entry) => {
|
|
1240
|
+
return de_JobDefinition(entry, context);
|
|
1241
|
+
});
|
|
1242
|
+
return retVal;
|
|
1243
|
+
}, "de_JobDefinitionList");
|
|
1244
|
+
var de_JobDetail = /* @__PURE__ */ __name((output, context) => {
|
|
1245
|
+
return (0, import_smithy_client.take)(output, {
|
|
1246
|
+
arrayProperties: import_smithy_client._json,
|
|
1247
|
+
attempts: import_smithy_client._json,
|
|
1248
|
+
container: import_smithy_client._json,
|
|
1249
|
+
createdAt: import_smithy_client.expectLong,
|
|
1250
|
+
dependsOn: import_smithy_client._json,
|
|
1251
|
+
ecsProperties: import_smithy_client._json,
|
|
1252
|
+
eksAttempts: import_smithy_client._json,
|
|
1253
|
+
eksProperties: import_smithy_client._json,
|
|
1254
|
+
isCancelled: import_smithy_client.expectBoolean,
|
|
1255
|
+
isTerminated: import_smithy_client.expectBoolean,
|
|
1256
|
+
jobArn: import_smithy_client.expectString,
|
|
1257
|
+
jobDefinition: import_smithy_client.expectString,
|
|
1258
|
+
jobId: import_smithy_client.expectString,
|
|
1259
|
+
jobName: import_smithy_client.expectString,
|
|
1260
|
+
jobQueue: import_smithy_client.expectString,
|
|
1261
|
+
nodeDetails: import_smithy_client._json,
|
|
1262
|
+
nodeProperties: (_) => de_NodeProperties(_, context),
|
|
1263
|
+
parameters: import_smithy_client._json,
|
|
1264
|
+
platformCapabilities: import_smithy_client._json,
|
|
1265
|
+
propagateTags: import_smithy_client.expectBoolean,
|
|
1266
|
+
retryStrategy: import_smithy_client._json,
|
|
1267
|
+
schedulingPriority: import_smithy_client.expectInt32,
|
|
1268
|
+
shareIdentifier: import_smithy_client.expectString,
|
|
1269
|
+
startedAt: import_smithy_client.expectLong,
|
|
1270
|
+
status: import_smithy_client.expectString,
|
|
1271
|
+
statusReason: import_smithy_client.expectString,
|
|
1272
|
+
stoppedAt: import_smithy_client.expectLong,
|
|
1273
|
+
tags: import_smithy_client._json,
|
|
1274
|
+
timeout: import_smithy_client._json
|
|
1275
|
+
});
|
|
1276
|
+
}, "de_JobDetail");
|
|
1277
|
+
var de_JobDetailList = /* @__PURE__ */ __name((output, context) => {
|
|
1278
|
+
const retVal = (output || []).filter((e) => e != null).map((entry) => {
|
|
1279
|
+
return de_JobDetail(entry, context);
|
|
1280
|
+
});
|
|
1281
|
+
return retVal;
|
|
1282
|
+
}, "de_JobDetailList");
|
|
1283
|
+
var de_NodeProperties = /* @__PURE__ */ __name((output, context) => {
|
|
1284
|
+
return (0, import_smithy_client.take)(output, {
|
|
1285
|
+
mainNode: import_smithy_client.expectInt32,
|
|
1286
|
+
nodeRangeProperties: (_) => de_NodeRangeProperties(_, context),
|
|
1287
|
+
numNodes: import_smithy_client.expectInt32
|
|
1288
|
+
});
|
|
1289
|
+
}, "de_NodeProperties");
|
|
1290
|
+
var de_NodeRangeProperties = /* @__PURE__ */ __name((output, context) => {
|
|
1291
|
+
const retVal = (output || []).filter((e) => e != null).map((entry) => {
|
|
1292
|
+
return (0, import_smithy_client._json)(entry);
|
|
1293
|
+
});
|
|
1294
|
+
return retVal;
|
|
1295
|
+
}, "de_NodeRangeProperties");
|
|
1203
1296
|
var de_SchedulingPolicyDetail = /* @__PURE__ */ __name((output, context) => {
|
|
1204
1297
|
return (0, import_smithy_client.take)(output, {
|
|
1205
1298
|
arn: import_smithy_client.expectString,
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { requestBuilder as rb } from "@smithy/core";
|
|
2
|
-
import { _json, collectBody, decorateServiceException as __decorateServiceException, expectInt32 as __expectInt32, expectNonNull as __expectNonNull, expectObject as __expectObject, expectString as __expectString, limitedParseFloat32 as __limitedParseFloat32, map, serializeFloat as __serializeFloat, take, withBaseException, } from "@smithy/smithy-client";
|
|
2
|
+
import { _json, collectBody, decorateServiceException as __decorateServiceException, expectBoolean as __expectBoolean, expectInt32 as __expectInt32, expectLong as __expectLong, expectNonNull as __expectNonNull, expectObject as __expectObject, expectString as __expectString, limitedParseFloat32 as __limitedParseFloat32, map, serializeFloat as __serializeFloat, take, withBaseException, } from "@smithy/smithy-client";
|
|
3
3
|
import { BatchServiceException as __BaseException } from "../models/BatchServiceException";
|
|
4
4
|
import { ClientException, ServerException, } from "../models/models_0";
|
|
5
5
|
export const se_CancelJobCommand = async (input, context) => {
|
|
@@ -245,9 +245,10 @@ export const se_RegisterJobDefinitionCommand = async (input, context) => {
|
|
|
245
245
|
let body;
|
|
246
246
|
body = JSON.stringify(take(input, {
|
|
247
247
|
containerProperties: (_) => _json(_),
|
|
248
|
+
ecsProperties: (_) => _json(_),
|
|
248
249
|
eksProperties: (_) => _json(_),
|
|
249
250
|
jobDefinitionName: [],
|
|
250
|
-
nodeProperties: (_) =>
|
|
251
|
+
nodeProperties: (_) => se_NodeProperties(_, context),
|
|
251
252
|
parameters: (_) => _json(_),
|
|
252
253
|
platformCapabilities: (_) => _json(_),
|
|
253
254
|
propagateTags: [],
|
|
@@ -271,6 +272,7 @@ export const se_SubmitJobCommand = async (input, context) => {
|
|
|
271
272
|
arrayProperties: (_) => _json(_),
|
|
272
273
|
containerOverrides: (_) => _json(_),
|
|
273
274
|
dependsOn: (_) => _json(_),
|
|
275
|
+
ecsPropertiesOverride: (_) => _json(_),
|
|
274
276
|
eksPropertiesOverride: (_) => _json(_),
|
|
275
277
|
jobDefinition: [],
|
|
276
278
|
jobName: [],
|
|
@@ -498,7 +500,7 @@ export const de_DescribeJobDefinitionsCommand = async (output, context) => {
|
|
|
498
500
|
});
|
|
499
501
|
const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
|
|
500
502
|
const doc = take(data, {
|
|
501
|
-
jobDefinitions:
|
|
503
|
+
jobDefinitions: (_) => de_JobDefinitionList(_, context),
|
|
502
504
|
nextToken: __expectString,
|
|
503
505
|
});
|
|
504
506
|
Object.assign(contents, doc);
|
|
@@ -528,7 +530,7 @@ export const de_DescribeJobsCommand = async (output, context) => {
|
|
|
528
530
|
});
|
|
529
531
|
const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
|
|
530
532
|
const doc = take(data, {
|
|
531
|
-
jobs:
|
|
533
|
+
jobs: (_) => de_JobDetailList(_, context),
|
|
532
534
|
});
|
|
533
535
|
Object.assign(contents, doc);
|
|
534
536
|
return contents;
|
|
@@ -749,6 +751,20 @@ const se_FairsharePolicy = (input, context) => {
|
|
|
749
751
|
shareDistribution: (_) => se_ShareAttributesList(_, context),
|
|
750
752
|
});
|
|
751
753
|
};
|
|
754
|
+
const se_NodeProperties = (input, context) => {
|
|
755
|
+
return take(input, {
|
|
756
|
+
mainNode: [],
|
|
757
|
+
nodeRangeProperties: (_) => se_NodeRangeProperties(_, context),
|
|
758
|
+
numNodes: [],
|
|
759
|
+
});
|
|
760
|
+
};
|
|
761
|
+
const se_NodeRangeProperties = (input, context) => {
|
|
762
|
+
return input
|
|
763
|
+
.filter((e) => e != null)
|
|
764
|
+
.map((entry) => {
|
|
765
|
+
return _json(entry);
|
|
766
|
+
});
|
|
767
|
+
};
|
|
752
768
|
const se_ShareAttributes = (input, context) => {
|
|
753
769
|
return take(input, {
|
|
754
770
|
shareIdentifier: [],
|
|
@@ -769,6 +785,91 @@ const de_FairsharePolicy = (output, context) => {
|
|
|
769
785
|
shareDistribution: (_) => de_ShareAttributesList(_, context),
|
|
770
786
|
});
|
|
771
787
|
};
|
|
788
|
+
const de_JobDefinition = (output, context) => {
|
|
789
|
+
return take(output, {
|
|
790
|
+
containerOrchestrationType: __expectString,
|
|
791
|
+
containerProperties: _json,
|
|
792
|
+
ecsProperties: _json,
|
|
793
|
+
eksProperties: _json,
|
|
794
|
+
jobDefinitionArn: __expectString,
|
|
795
|
+
jobDefinitionName: __expectString,
|
|
796
|
+
nodeProperties: (_) => de_NodeProperties(_, context),
|
|
797
|
+
parameters: _json,
|
|
798
|
+
platformCapabilities: _json,
|
|
799
|
+
propagateTags: __expectBoolean,
|
|
800
|
+
retryStrategy: _json,
|
|
801
|
+
revision: __expectInt32,
|
|
802
|
+
schedulingPriority: __expectInt32,
|
|
803
|
+
status: __expectString,
|
|
804
|
+
tags: _json,
|
|
805
|
+
timeout: _json,
|
|
806
|
+
type: __expectString,
|
|
807
|
+
});
|
|
808
|
+
};
|
|
809
|
+
const de_JobDefinitionList = (output, context) => {
|
|
810
|
+
const retVal = (output || [])
|
|
811
|
+
.filter((e) => e != null)
|
|
812
|
+
.map((entry) => {
|
|
813
|
+
return de_JobDefinition(entry, context);
|
|
814
|
+
});
|
|
815
|
+
return retVal;
|
|
816
|
+
};
|
|
817
|
+
const de_JobDetail = (output, context) => {
|
|
818
|
+
return take(output, {
|
|
819
|
+
arrayProperties: _json,
|
|
820
|
+
attempts: _json,
|
|
821
|
+
container: _json,
|
|
822
|
+
createdAt: __expectLong,
|
|
823
|
+
dependsOn: _json,
|
|
824
|
+
ecsProperties: _json,
|
|
825
|
+
eksAttempts: _json,
|
|
826
|
+
eksProperties: _json,
|
|
827
|
+
isCancelled: __expectBoolean,
|
|
828
|
+
isTerminated: __expectBoolean,
|
|
829
|
+
jobArn: __expectString,
|
|
830
|
+
jobDefinition: __expectString,
|
|
831
|
+
jobId: __expectString,
|
|
832
|
+
jobName: __expectString,
|
|
833
|
+
jobQueue: __expectString,
|
|
834
|
+
nodeDetails: _json,
|
|
835
|
+
nodeProperties: (_) => de_NodeProperties(_, context),
|
|
836
|
+
parameters: _json,
|
|
837
|
+
platformCapabilities: _json,
|
|
838
|
+
propagateTags: __expectBoolean,
|
|
839
|
+
retryStrategy: _json,
|
|
840
|
+
schedulingPriority: __expectInt32,
|
|
841
|
+
shareIdentifier: __expectString,
|
|
842
|
+
startedAt: __expectLong,
|
|
843
|
+
status: __expectString,
|
|
844
|
+
statusReason: __expectString,
|
|
845
|
+
stoppedAt: __expectLong,
|
|
846
|
+
tags: _json,
|
|
847
|
+
timeout: _json,
|
|
848
|
+
});
|
|
849
|
+
};
|
|
850
|
+
const de_JobDetailList = (output, context) => {
|
|
851
|
+
const retVal = (output || [])
|
|
852
|
+
.filter((e) => e != null)
|
|
853
|
+
.map((entry) => {
|
|
854
|
+
return de_JobDetail(entry, context);
|
|
855
|
+
});
|
|
856
|
+
return retVal;
|
|
857
|
+
};
|
|
858
|
+
const de_NodeProperties = (output, context) => {
|
|
859
|
+
return take(output, {
|
|
860
|
+
mainNode: __expectInt32,
|
|
861
|
+
nodeRangeProperties: (_) => de_NodeRangeProperties(_, context),
|
|
862
|
+
numNodes: __expectInt32,
|
|
863
|
+
});
|
|
864
|
+
};
|
|
865
|
+
const de_NodeRangeProperties = (output, context) => {
|
|
866
|
+
const retVal = (output || [])
|
|
867
|
+
.filter((e) => e != null)
|
|
868
|
+
.map((entry) => {
|
|
869
|
+
return _json(entry);
|
|
870
|
+
});
|
|
871
|
+
return retVal;
|
|
872
|
+
};
|
|
772
873
|
const de_SchedulingPolicyDetail = (output, context) => {
|
|
773
874
|
return take(output, {
|
|
774
875
|
arn: __expectString,
|
|
@@ -26,35 +26,42 @@ declare const CreateComputeEnvironmentCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Creates an Batch compute environment. You can create <code>MANAGED</code> or
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
29
|
+
* <p>Creates an Batch compute environment. You can create <code>MANAGED</code> or
|
|
30
|
+
* <code>UNMANAGED</code> compute environments. <code>MANAGED</code> compute environments can
|
|
31
|
+
* use Amazon EC2 or Fargate resources. <code>UNMANAGED</code> compute environments can only use
|
|
32
|
+
* EC2 resources.</p>
|
|
33
|
+
* <p>In a managed compute environment, Batch manages the capacity and instance types of the
|
|
34
|
+
* compute resources within the environment. This is based on the compute resource specification
|
|
35
|
+
* that you define or the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html">launch template</a> that you
|
|
36
|
+
* specify when you create the compute environment. Either, you can choose to use EC2 On-Demand
|
|
37
|
+
* Instances and EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity in
|
|
38
|
+
* your managed compute environment. You can optionally set a maximum price so that Spot
|
|
39
|
+
* Instances only launch when the Spot Instance price is less than a specified percentage of the
|
|
40
|
+
* On-Demand price.</p>
|
|
38
41
|
* <note>
|
|
39
42
|
* <p>Multi-node parallel jobs aren't supported on Spot Instances.</p>
|
|
40
43
|
* </note>
|
|
41
|
-
* <p>In an unmanaged compute environment, you can manage your own EC2 compute resources and
|
|
42
|
-
*
|
|
43
|
-
*
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
44
|
+
* <p>In an unmanaged compute environment, you can manage your own EC2 compute resources and
|
|
45
|
+
* have flexibility with how you configure your compute resources. For example, you can use
|
|
46
|
+
* custom AMIs. However, you must verify that each of your AMIs meet the Amazon ECS container instance
|
|
47
|
+
* AMI specification. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container_instance_AMIs.html">container instance AMIs</a> in the
|
|
48
|
+
* <i>Amazon Elastic Container Service Developer Guide</i>. After you created your unmanaged compute environment,
|
|
49
|
+
* you can use the <a>DescribeComputeEnvironments</a> operation to find the Amazon ECS
|
|
50
|
+
* cluster that's associated with it. Then, launch your container instances into that Amazon ECS
|
|
51
|
+
* cluster. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_container_instance.html">Launching an Amazon ECS container
|
|
52
|
+
* instance</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.</p>
|
|
47
53
|
* <note>
|
|
48
|
-
* <p>To create a compute environment that uses EKS resources, the caller must have
|
|
49
|
-
*
|
|
54
|
+
* <p>To create a compute environment that uses EKS resources, the caller must have
|
|
55
|
+
* permissions to call <code>eks:DescribeCluster</code>.</p>
|
|
50
56
|
* </note>
|
|
51
57
|
* <note>
|
|
52
|
-
* <p>Batch doesn't automatically upgrade the AMIs in a compute environment after it's
|
|
53
|
-
*
|
|
54
|
-
*
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
+
* <p>Batch doesn't automatically upgrade the AMIs in a compute environment after it's
|
|
59
|
+
* created. For example, it also doesn't update the AMIs in your compute environment when a
|
|
60
|
+
* newer version of the Amazon ECS optimized AMI is available. You're responsible for the management
|
|
61
|
+
* of the guest operating system. This includes any updates and security patches. You're also
|
|
62
|
+
* responsible for any additional application software or utilities that you install on the
|
|
63
|
+
* compute resources. There are two ways to use a new AMI for your Batch jobs. The original
|
|
64
|
+
* method is to complete these steps:</p>
|
|
58
65
|
* <ol>
|
|
59
66
|
* <li>
|
|
60
67
|
* <p>Create a new compute environment with the new AMI.</p>
|
|
@@ -69,17 +76,19 @@ declare const CreateComputeEnvironmentCommand_base: {
|
|
|
69
76
|
* <p>Delete the earlier compute environment.</p>
|
|
70
77
|
* </li>
|
|
71
78
|
* </ol>
|
|
72
|
-
* <p>In April 2022, Batch added enhanced support for updating compute environments. For
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
79
|
+
* <p>In April 2022, Batch added enhanced support for updating compute environments. For
|
|
80
|
+
* more information, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/updating-compute-environments.html">Updating compute environments</a>.
|
|
81
|
+
* To use the enhanced updating of compute environments to update AMIs, follow these
|
|
82
|
+
* rules:</p>
|
|
76
83
|
* <ul>
|
|
77
84
|
* <li>
|
|
78
|
-
* <p>Either don't set the service role (<code>serviceRole</code>) parameter or set it to
|
|
85
|
+
* <p>Either don't set the service role (<code>serviceRole</code>) parameter or set it to
|
|
86
|
+
* the <b>AWSBatchServiceRole</b> service-linked role.</p>
|
|
79
87
|
* </li>
|
|
80
88
|
* <li>
|
|
81
|
-
* <p>Set the allocation strategy (<code>allocationStrategy</code>) parameter to
|
|
82
|
-
*
|
|
89
|
+
* <p>Set the allocation strategy (<code>allocationStrategy</code>) parameter to
|
|
90
|
+
* <code>BEST_FIT_PROGRESSIVE</code>, <code>SPOT_CAPACITY_OPTIMIZED</code>, or
|
|
91
|
+
* <code>SPOT_PRICE_CAPACITY_OPTIMIZED</code>.</p>
|
|
83
92
|
* </li>
|
|
84
93
|
* <li>
|
|
85
94
|
* <p>Set the update to latest image version (<code>updateToLatestImageVersion</code>)
|
|
@@ -90,24 +99,29 @@ declare const CreateComputeEnvironmentCommand_base: {
|
|
|
90
99
|
* environment.</p>
|
|
91
100
|
* </li>
|
|
92
101
|
* <li>
|
|
93
|
-
* <p>Don't specify an AMI ID in <code>imageId</code>, <code>imageIdOverride</code> (in
|
|
102
|
+
* <p>Don't specify an AMI ID in <code>imageId</code>, <code>imageIdOverride</code> (in
|
|
103
|
+
* <a href="https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html">
|
|
94
104
|
* <code>ec2Configuration</code>
|
|
95
|
-
* </a>), or in the launch
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
-
*
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
+
* </a>), or in the launch template
|
|
106
|
+
* (<code>launchTemplate</code>). In that case, Batch selects the latest Amazon ECS
|
|
107
|
+
* optimized AMI that's supported by Batch at the time the infrastructure update is
|
|
108
|
+
* initiated. Alternatively, you can specify the AMI ID in the <code>imageId</code> or
|
|
109
|
+
* <code>imageIdOverride</code> parameters, or the launch template identified by the
|
|
110
|
+
* <code>LaunchTemplate</code> properties. Changing any of these properties starts an
|
|
111
|
+
* infrastructure update. If the AMI ID is specified in the launch template, it can't be
|
|
112
|
+
* replaced by specifying an AMI ID in either the <code>imageId</code> or
|
|
113
|
+
* <code>imageIdOverride</code> parameters. It can only be replaced by specifying a
|
|
114
|
+
* different launch template, or if the launch template version is set to
|
|
115
|
+
* <code>$Default</code> or <code>$Latest</code>, by setting either a new default version
|
|
116
|
+
* for the launch template (if <code>$Default</code>) or by adding a new version to the
|
|
117
|
+
* launch template (if <code>$Latest</code>).</p>
|
|
105
118
|
* </li>
|
|
106
119
|
* </ul>
|
|
107
|
-
* <p>If these rules are followed, any update that starts an infrastructure update causes the
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
*
|
|
120
|
+
* <p>If these rules are followed, any update that starts an infrastructure update causes the
|
|
121
|
+
* AMI ID to be re-selected. If the <code>version</code> setting in the launch template
|
|
122
|
+
* (<code>launchTemplate</code>) is set to <code>$Latest</code> or <code>$Default</code>, the
|
|
123
|
+
* latest or default version of the launch template is evaluated up at the time of the
|
|
124
|
+
* infrastructure update, even if the <code>launchTemplate</code> wasn't updated.</p>
|
|
111
125
|
* </note>
|
|
112
126
|
* @example
|
|
113
127
|
* Use a bare-bones client and the command you need to make an API call.
|
|
@@ -26,12 +26,13 @@ declare const CreateJobQueueCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Creates an Batch job queue. When you create a job queue, you associate one or more
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
29
|
+
* <p>Creates an Batch job queue. When you create a job queue, you associate one or more
|
|
30
|
+
* compute environments to the queue and assign an order of preference for the compute
|
|
31
|
+
* environments.</p>
|
|
32
|
+
* <p>You also set a priority to the job queue that determines the order that the Batch
|
|
33
|
+
* scheduler places jobs onto its associated compute environments. For example, if a compute
|
|
34
|
+
* environment is associated with more than one job queue, the job queue with a higher priority
|
|
35
|
+
* is given preference for scheduling jobs to that compute environment.</p>
|
|
35
36
|
* @example
|
|
36
37
|
* Use a bare-bones client and the command you need to make an API call.
|
|
37
38
|
* ```javascript
|
|
@@ -27,9 +27,12 @@ declare const DeleteComputeEnvironmentCommand_base: {
|
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
29
|
* <p>Deletes an Batch compute environment.</p>
|
|
30
|
-
* <p>Before you can delete a compute environment, you must set its state to
|
|
31
|
-
*
|
|
32
|
-
*
|
|
30
|
+
* <p>Before you can delete a compute environment, you must set its state to
|
|
31
|
+
* <code>DISABLED</code> with the <a>UpdateComputeEnvironment</a> API operation and
|
|
32
|
+
* disassociate it from any job queues with the <a>UpdateJobQueue</a> API operation.
|
|
33
|
+
* Compute environments that use Fargate resources must terminate all active jobs on that
|
|
34
|
+
* compute environment before deleting the compute environment. If this isn't done, the compute
|
|
35
|
+
* environment enters an invalid state.</p>
|
|
33
36
|
* @example
|
|
34
37
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
38
|
* ```javascript
|
|
@@ -26,10 +26,12 @@ declare const DeleteJobQueueCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Deletes the specified job queue. You must first disable submissions for a queue with the
|
|
30
|
-
*
|
|
29
|
+
* <p>Deletes the specified job queue. You must first disable submissions for a queue with the
|
|
30
|
+
* <a>UpdateJobQueue</a> operation. All jobs in the queue are eventually terminated
|
|
31
|
+
* when you delete a job queue. The jobs are terminated at a rate of about 16 jobs each
|
|
32
|
+
* second.</p>
|
|
31
33
|
* <p>It's not necessary to disassociate compute environments from a queue before submitting a
|
|
32
|
-
*
|
|
34
|
+
* <code>DeleteJobQueue</code> request.</p>
|
|
33
35
|
* @example
|
|
34
36
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
37
|
* ```javascript
|
|
@@ -26,7 +26,8 @@ declare const DeregisterJobDefinitionCommand_base: {
|
|
|
26
26
|
};
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
|
-
* <p>Deregisters an Batch job definition. Job definitions are permanently deleted after 180
|
|
29
|
+
* <p>Deregisters an Batch job definition. Job definitions are permanently deleted after 180
|
|
30
|
+
* days.</p>
|
|
30
31
|
* @example
|
|
31
32
|
* Use a bare-bones client and the command you need to make an API call.
|
|
32
33
|
* ```javascript
|
|
@@ -27,9 +27,9 @@ declare const DescribeComputeEnvironmentsCommand_base: {
|
|
|
27
27
|
/**
|
|
28
28
|
* @public
|
|
29
29
|
* <p>Describes one or more of your compute environments.</p>
|
|
30
|
-
* <p>If you're using an unmanaged compute environment, you can use the
|
|
31
|
-
*
|
|
32
|
-
*
|
|
30
|
+
* <p>If you're using an unmanaged compute environment, you can use the
|
|
31
|
+
* <code>DescribeComputeEnvironment</code> operation to determine the
|
|
32
|
+
* <code>ecsClusterArn</code> that you launch your Amazon ECS container instances into.</p>
|
|
33
33
|
* @example
|
|
34
34
|
* Use a bare-bones client and the command you need to make an API call.
|
|
35
35
|
* ```javascript
|