aws_sdk_sagemaker/client/
describe_training_plan.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`DescribeTrainingPlan`](crate::operation::describe_training_plan::builders::DescribeTrainingPlanFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`training_plan_name(impl Into<String>)`](crate::operation::describe_training_plan::builders::DescribeTrainingPlanFluentBuilder::training_plan_name) / [`set_training_plan_name(Option<String>)`](crate::operation::describe_training_plan::builders::DescribeTrainingPlanFluentBuilder::set_training_plan_name):<br>required: **true**<br><p>The name of the training plan to describe.</p><br>
    /// - On success, responds with [`DescribeTrainingPlanOutput`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput) with field(s):
    ///   - [`training_plan_arn(Option<String>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::training_plan_arn): <p>The Amazon Resource Name (ARN); of the training plan.</p>
    ///   - [`training_plan_name(Option<String>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::training_plan_name): <p>The name of the training plan.</p>
    ///   - [`status(Option<TrainingPlanStatus>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::status): <p>The current status of the training plan (e.g., Pending, Active, Expired). To see the complete list of status values available for a training plan, refer to the <code>Status</code> attribute within the <code> <a href="https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html">TrainingPlanSummary</a> </code> object.</p>
    ///   - [`status_message(Option<String>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::status_message): <p>A message providing additional information about the current status of the training plan.</p>
    ///   - [`duration_hours(Option<i64>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::duration_hours): <p>The number of whole hours in the total duration for this training plan.</p>
    ///   - [`duration_minutes(Option<i64>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::duration_minutes): <p>The additional minutes beyond whole hours in the total duration for this training plan.</p>
    ///   - [`start_time(Option<DateTime>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::start_time): <p>The start time of the training plan.</p>
    ///   - [`end_time(Option<DateTime>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::end_time): <p>The end time of the training plan.</p>
    ///   - [`upfront_fee(Option<String>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::upfront_fee): <p>The upfront fee for the training plan.</p>
    ///   - [`currency_code(Option<String>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::currency_code): <p>The currency code for the upfront fee (e.g., USD).</p>
    ///   - [`total_instance_count(Option<i32>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::total_instance_count): <p>The total number of instances reserved in this training plan.</p>
    ///   - [`available_instance_count(Option<i32>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::available_instance_count): <p>The number of instances currently available for use in this training plan.</p>
    ///   - [`in_use_instance_count(Option<i32>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::in_use_instance_count): <p>The number of instances currently in use from this training plan.</p>
    ///   - [`target_resources(Option<Vec::<SageMakerResourceName>>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::target_resources): <p>The target resources (e.g., SageMaker Training Jobs, SageMaker HyperPod) that can use this training plan.</p> <p>Training plans are specific to their target resource.</p> <ul>  <li>   <p>A training plan designed for SageMaker training jobs can only be used to schedule and run training jobs.</p></li>  <li>   <p>A training plan for HyperPod clusters can be used exclusively to provide compute resources to a cluster's instance group.</p></li> </ul>
    ///   - [`reserved_capacity_summaries(Option<Vec::<ReservedCapacitySummary>>)`](crate::operation::describe_training_plan::DescribeTrainingPlanOutput::reserved_capacity_summaries): <p>The list of Reserved Capacity providing the underlying compute resources of the plan.</p>
    /// - On failure, responds with [`SdkError<DescribeTrainingPlanError>`](crate::operation::describe_training_plan::DescribeTrainingPlanError)
    pub fn describe_training_plan(&self) -> crate::operation::describe_training_plan::builders::DescribeTrainingPlanFluentBuilder {
        crate::operation::describe_training_plan::builders::DescribeTrainingPlanFluentBuilder::new(self.handle.clone())
    }
}