AWS::GameLift::GameSessionQueue - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::GameLift::GameSessionQueue

AWS::GameLift::GameSessionQueue 资源建立一个队列以处理创建新游戏会话的请求。队列指定一个目标列表(队列或别名),以确定可以在何处托管新的游戏会话。它还设置在超时之前请求可以在队列中等待多长时间。您可以使用多个区域中的目标设置队列。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::GameLift::GameSessionQueue", "Properties" : { "Destinations" : [ Destination, ... ], "Name" : String, "PlayerLatencyPolicies" : [ PlayerLatencyPolicy, ... ], "TimeoutInSeconds" : Integer } }

YAML

Type: AWS::GameLift::GameSessionQueue Properties: Destinations: - Destination Name: String PlayerLatencyPolicies: - PlayerLatencyPolicy TimeoutInSeconds: Integer

属性

Destinations

可用于满足队列中的游戏会话放置请求的队列列表。队列是由队列 ARN 或队列别名 ARN 标识的。目标是以默认首选项顺序列出的。

必需:否

类型Destination 列表

Update requires: No interruption

Name

与游戏会话队列关联的描述性标签。队列名称在每个区域中必须是唯一的。

必需:是

类型:字符串

最低1

最高128

模式[a-zA-Z0-9-]+

Update requires: Replacement

PlayerLatencyPolicies

在处理包含玩家延迟信息的游戏会话放置请求时应用的一组延迟策略。将按最大延迟值的顺序评估多个策略,从最低延迟值开始。在仅使用一个策略时,将在持续期间内开始放置游戏会话时实施该策略。在使用多个策略时,将在持续时间内连续实施每个策略。例如,队列可能会实施 60 秒的策略,然后实施 120 秒的策略,并在其余放置中不实施任何策略。玩家延迟策略必须设置 MaximumIndividualPlayerLatencyMilliseconds 值。如果未设置,该 API 请求将失败。

必需:否

类型PlayerLatencyPolicy 列表

Update requires: No interruption

TimeoutInSeconds

新游戏会话放置请求在队列中保留的最长时间(以秒为单位)。在请求超过该时间时,游戏会话放置将变为 TIMED_OUT 状态。

必需:否

类型:整数

最低0

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回游戏会话队列的名称,它在每个区域中是唯一的。

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

Arn

GameSessionQueue 的唯一 Amazon 资源名称 (ARN)。

Name

与游戏会话队列关联的描述性标签。名称在每个区域中是唯一的。

示例

创建游戏会话队列

以下示例创建一个名为 MyGameSessionQueue 的 GameLift 游戏会话队列。队列配置了两个目标,一个使用队列 ID,另一个使用别名 ID。队列具有延迟策略。

JSON

{ "Resources": { "Queue": { "Type": "AWS::GameLift::GameSessionQueue", "Properties": { "Name": "MyGameSessionQueue", "TimeoutInSeconds": 60, "Destinations": [ { "DestinationArn": "arn:aws:gamelift:us-west-2:012345678912:fleet/fleet-id" }, { "DestinationArn": "arn:aws:gamelift:us-west-2:012345678912:alias/alias-id" } ], "PlayerLatencyPolicies": [ { "MaximumIndividualPlayerLatencyMilliseconds": 1000, "PolicyDurationSeconds": 60 } ] } } } }

YAML

Resources: Queue: Type: "AWS::GameLift::GameSessionQueue" Properties: Name: "MyGameSessionQueue" TimeoutInSeconds: 60 Destinations: # DestinationArn can be either an Alias arn or Fleet arn that you own - DestinationArn: "arn:aws:gamelift:us-west-2:012345678912:fleet/fleet-id" - DestinationArn: "arn:aws:gamelift:us-west-2:012345678912:alias/alias-id" PlayerLatencyPolicies: - MaximumIndividualPlayerLatencyMilliseconds: 1000 PolicyDurationSeconds: 60

另请参阅