Class: Aws::GameLift::Types::CreateMatchmakingConfigurationInput

Inherits:

Struct

Object
Struct
Aws::GameLift::Types::CreateMatchmakingConfigurationInput

show all

Includes:: Structure

Defined in:: lib/aws-sdk-gamelift/types.rb

Overview

Constant Summary collapse

SENSITIVE =

[]

Instance Attribute Summary collapse

#acceptance_required ⇒ Boolean

A flag that determines whether a match that was created with this configuration must be accepted by the matched players.
#acceptance_timeout_seconds ⇒ Integer

The length of time (in seconds) to wait for players to accept a proposed match, if acceptance is required.
#additional_player_count ⇒ Integer

The number of player slots in a match to keep open for future players.
#backfill_mode ⇒ String

The method used to backfill game sessions that are created with this matchmaking configuration.
#custom_event_data ⇒ String

Information to be added to all events related to this matchmaking configuration.
#description ⇒ String

A human-readable description of the matchmaking configuration.
#flex_match_mode ⇒ String

Indicates whether this matchmaking configuration is being used with Amazon GameLift hosting or as a standalone matchmaking solution.
#game_properties ⇒ Array<Types::GameProperty>

A set of key-value pairs that can store custom data in a game session.
#game_session_data ⇒ String

A set of custom game session properties, formatted as a single string value.
#game_session_queue_arns ⇒ Array<String>

The Amazon Resource Name ([ARN]) that is assigned to a Amazon GameLift game session queue resource and uniquely identifies it.
#name ⇒ String

A unique identifier for the matchmaking configuration.
#notification_target ⇒ String

An SNS topic ARN that is set up to receive matchmaking notifications.
#request_timeout_seconds ⇒ Integer

The maximum duration, in seconds, that a matchmaking ticket can remain in process before timing out.
#rule_set_name ⇒ String

A unique identifier for the matchmaking rule set to use with this configuration.
#tags ⇒ Array<Types::Tag>

A list of labels to assign to the new matchmaking configuration resource.

Instance Attribute Details

#acceptance_required ⇒ `Boolean`

A flag that determines whether a match that was created with this configuration must be accepted by the matched players. To require acceptance, set to ‘TRUE`. With this option enabled, matchmaking tickets use the status `REQUIRES_ACCEPTANCE` to indicate when a completed potential match is waiting for player acceptance.

Returns:

(Boolean)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#acceptance_timeout_seconds ⇒ `Integer`

The length of time (in seconds) to wait for players to accept a proposed match, if acceptance is required.

Returns:

(Integer)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#additional_player_count ⇒ `Integer`

The number of player slots in a match to keep open for future players. For example, if the configuration’s rule set specifies a match for a single 12-person team, and the additional player count is set to 2, only 10 players are selected for the match. This parameter is not used if ‘FlexMatchMode` is set to `STANDALONE`.

Returns:

(Integer)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#backfill_mode ⇒ `String`

The method used to backfill game sessions that are created with this matchmaking configuration. Specify ‘MANUAL` when your game manages backfill requests manually or does not use the match backfill feature. Specify `AUTOMATIC` to have Amazon GameLift create a backfill request whenever a game session has one or more open slots. Learn more about manual and automatic backfill in [ Backfill Existing Games with FlexMatch]. Automatic backfill is not available when `FlexMatchMode` is set to `STANDALONE`.

[1]: docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#custom_event_data ⇒ `String`

Information to be added to all events related to this matchmaking configuration.

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#description ⇒ `String`

A human-readable description of the matchmaking configuration.

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#flex_match_mode ⇒ `String`

Indicates whether this matchmaking configuration is being used with Amazon GameLift hosting or as a standalone matchmaking solution.

STANDALONE - FlexMatch forms matches and returns match information, including players and team assignments, in a [ MatchmakingSucceeded] event.
WITH_QUEUE - FlexMatch forms matches and uses the specified Amazon GameLift queue to start a game session for the match.

[1]: docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html#match-events-matchmakingsucceeded

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#game_properties ⇒ `Array<Types::GameProperty>`

A set of key-value pairs that can store custom data in a game session. For example: ‘“difficulty”, “Value”: “novice”`. This information is added to the new `GameSession` object that is created for a successful match. This parameter is not used if `FlexMatchMode` is set to `STANDALONE`.

Returns:

(Array<Types::GameProperty>)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#game_session_data ⇒ `String`

A set of custom game session properties, formatted as a single string value. This data is passed to a game server process with a request to start a new game session. For more information, see [Start a game session]. This information is added to the new ‘GameSession` object that is created for a successful match. This parameter is not used if `FlexMatchMode` is set to `STANDALONE`.

[1]: docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#game_session_queue_arns ⇒ `Array<String>`

The Amazon Resource Name ([ARN]) that is assigned to a Amazon GameLift game session queue resource and uniquely identifies it. ARNs are unique across all Regions. Format is ‘arn:aws:gamelift:<region>::gamesessionqueue/<queue name>`. Queues can be located in any Region. Queues are used to start new Amazon GameLift-hosted game sessions for matches that are created with this matchmaking configuration. If `FlexMatchMode` is set to `STANDALONE`, do not set this parameter.

[1]: docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html

Returns:

(Array<String>)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#name ⇒ `String`

A unique identifier for the matchmaking configuration. This name is used to identify the configuration associated with a matchmaking request or ticket.

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#notification_target ⇒ `String`

An SNS topic ARN that is set up to receive matchmaking notifications. See [ Setting up notifications for matchmaking] for more information.

[1]: docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#request_timeout_seconds ⇒ `Integer`

The maximum duration, in seconds, that a matchmaking ticket can remain in process before timing out. Requests that fail due to timing out can be resubmitted as needed.

Returns:

(Integer)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#rule_set_name ⇒ `String`

A unique identifier for the matchmaking rule set to use with this configuration. You can use either the rule set name or ARN value. A matchmaking configuration can only use rule sets that are defined in the same Region.

Returns:

(String)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ `Array<Types::Tag>`

A list of labels to assign to the new matchmaking configuration resource. Tags are developer-defined key-value pairs. Tagging Amazon Web Services resources are useful for resource management, access management and cost allocation. For more information, see [ Tagging Amazon Web Services Resources] in the *Amazon Web Services General Reference*.

[1]: docs.aws.amazon.com/general/latest/gr/aws_tagging.html

Returns:

(Array<Types::Tag>)

# File 'lib/aws-sdk-gamelift/types.rb', line 2747

class CreateMatchmakingConfigurationInput < Struct.new(
  :name,
  :description,
  :game_session_queue_arns,
  :request_timeout_seconds,
  :acceptance_timeout_seconds,
  :acceptance_required,
  :rule_set_name,
  :notification_target,
  :additional_player_count,
  :custom_event_data,
  :game_properties,
  :game_session_data,
  :backfill_mode,
  :flex_match_mode,
  :tags)
  SENSITIVE = []
  include Aws::Structure
end

Class: Aws::GameLift::Types::CreateMatchmakingConfigurationInput

Overview

Constant Summary collapse

Instance Attribute Summary collapse

Instance Attribute Details

#acceptance_required ⇒ Boolean

#acceptance_timeout_seconds ⇒ Integer

#additional_player_count ⇒ Integer

#backfill_mode ⇒ String

#custom_event_data ⇒ String

#description ⇒ String

#flex_match_mode ⇒ String

#game_properties ⇒ Array<Types::GameProperty>

#game_session_data ⇒ String

#game_session_queue_arns ⇒ Array<String>

#name ⇒ String

#notification_target ⇒ String

#request_timeout_seconds ⇒ Integer

#rule_set_name ⇒ String

#tags ⇒ Array<Types::Tag>

#acceptance_required ⇒ `Boolean`

#acceptance_timeout_seconds ⇒ `Integer`

#additional_player_count ⇒ `Integer`

#backfill_mode ⇒ `String`

#custom_event_data ⇒ `String`

#description ⇒ `String`

#flex_match_mode ⇒ `String`

#game_properties ⇒ `Array<Types::GameProperty>`

#game_session_data ⇒ `String`

#game_session_queue_arns ⇒ `Array<String>`

#name ⇒ `String`

#notification_target ⇒ `String`

#request_timeout_seconds ⇒ `Integer`

#rule_set_name ⇒ `String`

#tags ⇒ `Array<Types::Tag>`