@aws-sdk/client-batch 3.863.0 → 3.870.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.
@@ -482,8 +482,7 @@ export interface LaunchTemplateSpecificationOverride {
482
482
  * <p>Must be a valid Amazon EC2 instance type or family.</p>
483
483
  * </li>
484
484
  * <li>
485
- * <p>
486
- * <code>optimal</code> isn't allowed.</p>
485
+ * <p>The following Batch <code>InstanceTypes</code> are not allowed: <code>optimal</code>, <code>default_x86_64</code>, and <code>default_arm64</code>.</p>
487
486
  * </li>
488
487
  * <li>
489
488
  * <p>
@@ -688,9 +687,55 @@ export interface ComputeResource {
688
687
  /**
689
688
  * <p>The instances types that can be launched. You can specify instance families to launch any
690
689
  * instance type within those families (for example, <code>c5</code> or <code>p3</code>), or you can
691
- * specify specific sizes within a family (such as <code>c5.8xlarge</code>). You can also choose
692
- * <code>optimal</code> to select instance types (from the C4, M4, and R4 instance families) that
693
- * match the demand of your job queues.</p>
690
+ * specify specific sizes within a family (such as <code>c5.8xlarge</code>). </p>
691
+ * <p>Batch can select the instance type for you if you choose one of the following:</p>
692
+ * <ul>
693
+ * <li>
694
+ * <p>
695
+ * <code>optimal</code> to select instance types (from the <code>c4</code>, <code>m4</code>,
696
+ * <code>r4</code>, <code>c5</code>, <code>m5</code>, and <code>r5</code>
697
+ * instance families) that match the demand of your job queues. </p>
698
+ * </li>
699
+ * <li>
700
+ * <p>
701
+ * <code>default_x86_64</code> to choose x86 based instance types (from the <code>m6i</code>,
702
+ * <code>c6i</code>, <code>r6i</code>, and <code>c7i</code> instance families) that matches the resource demands of the job queue.</p>
703
+ * </li>
704
+ * <li>
705
+ * <p>
706
+ * <code>default_arm64</code> to choose x86 based instance types (from the <code>m6g</code>,
707
+ * <code>c6g</code>, <code>r6g</code>, and <code>c7g</code> instance families) that matches the resource demands of the job queue.</p>
708
+ * </li>
709
+ * </ul>
710
+ * <note>
711
+ * <p>Starting on 11/01/2025 the behavior of <code>optimal</code> is going to be changed to
712
+ * match <code>default_x86_64</code>.
713
+ *
714
+ * During the change your instance families could be updated to a newer
715
+ * generation.
716
+ * You do not need to perform any actions for the upgrade to
717
+ * happen. For more information about change, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/optimal-default-instance-troubleshooting.html">Optimal instance type configuration to
718
+ * receive automatic instance family updates</a>.</p>
719
+ * </note>
720
+ * <note>
721
+ * <p>Instance family availability varies by
722
+ * Amazon Web Services Region.
723
+ * For example, some Amazon Web Services Regions may not have any fourth generation instance families
724
+ * but have fifth and sixth generation instance families.</p>
725
+ * <p>When using <code>default_x86_64</code> or <code>default_arm64</code>
726
+ * instance bundles, Batch selects instance families based on a balance of
727
+ * cost-effectiveness and performance. While newer generation instances often provide
728
+ * better price-performance, Batch may choose an earlier generation instance family
729
+ * if it provides the optimal combination of availability, cost, and performance for
730
+ * your workload. For example, in an
731
+ * Amazon Web Services Region
732
+ * where both c6i and c7i instances are available, Batch might select c6i instances
733
+ * if they offer better cost-effectiveness for your specific job requirements. For more information on Batch instance types and Amazon Web Services Region availability, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/instance-type-compute-table.html">Instance type compute table</a> in the <i>Batch User Guide</i>.</p>
734
+ * <p>Batch periodically updates your instances in default bundles to newer,
735
+ * more cost-effective options. Updates happen automatically without requiring any
736
+ * action from you. Your workloads continue running during updates with no interruption
737
+ * </p>
738
+ * </note>
694
739
  * <note>
695
740
  * <p>This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.</p>
696
741
  * </note>
@@ -699,11 +744,6 @@ export interface ComputeResource {
699
744
  * share the same architecture. For example, you can't mix x86 and ARM instances in the same compute
700
745
  * environment.</p>
701
746
  * </note>
702
- * <note>
703
- * <p>Currently, <code>optimal</code> uses instance types from the C4, M4, and R4 instance
704
- * families. In Regions that don't have instance types from those instance families, instance types
705
- * from the C5, M5, and R5 instance families are used.</p>
706
- * </note>
707
747
  * @public
708
748
  */
709
749
  instanceTypes?: string[] | undefined;
@@ -6823,20 +6863,33 @@ export interface ListServiceJobsRequest {
6823
6863
  */
6824
6864
  nextToken?: string | undefined;
6825
6865
  /**
6826
- * <p>The filters to apply to the service job list query. The filter names and values can be:</p>
6827
- * <ul>
6828
- * <li>
6829
- * <p>name: <code>JOB_STATUS</code>
6830
- * </p>
6831
- * <p>values: <code>SUBMITTED | PENDING | RUNNABLE | STARTING | RUNNING | SUCCEEDED | FAILED | SCHEDULED</code>
6832
- * </p>
6833
- * </li>
6834
- * <li>
6835
- * <p>name: <code>JOB_NAME</code>
6836
- * </p>
6837
- * <p>values: case-insensitive matches for the job name. If a filter value ends with an asterisk (*), it matches any job name that begins with the string before the '*'.</p>
6838
- * </li>
6839
- * </ul>
6866
+ * <p>The filter to apply to the query. Only one filter can be used at a time. When the filter
6867
+ * is used, <code>jobStatus</code> is ignored. The results are sorted by the <code>createdAt</code> field,
6868
+ * with the most recent jobs being first.</p>
6869
+ * <dl>
6870
+ * <dt>JOB_NAME</dt>
6871
+ * <dd>
6872
+ * <p>The value of the filter is a case-insensitive match for the job name. If the value
6873
+ * ends with an asterisk (*), the filter matches any job name that begins with the string
6874
+ * before the '*'. This corresponds to the <code>jobName</code> value. For example,
6875
+ * <code>test1</code> matches both <code>Test1</code> and <code>test1</code>, and
6876
+ * <code>test1*</code> matches both <code>test1</code> and <code>Test10</code>. When the
6877
+ * <code>JOB_NAME</code> filter is used, the results are grouped by the job name and
6878
+ * version.</p>
6879
+ * </dd>
6880
+ * <dt>BEFORE_CREATED_AT</dt>
6881
+ * <dd>
6882
+ * <p>The value for the filter is the time that's before the job was created. This
6883
+ * corresponds to the <code>createdAt</code> value. The value is a string representation of
6884
+ * the number of milliseconds since 00:00:00 UTC (midnight) on January 1, 1970.</p>
6885
+ * </dd>
6886
+ * <dt>AFTER_CREATED_AT</dt>
6887
+ * <dd>
6888
+ * <p>The value for the filter is the time that's after the job was created. This
6889
+ * corresponds to the <code>createdAt</code> value. The value is a string representation of
6890
+ * the number of milliseconds since 00:00:00 UTC (midnight) on January 1, 1970.</p>
6891
+ * </dd>
6892
+ * </dl>
6840
6893
  * @public
6841
6894
  */
6842
6895
  filters?: KeyValuesPair[] | undefined;
@@ -7890,12 +7943,55 @@ export interface ComputeResourceUpdate {
7890
7943
  /**
7891
7944
  * <p>The instances types that can be launched. You can specify instance families to launch any
7892
7945
  * instance type within those families (for example, <code>c5</code> or <code>p3</code>), or you can
7893
- * specify specific sizes within a family (such as <code>c5.8xlarge</code>). You can also choose
7894
- * <code>optimal</code> to select instance types (from the C4, M4, and R4 instance families) that
7895
- * match the demand of your job queues.</p>
7896
- * <p>When updating a compute environment, changing this setting requires an infrastructure update
7897
- * of the compute environment. For more information, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/updating-compute-environments.html">Updating compute environments</a> in the
7898
- * <i>Batch User Guide</i>.</p>
7946
+ * specify specific sizes within a family (such as <code>c5.8xlarge</code>). </p>
7947
+ * <p>Batch can select the instance type for you if you choose one of the following:</p>
7948
+ * <ul>
7949
+ * <li>
7950
+ * <p>
7951
+ * <code>optimal</code> to select instance types (from the <code>c4</code>, <code>m4</code>,
7952
+ * <code>r4</code>, <code>c5</code>, <code>m5</code>, and <code>r5</code>
7953
+ * instance families) that match the demand of your job queues. </p>
7954
+ * </li>
7955
+ * <li>
7956
+ * <p>
7957
+ * <code>default_x86_64</code> to choose x86 based instance types (from the <code>m6i</code>,
7958
+ * <code>c6i</code>, <code>r6i</code>, and <code>c7i</code> instance families) that matches the resource demands of the job queue.</p>
7959
+ * </li>
7960
+ * <li>
7961
+ * <p>
7962
+ * <code>default_arm64</code> to choose x86 based instance types (from the <code>m6g</code>,
7963
+ * <code>c6g</code>, <code>r6g</code>, and <code>c7g</code> instance families) that matches the resource demands of the job queue.</p>
7964
+ * </li>
7965
+ * </ul>
7966
+ * <note>
7967
+ * <p>Starting on 11/01/2025 the behavior of <code>optimal</code> is going to be changed to
7968
+ * match <code>default_x86_64</code>.
7969
+ *
7970
+ * During the change your instance families could be updated to a newer
7971
+ * generation.
7972
+ * You do not need to perform any actions for the upgrade to
7973
+ * happen. For more information about change, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/optimal-default-instance-troubleshooting.html">Optimal instance type configuration to
7974
+ * receive automatic instance family updates</a>.</p>
7975
+ * </note>
7976
+ * <note>
7977
+ * <p>Instance family availability varies by
7978
+ * Amazon Web Services Region.
7979
+ * For example, some Amazon Web Services Regions may not have any fourth generation instance families
7980
+ * but have fifth and sixth generation instance families.</p>
7981
+ * <p>When using <code>default_x86_64</code> or <code>default_arm64</code>
7982
+ * instance bundles, Batch selects instance families based on a balance of
7983
+ * cost-effectiveness and performance. While newer generation instances often provide
7984
+ * better price-performance, Batch may choose an earlier generation instance family
7985
+ * if it provides the optimal combination of availability, cost, and performance for
7986
+ * your workload. For example, in an
7987
+ * Amazon Web Services Region
7988
+ * where both c6i and c7i instances are available, Batch might select c6i instances
7989
+ * if they offer better cost-effectiveness for your specific job requirements. For more information on Batch instance types and Amazon Web Services Region availability, see <a href="https://docs.aws.amazon.com/batch/latest/userguide/instance-type-compute-table.html">Instance type compute table</a> in the <i>Batch User Guide</i>.</p>
7990
+ * <p>Batch periodically updates your instances in default bundles to newer,
7991
+ * more cost-effective options. Updates happen automatically without requiring any
7992
+ * action from you. Your workloads continue running during updates with no interruption
7993
+ * </p>
7994
+ * </note>
7899
7995
  * <note>
7900
7996
  * <p>This parameter isn't applicable to jobs that are running on Fargate resources. Don't specify it.</p>
7901
7997
  * </note>
@@ -7904,11 +8000,6 @@ export interface ComputeResourceUpdate {
7904
8000
  * share the same architecture. For example, you can't mix x86 and ARM instances in the same compute
7905
8001
  * environment.</p>
7906
8002
  * </note>
7907
- * <note>
7908
- * <p>Currently, <code>optimal</code> uses instance types from the C4, M4, and R4 instance
7909
- * families. In Regions that don't have instance types from those instance families, instance types
7910
- * from the C5, M5, and R5 instance families are used.</p>
7911
- * </note>
7912
8003
  * @public
7913
8004
  */
7914
8005
  instanceTypes?: string[] | undefined;
@@ -8228,9 +8319,7 @@ export interface UpdateConsumableResourceRequest {
8228
8319
  quantity?: number | undefined;
8229
8320
  /**
8230
8321
  * <p>If this parameter is specified and two update requests with identical payloads and
8231
- * <code>clientToken</code>s are received, these requests are considered the same request and
8232
- * the second request is rejected. A <code>clientToken</code> is valid for 8 hours or until
8233
- * one hour after the consumable resource is deleted, whichever is less.</p>
8322
+ * <code>clientToken</code>s are received, these requests are considered the same request. Both requests will succeed, but the update will only happen once. A <code>clientToken</code> is valid for 8 hours.</p>
8234
8323
  * @public
8235
8324
  */
8236
8325
  clientToken?: string | undefined;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-batch",
3
3
  "description": "AWS SDK for JavaScript Batch Client for Node.js, Browser and React Native",
4
- "version": "3.863.0",
4
+ "version": "3.870.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-batch",
@@ -20,17 +20,17 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
- "@aws-sdk/core": "3.863.0",
24
- "@aws-sdk/credential-provider-node": "3.863.0",
23
+ "@aws-sdk/core": "3.864.0",
24
+ "@aws-sdk/credential-provider-node": "3.864.0",
25
25
  "@aws-sdk/middleware-host-header": "3.862.0",
26
26
  "@aws-sdk/middleware-logger": "3.862.0",
27
27
  "@aws-sdk/middleware-recursion-detection": "3.862.0",
28
- "@aws-sdk/middleware-user-agent": "3.863.0",
28
+ "@aws-sdk/middleware-user-agent": "3.864.0",
29
29
  "@aws-sdk/region-config-resolver": "3.862.0",
30
30
  "@aws-sdk/types": "3.862.0",
31
31
  "@aws-sdk/util-endpoints": "3.862.0",
32
32
  "@aws-sdk/util-user-agent-browser": "3.862.0",
33
- "@aws-sdk/util-user-agent-node": "3.863.0",
33
+ "@aws-sdk/util-user-agent-node": "3.864.0",
34
34
  "@smithy/config-resolver": "^4.1.5",
35
35
  "@smithy/core": "^3.8.0",
36
36
  "@smithy/fetch-http-handler": "^5.1.1",