#[non_exhaustive]pub struct CapacityReservation {Show 27 fields
pub capacity_reservation_id: Option<String>,
pub owner_id: Option<String>,
pub capacity_reservation_arn: Option<String>,
pub availability_zone_id: Option<String>,
pub instance_type: Option<String>,
pub instance_platform: Option<CapacityReservationInstancePlatform>,
pub availability_zone: Option<String>,
pub tenancy: Option<CapacityReservationTenancy>,
pub total_instance_count: Option<i32>,
pub available_instance_count: Option<i32>,
pub ebs_optimized: Option<bool>,
pub ephemeral_storage: Option<bool>,
pub state: Option<CapacityReservationState>,
pub start_date: Option<DateTime>,
pub end_date: Option<DateTime>,
pub end_date_type: Option<EndDateType>,
pub instance_match_criteria: Option<InstanceMatchCriteria>,
pub create_date: Option<DateTime>,
pub tags: Option<Vec<Tag>>,
pub outpost_arn: Option<String>,
pub capacity_reservation_fleet_id: Option<String>,
pub placement_group_arn: Option<String>,
pub capacity_allocations: Option<Vec<CapacityAllocation>>,
pub reservation_type: Option<CapacityReservationType>,
pub unused_reservation_billing_owner_id: Option<String>,
pub commitment_info: Option<CapacityReservationCommitmentInfo>,
pub delivery_preference: Option<CapacityReservationDeliveryPreference>,
}
Expand description
Describes a Capacity Reservation.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.capacity_reservation_id: Option<String>
The ID of the Capacity Reservation.
owner_id: Option<String>
The ID of the Amazon Web Services account that owns the Capacity Reservation.
capacity_reservation_arn: Option<String>
The Amazon Resource Name (ARN) of the Capacity Reservation.
availability_zone_id: Option<String>
The Availability Zone ID of the Capacity Reservation.
instance_type: Option<String>
The type of instance for which the Capacity Reservation reserves capacity.
instance_platform: Option<CapacityReservationInstancePlatform>
The type of operating system for which the Capacity Reservation reserves capacity.
availability_zone: Option<String>
The Availability Zone in which the capacity is reserved.
tenancy: Option<CapacityReservationTenancy>
Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
-
default
- The Capacity Reservation is created on hardware that is shared with other Amazon Web Services accounts. -
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single Amazon Web Services account.
total_instance_count: Option<i32>
The total number of instances for which the Capacity Reservation reserves capacity.
available_instance_count: Option<i32>
The remaining capacity. Indicates the number of instances that can be launched in the Capacity Reservation.
ebs_optimized: Option<bool>
Indicates whether the Capacity Reservation supports EBS-optimized instances. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS- optimized instance.
ephemeral_storage: Option<bool>
Deprecated.
state: Option<CapacityReservationState>
The current state of the Capacity Reservation. A Capacity Reservation can be in one of the following states:
-
active
- The capacity is available for use. -
expired
- The Capacity Reservation expired automatically at the date and time specified in your reservation request. The reserved capacity is no longer available for your use. -
cancelled
- The Capacity Reservation was canceled. The reserved capacity is no longer available for your use. -
pending
- The Capacity Reservation request was successful but the capacity provisioning is still pending. -
failed
- The Capacity Reservation request has failed. A request can fail due to request parameters that are not valid, capacity constraints, or instance limit constraints. You can view a failed request for 60 minutes. -
scheduled
- (Future-dated Capacity Reservations) The future-dated Capacity Reservation request was approved and the Capacity Reservation is scheduled for delivery on the requested start date. -
payment-pending
- (Capacity Blocks) The upfront payment has not been processed yet. -
payment-failed
- (Capacity Blocks) The upfront payment was not processed in the 12-hour time frame. Your Capacity Block was released. -
assessing
- (Future-dated Capacity Reservations) Amazon EC2 is assessing your request for a future-dated Capacity Reservation. -
delayed
- (Future-dated Capacity Reservations) Amazon EC2 encountered a delay in provisioning the requested future-dated Capacity Reservation. Amazon EC2 is unable to deliver the requested capacity by the requested start date and time. -
unsupported
- (Future-dated Capacity Reservations) Amazon EC2 can't support the future-dated Capacity Reservation request due to capacity constraints. You can view unsupported requests for 30 days. The Capacity Reservation will not be delivered.
start_date: Option<DateTime>
The date and time at which the Capacity Reservation was started.
end_date: Option<DateTime>
The date and time at which the Capacity Reservation expires. When a Capacity Reservation expires, the reserved capacity is released and you can no longer launch instances into it. The Capacity Reservation's state changes to expired
when it reaches its end date and time.
end_date_type: Option<EndDateType>
Indicates the way in which the Capacity Reservation ends. A Capacity Reservation can have one of the following end types:
-
unlimited
- The Capacity Reservation remains active until you explicitly cancel it. -
limited
- The Capacity Reservation expires automatically at a specified date and time.
instance_match_criteria: Option<InstanceMatchCriteria>
Indicates the type of instance launches that the Capacity Reservation accepts. The options include:
-
open
- The Capacity Reservation accepts all instances that have matching attributes (instance type, platform, and Availability Zone). Instances that have matching attributes launch into the Capacity Reservation automatically without specifying any additional parameters. -
targeted
- The Capacity Reservation only accepts instances that have matching attributes (instance type, platform, and Availability Zone), and explicitly target the Capacity Reservation. This ensures that only permitted instances can use the reserved capacity.
create_date: Option<DateTime>
The date and time at which the Capacity Reservation was created.
Any tags assigned to the Capacity Reservation.
outpost_arn: Option<String>
The Amazon Resource Name (ARN) of the Outpost on which the Capacity Reservation was created.
capacity_reservation_fleet_id: Option<String>
The ID of the Capacity Reservation Fleet to which the Capacity Reservation belongs. Only valid for Capacity Reservations that were created by a Capacity Reservation Fleet.
placement_group_arn: Option<String>
The Amazon Resource Name (ARN) of the cluster placement group in which the Capacity Reservation was created. For more information, see Capacity Reservations for cluster placement groups in the Amazon EC2 User Guide.
capacity_allocations: Option<Vec<CapacityAllocation>>
Information about instance capacity usage.
reservation_type: Option<CapacityReservationType>
The type of Capacity Reservation.
unused_reservation_billing_owner_id: Option<String>
The ID of the Amazon Web Services account to which billing of the unused capacity of the Capacity Reservation is assigned.
commitment_info: Option<CapacityReservationCommitmentInfo>
Information about your commitment for a future-dated Capacity Reservation.
delivery_preference: Option<CapacityReservationDeliveryPreference>
The delivery method for a future-dated Capacity Reservation. incremental
indicates that the requested capacity is delivered in addition to any running instances and reserved capacity that you have in your account at the requested date and time.
Implementations§
Source§impl CapacityReservation
impl CapacityReservation
Sourcepub fn capacity_reservation_id(&self) -> Option<&str>
pub fn capacity_reservation_id(&self) -> Option<&str>
The ID of the Capacity Reservation.
Sourcepub fn owner_id(&self) -> Option<&str>
pub fn owner_id(&self) -> Option<&str>
The ID of the Amazon Web Services account that owns the Capacity Reservation.
Sourcepub fn capacity_reservation_arn(&self) -> Option<&str>
pub fn capacity_reservation_arn(&self) -> Option<&str>
The Amazon Resource Name (ARN) of the Capacity Reservation.
Sourcepub fn availability_zone_id(&self) -> Option<&str>
pub fn availability_zone_id(&self) -> Option<&str>
The Availability Zone ID of the Capacity Reservation.
Sourcepub fn instance_type(&self) -> Option<&str>
pub fn instance_type(&self) -> Option<&str>
The type of instance for which the Capacity Reservation reserves capacity.
Sourcepub fn instance_platform(&self) -> Option<&CapacityReservationInstancePlatform>
pub fn instance_platform(&self) -> Option<&CapacityReservationInstancePlatform>
The type of operating system for which the Capacity Reservation reserves capacity.
Sourcepub fn availability_zone(&self) -> Option<&str>
pub fn availability_zone(&self) -> Option<&str>
The Availability Zone in which the capacity is reserved.
Sourcepub fn tenancy(&self) -> Option<&CapacityReservationTenancy>
pub fn tenancy(&self) -> Option<&CapacityReservationTenancy>
Indicates the tenancy of the Capacity Reservation. A Capacity Reservation can have one of the following tenancy settings:
-
default
- The Capacity Reservation is created on hardware that is shared with other Amazon Web Services accounts. -
dedicated
- The Capacity Reservation is created on single-tenant hardware that is dedicated to a single Amazon Web Services account.
Sourcepub fn total_instance_count(&self) -> Option<i32>
pub fn total_instance_count(&self) -> Option<i32>
The total number of instances for which the Capacity Reservation reserves capacity.
Sourcepub fn available_instance_count(&self) -> Option<i32>
pub fn available_instance_count(&self) -> Option<i32>
The remaining capacity. Indicates the number of instances that can be launched in the Capacity Reservation.
Sourcepub fn ebs_optimized(&self) -> Option<bool>
pub fn ebs_optimized(&self) -> Option<bool>
Indicates whether the Capacity Reservation supports EBS-optimized instances. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS- optimized instance.
Sourcepub fn ephemeral_storage(&self) -> Option<bool>
pub fn ephemeral_storage(&self) -> Option<bool>
Deprecated.
Sourcepub fn state(&self) -> Option<&CapacityReservationState>
pub fn state(&self) -> Option<&CapacityReservationState>
The current state of the Capacity Reservation. A Capacity Reservation can be in one of the following states:
-
active
- The capacity is available for use. -
expired
- The Capacity Reservation expired automatically at the date and time specified in your reservation request. The reserved capacity is no longer available for your use. -
cancelled
- The Capacity Reservation was canceled. The reserved capacity is no longer available for your use. -
pending
- The Capacity Reservation request was successful but the capacity provisioning is still pending. -
failed
- The Capacity Reservation request has failed. A request can fail due to request parameters that are not valid, capacity constraints, or instance limit constraints. You can view a failed request for 60 minutes. -
scheduled
- (Future-dated Capacity Reservations) The future-dated Capacity Reservation request was approved and the Capacity Reservation is scheduled for delivery on the requested start date. -
payment-pending
- (Capacity Blocks) The upfront payment has not been processed yet. -
payment-failed
- (Capacity Blocks) The upfront payment was not processed in the 12-hour time frame. Your Capacity Block was released. -
assessing
- (Future-dated Capacity Reservations) Amazon EC2 is assessing your request for a future-dated Capacity Reservation. -
delayed
- (Future-dated Capacity Reservations) Amazon EC2 encountered a delay in provisioning the requested future-dated Capacity Reservation. Amazon EC2 is unable to deliver the requested capacity by the requested start date and time. -
unsupported
- (Future-dated Capacity Reservations) Amazon EC2 can't support the future-dated Capacity Reservation request due to capacity constraints. You can view unsupported requests for 30 days. The Capacity Reservation will not be delivered.
Sourcepub fn start_date(&self) -> Option<&DateTime>
pub fn start_date(&self) -> Option<&DateTime>
The date and time at which the Capacity Reservation was started.
Sourcepub fn end_date(&self) -> Option<&DateTime>
pub fn end_date(&self) -> Option<&DateTime>
The date and time at which the Capacity Reservation expires. When a Capacity Reservation expires, the reserved capacity is released and you can no longer launch instances into it. The Capacity Reservation's state changes to expired
when it reaches its end date and time.
Sourcepub fn end_date_type(&self) -> Option<&EndDateType>
pub fn end_date_type(&self) -> Option<&EndDateType>
Indicates the way in which the Capacity Reservation ends. A Capacity Reservation can have one of the following end types:
-
unlimited
- The Capacity Reservation remains active until you explicitly cancel it. -
limited
- The Capacity Reservation expires automatically at a specified date and time.
Sourcepub fn instance_match_criteria(&self) -> Option<&InstanceMatchCriteria>
pub fn instance_match_criteria(&self) -> Option<&InstanceMatchCriteria>
Indicates the type of instance launches that the Capacity Reservation accepts. The options include:
-
open
- The Capacity Reservation accepts all instances that have matching attributes (instance type, platform, and Availability Zone). Instances that have matching attributes launch into the Capacity Reservation automatically without specifying any additional parameters. -
targeted
- The Capacity Reservation only accepts instances that have matching attributes (instance type, platform, and Availability Zone), and explicitly target the Capacity Reservation. This ensures that only permitted instances can use the reserved capacity.
Sourcepub fn create_date(&self) -> Option<&DateTime>
pub fn create_date(&self) -> Option<&DateTime>
The date and time at which the Capacity Reservation was created.
Any tags assigned to the Capacity Reservation.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .tags.is_none()
.
Sourcepub fn outpost_arn(&self) -> Option<&str>
pub fn outpost_arn(&self) -> Option<&str>
The Amazon Resource Name (ARN) of the Outpost on which the Capacity Reservation was created.
Sourcepub fn capacity_reservation_fleet_id(&self) -> Option<&str>
pub fn capacity_reservation_fleet_id(&self) -> Option<&str>
The ID of the Capacity Reservation Fleet to which the Capacity Reservation belongs. Only valid for Capacity Reservations that were created by a Capacity Reservation Fleet.
Sourcepub fn placement_group_arn(&self) -> Option<&str>
pub fn placement_group_arn(&self) -> Option<&str>
The Amazon Resource Name (ARN) of the cluster placement group in which the Capacity Reservation was created. For more information, see Capacity Reservations for cluster placement groups in the Amazon EC2 User Guide.
Sourcepub fn capacity_allocations(&self) -> &[CapacityAllocation]
pub fn capacity_allocations(&self) -> &[CapacityAllocation]
Information about instance capacity usage.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .capacity_allocations.is_none()
.
Sourcepub fn reservation_type(&self) -> Option<&CapacityReservationType>
pub fn reservation_type(&self) -> Option<&CapacityReservationType>
The type of Capacity Reservation.
Sourcepub fn unused_reservation_billing_owner_id(&self) -> Option<&str>
pub fn unused_reservation_billing_owner_id(&self) -> Option<&str>
The ID of the Amazon Web Services account to which billing of the unused capacity of the Capacity Reservation is assigned.
Sourcepub fn commitment_info(&self) -> Option<&CapacityReservationCommitmentInfo>
pub fn commitment_info(&self) -> Option<&CapacityReservationCommitmentInfo>
Information about your commitment for a future-dated Capacity Reservation.
Sourcepub fn delivery_preference(
&self,
) -> Option<&CapacityReservationDeliveryPreference>
pub fn delivery_preference( &self, ) -> Option<&CapacityReservationDeliveryPreference>
The delivery method for a future-dated Capacity Reservation. incremental
indicates that the requested capacity is delivered in addition to any running instances and reserved capacity that you have in your account at the requested date and time.
Source§impl CapacityReservation
impl CapacityReservation
Sourcepub fn builder() -> CapacityReservationBuilder
pub fn builder() -> CapacityReservationBuilder
Creates a new builder-style object to manufacture CapacityReservation
.
Trait Implementations§
Source§impl Clone for CapacityReservation
impl Clone for CapacityReservation
Source§fn clone(&self) -> CapacityReservation
fn clone(&self) -> CapacityReservation
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for CapacityReservation
impl Debug for CapacityReservation
Source§impl PartialEq for CapacityReservation
impl PartialEq for CapacityReservation
impl StructuralPartialEq for CapacityReservation
Auto Trait Implementations§
impl Freeze for CapacityReservation
impl RefUnwindSafe for CapacityReservation
impl Send for CapacityReservation
impl Sync for CapacityReservation
impl Unpin for CapacityReservation
impl UnwindSafe for CapacityReservation
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);