aws_sdk_imagebuilder/client/
import_disk_image.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 [`ImportDiskImage`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`name(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::name) / [`set_name(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_name):<br>required: **true**<br><p>The name of the image resource that's created from the import.</p><br>
7    ///   - [`semantic_version(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::semantic_version) / [`set_semantic_version(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_semantic_version):<br>required: **true**<br><p>The semantic version to attach to the image that's created during the import process. This version follows the semantic version syntax.</p><br>
8    ///   - [`description(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_description):<br>required: **false**<br><p>The description for your disk image import.</p><br>
9    ///   - [`platform(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::platform) / [`set_platform(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_platform):<br>required: **true**<br><p>The operating system platform for the imported image. Allowed values include the following: <code>Windows</code>.</p><br>
10    ///   - [`os_version(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::os_version) / [`set_os_version(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_os_version):<br>required: **true**<br><p>The operating system version for the imported image. Allowed values include the following: <code>Microsoft Windows 11</code>.</p><br>
11    ///   - [`execution_role(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::execution_role) / [`set_execution_role(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_execution_role):<br>required: **false**<br><p>The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions to import an image from a Microsoft ISO file.</p><br>
12    ///   - [`infrastructure_configuration_arn(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::infrastructure_configuration_arn) / [`set_infrastructure_configuration_arn(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_infrastructure_configuration_arn):<br>required: **true**<br><p>The Amazon Resource Name (ARN) of the infrastructure configuration resource that's used for launching the EC2 instance on which the ISO image is built.</p><br>
13    ///   - [`uri(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::uri) / [`set_uri(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_uri):<br>required: **true**<br><p>The <code>uri</code> of the ISO disk file that's stored in Amazon S3.</p><br>
14    ///   - [`tags(impl Into<String>, impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::tags) / [`set_tags(Option<HashMap::<String, String>>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_tags):<br>required: **false**<br><p>Tags that are attached to image resources created from the import.</p><br>
15    ///   - [`client_token(impl Into<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::client_token) / [`set_client_token(Option<String>)`](crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::set_client_token):<br>required: **true**<br><p>Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a> in the <i>Amazon EC2 API Reference</i>.</p><br>
16    /// - On success, responds with [`ImportDiskImageOutput`](crate::operation::import_disk_image::ImportDiskImageOutput) with field(s):
17    ///   - [`client_token(Option<String>)`](crate::operation::import_disk_image::ImportDiskImageOutput::client_token): <p>The client token that uniquely identifies the request.</p>
18    ///   - [`image_build_version_arn(Option<String>)`](crate::operation::import_disk_image::ImportDiskImageOutput::image_build_version_arn): <p>The Amazon Resource Name (ARN) of the output AMI that was created from the ISO disk file.</p>
19    /// - On failure, responds with [`SdkError<ImportDiskImageError>`](crate::operation::import_disk_image::ImportDiskImageError)
20    pub fn import_disk_image(&self) -> crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder {
21        crate::operation::import_disk_image::builders::ImportDiskImageFluentBuilder::new(self.handle.clone())
22    }
23}