本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
亚马逊 GameLift 服务 API
在构建 Amazon GameLift 游戏托管解决方案和其他API功能时,使用此基于任务的列表来查找操作。在aws.gamelift
命名空间中 Amazon SDK包含这些操作。下载 Amazon SDK或查
API包括两组用于托管游戏的操作:
亚马逊 GameLift 服务API还包含用于其他亚马逊 GameLift 工具和解决方案的操作。有关 FleetiQ 的列表,请参阅 APIs FleetiQ 的操作。API有关配对 FlexMatch APIs的列表,请参阅FlexMatch API操作。
管理 Amazon GameLift 托管资源
调用这些操作为您的游戏服务器配置托管资源,扩展容量以满足玩家需求,获取性能和使用率指标等。在 Amazon 上托管游戏服务器(包括实时服务器)时 GameLift,请使用这些API操作。您也可以在 Amazon GameLift 控制台
准备游戏服务器以进行部署
上传并配置游戏的游戏服务器代码,为在托管资源上部署和启动做好准备。
管理自定义游戏服务器构建
-
upload-b uild — 从本地路径上传构建文件并创建新的 Ama GameLift zon 构建资源。此操作可用作 Amazon CLI 命令,是上传游戏服务器版本的最常用方法。
-
CreateBuild— 使用存储在 Amazon S3 存储桶中的文件创建新版本。
-
ListBuilds— 获取上传到某个 Amazon GameLift 地区的所有版本的列表。
-
DescribeBuild— 检索与版本相关的信息。
-
UpdateBuild— 更改版本元数据,包括版本名称和版本。
-
DeleteBuild— 从 Amazon 中移除一个版本 GameLift。
管理实时服务器配置脚本
-
CreateScript— 上传 JavaScript 文件并创建新的 Amazon GameLift 脚本资源。
-
ListScripts— 获取上传到亚马逊 GameLift 地区的所有实时脚本的列表。
-
DescribeScript— 检索与实时脚本相关的信息。
-
UpdateScript— 更改脚本元数据并上传修改后的脚本内容。
-
DeleteScript— 从亚马逊 GameLift移除实时脚本。
设置用于托管的计算资源
配置托管资源并将其与游戏服务器构建或实时配置脚本一起构建。
创建和管理实例集
-
CreateFleet— 配置和部署新的 Amazon 计算资源 GameLift 队列来运行您的游戏服务器。部署后,游戏服务器将按照配置自动启动,随时可以托管游戏会话。
-
ListFleets— 获取亚马逊 GameLift 地区所有车队的列表。
-
DeleteFleet— 移除不再运行游戏服务器或托管玩家的舰队。
-
查看/更新实例集位置。
-
CreateFleetLocations— 将远程位置添加到支持多个地点的现有舰队中
-
DescribeFleetLocationAttributes— 获取舰队所有远程位置的列表并查看每个位置的当前状态。
-
DeleteFleetLocations— 从支持多个位置的舰队中移除远程位置。
-
-
查看/更新实例集配置。
-
DescribeFleetAttributes/UpdateFleetAttributes— 查看或更改舰队的元数据以及游戏会话保护和资源创建限制的设置。
-
DescribeFleetPortSettings/UpdateFleetPortSettings— 查看或更改队列允许的入站权限(IP 地址和端口设置范围)。
-
DescribeRuntimeConfiguration/UpdateRuntimeConfiguration— 查看或更改队列中每个实例上要运行的服务器进程(以及数量)。
-
管理实例集容量
-
描述 EC2InstanceLimits-检索当前 Amazon 账户允许的最大实例数和当前使用级别。
-
DescribeFleetCapacity— 检索舰队所在区域的当前容量设置。
-
DescribeFleetLocationCapacity— 检索多地点车队中每个地点的当前容量设置。
-
UpdateFleetCapacity— 手动调整车队的容量设置。
-
设置 :
-
PutScalingPolicy— 开启基于目标的自动缩放或创建自定义的自动缩放策略,或者更新现有策略。
-
DescribeScalingPolicies— 检索现有的自动缩放策略。
-
DeleteScalingPolicy— 删除自动缩放策略并阻止其影响队列的容量。
-
StartFleetActions— 重启队列的自动缩放策略。
-
StopFleetActions— 暂停舰队的自动缩放策略。
-
监控实例集活动。
-
DescribeFleetUtilization— 检索队列中当前活跃的服务器进程、游戏会话和玩家数量的统计信息。
-
DescribeFleetLocationUtilization— 检索多地点车队中每个位置的利用率统计信息。
-
DescribeFleetEvents— 查看队列在指定时间段内记录的事件。
-
DescribeGameSessions— 检索游戏会话元数据,包括游戏的运行时间和当前玩家人数。
设置游戏会话放置队列
设置多实例集、多区域队列,以使用最佳可用托管资源放置游戏会话,从而实现成本、延迟和恢复能力等方面的优势。
-
CreateGameSessionQueue— 创建队列,以便在处理游戏会话放置请求时使用。
-
DescribeGameSessionQueues— 检索在 Amazon GameLift 地区定义的游戏会话队列。
-
UpdateGameSessionQueue— 更改游戏会话队列的配置。
-
DeleteGameSessionQueue— 从该区域移除游戏会话队列。
管理别名
使用别名来表示您的实例集,或创建终端替代目标。别名在将游戏活动从一个实例集转换到另一个实例集时非常有用,例如在游戏服务器构建更新期间。
-
CreateAlias— 定义新别名并可选择将其分配给舰队。
-
ListAliases— 获取在 Amazon GameLift 地区定义的所有车队别名。
-
DescribeAlias— 检索有关现有别名的信息。
-
UpdateAlias— 更改别名的设置,例如将其从一个舰队重定向到另一个舰队。
-
DeleteAlias— 从该区域删除别名。
-
ResolveAlias— 获取指定别名指向的舰队 ID。
Connect 连接到托管托管实例
查看有关实例集中各个实例的信息,或请求远程访问指定的实例集实例以进行故障排除。
-
DescribeInstances— 获取队列中每个实例的信息,包括实例 ID、IP 地址、位置和状态。
-
GetInstanceAccess— 请求远程连接到队列中指定实例所需的访问凭证。
设置对VPC等互连
创建和管理您的 Amazon GameLift 托管资源与其他 Amazon 资源之间的对等VPC连接。
-
CreateVpcPeeringAuthorization— 授权与您的VPCs其中一个建立对等连接。
-
DescribeVpcPeeringAuthorizations— 检索有效的对等连接授权。
-
DeleteVpcPeeringAuthorization— 删除对等连接授权。
-
CreateVpcPeeringConnection— 在 for Amazon GameLift 车队和您的VPCs车队之间建立对等连接。VPC
-
DescribeVpcPeeringConnections— 检索有关与 Amazon GameLift 舰队的活跃或待处理VPC对等连接的信息。
-
DeleteVpcPeeringConnection— 删除与 Amazon GameLift 舰队的对VPC等连接。
开始游戏会话并加入玩家行列
从后端服务调用这些操作即可开始新的游戏会话、获取有关现有游戏会话的信息以及加入玩家的游戏会话。这些操作适用于托管在 Amazon 上的自定义游戏服务器 GameLift。如果您使用的是实时服务器,请使用实时服务器客户端 API (C#) 参考管理游戏会话。
-
为一个或多个玩家启动新游戏会话。
-
StartGameSessionPlacement— 让 Amazon GameLift 查找可用的最佳托管资源并开始新的游戏会话。这是创建新游戏会话的首选方法。它依靠游戏会话队列来跟踪多个地区的托管可用性,并使用 FleetIQ 算法根据玩家延迟、托管成本、位置等对展示位置进行优先排序。
-
DescribeGameSessionPlacement— 获取安置申请的详细信息和状态。
-
StopGameSessionPlacement— 取消安置申请。
-
CreateGameSession— 在特定的舰队位置开始新的空白游戏会话。此操作使您可以更好地控制从何处开始游戏会话,而不必使用 FleetIQ 来评估放置选项。您必须通过单独的步骤将玩家添加到新游戏会话中。
-
-
使玩家进入现有游戏会话。查找具有可用玩家位置的正在运行的游戏会话,并为新玩家预留位置。
-
CreatePlayerSession— 为玩家预留空位以加入游戏会话。
-
CreatePlayerSessions— 为多名玩家预留空位以加入游戏会话。
-
-
处理游戏会话和玩家会话数据。管理游戏会话和玩家会话信息。
-
SearchGameSessions— 根据一组搜索条件请求活跃游戏会话列表。
-
DescribeGameSessions— 检索特定游戏会话的元数据,包括活跃时间长度和当前玩家人数。
-
DescribeGameSessionDetails— 检索一个或多个游戏会话的元数据,包括游戏会话保护设置。
-
DescribePlayerSessions— 获取玩家活动的详细信息,包括状态、游戏时间和玩家数据。
-
UpdateGameSession— 更改游戏会话设置,例如最大玩家人数和加入政策。
-
GetGameSessionLogUrl— 获取游戏会话保存日志的位置。
-