AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::SageMaker::Cluster

CfnCluster

Creates an Amazon SageMaker HyperPod cluster. SageMaker HyperPod is a capability of SageMaker for creating and managing persistent clusters for developing large machine learning models, such as large language models (LLMs) and diffusion models. To learn more, see [Amazon SageMaker HyperPod](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-hyperpod.html) in the *Amazon SageMaker Developer Guide* .

Import

import { CfnCluster } from 'aws-cdk-lib/aws-sagemaker';

Or use the module namespace:

import * as sagemaker from 'aws-cdk-lib/aws-sagemaker';
// sagemaker.CfnCluster

Properties

Configuration passed to the constructor as CfnClusterProps.

autoScalingOptional
IResolvable | ClusterAutoScalingConfigProperty

Configuration for cluster auto-scaling.

clusterNameOptional
string

The name of the SageMaker HyperPod cluster.

clusterRoleOptional
string

The cluster role for the autoscaler to assume.

instanceGroupsOptional
IResolvable | IResolvable | ClusterInstanceGroupProperty[]

The instance groups of the SageMaker HyperPod cluster. To delete an instance group, remove it from the array.

nodeProvisioningModeOptional
string

Determines the scaling strategy for the SageMaker HyperPod cluster. When set to 'Continuous', enables continuous scaling which dynamically manages node provisioning. If the parameter is omitted, uses the standard scaling approach in previous release.

nodeRecoveryOptional
string

Specifies whether to enable or disable the automatic node recovery feature of SageMaker HyperPod. Available values are `Automatic` for enabling and `None` for disabling.

orchestratorOptional
IResolvable | OrchestratorProperty

The orchestrator type for the SageMaker HyperPod cluster. Currently, `'eks'` is the only available option.

restrictedInstanceGroupsOptional
IResolvable | IResolvable | ClusterRestrictedInstanceGroupProperty[]

The restricted instance groups of the SageMaker HyperPod cluster.

tagsOptional
CfnTag[]

A tag object that consists of a key and an optional value, used to manage metadata for SageMaker AWS resources. You can add tags to notebook instances, training jobs, hyperparameter tuning jobs, batch transform jobs, models, labeling jobs, work teams, endpoint configurations, and endpoints. For more information on adding tags to SageMaker resources, see [AddTags](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AddTags.html) . For more information on adding metadata to your AWS resources with tagging, see [Tagging AWS resources](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) . For advice on best practices for managing AWS resources with tagging, see [Tagging Best Practices: Implement an Effective AWS Resource Tagging Strategy](https://docs.aws.amazon.com/https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf) .

tieredStorageConfigOptional
IResolvable | TieredStorageConfigProperty

Configuration for tiered storage in the SageMaker HyperPod cluster.

vpcConfigOptional
IResolvable | VpcConfigProperty

Specifies an Amazon Virtual Private Cloud (VPC) that your SageMaker jobs, hosted models, and compute resources have access to. You can control access to and from your resources by configuring a VPC. For more information, see [Give SageMaker Access to Resources in your Amazon VPC](https://docs.aws.amazon.com/sagemaker/latest/dg/infrastructure-give-access.html) .

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter