AWS sagemaker documentation change

Service: sagemaker · 2026-04-19 · Documentation low

File: sagemaker/latest/dg/sagemaker-hyperpod-eks-operate-cli-command-create-cluster.md

Summary

Added documentation for flexible instance groups feature allowing specification of multiple instance types using InstanceRequirements parameter with provisioning priority and continuous node provisioning mode requirement.

Security assessment

This change documents a new feature for instance type flexibility and provisioning behavior. There is no mention of security vulnerabilities, patches, or security configurations. The change is purely about operational flexibility and capacity management.

Diff

diff --git a/sagemaker/latest/dg/sagemaker-hyperpod-eks-operate-cli-command-create-cluster.md b/sagemaker/latest/dg/sagemaker-hyperpod-eks-operate-cli-command-create-cluster.md
index 0485e3c51..c2484b296 100644
--- a//sagemaker/latest/dg/sagemaker-hyperpod-eks-operate-cli-command-create-cluster.md
+++ b//sagemaker/latest/dg/sagemaker-hyperpod-eks-operate-cli-command-create-cluster.md
@@ -130,0 +131,25 @@ Ensure that your SageMaker HyperPod cluster is deployed within the same Virtual
+###### Flexible instance groups
+
+Instead of specifying a single `InstanceType`, you can use the `InstanceRequirements` parameter to specify multiple instance types for an instance group. Note the following:
+
+     * `InstanceType` and `InstanceRequirements` are mutually exclusive. You must specify one or the other, but not both.
+
+     * `InstanceRequirements.InstanceTypes` is an ordered list that determines provisioning priority. SageMaker HyperPod attempts to provision the first instance type in the list and falls back to subsequent types if capacity is unavailable. You can specify up to 20 instance types, and the list must not contain duplicates.
+
+     * Flexible instance groups require continuous node provisioning mode.
+
+The following example shows an instance group using `InstanceRequirements`:
+    
+        {
+        "InstanceGroupName": "flexible-ig",
+        "InstanceRequirements": {
+            "InstanceTypes": ["ml.p5.48xlarge", "ml.p4d.24xlarge", "ml.g6.48xlarge"]
+        },
+        "InstanceCount": 10,
+        "LifeCycleConfig": {
+            "SourceS3Uri": "s3://amzn-s3-demo-bucket-sagemaker/lifecycle-script-directory/src/",
+            "OnCreate": "on_create.sh"
+        },
+        "ExecutionRole": "arn:aws:iam::111122223333:role/iam-role-for-cluster"
+    }
+