PCS Compute Node Group

Docs > DDSQL Reference > Data Directory > PCS Compute Node Group

PCS Compute Node Group in AWS represents a collection of compute nodes managed within the PCS (ParallelCluster Service). It defines the configuration, scaling, and lifecycle of compute resources used for high-performance computing workloads. This resource allows users to manage groups of instances that run tightly coupled workloads, ensuring efficient scaling and optimized performance for HPC clusters.

aws.pcs_compute_node_group

Fields

ID	Type	Data Type	Description
_key	core	string
account_id	core	string
ami_id	core	string	The ID of the Amazon Machine Image (AMI) that PCS uses to launch instances. If not provided, PCS uses the AMI ID specified in the custom launch template.
arn	core	string	The unique Amazon Resource Name (ARN) of the compute node group.
cluster_id	core	string	The ID of the cluster of the compute node group.
created_at	core	timestamp	The date and time the resource was created.
custom_launch_template	core	json	An Amazon EC2 launch template PCS uses to launch compute nodes.
error_info	core	json	The list of errors that occurred during compute node group provisioning.
iam_instance_profile_arn	core	string	The Amazon Resource Name (ARN) of the IAM instance profile used to pass an IAM role when launching EC2 instances. The role contained in your instance profile must have the pcs:RegisterComputeNodeGroupInstance permission and the role name must start with AWSPCS or must have the path /aws-pcs/. For more information, see IAM instance profiles for PCS in the PCS User Guide.
id	core	string	The generated unique ID of the compute node group.
instance_configs	core	json	A list of EC2 instance configurations that PCS can provision in the compute node group.
modified_at	core	timestamp	The date and time the resource was modified.
name	core	string	The name that identifies the compute node group.
purchase_option	core	string	Specifies how EC2 instances are purchased on your behalf. PCS supports On-Demand Instances, Spot Instances, and Amazon EC2 Capacity Blocks for ML. For more information, see Amazon EC2 billing and purchasing options in the Amazon Elastic Compute Cloud User Guide. For more information about PCS support for Capacity Blocks, see Using Amazon EC2 Capacity Blocks for ML with PCS in the PCS User Guide. If you don't provide this option, it defaults to On-Demand.
scaling_configuration	core	json	Specifies the boundaries of the compute node group auto scaling.
slurm_configuration	core	json	Additional options related to the Slurm scheduler.
spot_options	core	json	Additional configuration when you specify SPOT as the purchaseOption for the CreateComputeNodeGroup API action.
status	core	string	The provisioning status of the compute node group. The provisioning status doesn't indicate the overall health of the compute node group. The resource enters the SUSPENDING and SUSPENDED states when the scheduler is beyond end of life and we have suspended the cluster. When in these states, you can't use the cluster. The cluster controller is down and all compute instances are terminated. The resources still count toward your service quotas. You can delete a resource if its status is SUSPENDED. For more information, see Frequently asked questions about Slurm versions in PCS in the PCS User Guide.
subnet_ids	core	array<string>	The list of subnet IDs where instances are provisioned by the compute node group. The subnets must be in the same VPC as the cluster.
tags	core	hstore_csv