Struct aws_sdk_gamelift::operation::update_game_server::builders::UpdateGameServerFluentBuilder
source · pub struct UpdateGameServerFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to UpdateGameServer
.
This operation is used with the Amazon GameLift FleetIQ solution and game server groups.
Updates information about a registered game server to help Amazon GameLift FleetIQ track game server availability. This operation is called by a game server process that is running on an instance in a game server group.
Use this operation to update the following types of game server information. You can make all three types of updates in the same request:
-
To update the game server's utilization status from
AVAILABLE
(when the game server is available to be claimed) toUTILIZED
(when the game server is currently hosting games). Identify the game server and game server group and specify the new utilization status. You can't change the status from toUTILIZED
toAVAILABLE
. -
To report health status, identify the game server and game server group and set health check to
HEALTHY
. If a game server does not report health status for a certain length of time, the game server is no longer considered healthy. As a result, it will be eventually deregistered from the game server group to avoid affecting utilization metrics. The best practice is to report health every 60 seconds. -
To change game server metadata, provide updated game server data.
Once a game server is successfully updated, the relevant statuses and timestamps are updated.
Learn more
Implementations§
source§impl UpdateGameServerFluentBuilder
impl UpdateGameServerFluentBuilder
sourcepub fn as_input(&self) -> &UpdateGameServerInputBuilder
pub fn as_input(&self) -> &UpdateGameServerInputBuilder
Access the UpdateGameServer as a reference.
sourcepub async fn send(
self
) -> Result<UpdateGameServerOutput, SdkError<UpdateGameServerError, HttpResponse>>
pub async fn send( self ) -> Result<UpdateGameServerOutput, SdkError<UpdateGameServerError, 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<UpdateGameServerOutput, UpdateGameServerError, Self>
pub fn customize( self ) -> CustomizableOperation<UpdateGameServerOutput, UpdateGameServerError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
sourcepub fn game_server_group_name(self, input: impl Into<String>) -> Self
pub fn game_server_group_name(self, input: impl Into<String>) -> Self
A unique identifier for the game server group where the game server is running.
sourcepub fn set_game_server_group_name(self, input: Option<String>) -> Self
pub fn set_game_server_group_name(self, input: Option<String>) -> Self
A unique identifier for the game server group where the game server is running.
sourcepub fn get_game_server_group_name(&self) -> &Option<String>
pub fn get_game_server_group_name(&self) -> &Option<String>
A unique identifier for the game server group where the game server is running.
sourcepub fn game_server_id(self, input: impl Into<String>) -> Self
pub fn game_server_id(self, input: impl Into<String>) -> Self
A custom string that uniquely identifies the game server to update.
sourcepub fn set_game_server_id(self, input: Option<String>) -> Self
pub fn set_game_server_id(self, input: Option<String>) -> Self
A custom string that uniquely identifies the game server to update.
sourcepub fn get_game_server_id(&self) -> &Option<String>
pub fn get_game_server_id(&self) -> &Option<String>
A custom string that uniquely identifies the game server to update.
sourcepub fn game_server_data(self, input: impl Into<String>) -> Self
pub fn game_server_data(self, input: impl Into<String>) -> Self
A set of custom game server properties, formatted as a single string value. This data is passed to a game client or service when it requests information on game servers.
sourcepub fn set_game_server_data(self, input: Option<String>) -> Self
pub fn set_game_server_data(self, input: Option<String>) -> Self
A set of custom game server properties, formatted as a single string value. This data is passed to a game client or service when it requests information on game servers.
sourcepub fn get_game_server_data(&self) -> &Option<String>
pub fn get_game_server_data(&self) -> &Option<String>
A set of custom game server properties, formatted as a single string value. This data is passed to a game client or service when it requests information on game servers.
sourcepub fn utilization_status(self, input: GameServerUtilizationStatus) -> Self
pub fn utilization_status(self, input: GameServerUtilizationStatus) -> Self
Indicates if the game server is available or is currently hosting gameplay. You can update a game server status from AVAILABLE
to UTILIZED
, but you can't change a the status from UTILIZED
to AVAILABLE
.
sourcepub fn set_utilization_status(
self,
input: Option<GameServerUtilizationStatus>
) -> Self
pub fn set_utilization_status( self, input: Option<GameServerUtilizationStatus> ) -> Self
Indicates if the game server is available or is currently hosting gameplay. You can update a game server status from AVAILABLE
to UTILIZED
, but you can't change a the status from UTILIZED
to AVAILABLE
.
sourcepub fn get_utilization_status(&self) -> &Option<GameServerUtilizationStatus>
pub fn get_utilization_status(&self) -> &Option<GameServerUtilizationStatus>
Indicates if the game server is available or is currently hosting gameplay. You can update a game server status from AVAILABLE
to UTILIZED
, but you can't change a the status from UTILIZED
to AVAILABLE
.
sourcepub fn health_check(self, input: GameServerHealthCheck) -> Self
pub fn health_check(self, input: GameServerHealthCheck) -> Self
Indicates health status of the game server. A request that includes this parameter updates the game server's LastHealthCheckTime timestamp.
sourcepub fn set_health_check(self, input: Option<GameServerHealthCheck>) -> Self
pub fn set_health_check(self, input: Option<GameServerHealthCheck>) -> Self
Indicates health status of the game server. A request that includes this parameter updates the game server's LastHealthCheckTime timestamp.
sourcepub fn get_health_check(&self) -> &Option<GameServerHealthCheck>
pub fn get_health_check(&self) -> &Option<GameServerHealthCheck>
Indicates health status of the game server. A request that includes this parameter updates the game server's LastHealthCheckTime timestamp.
Trait Implementations§
source§impl Clone for UpdateGameServerFluentBuilder
impl Clone for UpdateGameServerFluentBuilder
source§fn clone(&self) -> UpdateGameServerFluentBuilder
fn clone(&self) -> UpdateGameServerFluentBuilder
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 UpdateGameServerFluentBuilder
impl !RefUnwindSafe for UpdateGameServerFluentBuilder
impl Send for UpdateGameServerFluentBuilder
impl Sync for UpdateGameServerFluentBuilder
impl Unpin for UpdateGameServerFluentBuilder
impl !UnwindSafe for UpdateGameServerFluentBuilder
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> 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 more