本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Amazon GameLift Servers 管理游戏托管资源
管理 Amazon GameLift Servers 资源，包括生成包、实例集、游戏会话队列和对战构建器。您可以使用 Amazon GameLift Servers 控制台浏览资源列表，或查看资源详细信息（包括指标）。您也可以使用 AWS SDK 或 AWS CLI 检索资源信息 Amazon GameLift Servers
## Amazon GameLift Servers 控制台功能
使用 Amazon GameLift Servers 控制台，可以近乎实时地查看和管理您的游戏托管资源和正在进行的托管活动。该控制台为 Amazon GameLift Servers 服务 API 的大部分功能提供了图形界面。您可以使用控制台执行以下操作：
+ **使用控制面板获取概览信息。**您可以查看所有 Amazon GameLift Servers 托管资源的数量和当前状态，并点击链接获取有关各个资源的详细信息。
+ **管理单个托管资源。**您可以创建、查看和删除所有 Amazon GameLift Servers 资源，并更新其可变属性。您还可以查看某些类型的托管活动，例如活动和绩效指标。
+ **与游戏和玩家会话活动交互。**您可以按实例集跟踪游戏会话和玩家会话活动，并使用这些信息来解决游戏会话问题。查看游戏会话的详细信息，每个游戏会话的玩家会话，以及多个游戏会话中的玩家活动。您还可以根据需要关闭单个游戏会话。
**Topics**
+ [
## Amazon GameLift Servers 控制台功能
](#gamelift-console-features)
+ [
# Amazon GameLift Servers 控制台中的托管控制面板
](gamelift-console-dashboard.md)
+ [
# 游戏服务器生成包
](gamelift-console-builds.md)
+ [
# Amazon GameLift Servers 控制台中的实例集
](gamelift-console-fleets.md)
+ [
# Amazon GameLift Servers 控制台中的别名
](gamelift-console-aliases.md)
+ [
# Amazon GameLift Servers 控制台中的游戏会话队列
](queues-console.md)
# Amazon GameLift Servers 控制台中的托管控制面板
使用Amazon GameLift Servers控制台仪表板获取有关您 AWS 账户中Amazon GameLift Servers托管资源的当前状态的高级快照。**Amazon GameLift Servers 控制面板**提供以下内容的视图：
+ 处于**就绪**、**已初始化**和**失败**状态的构建数量。选择**查看构建**，了解有关您当前区域中构建的详细信息。
+ 处于所有状态的实例集数量。选择**查看实例集**，了解有关您当前区域中实例集的详细信息。
+ 您当前的资源。
+ 新特征和服务公告。
**打开 Amazon GameLift Servers 控制面板**
+ 在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)的导航窗格中，选择**控制面板**。
从控制面板中，您可以执行以下操作：
+ 选择**准备上线**并填写相应的发布问卷，为游戏发布做好准备。
+ 通过选择**查看服务限额**来申请增加服务限额，为启动做准备或响应启动。
+ 通过选择**特征亮点**中的链接，查看有关新特征的博客文章和详细信息。
![\[控制面板显示了您当前区域中所有 Amazon GameLift Servers 资源的状态。\]](http://docs.aws.amazon.com/zh_cn/gameliftservers/latest/developerguide/images/gamelift-console-dashboard.png)
# 游戏服务器生成包
生成包资源代表您的游戏服务器软件。您可以将构建包上传到，Amazon GameLift Servers以便部署到托管 EC2 队列。
在Amazon GameLift Servers控制台中或使用或 AWS SDK 查看有关游戏服务器版本的信息Amazon GameLift Servers。
------
#### [ Console ]
在[Amazon GameLift Servers主机](https://console.aws.amazon.com/gamelift/)的 “**构建**” 页面上，您可以查看有关您上传到托管 EC2 队列上部署的所有游戏服务器版本的信息并对其Amazon GameLift Servers进行管理。**在导航窗格中，选择 “托管”、“**托管**” EC2、“**构建**”。**
**生成包**页面显示了每个生成包的以下信息。您可以根据需要使用**首选项**工具调整表内容（请参阅表右上角的 ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_cn/gameliftservers/latest/developerguide/images/settings.png) 图标）。自定义首选项将保存到您的 AWS 账户用户，并在您查看此页面时自动应用。
**注意**
B **uil** ds 页面仅显示您当前 AWS 区域的构建。
+ **名称** – 已上传构建的名称。
+ **状态** - 构建的状态。显示以下三种状态消息的一种：
+ **已初始化** – 上传尚未开始或仍在进行中。
+ **准备就绪** – 构建已准备就绪，可以创建实例集。
+ **失败** – 在 Amazon GameLift Servers 收到二进制文件之前，生成包已过期。
+ **创建时间** – 将生成包上传到 Amazon GameLift Servers 的日期和时间。
+ **构建 ID** – 分配给上传构建的唯一 ID。
+ **版本** – 已上传构建的版本标签。
+ **操作系统** – 运行构建的操作系统。生成包操作系统决定了 Amazon GameLift Servers 在实例集实例上安装的操作系统。
+ **大小**：上传到 Amazon GameLift Servers 的生成包文件的大小（MB）。
+ **实例集** – 在构建时部署的实例集数量。
在此页面中，您可以执行以下任意操作：
+ 查看构建详细信息。选择构建的名称以打开其构建详细信息页面。
+ 从构建创建新实例集。选择一个构建，然后选择**创建实例集**。
+ 筛选和排序构建列表。使用表顶部的控件。
+ 删除构建。选择构建，然后选择**删除**。
**构建详细信息**
在**构建**页面上，选择构建的名称以打开其构建详细信息页面。详细信息页面的**概览**部分与**构建**页面显示相同的构建摘要信息。**实例集**部分显示运行该生成包的实例集列表，包括与[**实例集**页面](gamelift-console-fleets.md)相同的摘要信息。
------
#### [ AWS SDK ]
使用以下 AWS CLI 命令检索有关此资源的信息：
+ [ListBuild](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListBuilds.html)
+ [DescribeBuild](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeBuild.html)
------
# 更新游戏服务器生成包
为 Amazon GameLift Servers 托管式 EC2 托管部署游戏服务器生成包时，您需要上传游戏服务器软件并创建 Amazon GameLift Servers 生成包资源。创建Amazon GameLift Servers版本后，您可以更新版本的元数据，但不能自行更新构建文件。要将更新部署到游戏服务器版本中，必须使用 AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html)命令上传一组新文件并创建新Amazon GameLift Servers版本。或者，您也可以使用 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html) 命令从您控制的 Amazon S3 存储桶上传新生成包。然后通过为新生成包创建新实例集来部署新生成包。
您可以更新生成包的元数据，包括名称和描述。要执行这些任务，请使用Amazon GameLift Servers控制台或[https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-build.html) AWS CLI 命令。
## 自动执行游戏生成包更新
请按照以下提示帮助自动执行和简化为 Amazon GameLift Servers 托管式实例集更新游戏服务器生成包的流程：
+ **根据需要使用游戏会话队列和换出实例集。**向 Amazon GameLift Servers 发送游戏会话请求时，请指定游戏会话队列，而不是特定的实例集。借助队列，您可以添加包含新生成包的实例集，以及根据需要删除旧实例集。有关更多信息，请参阅[配置游戏会话放置](queues-intro.md)。
+ **使用别名将玩家传输到新游戏构建。**向 Amazon GameLift Servers 发送游戏会话请求时，请指定实例集别名，而不是实例集 ID。有关更多信息，请参阅 [创建 Amazon GameLift Servers别名](aliases-creating.md)。
+ **为迭代开发做好准备。**在游戏开发过程中，探索设置支持快速迭代开发的托管测试环境的选项。请参阅[借助 Amazon GameLift Servers Anywhere 为迭代开发做好准备](integration-dev-iteration.md)。
试用[Amazon GameLift Servers工具包中的这些资源，网](https://github.com/aws/amazon-gamelift-toolkit)址 GitHub为：
**Fast Build Update Tool（仅用于开发）**
此工具可帮助您修改已部署在托管式 EC2 实例集中的计算上的游戏服务器生成包，从而在快速开发迭代期间节省时间。此工具有多个选项；您可以替换整个游戏生成包或更改特定文件，也可以管理更新后重新启动游戏服务器进程的方式。您还可以使用它来更新实例集中的所有计算或针对单个计算进行更新。
访问 Amazon GameLift Servers Toolkit 存储库，获取[快速版本更新工具](https://github.com/aws/amazon-gamelift-toolkit/tree/main/fast-build-update-tool)， GitHub 并详细了解如何使用它。 GitHub
**生产部署示例脚本**
此脚本说明了如何自动执行以下过程：更新部署在生产环境中的托管式 EC2 实例集上的游戏服务器生成包。要使用此脚本，您的Amazon GameLift Servers托管解决方案必须使用别名来抽象舰队 IDs。此示例脚本处理以下基本步骤：上传更新后的生成包，创建新生成包并部署到新实例集，将玩家流量从现有实例集重定向到新实例集，以及删除旧实例集。请自定义示例脚本以满足您的特定部署要求。
访问 Amazon GameLift Servers Toolkit 存储库，获取[生产部署示例脚本](https://github.com/aws/amazon-gamelift-toolkit/tree/main/production-deployment-sample-script)， GitHub 并详细了解如何使用它。 GitHub
# Amazon GameLift Servers 控制台中的实例集
实例集资源表示一组已部署并用于运行您的游戏服务器的计算设备。根据您的托管解决方案，您可能拥有托管舰队、托管集装箱 EC2 舰队、Anywhere 舰队或两者兼而有之。
在Amazon GameLift Servers控制台中或使用或 AWS SDK 查看有关舰队的信息。Amazon GameLift Servers
------
#### [ Console ]
您可以查看您的 AWS 账户Amazon GameLift Servers下为托管游戏而创建的所有舰队的信息。在控制台的左侧导航中，找到所需的托管选项（Anywhere、托管 EC2、托管容器），然后选择 **Fle** ets。
对于每个托管选项，“**车队**” 页面都会列出位于您当前所选 AWS 地区的车队。您可以从**实例集**页面上创建新的实例集，或查看实例集的更多详细信息。实例集的[详细信息页面](gamelift-console-fleets-metrics.md)包含使用信息、指标、游戏会话数据和玩家会话数据。您也可以编辑舰队记录或删除舰队。
默认情况下，**实例集**页面显示以下摘要信息。您可以根据需要使用**首选项**工具调整表内容（请参阅表右上角的 ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_cn/gameliftservers/latest/developerguide/images/settings.png) 图标）。自定义首选项将保存到您的 AWS 账户用户，并在您查看此页面时自动应用。
+ **ID** – 分配给实例集的标识符。这个 ID 在创建队列 AWS 区域 的地方是唯一的。
+ **名称** – 为实例集指定的易记名称。
+ **状态** – 实例集的状态：**新建**、**正在下载**、**正在构建**和**活动**。
+ **创建时间** – 实例集的创建日期和时间。
**注意**
对于在 90 天前创建的实例集，实例集会显示警告图标。作为最佳实践，我们建议每 30 天更换一次舰队，以维护托管游戏服务器的安全 up-to-date运行环境。有关指南，请参阅[Amazon GameLift Servers 的安全最佳实践](security-best-practices.md)。
+ **实例集类型**：用于托管游戏的实例的可用性，这可能会影响托管成本。托管式实例集可以使用**按需型**（始终可用）或**竞价型**（可用性动态变化）实例。
+ **活动实例**-队列正在使用的 EC2 实例数量。
+ **所需实例**-要保持活动状态的 EC2 实例数量。
+ **游戏会话数** – 实例集中当前正在运行的活动游戏会话数。该数据有五分钟的延迟。
+ **玩家会话**：实例集中活跃玩家会话的数量。该数据有五分钟的延迟。
------
#### [ AWS SDK ]
使用以下 AWS CLI 命令检索有关此资源的信息：
+ 托管 EC2 车队
+ [ListFleets](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListFeets.html)
+ [ListCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListCompute.html)
+ [DescribeFleetAttributes](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeFleetAttributes.html)
+ [DescribeCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeCompute.html)
+ [DescribeFleetCapacity](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeFleetCapacity.html)
+ [DescribeFleetUtilization](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeFleetUtilization.html)
+ 托管式容器实例集
+ [ListContainerFleets](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListContainerFleets.html)
+ [DescribeContainerFleet](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeContainerFleet.html)
+ [ListContainerGroupDefinitions](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListContainerGroupDefinition.html)
+ [DescribeContainerGroupDefinition](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeContainerGroupDefinition.html)
+
+ [ListFleets](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListFeets.html)
+ [ListCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListCompute.html)
+ [DescribeFleetAttributes](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeFleetAttributes.html)
+ [DescribeCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeCompute.html)
------
# 更新 Amazon GameLift Servers 实例集配置
使用Amazon GameLift Servers控制台或 AWS CLI 更新您的舰队设置、更改远程位置或删除舰队。对于托管式实例集，您无法更改实例集的游戏服务器生成包或实例类型，而是必须更换实例集。
**Fast Build Update Tool（仅用于开发）**
对于托管 EC2 舰队，要部署游戏服务器版本更新，您需要将每个新版本上传到该Amazon GameLift Servers队列并为其创建新的舰队。
Fast Build Update Tool 可让您在开发过程中绕过这些步骤，从而节省时间并加快开发迭代速度。利用此工具，您可以在现有实例集的所有计算中快速更新游戏生成包文件。此工具有多个选项；您可以替换整个游戏生成包或更改 6 个特定文件，也可以管理更新后重新启动游戏服务器进程的方式。您还可以使用它来更新实例集中的单个计算。
要获取 Fast Build Update Tool 并详细了解其使用方法，请访问 Github 中的 Amazon GameLift Servers Toolkit 存储库，查看关于 [Fast Build Update Tool](https://github.com/aws/amazon-gamelift-toolkit/tree/main/fast-build-update-tool) 的页面。
您可以使用Amazon GameLift Servers控制台或 AWS CLI 更新可变队列属性、端口设置和运行时配置。要更改扩展限制，请参阅[通过 Amazon GameLift Servers 自动扩展队组容量](fleets-autoscaling.md)。
------
#### [ Console ]
1. 在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)的导航窗格中，选择**实例集**。
1. 选择要更新的实例集。实例集必须处于 `ACTIVE` 状态才能进行编辑。
1. 在实例集详情页面的以下任何部分中，选择**编辑**。
+ **实例集设置**
+ 更改实例集属性，如**名称**和**说明**。
+ 添加或删除**指标组**，亚马逊 CloudWatch 使用这些指标组来跟踪多个队列的汇总Amazon GameLift Servers指标。
+ 更新**资源创建限制**设置。
+ 打开或关闭游戏会话保护。
+ **运行时配置** – 您可以更改运行时配置的以下任何设置，也可以添加或删除运行时配置。
+ 更改游戏服务器的**启动路径**。
+ 添加、移除或更改可选的**启动参数**。
+ 更改游戏服务器运行的**并发进程**数。
+ **游戏会话激活** – 通过更新**最大并发游戏会话激活次数**和**新激活超时**，更改服务器进程的运行方式和托管游戏会话的方式。
+ **EC2 端口设置**-更新允许对队列进行入站访问的 IP 地址和端口范围。
1. 选择**确认**以保存所做的更改。
------
#### [ AWS CLI ]
使用以下 AWS CLI 命令更新舰队：
+ [update-fleet-attributes](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-attributes.html)
+ [update-fleet-port-settings](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-fleet-port-settings.html)
+ [update-runtime-configuration](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-runtime-configuration.html)
------
# 更新实例集位置
您可以使用 Amazon GameLift Servers 控制台或 AWS CLI 来添加或移除实例集的远程位置。您无法更改实例集的主区域。
------
#### [ Console ]
1. 在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)的导航窗格中，选择**实例集**。
1. 选择要更新的实例集。实例集必须处于 `ACTIVE` 状态才能进行编辑。
1. 在实例集详情页面上，选择**位置**选项卡以查看实例集的位置。
1. 要添加新的远程位置，请选择**添加**并选择要将实例部署到的位置。此列表不包括实例集实例类型不可用的实例。
1. 选择新位置后，选择**添加**。Amazon GameLift Servers 会将新位置添加到列表中，并将状态设置为 `NEW`。然后，Amazon GameLift Servers 开始在每个添加的位置预调配一个实例，并使其准备就绪以托管游戏会话。
1. 要从实例集中移除现有的远程位置，请使用复选框选择一个或多个列出的位置。
1. 选择一个或多个实例集后，选择**移除**。已移除的位置仍保留在列表中，状态设置为 `DELETING`。然后，Amazon GameLift Servers 开始终止已移除位置的活动。如果存在托管游戏会话的活动实例，Amazon GameLift Servers 会使用游戏服务器终止流程正常结束游戏会话、终止游戏服务器和关闭实例。
------
#### [ AWS CLI ]
使用以下 AWS CLI 命令更新舰队位置：
+ [create-fleet-locations](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-fleet-locations.html)
+ [delete-fleet-locations](https://docs.aws.amazon.com/cli/latest/reference/gamelift/delete-fleet-locations.html)
------
# 删除实例集
当您不再需要某个实例集时，可以删除它。删除实例集将永久删除所有与游戏会话和玩家会话相关的数据以及所有收集的指标数据。作为替代方案，您可以保留实例集，禁用自动扩缩，并将实例集手动缩减为 0 个实例。
**注意**
如果队列具有 VPC 对等连接，请先调用[CreateVpcPeeringAuthorization](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateVpcPeeringAuthorization.html)请求授权。 Amazon GameLift Servers在删除队列期间删除 VPC 对等连接。
您可以使用Amazon GameLift Servers控制台或 AWS CLI 工具删除舰队。
------
#### [ Console ]
1. 在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)的导航窗格中，选择**实例集**。
1. 选择要删除的实例集。您只能删除处于 `ACTIVE` 或 `ERROR` 状态的实例集。
1. 选择**删除**。
1. 在**删除实例集**对话框中，输入**delete**确认删除。
1. 选择**删除**。
------
#### [ AWS CLI ]
使用以下 AWS CLI 命令删除舰队：
+ [delete-fleet](https://docs.aws.amazon.com/cli/latest/reference/gamelift/delete-fleet.html)
------
# Amazon GameLift Servers 控制台中的实例集详细信息
在控制面板或**实例集**页面中选择实例集名称可访问**实例集**详细信息页面。
在实例集详细信息页面上，您可以执行以下操作：
+ 更新实例集的属性、端口设置和运行时配置。
+ 添加或删除实例集位置。
+ 更改实例集容量设置。
+ 设置或更改目标跟踪自动扩缩。
+ 删除实例集。
## Details
**实例集设置**
+ **实例集 ID** – 分配给实例集的标识符。这个 ID 在创建队列 AWS 区域 的地方是唯一的。
+ **实例集名称**：为实例集指定的易记名称。
+ **ARN** – 分配给此实例集的唯一标识符。实例集的 ARN 将其标识为 Amazon GameLift Servers 资源并指定区域和 AWS 账户。
+ **描述** – 实例集的简要可识别描述。
+ **状态** – 实例集的当前状态，可以是**新建**、**正在下载**、**正在构建**和**活动**。
+ **创建时间** – 创建实例集的日期和时间。
**注意**
对于在 90 天前创建的实例集，实例集会显示警告图标。作为最佳实践，我们建议每 30 天更换一次舰队，以维护托管游戏服务器的安全 up-to-date运行环境。有关指南，请参阅[Amazon GameLift Servers 的安全最佳实践](security-best-practices.md)。
+ **计算类型** – 用于托管游戏的计算类型。队列可以是托管集装箱 EC2、**托管****集装箱**或 **Anywhere** 队列。
+ **操作系统**：部署到实例集中每个实例的亚马逊机器映像（AMI）。AMI 版本是指创建实例集时可用的最新版本。
+ **证书类型**-舰队使用 TLS 证书对游戏服务器进行身份验证和加密所有 client/server 通信的能力状态。
+ **实例集类型**：用于托管游戏的实例的可用性，这可能会影响托管成本。实例集可以使用**按需型**（始终可用）或**竞价型**（可用性动态变化）实例。
+ **EC2 实例类型**-创建队列时为队列选择的 Amazon EC2 [实例类型](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)。
+ **实例角色 ARN** — 一个 AWS IAM 角色，用于管理对您的其他 AWS 资源的访问权限（如果在创建队列时提供了其他资源）。
+ **实例角色证书提供商** — 一个 AWS IAM 角色，用于管理对您的其他 AWS 资源的访问权限（如果在创建队列时提供了其他资源）。
+ **指标组名称** – 用于聚合多个实例集的指标的组。
+ **游戏扩缩保护策略**：指示是否启用了实例集的游戏会话保护，该功能可以防止活动游戏会话在缩减事件期间过早结束。
+ **每位玩家的最大游戏会话数** – 玩家在**策略期限**内可以创建的最大会话数。
+ **策略周期**：用于限制玩家可创建会话数量的时间长度。
**构建详细信息**
**构建详细信息**部分显示实例集上托管的构建。选择构建名称可查看完整的构建详细信息页面。
**运行时配置**
**运行时配置**部分显示要在每个实例上启动的服务器进程。它包括游戏服务器可执行文件的路径和可选的启动参数。
**游戏会话激活**
**游戏会话激活**部分显示同时启动的服务器进程的数量以及该进程在终止之前需要等待多长时间才能激活。
**EC2 端口设置**
**端口**部分显示实例集的连接权限，包括 IP 地址和端口设置范围。
## 指标
**指标**部分显示一段时间内实例集指标的图形化表示。有关在 Amazon GameLift Servers 中使用指标的更多信息，请参阅[Amazon GameLift Servers使用 Amazon 进行监控 CloudWatch](monitoring-cloudwatch.md)。
## Events
**事件**选项卡提供实例集中已发生的所有事件的日志，包括事件代码、消息和时间戳。请参阅《Amazon GameLift Servers API 参考》中的[事件](https://docs.aws.amazon.com/gamelift/latest/apireference/API_Event.html)描述。
## 扩展
**扩展**选项卡包含与实例集容量相关的信息，包括当前状态和一段时间内容量的变化。它还提供了用于更新容量限制和管理自动扩缩的工具。
**扩展容量**
查看每个实例集位置的当前实例集容量设置。有关更改限额和容量的更多信息，请参阅[利用 Amazon GameLift Servers 扩展游戏托管容量](fleets-manage-capacity.md)。
+ **AWS 位置** – 部署实例集实例的位置的名称。
+ **状态** – 实例集位置的托管状态。位置状态必须为 `ACTIVE` 才能托管游戏。
+ **最小大小** – 必须在该位置部署的最小实例数。
+ **所需实例** – 维护该位置的活动实例的目标数量。当活动实例和所需实例不相同时，将启动扩缩事件以根据需要启动或关闭实例，直到活动实例等于所需的实例。
+ **最大大小** – 可以在该位置部署的最大实例数。
+ **可用** – 实例的服务限额减去正在使用的实例数量。此值告诉您可以添加至该位置的最大实例数。
**自动扩缩策略**
本节介绍有关应用于实例集的自动扩缩策略的信息。您可以设置或更新基于目标的策略。此处显示了舰队基于规则的策略，这些策略必须使用 AWS SDK 或 CLI 进行定义。有关扩展的更多信息，请参阅[通过 Amazon GameLift Servers 自动扩展队组容量](fleets-autoscaling.md)。
**扩展历史记录**
查看容量随时间变化的图表。
## 位置
**位置**选项卡列出了部署实例集实例的所有位置。位置包括实例集的所在主地区和已添加的任何远程位置。您可以直接在此选项卡中添加或删除位置。
+ **位置** – 部署实例集实例的位置的名称。
+ **状态** – 实例集位置的托管状态。位置状态跟踪激活该位置中第一个实例的过程。位置状态必须为 `ACTIVE` 才能托管游戏。
+ **活动实例** – 在实例集位置上运行服务器进程的实例数量。
+ **活动服务器** – 能够在实例集位置托管游戏会话的游戏服务器进程的数量。
+ **游戏会话** – 实例集位置中实例上的活动游戏会话数。
+ **玩家会话** – 代表个人玩家参与实例集所在位置的游戏会话的玩家会话数量。
## 游戏会话
**游戏会话**选项卡列出了过去和当前在实例集上托管的游戏会话，包括一些详细信息。选择一个游戏会话 ID 可访问游戏会话的更多信息，包括玩家会话。有关玩家会话的更多信息，请参阅[Amazon GameLift Servers 控制台中的游戏和玩家会话](gamelift-console-game-player-sessions-metrics.md)。
# Amazon GameLift Servers 控制台中的游戏和玩家会话
您可以使用 Amazon GameLift Servers 控制台来处理游戏会话和玩家会话。有关游戏会话和玩家会话的更多信息，请参阅[Amazon GameLift Servers 和玩家体验](game-sessions-intro.md)。Amazon GameLift Servers 控制台提供相关信息和工具，可帮助您调查游戏会话中的问题。
支持的操作：
+ 浏览托管在特定实例集上的游戏会话和玩家会话活动。
+ 在多个实例集中查找特定玩家的游戏会话活动。
+ 关闭特定游戏会话。
## 查看游戏会话详情
游戏会话和玩家会话数据按托管游戏会话的实例集组织。
**访问游戏会话和玩家会话信息**
1. 在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)中，打开左侧导航窗格。选择托管解决方案类型，并打开**实例集**页面。例如：
+ **托管**、**Anywhere**、**实例集**
+ **托管**、**托管式 EC2**、**实例集**
+ **托管**、**托管容器**、**实例集**
1. 每个 **Fleets** 页面都会显示您当前选择的舰队列表。 AWS 区域请选择要查看其游戏会话数据的实例集。
1. 在实例集的详情页面中，打开**游戏会话**选项卡。此选项卡将列出实例集中托管的所有游戏会话及其摘要信息。您可以根据需要使用**首选项**工具调整表内容（请参阅表右上角的 ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_cn/gameliftservers/latest/developerguide/images/settings.png) 图标）。自定义首选项将保存到您的 AWS 账户用户，并在您查看此页面时自动应用。
1. 从列表中选择一个游戏会话以查看更多信息。
1. 如果该游戏会话包含玩家会话数据，请选择**查看玩家会话**以打开玩家会话查询工具，其中会自动填充游戏会话 ID。
**游戏会话**详情包括以下信息：
+ **状态** – 游戏会话状态。
+ **激活** – 实例正在启动游戏会话。
+ **活动** – 游戏会话正在运行且可以接收玩家（取决于会话的[玩家创建策略](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession.html)）。
+ **已终止** – 游戏会话已结束。
+ **ARN** – 游戏会话的 Amazon 资源名称。
+ **名称** – 为游戏会话生成的名称。
+ **位置** – Amazon GameLift Servers 托管游戏会话的位置。
+ **创建时间** – Amazon GameLift Servers 创建流会话的日期和时间。
+ **结束时间** – 游戏会话结束的日期和时间。
+ **DNS 名称** – 游戏会话的主机名。
+ **IP 地址** – 为游戏会话指定的 IP 地址。
+ **端口** – 用于连接到游戏会话的端口号。
+ **创建者 ID** – 发起游戏会话的玩家的唯一标识符。
+ **玩家会话创建策略** – 指示游戏会话是否接受新玩家。
+ **游戏扩缩保护策略** – 要在 Amazon GameLift Servers 在实例集中启动的所有新实例上设置的游戏会话保护类型。
**游戏数据**
游戏属性数据，格式为字符串，在启动时发送到游戏会话。
**游戏属性**
游戏属性数据，格式成 key/value 对，在启动时发送到您的游戏会话。
**对战数据**
如果游戏会话是使用 FlexMatch 创建的，对战数据将描述有关对战配置和规则集的信息。这包括每个匹配项的玩家属性和队伍分配。数据采用 JSON 格式。有关 FlexMatch 对战的更多信息，请参阅[构建对战构建器](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/matchmaker-build.html)。
# 查找玩家会话数据
如果您的游戏托管解决方案使用玩家会话并提供独特的玩家 IDs，则您可以浏览多个队列中过去或现在的游戏会话中特定于玩家的活动。可使用以下任一方法打开玩家会话查询工具：
+ 在 Amazon GameLift Servers 控制台中，打开左侧导航窗格并选择**玩家会话查找**，然后选择要使用的过滤器类型。
+ 要查看实例集的游戏会话详细信息，请选择**查看玩家会话**。查找工具将打开游戏会话，其中已预先选择了游戏会话 ID 过滤器并填写了游戏会话值。
使用查找工具时，您可以提供以下任何信息：
+ 玩家会话 ID，用于获取有关特定玩家会话的信息。
+ 游戏会话 ID，用于获取有关所请求游戏会话的所有玩家会话的信息。结果代表已预留位置或连接到游戏会话的所有玩家。您可以选择按玩家会话状态筛选结果。
+ 玩家 ID，用于获取所请求玩家的所有玩家会话信息。结果代表玩家参与的所有游戏会话。
**注意**
查找工具会搜索当前选定区域内的所有玩家会话活动 AWS 区域。如果您在该区域内有多个实例集，结果将包含所有实例集中的玩家会话活动。对于多位置实例集，结果还将包含实例集远程位置的玩家会话活动。
每个游戏会话中将收集以下玩家会话数据：
+ **玩家会话 ID** – 分配给玩家会话的标识符。
+ **玩家 ID** – 玩家的唯一标识符。单击此 ID 获取更多玩家信息。
+ **游戏会话 ID** – 分配给游戏会话的标识符。
+ **实例集 ID** –分配给托管游戏会话的实例集的标识符。
+ **状态** – 玩家会话的状态。有以下可能状态：
+ **已预留** – 玩家会话已预留，但玩家尚未连接。
+ **活动** – 玩家会话已连接到游戏服务器。
+ **已完成** – 玩家会话已结束；玩家不再处于连接状态。
+ **超时** – 玩家连接失败。
+ **开始时间** – 玩家连接到游戏会话的时间。
+ **结束时间** – 玩家从游戏会话断开连接的时间。
+ **连接数据** – 玩家用于连接到游戏会话的 IP 地址、DNS 名称和端口。
+ **玩家数据** – 玩家会话创建期间提供的有关玩家的信息。
# 关闭游戏会话
使用 Amazon GameLift Servers 控制台关闭特定的游戏会话。此功能为您提供了一种简单快捷的方法来定位游戏会话并发送终止信号。另一种终止方法则要求您找到运行游戏会话的实例集实例，远程访问该实例，然后手动关闭游戏会话。
您可以出于任何原因关闭游戏会话。最常见的原因是为了解决无法自然关闭的游戏会话问题。此类问题会导致无法腾出游戏会话的托管资源来托管新的游戏会话，而且实例集的托管容量也随之降低。
**注意**
此功能依赖于您的托管解决方案的某些配置设置，并且具有以下限制：
游戏会话必须托管在运行游戏服务器生成包（使用适用于 Amazon GameLift Servers v5 或更高版本的服务器 SDK）的实例集上。如果您的游戏服务器部署的是旧版本，则需要通过远程访问来删除游戏会话。
如果游戏会话托管在 Anywhere 实例集上，则该实例集必须使用 Amazon GameLift Servers 代理来管理游戏服务器进程。
**终止游戏会话**
1. 在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)中，打开左侧导航窗格。选择托管解决方案类型，并打开**实例集**页面。例如：
+ **托管**、**Anywhere**、**实例集**
+ **托管**、**托管式 EC2**、**实例集**
+ **托管**、**托管容器**、**实例集**
1. 每个 **Fleets** 页面都会显示您当前选择的舰队列表。 AWS 区域选择托管您要终止的游戏会话的实例集。
1. 在实例集的详情页面中，打开**游戏会话**选项卡。在游戏会话列表中，选择要终止的会话，然后选择**终止**按钮。
1. 在**终止游戏会话中？**窗口中，确认您正在关闭正确的游戏会话并选择终止方法。
+ 正常关闭游戏会话：此选项会向托管游戏会话的服务器进程发送关闭信号。如果您的游戏服务器生成包已正确集成 Amazon GameLift Servers，则服务器进程会启动其游戏会话关闭序列，通知 Amazon GameLift Servers 该会话即将结束，然后停止。根据您的游戏设计，关闭序列可能包括正常完成游戏会话的步骤，例如保存数据和通知活跃玩家。此方法可能需要短暂延迟来完成游戏会话关闭序列。
+ 立即关闭游戏会话：此选项会向进程管理器发送信号，要求其关闭托管游戏会话的服务器进程。此选项会绕过正常的游戏会话关闭流程。即使服务器进程无法响应，它也可以终止游戏会话。
1. 确认游戏会话终止。您可以在**游戏会话**控制台页面上跟踪关闭进度。游戏会话状态将更改为“正在终止”，然后在关闭完成后更改为“已终止”。
**相关主题**
+ 您也可以使用 AWS SDK 和. 关闭游戏会话 AWS CLI。有关更多详细信息和示例，请参阅 Amazon GameLift Servers API 参考主题[TerminateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_TerminateGameSession.html)。
+ 有关游戏服务器集成以及服务器进程如何响应来自 Amazon GameLift Servers 服务的信号的更多信息，请参阅[借助服务器 SDK 将 Amazon GameLift Servers 添加到游戏服务器](gamelift-sdk-server-api.md)。
# 更新 Amazon GameLift Servers 托管式容器实例集
您可以更新托管式容器实例集的大部分属性，包括容器组定义。根据所更新的设置，实例集更新可能会启动新的实例集部署。在实例集部署过程中，实例集中的所有实例都将被移除，并替换为采用新配置的实例。需要重新部署的设置包括：
+ 容器组定义，包括对容器映像的更新
+ 连接端口范围和入站权限
+ 日志配置
您可以在用于创建容器实例集的 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)或 AWS Command Line Interface（AWS CLI）中跟踪实例集部署状态。
**注意**
您无法更新实例集的运行时环境。创建实例集时，实例集的亚马逊机器映像（AMI）会设置为最新可用的 Linux AMI 版本。部署到该实例集的所有容器映像都必须与此版本兼容。要更改实例集的 AMI 或升级到新版本，您必须创建新的实例集。作为最佳实践，我们建议每 30 天更换一次实例集，以便为托管游戏服务器维护安全且最新的运行时环境。有关更多指导，请参阅[Amazon GameLift Servers 的安全最佳实践](security-best-practices.md)。
------
#### [ Console ]
在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)中，选择要创建实例集的 AWS 区域。容器组定义必须与您要创建实例集的区域保持一致。
打开控制台的左侧导航栏，并选择**托管容器：实例集**。在托管式容器实例集页面上，从列表中选择一个实例集，然后选择**编辑**。
1. 根据需要更新容器实例集设置。完成后，选择 **Create (创建)**。
1. 如果您的更新需要重新部署实例集，系统会要求您指定以下部署选项：
+ 游戏会话保护。您可以选择保护具有处于活动状态的游戏会话的实例集实例（安全部署）。使用此设置，直到游戏会话结束后才会替换实例集实例。或者，您也可以选择无论游戏会话活动如何，都替换实例集实例（非安全部署）。非安全部署适用于开发和测试阶段，可缩短部署时间。
+ 最低运行正常百分比。您可以管理替换实例集实例的速度。使用此设置，可在部署期间保持最低数量的正常任务。较低的数值会优先保证部署速度，而较高的数值则可确保游戏服务器在整个部署过程中保持较高的可用性。
+ 部署失败策略。决定部署失败时要采取的措施。部署失败指部分更新后的容器未通过状态检查，被判定为异常状态。您可以将部署设置为自动将所有实例集实例回滚到先前部署的状态。或者，您也可以选择保留部分异常的实例集实例以用于调试。
如果请求成功，控制台将显示托管容器实例集的**部署**选项卡。您可以使用此选项卡跟踪每个部署的状态。如果您开始对实例集进行新的部署，则此操作会自动取消实例集当前正在进行的任何部署。
------
#### [ AWS CLI ]
要使用 AWS CLI 创建容器实例集，请打开命令行窗口，然后使用 `update-container-fleet` 命令。有关此命令的更多信息，请参阅《AWS CLI 命令参考》**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-container-fleet.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/gamelift/update-container-fleet.html)。
以下示例更新了一个具有以下特征的现有容器实例集：
+ 它将游戏服务器容器组定义更新为使用版本 2。
+ 它指定了安全部署选项。
```
{
"DeploymentConfiguration": {
"ImpairmentStrategy": "ROLLBACK",
"MinimumHealthyPercentage": 75,
"ProtectionStrategy": "WITH_PROTECTION"
},
"FleetId": "containerfleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa",
"GameServerContainerGroupDefinitionName": "arn:aws:gamelift:us-west-2:111122223333:containergroupdefinition/MyAdventureGameContainerGroup:2"
}
```
------
# 更新 Amazon GameLift Servers 容器实例集的容器组定义
您可以更新容器实例集的大部分属性，包括各个独立的容器定义。容器组定义包含版本号。更新容器组定义时，Amazon GameLift Servers 会保存更新并递增该定义的版本号。配置容器实例集时，可以指定要部署的容器组定义版本。
更新容器组定义后，您可以将新版本部署到新的或现有的容器实例集中。
## 更新游戏服务器容器组定义
本主题介绍如何使用Amazon GameLift Servers控制台或 AWS CLI 工具更新游戏服务器容器组定义。有关可选功能的更多详细信息，请参阅[自定义 Amazon GameLift Servers 容器实例集](containers-design-fleet.md)。
**要更新容器组定义，请执行以下操作：**
------
#### [ Console ]
在[Amazon GameLift Servers控制台](https://console.aws.amazon.com/gamelift/)中，选择要创建容器组 AWS 区域 的位置。
打开控制台的左侧导航栏，并选择**托管容器：组定义**。在容器组定义页面上，选择要更新的容器组定义和版本。
保存更新后，您可以使用新版本创建新的容器实例集，也可以将更新部署到现有的容器实例集。
**步骤 1：定义容器组定义详情**
+ 您可以更新总内存和 vCPU 限制设置。
**步骤 2：添加容器定义**
容器定义可以进行以下更新：
+ 更新现有容器定义。
+ 添加新的支持容器定义。
+ 移除支持容器定义。
1. 您可以更新 **ECR 映像 URI**。请务必更新**服务器 SDK 版本**设置以匹配新映像。
1. 您可以根据需要更新**内部容器端口范围**。当您对这些设置所做的更改被部署到容器实例集时，可能会影响该实例集的连接端口设置。有关更多详细信息，请参阅[配置网络连接](containers-design-fleet.md#containers-custom-network)。
**步骤 3：配置依赖关系**
+ 您可以按需更改依赖关系。有关更多信息，请参阅 [设置容器依赖关系](containers-design-fleet.md#containers-design-fleet-dependencies)。
**第 3 步：审核并创建**
+ 查看您的容器组定义更新。使用**编辑**，对任何部分进行其他任何更改。完成后，选择**创建**以生成新版本的容器组定义。
如果请求成功，控制台将显示新容器组定义资源的详细信息页面。初始状态为 `COPYING`，此时 Amazon GameLift Servers 开始为该组的所有容器映像拍摄快照。此阶段完成后，容器组定义状态将更改为 `READY`。容器组定义必须处于 `READY` 状态，才能使用它创建容器实例集。
------
#### [ AWS CLI ]
使用 AWS CLI 创建或更新容器组定义时，请在单独`JSON`的文件中维护您的容器定义配置。您可以在 CLI 命令中引用该文件。有关架构示例，请参阅[创建容器定义 `JSON` 文件](containers-create-groups.md#containers-definitions-create)。
更新定义时，您只需指定要更新的值即可。Amazon GameLift Servers 会保留您未包含在更新请求中的任何值。不过，如果要更改容器定义，则需提供一套完整的定义。
**更新容器组定义**
要更新新的容器组定义，请使用 `update-container-group-definition` CLI 命令。有关此命令的更多信息，请参见《*AWS CLI 命令参考*》[update-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-container-group-definition.html)中的。
**Example ：游戏服务器容器组**
在检索、更新或删除容器组定义时，或者在创建或更新容器实例集时，您可以指定容器组定义版本。每个容器组定义都有一个版本属性。此外，定义的 ARN 值也会指定版本号。
此示例展示了更改游戏服务器容器组定义的请求。假设您已经创建了一个包含该组容器定义的 JSON 文件。此示例使用 ARN 值作为定义名称，并指定此次更新针对的是版本 1。
```
aws gamelift update-container-group-definition \
--name arn:aws:gamelift:us-west-2:111122223333:containergroupdefinition/MyAdventureGameContainerGroup:1 \
--operating-system AMAZON_LINUX_2023 \
--container-group-type GAME_SERVER \
--total-memory-limit-mebibytes 4096 \
--total-vcpu-limit 1 \
--container-definitions file://SimpleServer.json
```
------
## 克隆容器组定义
您可以使用 Amazon GameLift Servers 控制台来克隆现有的容器组定义。
**克隆容器组**
1. 在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)中，转到左侧导航窗格，并选择**容器组**。
1. 在**容器组**列表页面上，选择要克隆的现有容器组。选择容器组后，**克隆**按钮变为活动状态。
1. 选择**克隆**。此操作将打开带有预填设置的容器组创建向导。
1. 为克隆的容器组输入新名称。同一区域中的容器组必须具有唯一的名称。
1. 依次浏览容器组和容器定义页面，进行审核，然后**创建**新的容器组。
# 删除 Amazon GameLift Servers 容器实例集的容器组定义
您可以通过多种方式来删除容器组定义。删除容器组定义时，此操作还会删除该容器组中的所有容器定义。
容器组定义可能有多个版本。容器组版本名称相同，但版本号不同。容器组定义同时 ARNs 指定名称和版本。
在检索、更新或删除容器组定义时，或者在创建或更新容器实例集时，您可以指定容器组定义版本。每个容器组定义都有一个版本属性。此外，定义的 ARN 值也会指定版本号。
删除容器组定义有以下几种方式：
+ 您可以删除特定定义的所有版本。
+ 您可以删除特定定义的某个特定版本。
+ 您可以针对特定定义保留一定数量的最新版本，并删除其旧版本。例如，您可以删除所有版本号低于 5 的版本。
仅当容器组定义版本未在容器实例集中使用时，您才能删除该版本。
**删除容器组定义**
------
#### [ Console ]
在[Amazon GameLift Servers控制台](https://console.aws.amazon.com/gamelift/)中，选择要创建容器组 AWS 区域 的位置。
打开控制台的左侧导航栏，并选择**托管容器：组定义**。在容器组定义页面上，选择要修改的定义，然后选择**删除**。
系统会提示您选择要执行的删除类型，并根据所选删除类型指定额外设置。
------
#### [ AWS CLI ]
+ 要删除容器组定义，请使用 `delete-container-group-definition` CLI 命令并提供要执行的删除类型的值。有关此命令的更多信息，请参见《*AWS CLI 命令参考*》[delete-container-group-definition](https://docs.aws.amazon.com/cli/latest/reference/gamelift/delete-container-group-definition.html)中的。
以下示例展示了删除版本号早于 5 的所有游戏服务器容器组定义的请求。
**Example**
```
aws gamelift delete-container-group-definition \
--name MyAdventureGameContainerGroup \
--version-count-to-retain 5 \
```
------
# Amazon GameLift Servers 控制台中的别名
别名资源代表指向实例集或终端目标的指针。它们用于将玩家流量引导到特定的托管目标位置。通过别名对目标位置进行抽象化处理，您在更新托管实例集时可以更便捷地重定向流量。
在Amazon GameLift Servers控制台中或使用或 AWS SDK 查看有关别名的信息。Amazon GameLift Servers
------
#### [ Console ]
**别名**页面显示有关 Amazon GameLift Servers 别名的信息，这些别名用于将流量引导至特定的托管目标位置。要查看别名，可在导航窗格中依次选择**托管**和**别名**。
在别名页面上，可以执行以下操作：
+ 创建新别名。选择**创建别名**。
+ 筛选和排序别名表。使用表顶部的控件。您可以根据需要使用**首选项**工具调整表内容（请参阅表右上角的 ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_cn/gameliftservers/latest/developerguide/images/settings.png) 图标）。自定义首选项将保存到您的 AWS 账户用户，并在您查看此页面时自动应用。
+ 查看别名详细信息。选择一个别名可打开别名详细信息页面。
+ 删除别名。选择一个别名，然后选择**删除**。
**别名详细信息**
别名详细信息页面中显示有关别名的信息。
在此页面上，您可以：
+ 编辑别名。选择**编辑**。
+ 查看与别名关联的实例集。
+ 删除别名。选择**删除**。
别名详细信息包括：
+ **ID** – 用于标识别名的唯一编号。
+ **描述** – 别名的描述。
+ **ARN** – 别名的 Amazon Resource Name。
+ **创建** – 别名的创建日期和时间。
+ **上次更新时间** – 上次更新别名的日期和时间。
+ **路由类型** – 别名的路由选项，可以选择以下选项之一：
+ **简单** – 将玩家流量路由到指定的实例集 ID。您可以随时更新别名的实例集 ID。
+ **终端** – 将消息传回客户端。例如，你可以将正在使用 out-of-date客户端的玩家引导到他们可以升级的地方。
+ **标签** - 用于标识别名的键和值对。
------
#### [ AWS SDK ]
使用以下 AWS CLI 命令检索有关此资源的信息：
+ [ListAliases](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_ListAliases.html)
+ [DescribeAlias](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeAlias.html)
------
# 编辑别名
您可以使用 Amazon GameLift Servers 控制台或 AWS CLI 命令 [update-alias](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-alias.html) 来编辑别名。
本主题介绍如何编辑用于游戏会话放置的 Amazon GameLift Servers 别名。您可以进行以下编辑：
**编辑别名**
使用 Amazon GameLift Servers 控制台或 AWS Command Line Interface（AWS CLI）编辑别名。
------
#### [ Console ]
在 [Amazon GameLift Servers 控制台](https://console.aws.amazon.com/gamelift/)中，使用导航窗格打开**别名**页面。
1. 选择要编辑的别名并选择**编辑**。如果没有看到要编辑的别名，请检查当前选择的 AWS 区域。
1. 在**编辑别名**页面上，可以进行以下编辑：
+ 更改别名名称。
+ 更改别名描述。
+ 将路由策略从“简单”更改为“终端”，或从“终端”更改为“简单”。
+ 对于包含简单路由策略的别名，请更改与该别名关联的实例集 ID。
+ 对于包含终端路由策略的别名，请更改消息文本。
1. 选择**保存更改**。更新包含简单路由策略的别名的实例集 ID 时，可能需要 2 分钟才能完成转换。在此期间，可能会在旧实例集上进行新的游戏会话放置。
------
#### [ AWS CLI ]
使用 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-alias.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/update-alias.html) 命令对别名资源进行更改。您可以更新当前默认 AWS 区域中的别名资源，也可以添加 `--region` 标签来指定其他 AWS 区域。
您可以更改以下属性：
+ 别名名称。
+ 别名描述。
+ 路由策略类型。请务必为新路由策略提供实例集 ID 或消息字符串。
+ 现有简单路由策略的实例集 ID。实例集 ID 必须与别名位于同一区域中。
+ 现有终端路由策略的消息字符串。
------
# Amazon GameLift Servers 控制台中的游戏会话队列
队列资源表示您对游戏会话放置组件的配置。它决定了 Amazon GameLift Servers 如何根据您的配置选项搜索并选择最佳计算资源来托管新游戏会话。
在Amazon GameLift Servers控制台中或使用或 AWS SDK 查看有关游戏会话队列的信息Amazon GameLift Servers。
------
#### [ Console ]
您可以查看所有队列的信息，这些队列用于处理新游戏会话的请求。队列页面显示当前所选队列中的游戏会话队列 AWS 区域。在 **Queues** 页面上，您可以创建新队列、删除现有队列或打开选定队列的详细信息页面。队列详细信息页面包括队列的配置和指标数据。有关队列的更多信息，请参阅[配置游戏会话放置](queues-intro.md)。
“队列”页面将显示每个队列的以下摘要信息：您可以根据需要使用**首选项**工具调整表内容（请参阅表右上角的 ![\[Gear icon representing settings or configuration options.\]](http://docs.aws.amazon.com/zh_cn/gameliftservers/latest/developerguide/images/settings.png) 图标）。自定义首选项将保存到您的 AWS 账户用户，并在您查看此页面时自动应用。
+ **队列名称** – 为队列分配的名称。对新游戏会话的请求通过此名称指定队列。
+ **队列超时** – 游戏会话放置请求在超时前保留在队列中的最长时间（以秒为单位）。
+ **队列中的目标** – 队列配置中列出的实例集数量。Amazon GameLift Servers 会在队列中的任何实例集上放置新游戏会话。
**查看队列详细信息**
您可以访问任何队列的详细信息，包括队列配置和指标。要打开队列详细信息页面，请转到**队列**页面并选择队列名称。
队列详细信息页面显示一个摘要表以及包含附加信息的选项卡。在此页上，您可以执行以下操作：
+ 更新队列的配置、目标和玩家延迟策略的列表。选择**编辑**。
+ 删除队列 删除队列后，对引用该队列名称的新游戏会话的所有请求都将失败。选择**删除**。
**注意**
要恢复已删除的队列，请使用已删除队列的名称创建一个新队列。
**Details**
**概述**部分显示队列的 Amazon 资源名称 (**ARN**) 和**超时时间**。在 Amazon GameLift Servers 的其它操作或区域中引用队列时，您可以使用 ARN。队列超时 游戏会话放置请求在超时前保留在队列中的最长时间（以秒为单位）。
**事件通知**
**事件通知**部分列出了 Amazon GameLift Servers 向其发布事件通知的 **SNS 主题**以及添加到该队列创建的所有事件中的**事件数据**。
**标签**
**标签**表显示了用于标记资源的键和值。有关标记的更多信息，请参阅为资源[添加标签。 AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)
**指标**
**Metrics** 选项卡显示一段时间内队列指标的图表化表示。
队列指标包括一系列描述整个队列上的放置活动以及按区域细分的成功放置的信息。您可以使用区域数据来了解您的游戏托管位置。区域放置指标可以帮助发现整体队列设计中的问题。
Amazon 中也提供队列指标 CloudWatch。有关这些指标的说明，请参阅 [Amazon GameLift Servers 队列指标](monitoring-cloudwatch.md#gamelift-metrics-queue)。
**目标**
**Destinations** 选项卡显示为队列列出的所有实例集或别名。
当 Amazon GameLift Servers 搜索可用资源的目标以托管新游戏会话时，会按此处列出的默认顺序进行搜索。只要列出的第一个目标上有容量，Amazon GameLift Servers 就会将新游戏会话放置在那里。通过提供玩家延迟数据，您可以让个别游戏会话放置请求覆盖默认顺序。此数据告知 Amazon GameLift Servers 搜索平均玩家延迟最小的可用目标。有关更多信息，请参阅设计您的架构。
**会话放置**
用于自定义游戏放置流程的配置设置。
**玩家延迟策略**
**玩家延迟策略**部分显示队列使用的所有策略。下表将按照强制执行的顺序列出策略。
**位置**
“**位置**” 部分显示了此队列可以将游戏会话置于的位置。
**优先级**
“**优先级**” 部分显示队列评估游戏会话详细信息的顺序。
**位置顺序**
**位置顺序**部分显示队列在放置游戏会话时使用的默认顺序。如果您尚未定义其他类型的优先级，则队列将使用此顺序。
------
#### [ AWS SDK ]
使用以下 AWS CLI 命令检索有关此资源的信息：
+ [DescribeGameSessionQueues](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_DescribeGameSessionQueues.html)
------