aws-sdk-pcs 1.63.0 → 1.64.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ef5eeec490b16238c0e1b312bba439269bf949cff5f1056387e9b6058e07a76a
4
- data.tar.gz: ed1ade00bb4b2def894863693f96c5360b085caf43083f82d1331fcfcf7cd7b3
3
+ metadata.gz: 740bf71e454bdeaf46a977d81677a58a1284d51e393553e8e860a839dff61b61
4
+ data.tar.gz: a553df7c36cab85171b1b279cfc86e05ea7d3aab8be6e6be05b99545c25c257b
5
5
  SHA512:
6
- metadata.gz: bcd582213ed7ceeaef14759344cab9dfa35c791814adf0f9bf9c55671994c3fbdfcd4f1ee991bc032c572a01de330a2f8bffb60afc7bef17c2102d6628c4d913
7
- data.tar.gz: 66c55fc262cfdc6c0f4f4f48ca5aac52bfe7a5213930e168204d9ce94f4aa12d8b08ef8c3f6df07fb864008c07eafba56c53142b6d75448c6326152d5cb6cb31
6
+ metadata.gz: ca0c1a8a15acd1a207ad2c44d601bd37152f047780f7b4f47d39807da9f440155e050ef3c488efe49c90d321a2319110ce792fec2ef98f255aea1a9eb2d41d7d
7
+ data.tar.gz: 1a3d07e01534b95f25ea687b54d08a3bfb3838d36ba591d94b8a541077c1f7d7a559f276ae40f72bb16f692f81dd250cf25a3e37da6d6e35f5876bdfd8d8417e
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.64.0 (2026-11-10)
5
+ ------------------
6
+
7
+ * Feature - Added support for configuring AMIs, Amazon EC2 security groups, SSH key pairs, and launch template modes when creating or updating AWS PCS compute node groups.
8
+
4
9
  1.63.0 (2026-11-09)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.63.0
1
+ 1.64.0
@@ -264,7 +264,8 @@ module Aws::PCS
264
264
  # An integer representing the maximum number attempts that will be made for
265
265
  # a single request, including the initial attempt. For example,
266
266
  # setting this value to 5 will result in a request being retried up to
267
- # 4 times. Used in `standard` and `adaptive` retry modes.
267
+ # 4 times. Used in `standard` and `adaptive` retry modes. Defaults to 3,
268
+ # except for DynamoDB and DynamoDB Streams, which default to 4.
268
269
  #
269
270
  # @option options [String] :profile ("default")
270
271
  # Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
@@ -327,15 +328,15 @@ module Aws::PCS
327
328
  # used by the default backoff function. This option is only used in the
328
329
  # `legacy` retry mode.
329
330
  #
330
- # @option options [String] :retry_mode ("legacy")
331
+ # @option options [String] :retry_mode ("standard")
331
332
  # Specifies which retry algorithm to use. Values are:
332
333
  #
333
- # * `legacy` - The pre-existing retry behavior. This is the default
334
- # value if no retry mode is provided.
334
+ # * `legacy` - The pre-existing retry behavior.
335
335
  #
336
336
  # * `standard` - A standardized set of retry rules across the AWS SDKs.
337
337
  # This includes support for retry quotas, which limit the number of
338
- # unsuccessful retries a client can make.
338
+ # unsuccessful retries a client can make. This is the default value
339
+ # if no retry mode is provided.
339
340
  #
340
341
  # * `adaptive` - A retry mode that includes all the functionality of
341
342
  # `standard` mode along with automatic client side throttling.
@@ -533,7 +534,7 @@ module Aws::PCS
533
534
  # request completes successfully, the subsequent retries with the same
534
535
  # client token return the result from the original successful request
535
536
  # and they have no additional effect. If you don't specify a client
536
- # token, the CLI and SDK automatically generate 1 for you.
537
+ # token, the CLI and SDK automatically generate one for you.
537
538
  #
538
539
  # **A suitable default value is auto-generated.** You should normally
539
540
  # not need to pass this option.**
@@ -653,14 +654,55 @@ module Aws::PCS
653
654
  # you provide to this API action to launch compute nodes in your
654
655
  # account. You can only specify subnets in the same Amazon VPC as your
655
656
  # cluster. You receive billing charges for the compute nodes that PCS
656
- # launches in your account. You must already have a launch template
657
- # before you call this API. For more information, see [Launch an
658
- # instance from a launch template][1] in the *Amazon Elastic Compute
659
- # Cloud User Guide for Linux Instances*.
657
+ # launches in your account. You can configure common instance settings,
658
+ # such as the AMI, security groups, and SSH key pair, directly on the
659
+ # compute node group, or you can provide a custom EC2 launch template.
660
+ # To use a launch template that PCS manages, set `launchTemplateMode` to
661
+ # `MANAGED` and don't provide `customLaunchTemplate`. In this case, you
662
+ # must specify `amiId` and `securityGroupIds`. For more information, see
663
+ # [Configuring instance settings for compute node groups in PCS][1] in
664
+ # the *PCS User Guide*.
660
665
  #
661
666
  #
662
667
  #
663
- # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html
668
+ # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/working-with_cng_instance-settings.html
669
+ #
670
+ # @option params [String] :ami_id
671
+ # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
672
+ # compute nodes (Amazon EC2 instances). This value overrides the AMI ID
673
+ # in the custom launch template. If you don't provide this value, PCS
674
+ # uses the AMI ID specified in the custom launch template. You must
675
+ # provide this value if `launchTemplateMode` is `MANAGED`.
676
+ #
677
+ # @option params [Array<String>] :security_group_ids
678
+ # The IDs of the EC2 security groups to configure directly on the
679
+ # compute node group. The security groups must be in the same VPC as the
680
+ # cluster. PCS uses these security groups instead of the security groups
681
+ # in the custom launch template. You can't specify this value if the
682
+ # custom launch template defines network interfaces. If you don't
683
+ # provide this value, PCS uses the security groups in the custom launch
684
+ # template. You must provide this value if `launchTemplateMode` is
685
+ # `MANAGED`. For more information, see [Configuring instance settings
686
+ # for compute node groups in PCS][1] in the *PCS User Guide*.
687
+ #
688
+ #
689
+ #
690
+ # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/working-with_cng_instance-settings.html
691
+ #
692
+ # @option params [String] :ssh_key_name
693
+ # The name of the EC2 key pair to configure directly on the compute node
694
+ # group. The key pair must exist in your account and Amazon Web Services
695
+ # Region. PCS uses this key pair instead of the key pair in the custom
696
+ # launch template. If you don't provide this value, PCS uses the key
697
+ # pair in the custom launch template, if one is specified. You must have
698
+ # permission for `ec2:DescribeKeyPairs`. If you delete the key pair
699
+ # later, future instance launches can fail. For more information, see
700
+ # [Configuring instance settings for compute node groups in PCS][1] in
701
+ # the *PCS User Guide*.
702
+ #
703
+ #
704
+ #
705
+ # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/working-with_cng_instance-settings.html
664
706
  #
665
707
  # @option params [required, String] :cluster_identifier
666
708
  # The name or ID of the cluster to create a compute node group in.
@@ -668,11 +710,6 @@ module Aws::PCS
668
710
  # @option params [required, String] :compute_node_group_name
669
711
  # A name to identify the cluster. Example: `MyCluster`
670
712
  #
671
- # @option params [String] :ami_id
672
- # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
673
- # compute nodes (Amazon EC2 instances). If you don't provide this
674
- # value, PCS uses the AMI ID specified in the custom launch template.
675
- #
676
713
  # @option params [required, Array<String>] :subnet_ids
677
714
  # The list of subnet IDs where the compute node group launches
678
715
  # instances. Subnets must be in the same VPC as the cluster.
@@ -698,8 +735,19 @@ module Aws::PCS
698
735
  # [3]: https://docs.aws.amazon.com/pcs/latest/userguide/capacity-reservations-iodcr.html
699
736
  # [4]: https://docs.aws.amazon.com/pcs/latest/userguide/capacity-reservations-odcr.html
700
737
  #
701
- # @option params [required, Types::CustomLaunchTemplate] :custom_launch_template
702
- # An Amazon EC2 launch template PCS uses to launch compute nodes.
738
+ # @option params [String] :launch_template_mode
739
+ # Specifies whether the compute node group uses a custom launch template
740
+ # or a launch template that PCS manages. The default value is `CUSTOM`.
741
+ #
742
+ # If the value is `CUSTOM`, provide `customLaunchTemplate`. If the value
743
+ # is `MANAGED`, omit `customLaunchTemplate` and provide `amiId` and
744
+ # `securityGroupIds`.
745
+ #
746
+ # @option params [Types::CustomLaunchTemplate] :custom_launch_template
747
+ # The custom Amazon EC2 launch template to associate with the compute
748
+ # node group. Specify the launch template `id` and `version` when
749
+ # `launchTemplateMode` is `CUSTOM`. Don't specify this value when
750
+ # `launchTemplateMode` is `MANAGED`.
703
751
  #
704
752
  # @option params [required, String] :iam_instance_profile_arn
705
753
  # The Amazon Resource Name (ARN) of the IAM instance profile used to
@@ -741,7 +789,7 @@ module Aws::PCS
741
789
  # request completes successfully, the subsequent retries with the same
742
790
  # client token return the result from the original successful request
743
791
  # and they have no additional effect. If you don't specify a client
744
- # token, the CLI and SDK automatically generate 1 for you.
792
+ # token, the CLI and SDK automatically generate one for you.
745
793
  #
746
794
  # **A suitable default value is auto-generated.** You should normally
747
795
  # not need to pass this option.**
@@ -757,12 +805,15 @@ module Aws::PCS
757
805
  # @example Request syntax with placeholder values
758
806
  #
759
807
  # resp = client.create_compute_node_group({
808
+ # ami_id: "AmiId",
809
+ # security_group_ids: ["SecurityGroupId"],
810
+ # ssh_key_name: "KeyPairName",
760
811
  # cluster_identifier: "ClusterIdentifier", # required
761
812
  # compute_node_group_name: "ComputeNodeGroupName", # required
762
- # ami_id: "AmiId",
763
813
  # subnet_ids: ["String"], # required
764
814
  # purchase_option: "ONDEMAND", # accepts ONDEMAND, SPOT, CAPACITY_BLOCK, INTERRUPTIBLE_CAPACITY_RESERVATION
765
- # custom_launch_template: { # required
815
+ # launch_template_mode: "CUSTOM", # accepts CUSTOM, MANAGED
816
+ # custom_launch_template: {
766
817
  # id: "String", # required
767
818
  # version: "String", # required
768
819
  # },
@@ -832,6 +883,10 @@ module Aws::PCS
832
883
  #
833
884
  # @example Response structure
834
885
  #
886
+ # resp.compute_node_group.ami_id #=> String
887
+ # resp.compute_node_group.security_group_ids #=> Array
888
+ # resp.compute_node_group.security_group_ids[0] #=> String
889
+ # resp.compute_node_group.ssh_key_name #=> String
835
890
  # resp.compute_node_group.name #=> String
836
891
  # resp.compute_node_group.id #=> String
837
892
  # resp.compute_node_group.arn #=> String
@@ -839,10 +894,10 @@ module Aws::PCS
839
894
  # resp.compute_node_group.created_at #=> Time
840
895
  # resp.compute_node_group.modified_at #=> Time
841
896
  # resp.compute_node_group.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED", "UPDATE_FAILED", "DELETED", "SUSPENDING", "SUSPENDED", "RESUMING"
842
- # resp.compute_node_group.ami_id #=> String
843
897
  # resp.compute_node_group.subnet_ids #=> Array
844
898
  # resp.compute_node_group.subnet_ids[0] #=> String
845
899
  # resp.compute_node_group.purchase_option #=> String, one of "ONDEMAND", "SPOT", "CAPACITY_BLOCK", "INTERRUPTIBLE_CAPACITY_RESERVATION"
900
+ # resp.compute_node_group.launch_template_mode #=> String, one of "CUSTOM", "MANAGED"
846
901
  # resp.compute_node_group.custom_launch_template.id #=> String
847
902
  # resp.compute_node_group.custom_launch_template.version #=> String
848
903
  # resp.compute_node_group.iam_instance_profile_arn #=> String
@@ -914,7 +969,7 @@ module Aws::PCS
914
969
  # request completes successfully, the subsequent retries with the same
915
970
  # client token return the result from the original successful request
916
971
  # and they have no additional effect. If you don't specify a client
917
- # token, the CLI and SDK automatically generate 1 for you.
972
+ # token, the CLI and SDK automatically generate one for you.
918
973
  #
919
974
  # **A suitable default value is auto-generated.** You should normally
920
975
  # not need to pass this option.**
@@ -992,7 +1047,7 @@ module Aws::PCS
992
1047
  # request completes successfully, the subsequent retries with the same
993
1048
  # client token return the result from the original successful request
994
1049
  # and they have no additional effect. If you don't specify a client
995
- # token, the CLI and SDK automatically generate 1 for you.
1050
+ # token, the CLI and SDK automatically generate one for you.
996
1051
  #
997
1052
  # **A suitable default value is auto-generated.** You should normally
998
1053
  # not need to pass this option.**
@@ -1031,7 +1086,7 @@ module Aws::PCS
1031
1086
  # request completes successfully, the subsequent retries with the same
1032
1087
  # client token return the result from the original successful request
1033
1088
  # and they have no additional effect. If you don't specify a client
1034
- # token, the CLI and SDK automatically generate 1 for you.
1089
+ # token, the CLI and SDK automatically generate one for you.
1035
1090
  #
1036
1091
  # **A suitable default value is auto-generated.** You should normally
1037
1092
  # not need to pass this option.**
@@ -1072,7 +1127,7 @@ module Aws::PCS
1072
1127
  # request completes successfully, the subsequent retries with the same
1073
1128
  # client token return the result from the original successful request
1074
1129
  # and they have no additional effect. If you don't specify a client
1075
- # token, the CLI and SDK automatically generate 1 for you.
1130
+ # token, the CLI and SDK automatically generate one for you.
1076
1131
  #
1077
1132
  # **A suitable default value is auto-generated.** You should normally
1078
1133
  # not need to pass this option.**
@@ -1188,6 +1243,10 @@ module Aws::PCS
1188
1243
  #
1189
1244
  # @example Response structure
1190
1245
  #
1246
+ # resp.compute_node_group.ami_id #=> String
1247
+ # resp.compute_node_group.security_group_ids #=> Array
1248
+ # resp.compute_node_group.security_group_ids[0] #=> String
1249
+ # resp.compute_node_group.ssh_key_name #=> String
1191
1250
  # resp.compute_node_group.name #=> String
1192
1251
  # resp.compute_node_group.id #=> String
1193
1252
  # resp.compute_node_group.arn #=> String
@@ -1195,10 +1254,10 @@ module Aws::PCS
1195
1254
  # resp.compute_node_group.created_at #=> Time
1196
1255
  # resp.compute_node_group.modified_at #=> Time
1197
1256
  # resp.compute_node_group.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED", "UPDATE_FAILED", "DELETED", "SUSPENDING", "SUSPENDED", "RESUMING"
1198
- # resp.compute_node_group.ami_id #=> String
1199
1257
  # resp.compute_node_group.subnet_ids #=> Array
1200
1258
  # resp.compute_node_group.subnet_ids[0] #=> String
1201
1259
  # resp.compute_node_group.purchase_option #=> String, one of "ONDEMAND", "SPOT", "CAPACITY_BLOCK", "INTERRUPTIBLE_CAPACITY_RESERVATION"
1260
+ # resp.compute_node_group.launch_template_mode #=> String, one of "CUSTOM", "MANAGED"
1202
1261
  # resp.compute_node_group.custom_launch_template.id #=> String
1203
1262
  # resp.compute_node_group.custom_launch_template.version #=> String
1204
1263
  # resp.compute_node_group.iam_instance_profile_arn #=> String
@@ -1642,7 +1701,7 @@ module Aws::PCS
1642
1701
  # request completes successfully, the subsequent retries with the same
1643
1702
  # client token return the result from the original successful request
1644
1703
  # and they have no additional effect. If you don't specify a client
1645
- # token, the CLI and SDK automatically generate 1 for you.
1704
+ # token, the CLI and SDK automatically generate one for you.
1646
1705
  #
1647
1706
  # **A suitable default value is auto-generated.** You should normally
1648
1707
  # not need to pass this option.**
@@ -1758,23 +1817,79 @@ module Aws::PCS
1758
1817
  # networking, compute nodes, and settings specific to your scheduler
1759
1818
  # (such as Slurm).
1760
1819
  #
1820
+ # @option params [String] :ami_id
1821
+ # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
1822
+ # instances. This value overrides the AMI ID in the custom launch
1823
+ # template. Specify an empty string (`""`) to remove the AMI ID from the
1824
+ # compute node group and use the AMI ID specified in the custom launch
1825
+ # template. Omit this value to leave the current setting unchanged.
1826
+ #
1827
+ # @option params [Array<String>] :security_group_ids
1828
+ # The IDs of the EC2 security groups to configure directly on the
1829
+ # compute node group. The security groups must be in the same VPC as the
1830
+ # cluster. PCS uses these security groups instead of the security groups
1831
+ # in the custom launch template. You can't specify this value if the
1832
+ # custom launch template defines network interfaces. Specify an empty
1833
+ # list (`[]`) to remove the security groups from the compute node group
1834
+ # and use the security groups in the custom launch template. Omit this
1835
+ # value to leave the current setting unchanged.
1836
+ #
1837
+ # @option params [String] :ssh_key_name
1838
+ # The name of the EC2 key pair to configure directly on the compute node
1839
+ # group. The key pair must exist in your account and Amazon Web Services
1840
+ # Region. PCS uses this key pair instead of the key pair in the custom
1841
+ # launch template. Specify an empty string (`""`) to remove the key pair
1842
+ # from the compute node group and use the key pair in the custom launch
1843
+ # template. Omit this value to leave the current setting unchanged. You
1844
+ # must have permission for `ec2:DescribeKeyPairs` to specify a key pair.
1845
+ # If you delete the key pair later, future instance launches can fail.
1846
+ #
1761
1847
  # @option params [required, String] :cluster_identifier
1762
1848
  # The name or ID of the cluster of the compute node group.
1763
1849
  #
1764
1850
  # @option params [required, String] :compute_node_group_identifier
1765
1851
  # The name or ID of the compute node group.
1766
1852
  #
1767
- # @option params [String] :ami_id
1768
- # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
1769
- # instances. If not provided, PCS uses the AMI ID specified in the
1770
- # custom launch template.
1771
- #
1772
1853
  # @option params [Array<String>] :subnet_ids
1773
1854
  # The list of subnet IDs where the compute node group provisions
1774
1855
  # instances. The subnets must be in the same VPC as the cluster.
1775
1856
  #
1857
+ # @option params [String] :launch_template_mode
1858
+ # Specifies whether the compute node group uses a custom launch template
1859
+ # or a launch template that PCS manages. Omit this value to keep the
1860
+ # current mode.
1861
+ #
1862
+ # Valid values:
1863
+ #
1864
+ # * `CUSTOM` – Use a custom launch template. To switch from `MANAGED`,
1865
+ # also provide `customLaunchTemplate`. If the compute node group
1866
+ # already uses `CUSTOM` and you omit `customLaunchTemplate`, the
1867
+ # existing launch template is unchanged.
1868
+ #
1869
+ # * `MANAGED` – Use a launch template created and managed by PCS. Omit
1870
+ # `customLaunchTemplate`. Switching to this mode removes the custom
1871
+ # launch template association but doesn't delete the launch template.
1872
+ #
1873
+ # When switching to `MANAGED`, the compute node group must have `amiId`
1874
+ # and `securityGroupIds` configured. You can set these values in the
1875
+ # same request.
1876
+ #
1776
1877
  # @option params [Types::CustomLaunchTemplate] :custom_launch_template
1777
- # An Amazon EC2 launch template PCS uses to launch compute nodes.
1878
+ # The custom Amazon EC2 launch template to associate with the compute
1879
+ # node group. To set or change the custom launch template, specify `id`
1880
+ # and `version`. If you provide this value and omit
1881
+ # `launchTemplateMode`, the compute node group must already use `CUSTOM`
1882
+ # mode. To switch from `MANAGED` to `CUSTOM`, specify
1883
+ # `launchTemplateMode` as `CUSTOM` and provide this value. If the
1884
+ # compute node group already uses `CUSTOM`, omit this value while also
1885
+ # omitting `launchTemplateMode`, or while specifying `CUSTOM`, to keep
1886
+ # the existing custom launch template. For more information, see
1887
+ # [Migrating a compute node group from a custom launch template][1] in
1888
+ # the *PCS User Guide*.
1889
+ #
1890
+ #
1891
+ #
1892
+ # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/working-with_cng_instance-settings-migrate.html
1778
1893
  #
1779
1894
  # @option params [String] :purchase_option
1780
1895
  # Specifies how EC2 instances are purchased on your behalf. PCS supports
@@ -1833,7 +1948,7 @@ module Aws::PCS
1833
1948
  # request completes successfully, the subsequent retries with the same
1834
1949
  # client token return the result from the original successful request
1835
1950
  # and they have no additional effect. If you don't specify a client
1836
- # token, the CLI and SDK automatically generate 1 for you.
1951
+ # token, the CLI and SDK automatically generate one for you.
1837
1952
  #
1838
1953
  # **A suitable default value is auto-generated.** You should normally
1839
1954
  # not need to pass this option.**
@@ -1845,10 +1960,13 @@ module Aws::PCS
1845
1960
  # @example Request syntax with placeholder values
1846
1961
  #
1847
1962
  # resp = client.update_compute_node_group({
1963
+ # ami_id: "AmiIdOrEmpty",
1964
+ # security_group_ids: ["SecurityGroupId"],
1965
+ # ssh_key_name: "KeyPairNameOrEmpty",
1848
1966
  # cluster_identifier: "ClusterIdentifier", # required
1849
1967
  # compute_node_group_identifier: "ComputeNodeGroupIdentifier", # required
1850
- # ami_id: "AmiId",
1851
1968
  # subnet_ids: ["String"],
1969
+ # launch_template_mode: "CUSTOM", # accepts CUSTOM, MANAGED
1852
1970
  # custom_launch_template: {
1853
1971
  # id: "String", # required
1854
1972
  # version: "String", # required
@@ -1912,6 +2030,10 @@ module Aws::PCS
1912
2030
  #
1913
2031
  # @example Response structure
1914
2032
  #
2033
+ # resp.compute_node_group.ami_id #=> String
2034
+ # resp.compute_node_group.security_group_ids #=> Array
2035
+ # resp.compute_node_group.security_group_ids[0] #=> String
2036
+ # resp.compute_node_group.ssh_key_name #=> String
1915
2037
  # resp.compute_node_group.name #=> String
1916
2038
  # resp.compute_node_group.id #=> String
1917
2039
  # resp.compute_node_group.arn #=> String
@@ -1919,10 +2041,10 @@ module Aws::PCS
1919
2041
  # resp.compute_node_group.created_at #=> Time
1920
2042
  # resp.compute_node_group.modified_at #=> Time
1921
2043
  # resp.compute_node_group.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED", "UPDATE_FAILED", "DELETED", "SUSPENDING", "SUSPENDED", "RESUMING"
1922
- # resp.compute_node_group.ami_id #=> String
1923
2044
  # resp.compute_node_group.subnet_ids #=> Array
1924
2045
  # resp.compute_node_group.subnet_ids[0] #=> String
1925
2046
  # resp.compute_node_group.purchase_option #=> String, one of "ONDEMAND", "SPOT", "CAPACITY_BLOCK", "INTERRUPTIBLE_CAPACITY_RESERVATION"
2047
+ # resp.compute_node_group.launch_template_mode #=> String, one of "CUSTOM", "MANAGED"
1926
2048
  # resp.compute_node_group.custom_launch_template.id #=> String
1927
2049
  # resp.compute_node_group.custom_launch_template.version #=> String
1928
2050
  # resp.compute_node_group.iam_instance_profile_arn #=> String
@@ -1993,7 +2115,7 @@ module Aws::PCS
1993
2115
  # request completes successfully, the subsequent retries with the same
1994
2116
  # client token return the result from the original successful request
1995
2117
  # and they have no additional effect. If you don't specify a client
1996
- # token, the CLI and SDK automatically generate 1 for you.
2118
+ # token, the CLI and SDK automatically generate one for you.
1997
2119
  #
1998
2120
  # **A suitable default value is auto-generated.** You should normally
1999
2121
  # not need to pass this option.**
@@ -2068,7 +2190,7 @@ module Aws::PCS
2068
2190
  tracer: tracer
2069
2191
  )
2070
2192
  context[:gem_name] = 'aws-sdk-pcs'
2071
- context[:gem_version] = '1.63.0'
2193
+ context[:gem_version] = '1.64.0'
2072
2194
  Seahorse::Client::Request.new(handlers, context)
2073
2195
  end
2074
2196
 
@@ -21,6 +21,7 @@ module Aws::PCS
21
21
  AccountingRequest = Shapes::StructureShape.new(name: 'AccountingRequest')
22
22
  AccountingRequestDefaultPurgeTimeInDaysInteger = Shapes::IntegerShape.new(name: 'AccountingRequestDefaultPurgeTimeInDaysInteger')
23
23
  AmiId = Shapes::StringShape.new(name: 'AmiId')
24
+ AmiIdOrEmpty = Shapes::StringShape.new(name: 'AmiIdOrEmpty')
24
25
  Arn = Shapes::StringShape.new(name: 'Arn')
25
26
  BootstrapId = Shapes::StringShape.new(name: 'BootstrapId')
26
27
  CgroupCustomSetting = Shapes::StructureShape.new(name: 'CgroupCustomSetting')
@@ -82,6 +83,9 @@ module Aws::PCS
82
83
  InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
83
84
  JwtAuth = Shapes::StructureShape.new(name: 'JwtAuth')
84
85
  JwtKey = Shapes::StructureShape.new(name: 'JwtKey')
86
+ KeyPairName = Shapes::StringShape.new(name: 'KeyPairName')
87
+ KeyPairNameOrEmpty = Shapes::StringShape.new(name: 'KeyPairNameOrEmpty')
88
+ LaunchTemplateMode = Shapes::StringShape.new(name: 'LaunchTemplateMode')
85
89
  ListClustersRequest = Shapes::StructureShape.new(name: 'ListClustersRequest')
86
90
  ListClustersResponse = Shapes::StructureShape.new(name: 'ListClustersResponse')
87
91
  ListComputeNodeGroupsRequest = Shapes::StructureShape.new(name: 'ListComputeNodeGroupsRequest')
@@ -134,6 +138,7 @@ module Aws::PCS
134
138
  ScriptSourceScriptLocationString = Shapes::StringShape.new(name: 'ScriptSourceScriptLocationString')
135
139
  SecurityGroupId = Shapes::StringShape.new(name: 'SecurityGroupId')
136
140
  SecurityGroupIdList = Shapes::ListShape.new(name: 'SecurityGroupIdList')
141
+ SecurityGroupIdListOrEmpty = Shapes::ListShape.new(name: 'SecurityGroupIdListOrEmpty')
137
142
  ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
138
143
  SharedSecret = Shapes::StringShape.new(name: 'SharedSecret')
139
144
  Size = Shapes::StringShape.new(name: 'Size')
@@ -240,6 +245,9 @@ module Aws::PCS
240
245
  ClusterSummary.add_member(:status, Shapes::ShapeRef.new(shape: ClusterStatus, required: true, location_name: "status"))
241
246
  ClusterSummary.struct_class = Types::ClusterSummary
242
247
 
248
+ ComputeNodeGroup.add_member(:ami_id, Shapes::ShapeRef.new(shape: AmiId, location_name: "amiId"))
249
+ ComputeNodeGroup.add_member(:security_group_ids, Shapes::ShapeRef.new(shape: SecurityGroupIdList, location_name: "securityGroupIds"))
250
+ ComputeNodeGroup.add_member(:ssh_key_name, Shapes::ShapeRef.new(shape: KeyPairName, location_name: "sshKeyName"))
243
251
  ComputeNodeGroup.add_member(:name, Shapes::ShapeRef.new(shape: ComputeNodeGroupName, required: true, location_name: "name"))
244
252
  ComputeNodeGroup.add_member(:id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "id"))
245
253
  ComputeNodeGroup.add_member(:arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "arn"))
@@ -247,10 +255,10 @@ module Aws::PCS
247
255
  ComputeNodeGroup.add_member(:created_at, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, required: true, location_name: "createdAt"))
248
256
  ComputeNodeGroup.add_member(:modified_at, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, required: true, location_name: "modifiedAt"))
249
257
  ComputeNodeGroup.add_member(:status, Shapes::ShapeRef.new(shape: ComputeNodeGroupStatus, required: true, location_name: "status"))
250
- ComputeNodeGroup.add_member(:ami_id, Shapes::ShapeRef.new(shape: AmiId, location_name: "amiId"))
251
258
  ComputeNodeGroup.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: SubnetIdList, required: true, location_name: "subnetIds"))
252
259
  ComputeNodeGroup.add_member(:purchase_option, Shapes::ShapeRef.new(shape: PurchaseOption, location_name: "purchaseOption"))
253
- ComputeNodeGroup.add_member(:custom_launch_template, Shapes::ShapeRef.new(shape: CustomLaunchTemplate, required: true, location_name: "customLaunchTemplate"))
260
+ ComputeNodeGroup.add_member(:launch_template_mode, Shapes::ShapeRef.new(shape: LaunchTemplateMode, location_name: "launchTemplateMode"))
261
+ ComputeNodeGroup.add_member(:custom_launch_template, Shapes::ShapeRef.new(shape: CustomLaunchTemplate, location_name: "customLaunchTemplate"))
254
262
  ComputeNodeGroup.add_member(:iam_instance_profile_arn, Shapes::ShapeRef.new(shape: InstanceProfileArn, required: true, location_name: "iamInstanceProfileArn"))
255
263
  ComputeNodeGroup.add_member(:scaling_configuration, Shapes::ShapeRef.new(shape: ScalingConfiguration, required: true, location_name: "scalingConfiguration"))
256
264
  ComputeNodeGroup.add_member(:instance_configs, Shapes::ShapeRef.new(shape: InstanceList, required: true, location_name: "instanceConfigs"))
@@ -303,12 +311,15 @@ module Aws::PCS
303
311
  CreateClusterResponse.add_member(:cluster, Shapes::ShapeRef.new(shape: Cluster, location_name: "cluster"))
304
312
  CreateClusterResponse.struct_class = Types::CreateClusterResponse
305
313
 
314
+ CreateComputeNodeGroupRequest.add_member(:ami_id, Shapes::ShapeRef.new(shape: AmiId, location_name: "amiId"))
315
+ CreateComputeNodeGroupRequest.add_member(:security_group_ids, Shapes::ShapeRef.new(shape: SecurityGroupIdList, location_name: "securityGroupIds"))
316
+ CreateComputeNodeGroupRequest.add_member(:ssh_key_name, Shapes::ShapeRef.new(shape: KeyPairName, location_name: "sshKeyName"))
306
317
  CreateComputeNodeGroupRequest.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: ClusterIdentifier, required: true, location_name: "clusterIdentifier"))
307
318
  CreateComputeNodeGroupRequest.add_member(:compute_node_group_name, Shapes::ShapeRef.new(shape: ComputeNodeGroupName, required: true, location_name: "computeNodeGroupName"))
308
- CreateComputeNodeGroupRequest.add_member(:ami_id, Shapes::ShapeRef.new(shape: AmiId, location_name: "amiId"))
309
319
  CreateComputeNodeGroupRequest.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: StringList, required: true, location_name: "subnetIds"))
310
320
  CreateComputeNodeGroupRequest.add_member(:purchase_option, Shapes::ShapeRef.new(shape: PurchaseOption, location_name: "purchaseOption"))
311
- CreateComputeNodeGroupRequest.add_member(:custom_launch_template, Shapes::ShapeRef.new(shape: CustomLaunchTemplate, required: true, location_name: "customLaunchTemplate"))
321
+ CreateComputeNodeGroupRequest.add_member(:launch_template_mode, Shapes::ShapeRef.new(shape: LaunchTemplateMode, location_name: "launchTemplateMode"))
322
+ CreateComputeNodeGroupRequest.add_member(:custom_launch_template, Shapes::ShapeRef.new(shape: CustomLaunchTemplate, location_name: "customLaunchTemplate"))
312
323
  CreateComputeNodeGroupRequest.add_member(:iam_instance_profile_arn, Shapes::ShapeRef.new(shape: InstanceProfileArn, required: true, location_name: "iamInstanceProfileArn"))
313
324
  CreateComputeNodeGroupRequest.add_member(:scaling_configuration, Shapes::ShapeRef.new(shape: ScalingConfigurationRequest, required: true, location_name: "scalingConfiguration"))
314
325
  CreateComputeNodeGroupRequest.add_member(:instance_configs, Shapes::ShapeRef.new(shape: InstanceList, required: true, location_name: "instanceConfigs"))
@@ -554,6 +565,8 @@ module Aws::PCS
554
565
 
555
566
  SecurityGroupIdList.member = Shapes::ShapeRef.new(shape: SecurityGroupId)
556
567
 
568
+ SecurityGroupIdListOrEmpty.member = Shapes::ShapeRef.new(shape: SecurityGroupId)
569
+
557
570
  ServiceQuotaExceededException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
558
571
  ServiceQuotaExceededException.add_member(:service_code, Shapes::ShapeRef.new(shape: String, required: true, location_name: "serviceCode"))
559
572
  ServiceQuotaExceededException.add_member(:resource_id, Shapes::ShapeRef.new(shape: String, location_name: "resourceId"))
@@ -629,10 +642,13 @@ module Aws::PCS
629
642
  UpdateClusterSlurmConfigurationRequest.add_member(:slurm_rest, Shapes::ShapeRef.new(shape: UpdateSlurmRestRequest, location_name: "slurmRest"))
630
643
  UpdateClusterSlurmConfigurationRequest.struct_class = Types::UpdateClusterSlurmConfigurationRequest
631
644
 
645
+ UpdateComputeNodeGroupRequest.add_member(:ami_id, Shapes::ShapeRef.new(shape: AmiIdOrEmpty, location_name: "amiId"))
646
+ UpdateComputeNodeGroupRequest.add_member(:security_group_ids, Shapes::ShapeRef.new(shape: SecurityGroupIdListOrEmpty, location_name: "securityGroupIds"))
647
+ UpdateComputeNodeGroupRequest.add_member(:ssh_key_name, Shapes::ShapeRef.new(shape: KeyPairNameOrEmpty, location_name: "sshKeyName"))
632
648
  UpdateComputeNodeGroupRequest.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: ClusterIdentifier, required: true, location_name: "clusterIdentifier"))
633
649
  UpdateComputeNodeGroupRequest.add_member(:compute_node_group_identifier, Shapes::ShapeRef.new(shape: ComputeNodeGroupIdentifier, required: true, location_name: "computeNodeGroupIdentifier"))
634
- UpdateComputeNodeGroupRequest.add_member(:ami_id, Shapes::ShapeRef.new(shape: AmiId, location_name: "amiId"))
635
650
  UpdateComputeNodeGroupRequest.add_member(:subnet_ids, Shapes::ShapeRef.new(shape: StringList, location_name: "subnetIds"))
651
+ UpdateComputeNodeGroupRequest.add_member(:launch_template_mode, Shapes::ShapeRef.new(shape: LaunchTemplateMode, location_name: "launchTemplateMode"))
636
652
  UpdateComputeNodeGroupRequest.add_member(:custom_launch_template, Shapes::ShapeRef.new(shape: CustomLaunchTemplate, location_name: "customLaunchTemplate"))
637
653
  UpdateComputeNodeGroupRequest.add_member(:purchase_option, Shapes::ShapeRef.new(shape: PurchaseOption, location_name: "purchaseOption"))
638
654
  UpdateComputeNodeGroupRequest.add_member(:spot_options, Shapes::ShapeRef.new(shape: SpotOptions, location_name: "spotOptions"))
@@ -391,6 +391,30 @@ module Aws::PCS
391
391
 
392
392
  # A compute node group associated with a cluster.
393
393
  #
394
+ # @!attribute [rw] ami_id
395
+ # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
396
+ # instances. If not present, PCS uses the AMI ID specified in the
397
+ # custom launch template.
398
+ # @return [String]
399
+ #
400
+ # @!attribute [rw] security_group_ids
401
+ # The IDs of the EC2 security groups configured directly on the
402
+ # compute node group. PCS uses these security groups instead of the
403
+ # security groups in the custom launch template. This value isn't
404
+ # present if security groups aren't configured directly on the
405
+ # compute node group. In that case, PCS uses the security groups in
406
+ # the custom launch template.
407
+ # @return [Array<String>]
408
+ #
409
+ # @!attribute [rw] ssh_key_name
410
+ # The name of the EC2 key pair configured directly on the compute node
411
+ # group. PCS uses this key pair instead of the key pair in the custom
412
+ # launch template. This value isn't present if a key pair isn't
413
+ # configured directly on the compute node group. In that case, PCS
414
+ # uses the key pair in the custom launch template, if one is
415
+ # specified.
416
+ # @return [String]
417
+ #
394
418
  # @!attribute [rw] name
395
419
  # The name that identifies the compute node group.
396
420
  # @return [String]
@@ -437,12 +461,6 @@ module Aws::PCS
437
461
  # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/slurm-versions_faq.html
438
462
  # @return [String]
439
463
  #
440
- # @!attribute [rw] ami_id
441
- # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
442
- # instances. If not provided, PCS uses the AMI ID specified in the
443
- # custom launch template.
444
- # @return [String]
445
- #
446
464
  # @!attribute [rw] subnet_ids
447
465
  # The list of subnet IDs where instances are provisioned by the
448
466
  # compute node group. The subnets must be in the same VPC as the
@@ -472,8 +490,23 @@ module Aws::PCS
472
490
  # [4]: https://docs.aws.amazon.com/pcs/latest/userguide/capacity-reservations-odcr.html
473
491
  # @return [String]
474
492
  #
493
+ # @!attribute [rw] launch_template_mode
494
+ # Indicates whether the compute node group uses a custom launch
495
+ # template or a launch template that PCS manages. The default value is
496
+ # `CUSTOM`.
497
+ #
498
+ # Valid values:
499
+ #
500
+ # * `CUSTOM` – The compute node group uses the launch template in
501
+ # `customLaunchTemplate`.
502
+ #
503
+ # * `MANAGED` – PCS creates and manages the launch template.
504
+ # @return [String]
505
+ #
475
506
  # @!attribute [rw] custom_launch_template
476
- # An Amazon EC2 launch template PCS uses to launch compute nodes.
507
+ # The custom Amazon EC2 launch template associated with the compute
508
+ # node group. This value is present when `launchTemplateMode` is
509
+ # `CUSTOM` and isn't present when `launchTemplateMode` is `MANAGED`.
477
510
  # @return [Types::CustomLaunchTemplate]
478
511
  #
479
512
  # @!attribute [rw] iam_instance_profile_arn
@@ -523,6 +556,9 @@ module Aws::PCS
523
556
  # @see http://docs.aws.amazon.com/goto/WebAPI/pcs-2023-02-10/ComputeNodeGroup AWS API Documentation
524
557
  #
525
558
  class ComputeNodeGroup < Struct.new(
559
+ :ami_id,
560
+ :security_group_ids,
561
+ :ssh_key_name,
526
562
  :name,
527
563
  :id,
528
564
  :arn,
@@ -530,9 +566,9 @@ module Aws::PCS
530
566
  :created_at,
531
567
  :modified_at,
532
568
  :status,
533
- :ami_id,
534
569
  :subnet_ids,
535
570
  :purchase_option,
571
+ :launch_template_mode,
536
572
  :custom_launch_template,
537
573
  :iam_instance_profile_arn,
538
574
  :scaling_configuration,
@@ -761,7 +797,7 @@ module Aws::PCS
761
797
  # request completes successfully, the subsequent retries with the same
762
798
  # client token return the result from the original successful request
763
799
  # and they have no additional effect. If you don't specify a client
764
- # token, the CLI and SDK automatically generate 1 for you.
800
+ # token, the CLI and SDK automatically generate one for you.
765
801
  #
766
802
  # **A suitable default value is auto-generated.** You should normally
767
803
  # not need to pass this option.
@@ -798,6 +834,47 @@ module Aws::PCS
798
834
  include Aws::Structure
799
835
  end
800
836
 
837
+ # @!attribute [rw] ami_id
838
+ # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
839
+ # compute nodes (Amazon EC2 instances). This value overrides the AMI
840
+ # ID in the custom launch template. If you don't provide this value,
841
+ # PCS uses the AMI ID specified in the custom launch template. You
842
+ # must provide this value if `launchTemplateMode` is `MANAGED`.
843
+ # @return [String]
844
+ #
845
+ # @!attribute [rw] security_group_ids
846
+ # The IDs of the EC2 security groups to configure directly on the
847
+ # compute node group. The security groups must be in the same VPC as
848
+ # the cluster. PCS uses these security groups instead of the security
849
+ # groups in the custom launch template. You can't specify this value
850
+ # if the custom launch template defines network interfaces. If you
851
+ # don't provide this value, PCS uses the security groups in the
852
+ # custom launch template. You must provide this value if
853
+ # `launchTemplateMode` is `MANAGED`. For more information, see
854
+ # [Configuring instance settings for compute node groups in PCS][1] in
855
+ # the *PCS User Guide*.
856
+ #
857
+ #
858
+ #
859
+ # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/working-with_cng_instance-settings.html
860
+ # @return [Array<String>]
861
+ #
862
+ # @!attribute [rw] ssh_key_name
863
+ # The name of the EC2 key pair to configure directly on the compute
864
+ # node group. The key pair must exist in your account and Amazon Web
865
+ # Services Region. PCS uses this key pair instead of the key pair in
866
+ # the custom launch template. If you don't provide this value, PCS
867
+ # uses the key pair in the custom launch template, if one is
868
+ # specified. You must have permission for `ec2:DescribeKeyPairs`. If
869
+ # you delete the key pair later, future instance launches can fail.
870
+ # For more information, see [Configuring instance settings for compute
871
+ # node groups in PCS][1] in the *PCS User Guide*.
872
+ #
873
+ #
874
+ #
875
+ # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/working-with_cng_instance-settings.html
876
+ # @return [String]
877
+ #
801
878
  # @!attribute [rw] cluster_identifier
802
879
  # The name or ID of the cluster to create a compute node group in.
803
880
  # @return [String]
@@ -806,12 +883,6 @@ module Aws::PCS
806
883
  # A name to identify the cluster. Example: `MyCluster`
807
884
  # @return [String]
808
885
  #
809
- # @!attribute [rw] ami_id
810
- # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
811
- # compute nodes (Amazon EC2 instances). If you don't provide this
812
- # value, PCS uses the AMI ID specified in the custom launch template.
813
- # @return [String]
814
- #
815
886
  # @!attribute [rw] subnet_ids
816
887
  # The list of subnet IDs where the compute node group launches
817
888
  # instances. Subnets must be in the same VPC as the cluster.
@@ -840,8 +911,21 @@ module Aws::PCS
840
911
  # [4]: https://docs.aws.amazon.com/pcs/latest/userguide/capacity-reservations-odcr.html
841
912
  # @return [String]
842
913
  #
914
+ # @!attribute [rw] launch_template_mode
915
+ # Specifies whether the compute node group uses a custom launch
916
+ # template or a launch template that PCS manages. The default value is
917
+ # `CUSTOM`.
918
+ #
919
+ # If the value is `CUSTOM`, provide `customLaunchTemplate`. If the
920
+ # value is `MANAGED`, omit `customLaunchTemplate` and provide `amiId`
921
+ # and `securityGroupIds`.
922
+ # @return [String]
923
+ #
843
924
  # @!attribute [rw] custom_launch_template
844
- # An Amazon EC2 launch template PCS uses to launch compute nodes.
925
+ # The custom Amazon EC2 launch template to associate with the compute
926
+ # node group. Specify the launch template `id` and `version` when
927
+ # `launchTemplateMode` is `CUSTOM`. Don't specify this value when
928
+ # `launchTemplateMode` is `MANAGED`.
845
929
  # @return [Types::CustomLaunchTemplate]
846
930
  #
847
931
  # @!attribute [rw] iam_instance_profile_arn
@@ -890,7 +974,7 @@ module Aws::PCS
890
974
  # request completes successfully, the subsequent retries with the same
891
975
  # client token return the result from the original successful request
892
976
  # and they have no additional effect. If you don't specify a client
893
- # token, the CLI and SDK automatically generate 1 for you.
977
+ # token, the CLI and SDK automatically generate one for you.
894
978
  #
895
979
  # **A suitable default value is auto-generated.** You should normally
896
980
  # not need to pass this option.
@@ -904,11 +988,14 @@ module Aws::PCS
904
988
  # @see http://docs.aws.amazon.com/goto/WebAPI/pcs-2023-02-10/CreateComputeNodeGroupRequest AWS API Documentation
905
989
  #
906
990
  class CreateComputeNodeGroupRequest < Struct.new(
991
+ :ami_id,
992
+ :security_group_ids,
993
+ :ssh_key_name,
907
994
  :cluster_identifier,
908
995
  :compute_node_group_name,
909
- :ami_id,
910
996
  :subnet_ids,
911
997
  :purchase_option,
998
+ :launch_template_mode,
912
999
  :custom_launch_template,
913
1000
  :iam_instance_profile_arn,
914
1001
  :scaling_configuration,
@@ -958,7 +1045,7 @@ module Aws::PCS
958
1045
  # request completes successfully, the subsequent retries with the same
959
1046
  # client token return the result from the original successful request
960
1047
  # and they have no additional effect. If you don't specify a client
961
- # token, the CLI and SDK automatically generate 1 for you.
1048
+ # token, the CLI and SDK automatically generate one for you.
962
1049
  #
963
1050
  # **A suitable default value is auto-generated.** You should normally
964
1051
  # not need to pass this option.
@@ -994,17 +1081,19 @@ module Aws::PCS
994
1081
  include Aws::Structure
995
1082
  end
996
1083
 
997
- # An Amazon EC2 launch template PCS uses to launch compute nodes.
1084
+ # An Amazon EC2 launch template PCS uses to launch compute nodes. The
1085
+ # structure contains the launch template ID and version.
998
1086
  #
999
1087
  # @!attribute [rw] id
1000
1088
  # The ID of the EC2 launch template to use to provision instances.
1089
+ # Specify this value together with `version`.
1001
1090
  #
1002
1091
  # Example: `lt-xxxx`
1003
1092
  # @return [String]
1004
1093
  #
1005
1094
  # @!attribute [rw] version
1006
1095
  # The version of the EC2 launch template to use to provision
1007
- # instances.
1096
+ # instances. Specify this value together with `id`.
1008
1097
  # @return [String]
1009
1098
  #
1010
1099
  # @see http://docs.aws.amazon.com/goto/WebAPI/pcs-2023-02-10/CustomLaunchTemplate AWS API Documentation
@@ -1027,7 +1116,7 @@ module Aws::PCS
1027
1116
  # request completes successfully, the subsequent retries with the same
1028
1117
  # client token return the result from the original successful request
1029
1118
  # and they have no additional effect. If you don't specify a client
1030
- # token, the CLI and SDK automatically generate 1 for you.
1119
+ # token, the CLI and SDK automatically generate one for you.
1031
1120
  #
1032
1121
  # **A suitable default value is auto-generated.** You should normally
1033
1122
  # not need to pass this option.
@@ -1061,7 +1150,7 @@ module Aws::PCS
1061
1150
  # request completes successfully, the subsequent retries with the same
1062
1151
  # client token return the result from the original successful request
1063
1152
  # and they have no additional effect. If you don't specify a client
1064
- # token, the CLI and SDK automatically generate 1 for you.
1153
+ # token, the CLI and SDK automatically generate one for you.
1065
1154
  #
1066
1155
  # **A suitable default value is auto-generated.** You should normally
1067
1156
  # not need to pass this option.
@@ -1096,7 +1185,7 @@ module Aws::PCS
1096
1185
  # request completes successfully, the subsequent retries with the same
1097
1186
  # client token return the result from the original successful request
1098
1187
  # and they have no additional effect. If you don't specify a client
1099
- # token, the CLI and SDK automatically generate 1 for you.
1188
+ # token, the CLI and SDK automatically generate one for you.
1100
1189
  #
1101
1190
  # **A suitable default value is auto-generated.** You should normally
1102
1191
  # not need to pass this option.
@@ -2435,7 +2524,7 @@ module Aws::PCS
2435
2524
  # request completes successfully, the subsequent retries with the same
2436
2525
  # client token return the result from the original successful request
2437
2526
  # and they have no additional effect. If you don't specify a client
2438
- # token, the CLI and SDK automatically generate 1 for you.
2527
+ # token, the CLI and SDK automatically generate one for you.
2439
2528
  #
2440
2529
  # **A suitable default value is auto-generated.** You should normally
2441
2530
  # not need to pass this option.
@@ -2523,6 +2612,38 @@ module Aws::PCS
2523
2612
  include Aws::Structure
2524
2613
  end
2525
2614
 
2615
+ # @!attribute [rw] ami_id
2616
+ # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
2617
+ # instances. This value overrides the AMI ID in the custom launch
2618
+ # template. Specify an empty string (`""`) to remove the AMI ID from
2619
+ # the compute node group and use the AMI ID specified in the custom
2620
+ # launch template. Omit this value to leave the current setting
2621
+ # unchanged.
2622
+ # @return [String]
2623
+ #
2624
+ # @!attribute [rw] security_group_ids
2625
+ # The IDs of the EC2 security groups to configure directly on the
2626
+ # compute node group. The security groups must be in the same VPC as
2627
+ # the cluster. PCS uses these security groups instead of the security
2628
+ # groups in the custom launch template. You can't specify this value
2629
+ # if the custom launch template defines network interfaces. Specify an
2630
+ # empty list (`[]`) to remove the security groups from the compute
2631
+ # node group and use the security groups in the custom launch
2632
+ # template. Omit this value to leave the current setting unchanged.
2633
+ # @return [Array<String>]
2634
+ #
2635
+ # @!attribute [rw] ssh_key_name
2636
+ # The name of the EC2 key pair to configure directly on the compute
2637
+ # node group. The key pair must exist in your account and Amazon Web
2638
+ # Services Region. PCS uses this key pair instead of the key pair in
2639
+ # the custom launch template. Specify an empty string (`""`) to remove
2640
+ # the key pair from the compute node group and use the key pair in the
2641
+ # custom launch template. Omit this value to leave the current setting
2642
+ # unchanged. You must have permission for `ec2:DescribeKeyPairs` to
2643
+ # specify a key pair. If you delete the key pair later, future
2644
+ # instance launches can fail.
2645
+ # @return [String]
2646
+ #
2526
2647
  # @!attribute [rw] cluster_identifier
2527
2648
  # The name or ID of the cluster of the compute node group.
2528
2649
  # @return [String]
@@ -2531,19 +2652,49 @@ module Aws::PCS
2531
2652
  # The name or ID of the compute node group.
2532
2653
  # @return [String]
2533
2654
  #
2534
- # @!attribute [rw] ami_id
2535
- # The ID of the Amazon Machine Image (AMI) that PCS uses to launch
2536
- # instances. If not provided, PCS uses the AMI ID specified in the
2537
- # custom launch template.
2538
- # @return [String]
2539
- #
2540
2655
  # @!attribute [rw] subnet_ids
2541
2656
  # The list of subnet IDs where the compute node group provisions
2542
2657
  # instances. The subnets must be in the same VPC as the cluster.
2543
2658
  # @return [Array<String>]
2544
2659
  #
2660
+ # @!attribute [rw] launch_template_mode
2661
+ # Specifies whether the compute node group uses a custom launch
2662
+ # template or a launch template that PCS manages. Omit this value to
2663
+ # keep the current mode.
2664
+ #
2665
+ # Valid values:
2666
+ #
2667
+ # * `CUSTOM` – Use a custom launch template. To switch from `MANAGED`,
2668
+ # also provide `customLaunchTemplate`. If the compute node group
2669
+ # already uses `CUSTOM` and you omit `customLaunchTemplate`, the
2670
+ # existing launch template is unchanged.
2671
+ #
2672
+ # * `MANAGED` – Use a launch template created and managed by PCS. Omit
2673
+ # `customLaunchTemplate`. Switching to this mode removes the custom
2674
+ # launch template association but doesn't delete the launch
2675
+ # template.
2676
+ #
2677
+ # When switching to `MANAGED`, the compute node group must have
2678
+ # `amiId` and `securityGroupIds` configured. You can set these values
2679
+ # in the same request.
2680
+ # @return [String]
2681
+ #
2545
2682
  # @!attribute [rw] custom_launch_template
2546
- # An Amazon EC2 launch template PCS uses to launch compute nodes.
2683
+ # The custom Amazon EC2 launch template to associate with the compute
2684
+ # node group. To set or change the custom launch template, specify
2685
+ # `id` and `version`. If you provide this value and omit
2686
+ # `launchTemplateMode`, the compute node group must already use
2687
+ # `CUSTOM` mode. To switch from `MANAGED` to `CUSTOM`, specify
2688
+ # `launchTemplateMode` as `CUSTOM` and provide this value. If the
2689
+ # compute node group already uses `CUSTOM`, omit this value while also
2690
+ # omitting `launchTemplateMode`, or while specifying `CUSTOM`, to keep
2691
+ # the existing custom launch template. For more information, see
2692
+ # [Migrating a compute node group from a custom launch template][1] in
2693
+ # the *PCS User Guide*.
2694
+ #
2695
+ #
2696
+ #
2697
+ # [1]: https://docs.aws.amazon.com/pcs/latest/userguide/working-with_cng_instance-settings-migrate.html
2547
2698
  # @return [Types::CustomLaunchTemplate]
2548
2699
  #
2549
2700
  # @!attribute [rw] purchase_option
@@ -2610,7 +2761,7 @@ module Aws::PCS
2610
2761
  # request completes successfully, the subsequent retries with the same
2611
2762
  # client token return the result from the original successful request
2612
2763
  # and they have no additional effect. If you don't specify a client
2613
- # token, the CLI and SDK automatically generate 1 for you.
2764
+ # token, the CLI and SDK automatically generate one for you.
2614
2765
  #
2615
2766
  # **A suitable default value is auto-generated.** You should normally
2616
2767
  # not need to pass this option.
@@ -2619,10 +2770,13 @@ module Aws::PCS
2619
2770
  # @see http://docs.aws.amazon.com/goto/WebAPI/pcs-2023-02-10/UpdateComputeNodeGroupRequest AWS API Documentation
2620
2771
  #
2621
2772
  class UpdateComputeNodeGroupRequest < Struct.new(
2773
+ :ami_id,
2774
+ :security_group_ids,
2775
+ :ssh_key_name,
2622
2776
  :cluster_identifier,
2623
2777
  :compute_node_group_identifier,
2624
- :ami_id,
2625
2778
  :subnet_ids,
2779
+ :launch_template_mode,
2626
2780
  :custom_launch_template,
2627
2781
  :purchase_option,
2628
2782
  :spot_options,
@@ -2731,7 +2885,7 @@ module Aws::PCS
2731
2885
  # request completes successfully, the subsequent retries with the same
2732
2886
  # client token return the result from the original successful request
2733
2887
  # and they have no additional effect. If you don't specify a client
2734
- # token, the CLI and SDK automatically generate 1 for you.
2888
+ # token, the CLI and SDK automatically generate one for you.
2735
2889
  #
2736
2890
  # **A suitable default value is auto-generated.** You should normally
2737
2891
  # not need to pass this option.
data/lib/aws-sdk-pcs.rb CHANGED
@@ -55,7 +55,7 @@ module Aws::PCS
55
55
  autoload :EndpointProvider, 'aws-sdk-pcs/endpoint_provider'
56
56
  autoload :Endpoints, 'aws-sdk-pcs/endpoints'
57
57
 
58
- GEM_VERSION = '1.63.0'
58
+ GEM_VERSION = '1.64.0'
59
59
 
60
60
  end
61
61
 
data/sig/client.rbs CHANGED
@@ -136,12 +136,15 @@ module Aws
136
136
  end
137
137
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PCS/Client.html#create_compute_node_group-instance_method
138
138
  def create_compute_node_group: (
139
+ ?ami_id: ::String,
140
+ ?security_group_ids: Array[::String],
141
+ ?ssh_key_name: ::String,
139
142
  cluster_identifier: ::String,
140
143
  compute_node_group_name: ::String,
141
- ?ami_id: ::String,
142
144
  subnet_ids: Array[::String],
143
145
  ?purchase_option: ("ONDEMAND" | "SPOT" | "CAPACITY_BLOCK" | "INTERRUPTIBLE_CAPACITY_RESERVATION"),
144
- custom_launch_template: {
146
+ ?launch_template_mode: ("CUSTOM" | "MANAGED"),
147
+ ?custom_launch_template: {
145
148
  id: ::String,
146
149
  version: ::String
147
150
  },
@@ -403,10 +406,13 @@ module Aws
403
406
  end
404
407
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/PCS/Client.html#update_compute_node_group-instance_method
405
408
  def update_compute_node_group: (
409
+ ?ami_id: ::String,
410
+ ?security_group_ids: Array[::String],
411
+ ?ssh_key_name: ::String,
406
412
  cluster_identifier: ::String,
407
413
  compute_node_group_identifier: ::String,
408
- ?ami_id: ::String,
409
414
  ?subnet_ids: Array[::String],
415
+ ?launch_template_mode: ("CUSTOM" | "MANAGED"),
410
416
  ?custom_launch_template: {
411
417
  id: ::String,
412
418
  version: ::String
data/sig/types.rbs CHANGED
@@ -80,6 +80,9 @@ module Aws::PCS
80
80
  end
81
81
 
82
82
  class ComputeNodeGroup
83
+ attr_accessor ami_id: ::String
84
+ attr_accessor security_group_ids: ::Array[::String]
85
+ attr_accessor ssh_key_name: ::String
83
86
  attr_accessor name: ::String
84
87
  attr_accessor id: ::String
85
88
  attr_accessor arn: ::String
@@ -87,9 +90,9 @@ module Aws::PCS
87
90
  attr_accessor created_at: ::Time
88
91
  attr_accessor modified_at: ::Time
89
92
  attr_accessor status: ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "CREATE_FAILED" | "DELETE_FAILED" | "UPDATE_FAILED" | "DELETED" | "SUSPENDING" | "SUSPENDED" | "RESUMING")
90
- attr_accessor ami_id: ::String
91
93
  attr_accessor subnet_ids: ::Array[::String]
92
94
  attr_accessor purchase_option: ("ONDEMAND" | "SPOT" | "CAPACITY_BLOCK" | "INTERRUPTIBLE_CAPACITY_RESERVATION")
95
+ attr_accessor launch_template_mode: ("CUSTOM" | "MANAGED")
93
96
  attr_accessor custom_launch_template: Types::CustomLaunchTemplate
94
97
  attr_accessor iam_instance_profile_arn: ::String
95
98
  attr_accessor scaling_configuration: Types::ScalingConfiguration
@@ -155,11 +158,14 @@ module Aws::PCS
155
158
  end
156
159
 
157
160
  class CreateComputeNodeGroupRequest
161
+ attr_accessor ami_id: ::String
162
+ attr_accessor security_group_ids: ::Array[::String]
163
+ attr_accessor ssh_key_name: ::String
158
164
  attr_accessor cluster_identifier: ::String
159
165
  attr_accessor compute_node_group_name: ::String
160
- attr_accessor ami_id: ::String
161
166
  attr_accessor subnet_ids: ::Array[::String]
162
167
  attr_accessor purchase_option: ("ONDEMAND" | "SPOT" | "CAPACITY_BLOCK" | "INTERRUPTIBLE_CAPACITY_RESERVATION")
168
+ attr_accessor launch_template_mode: ("CUSTOM" | "MANAGED")
163
169
  attr_accessor custom_launch_template: Types::CustomLaunchTemplate
164
170
  attr_accessor iam_instance_profile_arn: ::String
165
171
  attr_accessor scaling_configuration: Types::ScalingConfigurationRequest
@@ -571,10 +577,13 @@ module Aws::PCS
571
577
  end
572
578
 
573
579
  class UpdateComputeNodeGroupRequest
580
+ attr_accessor ami_id: ::String
581
+ attr_accessor security_group_ids: ::Array[::String]
582
+ attr_accessor ssh_key_name: ::String
574
583
  attr_accessor cluster_identifier: ::String
575
584
  attr_accessor compute_node_group_identifier: ::String
576
- attr_accessor ami_id: ::String
577
585
  attr_accessor subnet_ids: ::Array[::String]
586
+ attr_accessor launch_template_mode: ("CUSTOM" | "MANAGED")
578
587
  attr_accessor custom_launch_template: Types::CustomLaunchTemplate
579
588
  attr_accessor purchase_option: ("ONDEMAND" | "SPOT" | "CAPACITY_BLOCK" | "INTERRUPTIBLE_CAPACITY_RESERVATION")
580
589
  attr_accessor spot_options: Types::SpotOptions
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-pcs
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.63.0
4
+ version: 1.64.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
@@ -18,7 +18,7 @@ dependencies:
18
18
  version: '3'
19
19
  - - ">="
20
20
  - !ruby/object:Gem::Version
21
- version: 3.266.0
21
+ version: 3.267.0
22
22
  type: :runtime
23
23
  prerelease: false
24
24
  version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
28
28
  version: '3'
29
29
  - - ">="
30
30
  - !ruby/object:Gem::Version
31
- version: 3.266.0
31
+ version: 3.267.0
32
32
  - !ruby/object:Gem::Dependency
33
33
  name: aws-sigv4
34
34
  requirement: !ruby/object:Gem::Requirement