#[non_exhaustive]pub struct ImportImageInputBuilder { /* private fields */ }
Expand description
A builder for ImportImageInput
.
Implementations§
Source§impl ImportImageInputBuilder
impl ImportImageInputBuilder
Sourcepub fn architecture(self, input: impl Into<String>) -> Self
pub fn architecture(self, input: impl Into<String>) -> Self
The architecture of the virtual machine.
Valid values: i386
| x86_64
Sourcepub fn set_architecture(self, input: Option<String>) -> Self
pub fn set_architecture(self, input: Option<String>) -> Self
The architecture of the virtual machine.
Valid values: i386
| x86_64
Sourcepub fn get_architecture(&self) -> &Option<String>
pub fn get_architecture(&self) -> &Option<String>
The architecture of the virtual machine.
Valid values: i386
| x86_64
Sourcepub fn client_data(self, input: ClientData) -> Self
pub fn client_data(self, input: ClientData) -> Self
The client-specific data.
Sourcepub fn set_client_data(self, input: Option<ClientData>) -> Self
pub fn set_client_data(self, input: Option<ClientData>) -> Self
The client-specific data.
Sourcepub fn get_client_data(&self) -> &Option<ClientData>
pub fn get_client_data(&self) -> &Option<ClientData>
The client-specific data.
Sourcepub fn client_token(self, input: impl Into<String>) -> Self
pub fn client_token(self, input: impl Into<String>) -> Self
The token to enable idempotency for VM import requests.
Sourcepub fn set_client_token(self, input: Option<String>) -> Self
pub fn set_client_token(self, input: Option<String>) -> Self
The token to enable idempotency for VM import requests.
Sourcepub fn get_client_token(&self) -> &Option<String>
pub fn get_client_token(&self) -> &Option<String>
The token to enable idempotency for VM import requests.
Sourcepub fn description(self, input: impl Into<String>) -> Self
pub fn description(self, input: impl Into<String>) -> Self
A description string for the import image task.
Sourcepub fn set_description(self, input: Option<String>) -> Self
pub fn set_description(self, input: Option<String>) -> Self
A description string for the import image task.
Sourcepub fn get_description(&self) -> &Option<String>
pub fn get_description(&self) -> &Option<String>
A description string for the import image task.
Sourcepub fn disk_containers(self, input: ImageDiskContainer) -> Self
pub fn disk_containers(self, input: ImageDiskContainer) -> Self
Appends an item to disk_containers
.
To override the contents of this collection use set_disk_containers
.
Information about the disk containers.
Sourcepub fn set_disk_containers(self, input: Option<Vec<ImageDiskContainer>>) -> Self
pub fn set_disk_containers(self, input: Option<Vec<ImageDiskContainer>>) -> Self
Information about the disk containers.
Sourcepub fn get_disk_containers(&self) -> &Option<Vec<ImageDiskContainer>>
pub fn get_disk_containers(&self) -> &Option<Vec<ImageDiskContainer>>
Information about the disk containers.
Sourcepub fn dry_run(self, input: bool) -> Self
pub fn dry_run(self, input: bool) -> Self
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation
. Otherwise, it is UnauthorizedOperation
.
Sourcepub fn set_dry_run(self, input: Option<bool>) -> Self
pub fn set_dry_run(self, input: Option<bool>) -> Self
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation
. Otherwise, it is UnauthorizedOperation
.
Sourcepub fn get_dry_run(&self) -> &Option<bool>
pub fn get_dry_run(&self) -> &Option<bool>
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation
. Otherwise, it is UnauthorizedOperation
.
Sourcepub fn encrypted(self, input: bool) -> Self
pub fn encrypted(self, input: bool) -> Self
Specifies whether the destination AMI of the imported image should be encrypted. The default KMS key for EBS is used unless you specify a non-default KMS key using KmsKeyId
. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.
Sourcepub fn set_encrypted(self, input: Option<bool>) -> Self
pub fn set_encrypted(self, input: Option<bool>) -> Self
Specifies whether the destination AMI of the imported image should be encrypted. The default KMS key for EBS is used unless you specify a non-default KMS key using KmsKeyId
. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.
Sourcepub fn get_encrypted(&self) -> &Option<bool>
pub fn get_encrypted(&self) -> &Option<bool>
Specifies whether the destination AMI of the imported image should be encrypted. The default KMS key for EBS is used unless you specify a non-default KMS key using KmsKeyId
. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.
Sourcepub fn hypervisor(self, input: impl Into<String>) -> Self
pub fn hypervisor(self, input: impl Into<String>) -> Self
The target hypervisor platform.
Valid values: xen
Sourcepub fn set_hypervisor(self, input: Option<String>) -> Self
pub fn set_hypervisor(self, input: Option<String>) -> Self
The target hypervisor platform.
Valid values: xen
Sourcepub fn get_hypervisor(&self) -> &Option<String>
pub fn get_hypervisor(&self) -> &Option<String>
The target hypervisor platform.
Valid values: xen
Sourcepub fn kms_key_id(self, input: impl Into<String>) -> Self
pub fn kms_key_id(self, input: impl Into<String>) -> Self
An identifier for the symmetric KMS key to use when creating the encrypted AMI. This parameter is only required if you want to use a non-default KMS key; if this parameter is not specified, the default KMS key for EBS is used. If a KmsKeyId
is specified, the Encrypted
flag must also be set.
The KMS key identifier may be provided in any of the following formats:
-
Key ID
-
Key alias
-
ARN using key ID. The ID ARN contains the
arn:aws:kms
namespace, followed by the Region of the key, the Amazon Web Services account ID of the key owner, thekey
namespace, and then the key ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. -
ARN using key alias. The alias ARN contains the
arn:aws:kms
namespace, followed by the Region of the key, the Amazon Web Services account ID of the key owner, thealias
namespace, and then the key alias. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.
Amazon Web Services parses KmsKeyId
asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. This action will eventually report failure.
The specified KMS key must exist in the Region that the AMI is being copied to.
Amazon EBS does not support asymmetric KMS keys.
Sourcepub fn set_kms_key_id(self, input: Option<String>) -> Self
pub fn set_kms_key_id(self, input: Option<String>) -> Self
An identifier for the symmetric KMS key to use when creating the encrypted AMI. This parameter is only required if you want to use a non-default KMS key; if this parameter is not specified, the default KMS key for EBS is used. If a KmsKeyId
is specified, the Encrypted
flag must also be set.
The KMS key identifier may be provided in any of the following formats:
-
Key ID
-
Key alias
-
ARN using key ID. The ID ARN contains the
arn:aws:kms
namespace, followed by the Region of the key, the Amazon Web Services account ID of the key owner, thekey
namespace, and then the key ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. -
ARN using key alias. The alias ARN contains the
arn:aws:kms
namespace, followed by the Region of the key, the Amazon Web Services account ID of the key owner, thealias
namespace, and then the key alias. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.
Amazon Web Services parses KmsKeyId
asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. This action will eventually report failure.
The specified KMS key must exist in the Region that the AMI is being copied to.
Amazon EBS does not support asymmetric KMS keys.
Sourcepub fn get_kms_key_id(&self) -> &Option<String>
pub fn get_kms_key_id(&self) -> &Option<String>
An identifier for the symmetric KMS key to use when creating the encrypted AMI. This parameter is only required if you want to use a non-default KMS key; if this parameter is not specified, the default KMS key for EBS is used. If a KmsKeyId
is specified, the Encrypted
flag must also be set.
The KMS key identifier may be provided in any of the following formats:
-
Key ID
-
Key alias
-
ARN using key ID. The ID ARN contains the
arn:aws:kms
namespace, followed by the Region of the key, the Amazon Web Services account ID of the key owner, thekey
namespace, and then the key ID. For example, arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef. -
ARN using key alias. The alias ARN contains the
arn:aws:kms
namespace, followed by the Region of the key, the Amazon Web Services account ID of the key owner, thealias
namespace, and then the key alias. For example, arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias.
Amazon Web Services parses KmsKeyId
asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. This action will eventually report failure.
The specified KMS key must exist in the Region that the AMI is being copied to.
Amazon EBS does not support asymmetric KMS keys.
Sourcepub fn license_type(self, input: impl Into<String>) -> Self
pub fn license_type(self, input: impl Into<String>) -> Self
The license type to be used for the Amazon Machine Image (AMI) after importing.
Specify AWS
to replace the source-system license with an Amazon Web Services license or BYOL
to retain the source-system license. Leaving this parameter undefined is the same as choosing AWS
when importing a Windows Server operating system, and the same as choosing BYOL
when importing a Windows client operating system (such as Windows 10) or a Linux operating system.
To use BYOL
, you must have existing licenses with rights to use these licenses in a third party cloud, such as Amazon Web Services. For more information, see Prerequisites in the VM Import/Export User Guide.
Sourcepub fn set_license_type(self, input: Option<String>) -> Self
pub fn set_license_type(self, input: Option<String>) -> Self
The license type to be used for the Amazon Machine Image (AMI) after importing.
Specify AWS
to replace the source-system license with an Amazon Web Services license or BYOL
to retain the source-system license. Leaving this parameter undefined is the same as choosing AWS
when importing a Windows Server operating system, and the same as choosing BYOL
when importing a Windows client operating system (such as Windows 10) or a Linux operating system.
To use BYOL
, you must have existing licenses with rights to use these licenses in a third party cloud, such as Amazon Web Services. For more information, see Prerequisites in the VM Import/Export User Guide.
Sourcepub fn get_license_type(&self) -> &Option<String>
pub fn get_license_type(&self) -> &Option<String>
The license type to be used for the Amazon Machine Image (AMI) after importing.
Specify AWS
to replace the source-system license with an Amazon Web Services license or BYOL
to retain the source-system license. Leaving this parameter undefined is the same as choosing AWS
when importing a Windows Server operating system, and the same as choosing BYOL
when importing a Windows client operating system (such as Windows 10) or a Linux operating system.
To use BYOL
, you must have existing licenses with rights to use these licenses in a third party cloud, such as Amazon Web Services. For more information, see Prerequisites in the VM Import/Export User Guide.
Sourcepub fn platform(self, input: impl Into<String>) -> Self
pub fn platform(self, input: impl Into<String>) -> Self
The operating system of the virtual machine. If you import a VM that is compatible with Unified Extensible Firmware Interface (UEFI) using an EBS snapshot, you must specify a value for the platform.
Valid values: Windows
| Linux
Sourcepub fn set_platform(self, input: Option<String>) -> Self
pub fn set_platform(self, input: Option<String>) -> Self
The operating system of the virtual machine. If you import a VM that is compatible with Unified Extensible Firmware Interface (UEFI) using an EBS snapshot, you must specify a value for the platform.
Valid values: Windows
| Linux
Sourcepub fn get_platform(&self) -> &Option<String>
pub fn get_platform(&self) -> &Option<String>
The operating system of the virtual machine. If you import a VM that is compatible with Unified Extensible Firmware Interface (UEFI) using an EBS snapshot, you must specify a value for the platform.
Valid values: Windows
| Linux
Sourcepub fn role_name(self, input: impl Into<String>) -> Self
pub fn role_name(self, input: impl Into<String>) -> Self
The name of the role to use when not using the default role, 'vmimport'.
Sourcepub fn set_role_name(self, input: Option<String>) -> Self
pub fn set_role_name(self, input: Option<String>) -> Self
The name of the role to use when not using the default role, 'vmimport'.
Sourcepub fn get_role_name(&self) -> &Option<String>
pub fn get_role_name(&self) -> &Option<String>
The name of the role to use when not using the default role, 'vmimport'.
Sourcepub fn license_specifications(
self,
input: ImportImageLicenseConfigurationRequest,
) -> Self
pub fn license_specifications( self, input: ImportImageLicenseConfigurationRequest, ) -> Self
Appends an item to license_specifications
.
To override the contents of this collection use set_license_specifications
.
The ARNs of the license configurations.
Sourcepub fn set_license_specifications(
self,
input: Option<Vec<ImportImageLicenseConfigurationRequest>>,
) -> Self
pub fn set_license_specifications( self, input: Option<Vec<ImportImageLicenseConfigurationRequest>>, ) -> Self
The ARNs of the license configurations.
Sourcepub fn get_license_specifications(
&self,
) -> &Option<Vec<ImportImageLicenseConfigurationRequest>>
pub fn get_license_specifications( &self, ) -> &Option<Vec<ImportImageLicenseConfigurationRequest>>
The ARNs of the license configurations.
Sourcepub fn tag_specifications(self, input: TagSpecification) -> Self
pub fn tag_specifications(self, input: TagSpecification) -> Self
Appends an item to tag_specifications
.
To override the contents of this collection use set_tag_specifications
.
The tags to apply to the import image task during creation.
Sourcepub fn set_tag_specifications(
self,
input: Option<Vec<TagSpecification>>,
) -> Self
pub fn set_tag_specifications( self, input: Option<Vec<TagSpecification>>, ) -> Self
The tags to apply to the import image task during creation.
Sourcepub fn get_tag_specifications(&self) -> &Option<Vec<TagSpecification>>
pub fn get_tag_specifications(&self) -> &Option<Vec<TagSpecification>>
The tags to apply to the import image task during creation.
Sourcepub fn usage_operation(self, input: impl Into<String>) -> Self
pub fn usage_operation(self, input: impl Into<String>) -> Self
The usage operation value. For more information, see Licensing options in the VM Import/Export User Guide.
Sourcepub fn set_usage_operation(self, input: Option<String>) -> Self
pub fn set_usage_operation(self, input: Option<String>) -> Self
The usage operation value. For more information, see Licensing options in the VM Import/Export User Guide.
Sourcepub fn get_usage_operation(&self) -> &Option<String>
pub fn get_usage_operation(&self) -> &Option<String>
The usage operation value. For more information, see Licensing options in the VM Import/Export User Guide.
Sourcepub fn boot_mode(self, input: BootModeValues) -> Self
pub fn boot_mode(self, input: BootModeValues) -> Self
The boot mode of the virtual machine.
The uefi-preferred
boot mode isn't supported for importing images. For more information, see Boot modes in the VM Import/Export User Guide.
Sourcepub fn set_boot_mode(self, input: Option<BootModeValues>) -> Self
pub fn set_boot_mode(self, input: Option<BootModeValues>) -> Self
The boot mode of the virtual machine.
The uefi-preferred
boot mode isn't supported for importing images. For more information, see Boot modes in the VM Import/Export User Guide.
Sourcepub fn get_boot_mode(&self) -> &Option<BootModeValues>
pub fn get_boot_mode(&self) -> &Option<BootModeValues>
The boot mode of the virtual machine.
The uefi-preferred
boot mode isn't supported for importing images. For more information, see Boot modes in the VM Import/Export User Guide.
Sourcepub fn build(self) -> Result<ImportImageInput, BuildError>
pub fn build(self) -> Result<ImportImageInput, BuildError>
Consumes the builder and constructs a ImportImageInput
.
Source§impl ImportImageInputBuilder
impl ImportImageInputBuilder
Sourcepub async fn send_with(
self,
client: &Client,
) -> Result<ImportImageOutput, SdkError<ImportImageError, HttpResponse>>
pub async fn send_with( self, client: &Client, ) -> Result<ImportImageOutput, SdkError<ImportImageError, HttpResponse>>
Sends a request with this input using the given client.
Trait Implementations§
Source§impl Clone for ImportImageInputBuilder
impl Clone for ImportImageInputBuilder
Source§fn clone(&self) -> ImportImageInputBuilder
fn clone(&self) -> ImportImageInputBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for ImportImageInputBuilder
impl Debug for ImportImageInputBuilder
Source§impl Default for ImportImageInputBuilder
impl Default for ImportImageInputBuilder
Source§fn default() -> ImportImageInputBuilder
fn default() -> ImportImageInputBuilder
Source§impl PartialEq for ImportImageInputBuilder
impl PartialEq for ImportImageInputBuilder
impl StructuralPartialEq for ImportImageInputBuilder
Auto Trait Implementations§
impl Freeze for ImportImageInputBuilder
impl RefUnwindSafe for ImportImageInputBuilder
impl Send for ImportImageInputBuilder
impl Sync for ImportImageInputBuilder
impl Unpin for ImportImageInputBuilder
impl UnwindSafe for ImportImageInputBuilder
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);