pub struct ModifyInstancePlacementFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to ModifyInstancePlacement
.
Modifies the placement attributes for a specified instance. You can do the following:
-
Modify the affinity between an instance and a Dedicated Host. When affinity is set to
host
and the instance is not associated with a specific Dedicated Host, the next time the instance is started, it is automatically associated with the host on which it lands. If the instance is restarted or rebooted, this relationship persists. -
Change the Dedicated Host with which an instance is associated.
-
Change the instance tenancy of an instance.
-
Move an instance to or from a placement group.
At least one attribute for affinity, host ID, tenancy, or placement group name must be specified in the request. Affinity and tenancy can be modified in the same request.
To modify the host ID, tenancy, placement group, or partition for an instance, the instance must be in the stopped
state.
Implementations§
Source§impl ModifyInstancePlacementFluentBuilder
impl ModifyInstancePlacementFluentBuilder
Sourcepub fn as_input(&self) -> &ModifyInstancePlacementInputBuilder
pub fn as_input(&self) -> &ModifyInstancePlacementInputBuilder
Access the ModifyInstancePlacement as a reference.
Sourcepub async fn send(
self,
) -> Result<ModifyInstancePlacementOutput, SdkError<ModifyInstancePlacementError, HttpResponse>>
pub async fn send( self, ) -> Result<ModifyInstancePlacementOutput, SdkError<ModifyInstancePlacementError, HttpResponse>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
Sourcepub fn customize(
self,
) -> CustomizableOperation<ModifyInstancePlacementOutput, ModifyInstancePlacementError, Self>
pub fn customize( self, ) -> CustomizableOperation<ModifyInstancePlacementOutput, ModifyInstancePlacementError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
Sourcepub fn group_name(self, input: impl Into<String>) -> Self
pub fn group_name(self, input: impl Into<String>) -> Self
The name of the placement group in which to place the instance. For spread placement groups, the instance must have a tenancy of default
. For cluster and partition placement groups, the instance must have a tenancy of default
or dedicated
.
To remove an instance from a placement group, specify an empty string ("").
Sourcepub fn set_group_name(self, input: Option<String>) -> Self
pub fn set_group_name(self, input: Option<String>) -> Self
The name of the placement group in which to place the instance. For spread placement groups, the instance must have a tenancy of default
. For cluster and partition placement groups, the instance must have a tenancy of default
or dedicated
.
To remove an instance from a placement group, specify an empty string ("").
Sourcepub fn get_group_name(&self) -> &Option<String>
pub fn get_group_name(&self) -> &Option<String>
The name of the placement group in which to place the instance. For spread placement groups, the instance must have a tenancy of default
. For cluster and partition placement groups, the instance must have a tenancy of default
or dedicated
.
To remove an instance from a placement group, specify an empty string ("").
Sourcepub fn partition_number(self, input: i32) -> Self
pub fn partition_number(self, input: i32) -> Self
The number of the partition in which to place the instance. Valid only if the placement group strategy is set to partition
.
Sourcepub fn set_partition_number(self, input: Option<i32>) -> Self
pub fn set_partition_number(self, input: Option<i32>) -> Self
The number of the partition in which to place the instance. Valid only if the placement group strategy is set to partition
.
Sourcepub fn get_partition_number(&self) -> &Option<i32>
pub fn get_partition_number(&self) -> &Option<i32>
The number of the partition in which to place the instance. Valid only if the placement group strategy is set to partition
.
Sourcepub fn host_resource_group_arn(self, input: impl Into<String>) -> Self
pub fn host_resource_group_arn(self, input: impl Into<String>) -> Self
The ARN of the host resource group in which to place the instance. The instance must have a tenancy of host
to specify this parameter.
Sourcepub fn set_host_resource_group_arn(self, input: Option<String>) -> Self
pub fn set_host_resource_group_arn(self, input: Option<String>) -> Self
The ARN of the host resource group in which to place the instance. The instance must have a tenancy of host
to specify this parameter.
Sourcepub fn get_host_resource_group_arn(&self) -> &Option<String>
pub fn get_host_resource_group_arn(&self) -> &Option<String>
The ARN of the host resource group in which to place the instance. The instance must have a tenancy of host
to specify this parameter.
Sourcepub fn group_id(self, input: impl Into<String>) -> Self
pub fn group_id(self, input: impl Into<String>) -> Self
The Group Id of a placement group. You must specify the Placement Group Group Id to launch an instance in a shared placement group.
Sourcepub fn set_group_id(self, input: Option<String>) -> Self
pub fn set_group_id(self, input: Option<String>) -> Self
The Group Id of a placement group. You must specify the Placement Group Group Id to launch an instance in a shared placement group.
Sourcepub fn get_group_id(&self) -> &Option<String>
pub fn get_group_id(&self) -> &Option<String>
The Group Id of a placement group. You must specify the Placement Group Group Id to launch an instance in a shared placement group.
Sourcepub fn instance_id(self, input: impl Into<String>) -> Self
pub fn instance_id(self, input: impl Into<String>) -> Self
The ID of the instance that you are modifying.
Sourcepub fn set_instance_id(self, input: Option<String>) -> Self
pub fn set_instance_id(self, input: Option<String>) -> Self
The ID of the instance that you are modifying.
Sourcepub fn get_instance_id(&self) -> &Option<String>
pub fn get_instance_id(&self) -> &Option<String>
The ID of the instance that you are modifying.
Sourcepub fn tenancy(self, input: HostTenancy) -> Self
pub fn tenancy(self, input: HostTenancy) -> Self
The tenancy for the instance.
For T3 instances, you must launch the instance on a Dedicated Host to use a tenancy of host
. You can't change the tenancy from host
to dedicated
or default
. Attempting to make one of these unsupported tenancy changes results in an InvalidRequest
error code.
Sourcepub fn set_tenancy(self, input: Option<HostTenancy>) -> Self
pub fn set_tenancy(self, input: Option<HostTenancy>) -> Self
The tenancy for the instance.
For T3 instances, you must launch the instance on a Dedicated Host to use a tenancy of host
. You can't change the tenancy from host
to dedicated
or default
. Attempting to make one of these unsupported tenancy changes results in an InvalidRequest
error code.
Sourcepub fn get_tenancy(&self) -> &Option<HostTenancy>
pub fn get_tenancy(&self) -> &Option<HostTenancy>
The tenancy for the instance.
For T3 instances, you must launch the instance on a Dedicated Host to use a tenancy of host
. You can't change the tenancy from host
to dedicated
or default
. Attempting to make one of these unsupported tenancy changes results in an InvalidRequest
error code.
Sourcepub fn affinity(self, input: Affinity) -> Self
pub fn affinity(self, input: Affinity) -> Self
The affinity setting for the instance. For more information, see Host affinity in the Amazon EC2 User Guide.
Sourcepub fn set_affinity(self, input: Option<Affinity>) -> Self
pub fn set_affinity(self, input: Option<Affinity>) -> Self
The affinity setting for the instance. For more information, see Host affinity in the Amazon EC2 User Guide.
Sourcepub fn get_affinity(&self) -> &Option<Affinity>
pub fn get_affinity(&self) -> &Option<Affinity>
The affinity setting for the instance. For more information, see Host affinity in the Amazon EC2 User Guide.
Sourcepub fn host_id(self, input: impl Into<String>) -> Self
pub fn host_id(self, input: impl Into<String>) -> Self
The ID of the Dedicated Host with which to associate the instance.
Sourcepub fn set_host_id(self, input: Option<String>) -> Self
pub fn set_host_id(self, input: Option<String>) -> Self
The ID of the Dedicated Host with which to associate the instance.
Sourcepub fn get_host_id(&self) -> &Option<String>
pub fn get_host_id(&self) -> &Option<String>
The ID of the Dedicated Host with which to associate the instance.
Trait Implementations§
Source§impl Clone for ModifyInstancePlacementFluentBuilder
impl Clone for ModifyInstancePlacementFluentBuilder
Source§fn clone(&self) -> ModifyInstancePlacementFluentBuilder
fn clone(&self) -> ModifyInstancePlacementFluentBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for ModifyInstancePlacementFluentBuilder
impl !RefUnwindSafe for ModifyInstancePlacementFluentBuilder
impl Send for ModifyInstancePlacementFluentBuilder
impl Sync for ModifyInstancePlacementFluentBuilder
impl Unpin for ModifyInstancePlacementFluentBuilder
impl !UnwindSafe for ModifyInstancePlacementFluentBuilder
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);