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