aws_sdk_sagemaker/client/
update_cluster_software.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`UpdateClusterSoftware`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`cluster_name(impl Into<String>)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::cluster_name) / [`set_cluster_name(Option<String>)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::set_cluster_name):<br>required: **true**<br><p>Specify the name or the Amazon Resource Name (ARN) of the SageMaker HyperPod cluster you want to update for security patching.</p><br>
7    ///   - [`instance_groups(UpdateClusterSoftwareInstanceGroupSpecification)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::instance_groups) / [`set_instance_groups(Option<Vec::<UpdateClusterSoftwareInstanceGroupSpecification>>)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::set_instance_groups):<br>required: **false**<br><p>The array of instance groups for which to update AMI versions.</p><br>
8    ///   - [`deployment_config(DeploymentConfiguration)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::deployment_config) / [`set_deployment_config(Option<DeploymentConfiguration>)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::set_deployment_config):<br>required: **false**<br><p>The configuration to use when updating the AMI versions.</p><br>
9    ///   - [`image_id(impl Into<String>)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::image_id) / [`set_image_id(Option<String>)`](crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::set_image_id):<br>required: **false**<br><p>When configuring your HyperPod cluster, you can specify an image ID using one of the following options:</p> <ul>  <li>   <p><code>HyperPodPublicAmiId</code>: Use a HyperPod public AMI</p></li>  <li>   <p><code>CustomAmiId</code>: Use your custom AMI</p></li>  <li>   <p><code>default</code>: Use the default latest system image</p></li> </ul> <p>If you choose to use a custom AMI (<code>CustomAmiId</code>), ensure it meets the following requirements:</p> <ul>  <li>   <p>Encryption: The custom AMI must be unencrypted.</p></li>  <li>   <p>Ownership: The custom AMI must be owned by the same Amazon Web Services account that is creating the HyperPod cluster.</p></li>  <li>   <p>Volume support: Only the primary AMI snapshot volume is supported; additional AMI volumes are not supported.</p></li> </ul> <p>When updating the instance group's AMI through the <code>UpdateClusterSoftware</code> operation, if an instance group uses a custom AMI, you must provide an <code>ImageId</code> or use the default as input. Note that if you don't specify an instance group in your <code>UpdateClusterSoftware</code> request, then all of the instance groups are patched with the specified image.</p><br>
10    /// - On success, responds with [`UpdateClusterSoftwareOutput`](crate::operation::update_cluster_software::UpdateClusterSoftwareOutput) with field(s):
11    ///   - [`cluster_arn(Option<String>)`](crate::operation::update_cluster_software::UpdateClusterSoftwareOutput::cluster_arn): <p>The Amazon Resource Name (ARN) of the SageMaker HyperPod cluster being updated for security patching.</p>
12    /// - On failure, responds with [`SdkError<UpdateClusterSoftwareError>`](crate::operation::update_cluster_software::UpdateClusterSoftwareError)
13    pub fn update_cluster_software(&self) -> crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder {
14        crate::operation::update_cluster_software::builders::UpdateClusterSoftwareFluentBuilder::new(self.handle.clone())
15    }
16}