SageMaker / Client / update_cluster



Updates a SageMaker HyperPod cluster.

See also: AWS API Documentation

Request Syntax

response = client.update_cluster(
            'InstanceCount': 123,
            'InstanceGroupName': 'string',
            'InstanceType': 'ml.p4d.24xlarge'|'ml.p4de.24xlarge'|'ml.p5.48xlarge'|'ml.trn1.32xlarge'|'ml.trn1n.32xlarge'|'ml.g5.xlarge'|'ml.g5.2xlarge'|'ml.g5.4xlarge'|'ml.g5.8xlarge'|'ml.g5.12xlarge'|'ml.g5.16xlarge'|'ml.g5.24xlarge'|'ml.g5.48xlarge'|'ml.c5.large'|'ml.c5.xlarge'|'ml.c5.2xlarge'|'ml.c5.4xlarge'|'ml.c5.9xlarge'|'ml.c5.12xlarge'|'ml.c5.18xlarge'|'ml.c5.24xlarge'|'ml.c5n.large'|'ml.c5n.2xlarge'|'ml.c5n.4xlarge'|'ml.c5n.9xlarge'|'ml.c5n.18xlarge'|'ml.m5.large'|'ml.m5.xlarge'|'ml.m5.2xlarge'|'ml.m5.4xlarge'|'ml.m5.8xlarge'|'ml.m5.12xlarge'|'ml.m5.16xlarge'|'ml.m5.24xlarge'|'ml.t3.medium'|'ml.t3.large'|'ml.t3.xlarge'|'ml.t3.2xlarge',
            'LifeCycleConfig': {
                'SourceS3Uri': 'string',
                'OnCreate': 'string'
            'ExecutionRole': 'string',
            'ThreadsPerCore': 123
  • ClusterName (string) –


    Specify the name of the SageMaker HyperPod cluster you want to update.

  • InstanceGroups (list) –


    Specify the instance groups to update.

    • (dict) –

      The specifications of an instance group that you need to define.

      • InstanceCount (integer) – [REQUIRED]

        Specifies the number of instances to add to the instance group of a SageMaker HyperPod cluster.

      • InstanceGroupName (string) – [REQUIRED]

        Specifies the name of the instance group.

      • InstanceType (string) – [REQUIRED]

        Specifies the instance type of the instance group.

      • LifeCycleConfig (dict) – [REQUIRED]

        Specifies the LifeCycle configuration for the instance group.

        • SourceS3Uri (string) – [REQUIRED]

          An Amazon S3 bucket path where your LifeCycle scripts are stored.

        • OnCreate (string) – [REQUIRED]

          The directory of the LifeCycle script under SourceS3Uri. This LifeCycle script runs during cluster creation.

      • ExecutionRole (string) – [REQUIRED]

        Specifies an IAM execution role to be assumed by the instance group.

      • ThreadsPerCore (integer) –

        Specifies the value for Threads per core. For instance types that support multithreading, you can specify 1 for disabling multithreading and 2 for enabling multithreading. For instance types that doesn’t support multithreading, specify 1. For more information, see the reference table of CPU cores and threads per CPU core per instance type in the Amazon Elastic Compute Cloud User Guide.

Return type:



Response Syntax

    'ClusterArn': 'string'

Response Structure

  • (dict) –

    • ClusterArn (string) –

      The Amazon Resource Name (ARN) of the updated SageMaker HyperPod cluster.


  • SageMaker.Client.exceptions.ResourceLimitExceeded

  • SageMaker.Client.exceptions.ResourceNotFound

  • SageMaker.Client.exceptions.ConflictException