Struct aws_sdk_gamelift::types::GameServer
source · #[non_exhaustive]pub struct GameServer {
pub game_server_group_name: Option<String>,
pub game_server_group_arn: Option<String>,
pub game_server_id: Option<String>,
pub instance_id: Option<String>,
pub connection_info: Option<String>,
pub game_server_data: Option<String>,
pub claim_status: Option<GameServerClaimStatus>,
pub utilization_status: Option<GameServerUtilizationStatus>,
pub registration_time: Option<DateTime>,
pub last_claim_time: Option<DateTime>,
pub last_health_check_time: Option<DateTime>,
}
Expand description
This data type is used with the Amazon GameLift FleetIQ and game server groups.
Properties describing a game server that is running on an instance in a game server group.
A game server is created by a successful call to RegisterGameServer
and deleted by calling DeregisterGameServer
. A game server is claimed to host a game session by calling ClaimGameServer
.
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.game_server_group_name: Option<String>
A unique identifier for the game server group where the game server is running.
game_server_group_arn: Option<String>
The ARN identifier for the game server group where the game server is located.
game_server_id: Option<String>
A custom string that uniquely identifies the game server. Game server IDs are developer-defined and are unique across all game server groups in an Amazon Web Services account.
instance_id: Option<String>
The unique identifier for the instance where the game server is running. This ID is available in the instance metadata. EC2 instance IDs use a 17-character format, for example: i-1234567890abcdef0
.
connection_info: Option<String>
The port and IP address that must be used to establish a client connection to the game server.
game_server_data: 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.
claim_status: Option<GameServerClaimStatus>
Indicates when an available game server has been reserved for gameplay but has not yet started hosting a game. Once it is claimed, the game server remains in CLAIMED
status for a maximum of one minute. During this time, game clients connect to the game server to start the game and trigger the game server to update its utilization status. After one minute, the game server claim status reverts to null.
utilization_status: Option<GameServerUtilizationStatus>
Indicates whether the game server is currently available for new games or is busy. Possible statuses include:
-
AVAILABLE
- The game server is available to be claimed. A game server that has been claimed remains in this status until it reports game hosting activity. -
UTILIZED
- The game server is currently hosting a game session with players.
registration_time: Option<DateTime>
Timestamp that indicates when the game server registered. The format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
last_claim_time: Option<DateTime>
Timestamp that indicates the last time the game server was claimed. The format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
). This value is used to calculate when a claimed game server's status should revert to null.
last_health_check_time: Option<DateTime>
Timestamp that indicates the last time the game server was updated with health status. The format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
). After game server registration, this property is only changed when a game server update specifies a health check value.
Implementations§
source§impl GameServer
impl GameServer
sourcepub fn game_server_group_name(&self) -> Option<&str>
pub fn game_server_group_name(&self) -> Option<&str>
A unique identifier for the game server group where the game server is running.
sourcepub fn game_server_group_arn(&self) -> Option<&str>
pub fn game_server_group_arn(&self) -> Option<&str>
The ARN identifier for the game server group where the game server is located.
sourcepub fn game_server_id(&self) -> Option<&str>
pub fn game_server_id(&self) -> Option<&str>
A custom string that uniquely identifies the game server. Game server IDs are developer-defined and are unique across all game server groups in an Amazon Web Services account.
sourcepub fn instance_id(&self) -> Option<&str>
pub fn instance_id(&self) -> Option<&str>
The unique identifier for the instance where the game server is running. This ID is available in the instance metadata. EC2 instance IDs use a 17-character format, for example: i-1234567890abcdef0
.
sourcepub fn connection_info(&self) -> Option<&str>
pub fn connection_info(&self) -> Option<&str>
The port and IP address that must be used to establish a client connection to the game server.
sourcepub fn game_server_data(&self) -> Option<&str>
pub fn game_server_data(&self) -> Option<&str>
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 claim_status(&self) -> Option<&GameServerClaimStatus>
pub fn claim_status(&self) -> Option<&GameServerClaimStatus>
Indicates when an available game server has been reserved for gameplay but has not yet started hosting a game. Once it is claimed, the game server remains in CLAIMED
status for a maximum of one minute. During this time, game clients connect to the game server to start the game and trigger the game server to update its utilization status. After one minute, the game server claim status reverts to null.
sourcepub fn utilization_status(&self) -> Option<&GameServerUtilizationStatus>
pub fn utilization_status(&self) -> Option<&GameServerUtilizationStatus>
Indicates whether the game server is currently available for new games or is busy. Possible statuses include:
-
AVAILABLE
- The game server is available to be claimed. A game server that has been claimed remains in this status until it reports game hosting activity. -
UTILIZED
- The game server is currently hosting a game session with players.
sourcepub fn registration_time(&self) -> Option<&DateTime>
pub fn registration_time(&self) -> Option<&DateTime>
Timestamp that indicates when the game server registered. The format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
).
sourcepub fn last_claim_time(&self) -> Option<&DateTime>
pub fn last_claim_time(&self) -> Option<&DateTime>
Timestamp that indicates the last time the game server was claimed. The format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
). This value is used to calculate when a claimed game server's status should revert to null.
sourcepub fn last_health_check_time(&self) -> Option<&DateTime>
pub fn last_health_check_time(&self) -> Option<&DateTime>
Timestamp that indicates the last time the game server was updated with health status. The format is a number expressed in Unix time as milliseconds (for example "1469498468.057"
). After game server registration, this property is only changed when a game server update specifies a health check value.
source§impl GameServer
impl GameServer
sourcepub fn builder() -> GameServerBuilder
pub fn builder() -> GameServerBuilder
Creates a new builder-style object to manufacture GameServer
.
Trait Implementations§
source§impl Clone for GameServer
impl Clone for GameServer
source§fn clone(&self) -> GameServer
fn clone(&self) -> GameServer
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for GameServer
impl Debug for GameServer
source§impl PartialEq for GameServer
impl PartialEq for GameServer
source§fn eq(&self, other: &GameServer) -> bool
fn eq(&self, other: &GameServer) -> bool
self
and other
values to be equal, and is used
by ==
.impl StructuralPartialEq for GameServer
Auto Trait Implementations§
impl Freeze for GameServer
impl RefUnwindSafe for GameServer
impl Send for GameServer
impl Sync for GameServer
impl Unpin for GameServer
impl UnwindSafe for GameServer
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