Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

ReservedCapacitySummary - Amazon SageMaker

ReservedCapacitySummary

Details of a reserved capacity for the training plan.

For more information about how to reserve GPU capacity for your SageMaker HyperPod clusters using Amazon SageMaker Training Plan, see CreateTrainingPlan .

Contents

InstanceType

The instance type for the reserved capacity.

Type: String

Valid Values: ml.p4d.24xlarge | ml.p5.48xlarge | ml.p5e.48xlarge | ml.p5en.48xlarge | ml.trn1.32xlarge | ml.trn2.48xlarge

Required: Yes

ReservedCapacityArn

The Amazon Resource Name (ARN); of the reserved capacity.

Type: String

Length Constraints: Minimum length of 50. Maximum length of 2048.

Pattern: arn:aws[a-z\-]*:sagemaker:[a-z0-9\-]*:[0-9]{12}:reserved-capacity/.*

Required: Yes

Status

The current status of the reserved capacity.

Type: String

Valid Values: Pending | Active | Scheduled | Expired | Failed

Required: Yes

TotalInstanceCount

The total number of instances in the reserved capacity.

Type: Integer

Valid Range: Minimum value of 0.

Required: Yes

AvailabilityZone

The availability zone for the reserved capacity.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 32.

Pattern: [a-z]+\-[0-9a-z\-]+

Required: No

DurationHours

The number of whole hours in the total duration for this reserved capacity.

Type: Long

Valid Range: Minimum value of 0. Maximum value of 87600.

Required: No

DurationMinutes

The additional minutes beyond whole hours in the total duration for this reserved capacity.

Type: Long

Valid Range: Minimum value of 0. Maximum value of 59.

Required: No

EndTime

The end time of the reserved capacity.

Type: Timestamp

Required: No

StartTime

The start time of the reserved capacity.

Type: Timestamp

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.