#[non_exhaustive]pub struct ContainerGroupDefinitionBuilder { /* private fields */ }
Expand description
A builder for ContainerGroupDefinition
.
Implementations§
Source§impl ContainerGroupDefinitionBuilder
impl ContainerGroupDefinitionBuilder
Sourcepub fn container_group_definition_arn(self, input: impl Into<String>) -> Self
pub fn container_group_definition_arn(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) that is assigned to an Amazon GameLift Servers ContainerGroupDefinition
resource. It uniquely identifies the resource across all Amazon Web Services Regions. Format is arn:aws:gamelift:\[region\]::containergroupdefinition/\[container group definition name\]:\[version\]
.
Sourcepub fn set_container_group_definition_arn(self, input: Option<String>) -> Self
pub fn set_container_group_definition_arn(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) that is assigned to an Amazon GameLift Servers ContainerGroupDefinition
resource. It uniquely identifies the resource across all Amazon Web Services Regions. Format is arn:aws:gamelift:\[region\]::containergroupdefinition/\[container group definition name\]:\[version\]
.
Sourcepub fn get_container_group_definition_arn(&self) -> &Option<String>
pub fn get_container_group_definition_arn(&self) -> &Option<String>
The Amazon Resource Name (ARN) that is assigned to an Amazon GameLift Servers ContainerGroupDefinition
resource. It uniquely identifies the resource across all Amazon Web Services Regions. Format is arn:aws:gamelift:\[region\]::containergroupdefinition/\[container group definition name\]:\[version\]
.
Sourcepub fn creation_time(self, input: DateTime) -> Self
pub fn creation_time(self, input: DateTime) -> Self
A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn set_creation_time(self, input: Option<DateTime>) -> Self
pub fn set_creation_time(self, input: Option<DateTime>) -> Self
A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn get_creation_time(&self) -> &Option<DateTime>
pub fn get_creation_time(&self) -> &Option<DateTime>
A time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
Sourcepub fn operating_system(self, input: ContainerOperatingSystem) -> Self
pub fn operating_system(self, input: ContainerOperatingSystem) -> Self
The platform that all containers in the container group definition run on.
Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the Amazon Linux 2 FAQs. For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See Migrate to server SDK version 5.
Sourcepub fn set_operating_system(
self,
input: Option<ContainerOperatingSystem>,
) -> Self
pub fn set_operating_system( self, input: Option<ContainerOperatingSystem>, ) -> Self
The platform that all containers in the container group definition run on.
Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the Amazon Linux 2 FAQs. For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See Migrate to server SDK version 5.
Sourcepub fn get_operating_system(&self) -> &Option<ContainerOperatingSystem>
pub fn get_operating_system(&self) -> &Option<ContainerOperatingSystem>
The platform that all containers in the container group definition run on.
Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more details in the Amazon Linux 2 FAQs. For game servers that are hosted on AL2 and use server SDK version 4.x for Amazon GameLift Servers, first update the game server build to server SDK 5.x, and then deploy to AL2023 instances. See Migrate to server SDK version 5.
Sourcepub fn name(self, input: impl Into<String>) -> Self
pub fn name(self, input: impl Into<String>) -> Self
A descriptive identifier for the container group definition. The name value is unique in an Amazon Web Services Region.
This field is required.Sourcepub fn set_name(self, input: Option<String>) -> Self
pub fn set_name(self, input: Option<String>) -> Self
A descriptive identifier for the container group definition. The name value is unique in an Amazon Web Services Region.
Sourcepub fn get_name(&self) -> &Option<String>
pub fn get_name(&self) -> &Option<String>
A descriptive identifier for the container group definition. The name value is unique in an Amazon Web Services Region.
Sourcepub fn container_group_type(self, input: ContainerGroupType) -> Self
pub fn container_group_type(self, input: ContainerGroupType) -> Self
The type of container group. Container group type determines how Amazon GameLift Servers deploys the container group on each fleet instance.
Sourcepub fn set_container_group_type(self, input: Option<ContainerGroupType>) -> Self
pub fn set_container_group_type(self, input: Option<ContainerGroupType>) -> Self
The type of container group. Container group type determines how Amazon GameLift Servers deploys the container group on each fleet instance.
Sourcepub fn get_container_group_type(&self) -> &Option<ContainerGroupType>
pub fn get_container_group_type(&self) -> &Option<ContainerGroupType>
The type of container group. Container group type determines how Amazon GameLift Servers deploys the container group on each fleet instance.
Sourcepub fn total_memory_limit_mebibytes(self, input: i32) -> Self
pub fn total_memory_limit_mebibytes(self, input: i32) -> Self
The amount of memory (in MiB) on a fleet instance to allocate for the container group. All containers in the group share these resources.
You can set a limit for each container definition in the group. If individual containers have limits, this total value must be greater than any individual container's memory limit.
Sourcepub fn set_total_memory_limit_mebibytes(self, input: Option<i32>) -> Self
pub fn set_total_memory_limit_mebibytes(self, input: Option<i32>) -> Self
The amount of memory (in MiB) on a fleet instance to allocate for the container group. All containers in the group share these resources.
You can set a limit for each container definition in the group. If individual containers have limits, this total value must be greater than any individual container's memory limit.
Sourcepub fn get_total_memory_limit_mebibytes(&self) -> &Option<i32>
pub fn get_total_memory_limit_mebibytes(&self) -> &Option<i32>
The amount of memory (in MiB) on a fleet instance to allocate for the container group. All containers in the group share these resources.
You can set a limit for each container definition in the group. If individual containers have limits, this total value must be greater than any individual container's memory limit.
Sourcepub fn total_vcpu_limit(self, input: f64) -> Self
pub fn total_vcpu_limit(self, input: f64) -> Self
The amount of vCPU units on a fleet instance to allocate for the container group (1 vCPU is equal to 1024 CPU units). All containers in the group share these resources. You can set a limit for each container definition in the group. If individual containers have limits, this total value must be equal to or greater than the sum of the limits for each container in the group.
Sourcepub fn set_total_vcpu_limit(self, input: Option<f64>) -> Self
pub fn set_total_vcpu_limit(self, input: Option<f64>) -> Self
The amount of vCPU units on a fleet instance to allocate for the container group (1 vCPU is equal to 1024 CPU units). All containers in the group share these resources. You can set a limit for each container definition in the group. If individual containers have limits, this total value must be equal to or greater than the sum of the limits for each container in the group.
Sourcepub fn get_total_vcpu_limit(&self) -> &Option<f64>
pub fn get_total_vcpu_limit(&self) -> &Option<f64>
The amount of vCPU units on a fleet instance to allocate for the container group (1 vCPU is equal to 1024 CPU units). All containers in the group share these resources. You can set a limit for each container definition in the group. If individual containers have limits, this total value must be equal to or greater than the sum of the limits for each container in the group.
Sourcepub fn game_server_container_definition(
self,
input: GameServerContainerDefinition,
) -> Self
pub fn game_server_container_definition( self, input: GameServerContainerDefinition, ) -> Self
The definition for the game server container in this group. This property is used only when the container group type is GAME_SERVER
. This container definition specifies a container image with the game server build.
Sourcepub fn set_game_server_container_definition(
self,
input: Option<GameServerContainerDefinition>,
) -> Self
pub fn set_game_server_container_definition( self, input: Option<GameServerContainerDefinition>, ) -> Self
The definition for the game server container in this group. This property is used only when the container group type is GAME_SERVER
. This container definition specifies a container image with the game server build.
Sourcepub fn get_game_server_container_definition(
&self,
) -> &Option<GameServerContainerDefinition>
pub fn get_game_server_container_definition( &self, ) -> &Option<GameServerContainerDefinition>
The definition for the game server container in this group. This property is used only when the container group type is GAME_SERVER
. This container definition specifies a container image with the game server build.
Sourcepub fn support_container_definitions(
self,
input: SupportContainerDefinition,
) -> Self
pub fn support_container_definitions( self, input: SupportContainerDefinition, ) -> Self
Appends an item to support_container_definitions
.
To override the contents of this collection use set_support_container_definitions
.
The set of definitions for support containers in this group. A container group definition might have zero support container definitions. Support container can be used in any type of container group.
Sourcepub fn set_support_container_definitions(
self,
input: Option<Vec<SupportContainerDefinition>>,
) -> Self
pub fn set_support_container_definitions( self, input: Option<Vec<SupportContainerDefinition>>, ) -> Self
The set of definitions for support containers in this group. A container group definition might have zero support container definitions. Support container can be used in any type of container group.
Sourcepub fn get_support_container_definitions(
&self,
) -> &Option<Vec<SupportContainerDefinition>>
pub fn get_support_container_definitions( &self, ) -> &Option<Vec<SupportContainerDefinition>>
The set of definitions for support containers in this group. A container group definition might have zero support container definitions. Support container can be used in any type of container group.
Sourcepub fn version_number(self, input: i32) -> Self
pub fn version_number(self, input: i32) -> Self
Indicates the version of a particular container group definition. This number is incremented automatically when you update a container group definition. You can view, update, or delete individual versions or the entire container group definition.
Sourcepub fn set_version_number(self, input: Option<i32>) -> Self
pub fn set_version_number(self, input: Option<i32>) -> Self
Indicates the version of a particular container group definition. This number is incremented automatically when you update a container group definition. You can view, update, or delete individual versions or the entire container group definition.
Sourcepub fn get_version_number(&self) -> &Option<i32>
pub fn get_version_number(&self) -> &Option<i32>
Indicates the version of a particular container group definition. This number is incremented automatically when you update a container group definition. You can view, update, or delete individual versions or the entire container group definition.
Sourcepub fn version_description(self, input: impl Into<String>) -> Self
pub fn version_description(self, input: impl Into<String>) -> Self
An optional description that was provided for a container group definition update. Each version can have a unique description.
Sourcepub fn set_version_description(self, input: Option<String>) -> Self
pub fn set_version_description(self, input: Option<String>) -> Self
An optional description that was provided for a container group definition update. Each version can have a unique description.
Sourcepub fn get_version_description(&self) -> &Option<String>
pub fn get_version_description(&self) -> &Option<String>
An optional description that was provided for a container group definition update. Each version can have a unique description.
Sourcepub fn status(self, input: ContainerGroupDefinitionStatus) -> Self
pub fn status(self, input: ContainerGroupDefinitionStatus) -> Self
Current status of the container group definition resource. Values include:
-
COPYING
-- Amazon GameLift Servers is in the process of making copies of all container images that are defined in the group. While in this state, the resource can't be used to create a container fleet. -
READY
-- Amazon GameLift Servers has copied the registry images for all containers that are defined in the group. You can use a container group definition in this status to create a container fleet. -
FAILED
-- Amazon GameLift Servers failed to create a valid container group definition resource. For more details on the cause of the failure, seeStatusReason
. A container group definition resource in failed status will be deleted within a few minutes.
Sourcepub fn set_status(self, input: Option<ContainerGroupDefinitionStatus>) -> Self
pub fn set_status(self, input: Option<ContainerGroupDefinitionStatus>) -> Self
Current status of the container group definition resource. Values include:
-
COPYING
-- Amazon GameLift Servers is in the process of making copies of all container images that are defined in the group. While in this state, the resource can't be used to create a container fleet. -
READY
-- Amazon GameLift Servers has copied the registry images for all containers that are defined in the group. You can use a container group definition in this status to create a container fleet. -
FAILED
-- Amazon GameLift Servers failed to create a valid container group definition resource. For more details on the cause of the failure, seeStatusReason
. A container group definition resource in failed status will be deleted within a few minutes.
Sourcepub fn get_status(&self) -> &Option<ContainerGroupDefinitionStatus>
pub fn get_status(&self) -> &Option<ContainerGroupDefinitionStatus>
Current status of the container group definition resource. Values include:
-
COPYING
-- Amazon GameLift Servers is in the process of making copies of all container images that are defined in the group. While in this state, the resource can't be used to create a container fleet. -
READY
-- Amazon GameLift Servers has copied the registry images for all containers that are defined in the group. You can use a container group definition in this status to create a container fleet. -
FAILED
-- Amazon GameLift Servers failed to create a valid container group definition resource. For more details on the cause of the failure, seeStatusReason
. A container group definition resource in failed status will be deleted within a few minutes.
Sourcepub fn status_reason(self, input: impl Into<String>) -> Self
pub fn status_reason(self, input: impl Into<String>) -> Self
Additional information about a container group definition that's in FAILED
status. Possible reasons include:
-
An internal issue prevented Amazon GameLift Servers from creating the container group definition resource. Delete the failed resource and call CreateContainerGroupDefinitionagain.
-
An access-denied message means that you don't have permissions to access the container image on ECR. See IAM permission examples for help setting up required IAM permissions for Amazon GameLift Servers.
-
The
ImageUri
value for at least one of the containers in the container group definition was invalid or not found in the current Amazon Web Services account. -
At least one of the container images referenced in the container group definition exceeds the allowed size. For size limits, see Amazon GameLift Servers endpoints and quotas.
-
At least one of the container images referenced in the container group definition uses a different operating system than the one defined for the container group.
Sourcepub fn set_status_reason(self, input: Option<String>) -> Self
pub fn set_status_reason(self, input: Option<String>) -> Self
Additional information about a container group definition that's in FAILED
status. Possible reasons include:
-
An internal issue prevented Amazon GameLift Servers from creating the container group definition resource. Delete the failed resource and call CreateContainerGroupDefinitionagain.
-
An access-denied message means that you don't have permissions to access the container image on ECR. See IAM permission examples for help setting up required IAM permissions for Amazon GameLift Servers.
-
The
ImageUri
value for at least one of the containers in the container group definition was invalid or not found in the current Amazon Web Services account. -
At least one of the container images referenced in the container group definition exceeds the allowed size. For size limits, see Amazon GameLift Servers endpoints and quotas.
-
At least one of the container images referenced in the container group definition uses a different operating system than the one defined for the container group.
Sourcepub fn get_status_reason(&self) -> &Option<String>
pub fn get_status_reason(&self) -> &Option<String>
Additional information about a container group definition that's in FAILED
status. Possible reasons include:
-
An internal issue prevented Amazon GameLift Servers from creating the container group definition resource. Delete the failed resource and call CreateContainerGroupDefinitionagain.
-
An access-denied message means that you don't have permissions to access the container image on ECR. See IAM permission examples for help setting up required IAM permissions for Amazon GameLift Servers.
-
The
ImageUri
value for at least one of the containers in the container group definition was invalid or not found in the current Amazon Web Services account. -
At least one of the container images referenced in the container group definition exceeds the allowed size. For size limits, see Amazon GameLift Servers endpoints and quotas.
-
At least one of the container images referenced in the container group definition uses a different operating system than the one defined for the container group.
Sourcepub fn build(self) -> ContainerGroupDefinition
pub fn build(self) -> ContainerGroupDefinition
Consumes the builder and constructs a ContainerGroupDefinition
.
Trait Implementations§
Source§impl Clone for ContainerGroupDefinitionBuilder
impl Clone for ContainerGroupDefinitionBuilder
Source§fn clone(&self) -> ContainerGroupDefinitionBuilder
fn clone(&self) -> ContainerGroupDefinitionBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Default for ContainerGroupDefinitionBuilder
impl Default for ContainerGroupDefinitionBuilder
Source§fn default() -> ContainerGroupDefinitionBuilder
fn default() -> ContainerGroupDefinitionBuilder
Source§impl PartialEq for ContainerGroupDefinitionBuilder
impl PartialEq for ContainerGroupDefinitionBuilder
Source§fn eq(&self, other: &ContainerGroupDefinitionBuilder) -> bool
fn eq(&self, other: &ContainerGroupDefinitionBuilder) -> bool
self
and other
values to be equal, and is used by ==
.impl StructuralPartialEq for ContainerGroupDefinitionBuilder
Auto Trait Implementations§
impl Freeze for ContainerGroupDefinitionBuilder
impl RefUnwindSafe for ContainerGroupDefinitionBuilder
impl Send for ContainerGroupDefinitionBuilder
impl Sync for ContainerGroupDefinitionBuilder
impl Unpin for ContainerGroupDefinitionBuilder
impl UnwindSafe for ContainerGroupDefinitionBuilder
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);