

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon Stre GameLift ams 直播群组管理直播
<a name="stream-groups"></a>

设置 Amazon GameLift Streams 应用程序后，您就可以管理和部署计算资源来运行和流式传输您的应用程序了。Amazon *Stream GameLift s 直播组*代表这些计算资源的集合。您可以通过扩展流容量来指定要支持的最大并发流数量。

Amazon GameLift Streams 在您创建流组 AWS 区域 的地方分配计算资源。您还可以将远程位置添加到直播组并管理每个位置的容量。最佳做法是在地理位置靠近最终用户的地点举办直播会话。这有助于最大限度地减少延迟并提高直播质量。有关更多信息，请参阅[AWS 区域 以及 Amazon GameLift Streams 支持的直播地点](regions-quotas-rande.md)。

 在直播组中，您可以指定该流组可以 GameLift 流式传输的一个或多个 Amazon Streams 应用程序。单个应用程序可以位于多个流组中，因此您可以设置不同的配置或类型的计算资源来流式传输同一个应用程序。例如，要为流式传输应用程序提供两个图形质量的选项，您可以设置两个具有不同流类配置的流组，并将它们链接到同一个应用程序。

 相反，一个直播组可以有多个应用程序：可以在创建直播组时设置的*默认*应用程序，以及其他*关联的应用程序*。有关更多信息，请参阅[多应用程序流组概述](multi-apps.md)。

如何将直播组和应用程序关联在一起取决于您的用例，但关系可能如此 many-to-many。

应每 3-4 周重新创建直播组，以获取重要的服务更新和修复。有关更多信息，请参阅[直播群组生命周期](#stream-groups-lifecycle)。

## 关于直播容量
<a name="about-stream-capacity"></a>

您可以通过设置直播组的容量或直播容量来管理可以同时向最终用户传送的*直播*数量。直播容量表示直播组可以支持的并发流会话数量。它在每个位置都进行了配置。
+  **不间断容量：**如果此设置不为零，则表示分配给您的最小流式传输容量，该容量从不会释放回服务。无论是已用容量还是空闲容量，您始终都要为此基本容量水平付费。
+  **最大容量：**此容量表示服务可以为您分配的最大容量。新创建的流可能需要几分钟才能启动。容量在空闲时会被释放回服务。您需要为分配给您的容量付费，直到容量被释放。
+  **目标空闲容量：**此容量表示服务预先分配并保留的空闲容量，以备将来的活动需要。这有助于使您的用户免受容量分配延迟的影响。您需要为处于这种特意空闲状态的容量付费。

如果您的直播组在某个地点的最大容量设置为 100，则表示该直播组有足够的资源同时向该位置的 100 个最终用户进行流式传输。您可以随时在每个地点增加或减少直播容量（不超过您当前的配额金额），以满足用户需求的变化。

Amazon GameLift Streams 首先尝试使用已分配给您的空闲容量来满足新的会话请求。如果这样会导致空闲容量降至目标空闲容量以下，则会异步分配新容量。如果没有空闲容量可用，将暂停请求，同时按需分配新容量，直至流组的最大容量。如果已达到最大值但仍没有空闲容量可用，则会话请求将等待现有会话终止和释放容量。

当会话终止时，相应的容量会被标记为空闲。如果空闲容量超过目标空闲值，则多余的容量将被取消分配，并在短暂延迟后返回给服务。如果空闲容量使您的容量级别降至配置的最小值（可能为零）以下，则该服务将不会取消分配空闲容量。

在具有多租户流类别（每个计算资源可以流式传输超过 1 个会话）的流组中指定流容量时，容量必须是租户的倍数。例如，`gen6n_high`流类的多租户为 2。这意味着在您的流组中分配的每个计算资源都可以流式传输到 2 个客户端。因此，您请求的容量必须是 2 的倍数。

扩容量反映在直播组的总成本中。确保您设置账单提醒以管理您的 Amazon GameLift Streams 费用。请参考[创建账单提醒以监控使用情况](pricing.md#pricing-billing-alerts)。

要更改直播组容量，请编辑您的直播组设置，然后为容量设置输入新的值。当您更改永远在线的容量时，Amazon GameLift Streams 会通过配置新资源或关闭现有资源来调整分配的资源以匹配新值。如果资源不能立即可用，增加永远在线的容量可能需要几分钟以上的时间。减少永远在线的容量需要几分钟才能取消配置已分配的资源。

### 示例：直播容量配置
<a name="capacity-configuration-examples"></a>

以下示例演示了不同用例的常见流容量配置：

1. **注重成本的开发阶段：**您是一名想要节省成本的开发人员。你设置 `Minimum (always-on) capacity` = 0、`Maximum capacity` = 10 和 `Target Idle (pre-warmed) capacity` = 1。这样至少可以保留一个会话以便快速启动。

1. **具有固定需求的计划活动：**对于已知需求的计划活动，您希望快速启动会话。你设置 `Minimum (always-on) capacity` = 200、`Maximum capacity` = 200 和 `Target Idle (pre-warmed) capacity` = 0。您只需为 200 个容量付费。由于需求已知，因此不会发生扩展延迟。

1. **具有突发容量的大型活动：**您计划在高峰时段每分钟为 1,000 名用户提供 100 个新会话。你设置 `Minimum` = 0、`Maximum` = 1,000 和 `Target Idle` = 100。这样可以在闲置时节省资金。这样可以保持至少 100 个会话可供快速启动。

**注意**  
不推荐使用`OnDemandCapacity`输入参数。通过 API 配置容量时，请`MaximumCapacity`改为使用。

## 容量和服务配额
<a name="capacity-and-service-quotas"></a>

Amazon GameLift Streams 的使用受服务配额的限制，该配额限制了您可以在账户中为流媒体配置的总数 GPUs（计算资源）。可以在 GameLift 直播的服务配额控制台中查看默认配额和配额利用率。了解这些配额如何与流媒体容量交互有助于您规划流媒体基础架构并避免容量限制。

更具体地说，GPU 服务配额指定了 GPUs 您账户中所有直播组中每个位置可以请求的特定直播类别系列的最大数量。例如，如果您的账户限制为 5 `gen6n` GPUs 英寸`us-west-2`，则为所有直播组提供总直播容量`gen6n` GPUs 所需的总和必须小于或等于 5。`us-west-2`这包括 GPUs 永久在线和按需容量。

 Amazon GameLift Streams 根据分配的 GPU 总量来衡量您的服务配额。请务必记住，某些流类（例如`gen6n_high`或`gen6n_small`）在并发会话之间共享 GPU。其他流媒体类，例如和在每个`gen6n_ultra`并发会话中`gen6n_ultra_win2022`使用一个完整的 GPU。因此，在`gen6n_ultra`直播组中， GPUs 可以 MaximumCapacity 将 10 分配为 10，或者在 MaximumCapacity `gen6n_medium`直播类上分配 40。

### 示例：配额如何影响容量
<a name="quota-capacity-example"></a>

以下示例演示了服务配额如何与跨多个直播组和位置的直播容量交互。在此示例中，假设您的账户`gen6n` GPUs 每个地点的配额为 10。

1. **创建单租户直播组：**使用直播类创建直播组，总容量为 5（始终开启加点`gen6n_ultra`播）。`us-east-2`由于此流类具有 1:1 的租期（每个 GPU 1 个数据流），因此总容量需要 5 GPUs 比 5。这就剩下了 5 GPUs 个`us-east-2`。

1. **创建多租户直播组：**使用总容量为 6 的`gen6n_high`直播类创建另一个直播组。`us-east-2`由于此流类具有 1:2 的租期（每个 GPU 2 个数据流），因此总容量只 GPUs 需 3 个，即可获得 6 个。这就剩下了 2 GPUs 个`us-east-2`。

1. **在其他位置添加容量：**创建这些直播组后，还有 2 个可用`us-east-2`， GPUs 但在其他位置（例如`us-west-2`或）仍有 10 个 GPUs 可用容量`eu-west-1`。您可以将这些位置添加到之前创建的直播组中，也可以创建具有这些位置的新直播组。

此示例显示，配额是按位置和所有直播组强制执行的，这样您就可以在多个地理区域分配直播容量，同时保持在服务限制范围内。

**注意**  
通过选择 GameLift 直播作为服务，您可以在 Service Quotas 控制台中查看您的应用账户级别或默认配额，包括这些配额的 AWS 利用率。有关更多信息，请参阅 [Amazon GameLift Streams 服务配额](quotas.md)。

## 关于地点
<a name="about-hosting-locations"></a>

 该位置是 Amazon GameLift Streams 分配计算资源以托管您的应用程序并向用户直播的地方。为了降低延迟和提高质量，您应该选择离用户更近的地点。默认情况下，您可以从创建直播群组 AWS 区域 的地点（即*主位置*）进行直播。此外，直播组可以将其覆盖范围扩展到从其他受支持的地点（称为*远程位置*）进行直播。

 有关受支持位置的完整列表，请参阅[AWS 区域 和直播地点](regions-quotas-rande.md)。

**多地点直播组**  
 一种直播组，除了主位置（您创建直播组的位置）外，还配置为从多个位置托管应用程序和流式传输会话。 AWS 区域 您可以管理每个地点的容量。

## 创建直播组
<a name="stream-groups-create"></a>

------
#### [ Console ]

**在 Amazon Stream GameLift s 控制台中创建直播组**

1.  登录 AWS 管理控制台 并打开 [Amazon GameLift Streams 控制台](https://console.aws.amazon.com/gameliftstreams/)。选择要在 AWS 区域 哪里创建直播群组。此区域必须与您要通过直播组进行流式传输的应用程序的区域相同。有关更多信息，请参阅《*AWS 管理控制台 入门指南*》中的[选择区域](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/select-region.html)。

1.  要打开创建工作流程，请在导航窗格中选择**直播组**，然后选择**创建直播组**。

1. 在**定义直播组**中，输入以下内容：

   1. **描述**

       流组的用户可读标签。此值不必具有唯一性。作为最佳实践，请为流组使用有意义的描述、名称或标签。您可以随时编辑此字段。

   1. **标签**

       标签是可以帮助您整理 AWS 资源的标签。有关更多信息，请参阅[为 AWS 资源添加标签](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html)。

1.  在**选择直播类**中，为直播组选择一个直播类。

   1. **直播类选项**

      用于运行和流式传输应用程序的计算资源类型。这一选择会影响流式传输体验的质量以及成本。您只能为每个流组指定一个流类。选择最适合您的应用的课程。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/gameliftstreams/latest/developerguide/stream-groups.html)

   要继续，请选择 **Next**。

1.  在 “**链接应用程序**” 中，选择要流式传输的应用程序，或者选择 “**无应用程序**” 稍后再选择。创建直播组后，您可以对其进行编辑，以添加或删除应用程序。您只能链接处于`Ready`状态且运行时与您选择的流类兼容的应用程序。默认情况下，表中仅显示这些应用程序。要查看所有处于`Ready`状态的应用程序，请在下拉列表`All runtimes`中选择。
**注意**  
 如果未列出您的应用程序，请检查当前 AWS 区域 设置。您只能将应用程序链接到位于同一区域的直播组。

    要继续，请选择 **Next**。

1.  在 “**配置直播设置” 中的 “****位置和容量**” 下，选择一个或多个您的直播组将有能力流式传输应用程序的位置。默认情况下，您创建直播组的区域（称为*主位置*）已添加到您的直播组中，无法删除。您可以通过选中要添加的每个位置旁边的复选框来添加其他地点。为了降低延迟和提高直播质量，您应该选择离用户更近的地点。

    您可以为每个位置指定其*流媒体容量*。流容量表示一次可以激活的并发流的数量。您可以设置每个流组中每个位置的流容量。
   +  **不间断容量：**如果此设置不为零，则表示分配给您的最小流式传输容量，该容量从不会释放回服务。无论是已用容量还是空闲容量，您始终都要为此基本容量水平付费。
   +  **最大容量：**此容量表示服务可以为您分配的最大容量。新创建的流可能需要几分钟才能启动。容量在空闲时会被释放回服务。您需要为分配给您的容量付费，直到容量被释放。
   +  **目标空闲容量：**此容量表示服务预先分配并保留的空闲容量，以备将来的活动需要。这有助于使您的用户免受容量分配延迟的影响。您需要为处于这种特意空闲状态的容量付费。

    您可以随时通过调整任一容量来增加或减少总直播容量，以满足用户对某个位置的需求的变化。Amazon GameLift Streams 使用常开容量池中预先分配的闲置资源（如果有）来满足流媒体请求。如果所有始终开启的容量都在使用中，Amazon GameLift Streams 将预配置额外的计算资源，但不得超过按需容量中指定的最大数量。随着分配容量的扩展，这一变化将反映在流组的总成本中。

    关联的应用程序将自动复制到每个启用的位置。应用程序必须在远程位置完成复制，然后远程位置才能托管视频流。要检查复制状态，请在创建流组后将其打开，并参考链接应用程序表中的**复制状态**列。单击当前状态可查看每个已添加位置的复制状态。
**注意**  
 应用程序数据将存储在所有已启用的位置，包括该直播组的主位置。直播会话数据将存储在主位置和直播发生的地点。

1.  在**查看并创建直播组**中，验证您的直播组配置并根据需要进行更改。一切都正确后，选择**创建直播组**。

------
#### [ CLI ]

**先决条件**

 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。

**要使用创建直播组 AWS CLI**

 在您 AWS CLI 使用针对您的内容自定义的[CreateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_CreateStreamGroup.html)命令时。

```
aws gameliftstreams create-stream-group \
    --description "Test_gen4_high" \
    --default-application-identifier arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6 \
    --stream-class gen4n_high \
    --location-configurations '[{"LocationName": "us-east-1", "AlwaysOnCapacity": 2, "MaximumCapacity": 6, "TargetIdleCapacity": 1}]'
```

where

`description`:  
 流组的用户可读标签。此值不必具有唯一性。作为最佳实践，请为流组使用有意义的描述、名称或标签。您可以随时编辑此字段。

`default-application-identifier`  
 分配给 [Amazon GameLift Streams 应用程序资源的亚马逊资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 值或编号。应用程序必须处于`READY`状态。  
ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6`  
身份证示例：`a-9ZY8X7Wv6`

`stream-class`    
**直播类选项**  
用于运行和流式传输应用程序的计算资源类型。这一选择会影响流式传输体验的质量以及成本。您只能为每个流组指定一个流类。选择最适合您的应用的课程。      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/gameliftstreams/latest/developerguide/stream-groups.html)

`location-configurations`  
要添加到此直播组的一组位置及其容量。默认情况下，如果未指定容量，Amazon GameLift Streams 将仅分配足够的常开直播容量，以便在创建直播组的位置启动一个直播。有关 Amazon GameLift Streams 支持的地点的完整列表，请参阅[AWS 区域 以及 Amazon GameLift Streams 支持的直播地点](regions-quotas-rande.md)。  
容量值必须是流组流类租用值的整数倍。

 如果请求成功，Amazon GameLift Streams 将返回类似于以下内容的响应：

```
{
    "Arn": "arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4",
    "Description": "Test_gen4_high",
    "DefaultApplication": {
        "Id": "a-9ZY8X7Wv6"
    },
    "StreamClass": "gen4n_high",
    "Id": "sg-1AB2C3De4",
    "Status": "ACTIVATING",
    "LastUpdatedAt": "2024-11-18T15:49:01.482000-08:00",
    "CreatedAt": "2024-11-18T15:49:01.482000-08:00"
}
```

------

 Amazon GameLift Streams 开始搜索未分配的计算资源，并为新的直播组配置这些资源，这可能需要几分钟。在此期间，新的直播组处于 “**激活**” 状态。

 当直播组的状态为 “**活动**” 时，您可以调整其容量。有关更多信息，请参阅[编辑容量](#stream-groups-edit-capacity)。

 当直播组处于 A **ctiv** e 状态时，它就可以部署流媒体资源了。要开始流式传输，请参阅[使用 Amazon Streams 开始 GameLift 直播会话](stream-sessions.md)。

## 编辑常规设置
<a name="stream-groups-edit-general"></a>

 Amazon Stre GameLift ams 在控制台的**直播组设置下将以下设置**组合在一起：**状态**、**直播组 ID**、**描述**、**直播组 ARN** 和**直播**类别。其中，你唯一可以在不创建新直播组的情况下更新的是**描述**。

------
#### [ Console ]

1. 登录 AWS 管理控制台 并打开 [Amazon GameLift Streams 控制台](https://console.aws.amazon.com/gameliftstreams/)。

1. 在导航栏中，选择**直播群组**以查看现有直播组的列表。选择要编辑的直播组。

1. 在直播组详细信息页面中，选择**编辑设置**。

1. 要更新描述，请输入新值。

------
#### [ CLI ]

**先决条件**

 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。

**要使用编辑直播组的描述 AWS CLI**

 在您 AWS CLI 使用针对您的内容自定义的[UpdateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html)命令时。

```
aws gameliftstreams update-stream-group \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --description "MyGame - Ultra"
```

where

`identifier`  
 唯一标识直播组[资源的亚马逊资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。  
ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`  
身份证示例：`sg-1AB2C3De4`

`description`  
 流组的用户可读标签。此值不必具有唯一性。作为最佳实践，请为流组使用有意义的描述、名称或标签。您可以随时编辑此字段。

------

## 编辑容量
<a name="stream-groups-edit-capacity"></a>

通过调整每个位置的容量来扩展直播群组。

 请参阅[Amazon GameLift Streams 服务配额](quotas.md)，详细了解每个 AWS 账户位置的直播组容量配额以及如何提高这些配额。

------
#### [ Console ]

1. 登录 AWS 管理控制台 并打开 [Amazon GameLift Streams 控制台](https://console.aws.amazon.com/gameliftstreams/)。

1. 在导航栏中，选择**直播群组**以查看现有直播组的列表。选择要编辑的直播组。

1. 在直播组详细信息页面中，选择**编辑配置**。

1. 对于每个位置，请在表的相关单元格中输入新的常开容量、最大容量和目标空闲容量值。容量值必须是流组流类租用值的整数倍。

   如果您将始终开启的容量值设置为零，则直播组将不会为直播分配任何主机。

------
#### [ CLI ]

**先决条件**

 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。

**要编辑直播容量，请使用 AWS CLI**

 在您 AWS CLI 使用针对您的内容自定义的[UpdateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html)命令时。

```
aws gameliftstreams update-stream-group \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --location-configurations '[{"LocationName": "us-east-1", "AlwaysOnCapacity": 4, "MaximumCapacity": 8}, \ 
        {"LocationName": "ap-northeast-1", "AlwaysOnCapacity": 0, "MaximumCapacity": 2, "TargetIdleCapacity": 1}]'
```

where

`identifier`  
 唯一标识直播组[资源的亚马逊资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。  
ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`  
身份证示例：`sg-1AB2C3De4`

`location-configurations`  
此直播组中需要使用其新容量更新的一组位置。容量值必须是流组流类租用值的整数倍。

------

 当您更新直播组位置的容量时，Amazon GameLift Streams 将开始处理您的请求，这可能需要一些时间。在此期间，Amazon GameLift Streams 会根据需要在直播组中分配或释放资源，以满足您设置的所需永不间断直播容量。您可以通过查看 Amazon Stream GameLift s 控制台中的**直播组详情**页面或调用 [GetStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html)API 来查看直播容量的配置状态。

 当您的直播组处于 “**活动” 状态**、具有可用的直播容量并且应用程序已完成复制到您要直播的位置时，您可以开始流式传输。有关更多信息，请参阅[使用 Amazon Streams 开始 GameLift 直播会话](stream-sessions.md)。

## 容量缩小行为
<a name="stream-group-scaling-behavior"></a>

 当您缩减容量时，Amazon GameLift Streams 会等到主机处于空闲状态后再将其释放。由于一台主机可以支持 1 或 2 个会话，因此只有当主机上的所有活动会话都结束时，主机才处于空闲状态。当用户结束会话或会话超时时，直播会话即告结束。因此，在允许现有会话达到最大可能持续时间的极端情况下，可能需要长达 24 小时才能达到所需的容量。如果您想强制结束直播组中的所有活跃直播会话，可以在控制台中或使用 [DeleteStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DeleteStreamGroup.html)API 删除该直播组，也可以使用 [TerminateStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_TerminateStreamSession.html)API 逐一结束活动会话。

## 在直播群组中添加地点
<a name="stream-groups-add-locations"></a>

------
#### [ Console ]

**使用 Amazon Streams 控制台向 GameLift 直播组添加位置**

1.  在导航栏中，选择**直播群组**以查看现有直播组的列表。选择要向其添加新位置的直播组。

1. 在**直播组详细信息**页面中，选择**编辑配置**。

1.  选中要添加到此直播组的位置旁边的复选框，然后设置其容量。

1.  查看所选位置的摘要，包括直播容量成本。选择 “**保存**” 以确认您的选择。

------
#### [ CLI ]

**先决条件**

 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。

 **要将位置添加到直播组中，请使用 AWS CLI** 

 在您 AWS CLI 使用针对您的内容自定义的[AddStreamGroupLocations](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_AddStreamGroupLocations.html)命令时。

```
aws gameliftstreams add-stream-group-locations \ 
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4
    --location-configurations '[{"LocationName": "us-east-1", "AlwaysOnCapacity": 2, "MaximumCapacity": 4, "TargetIdleCapacity": 1}]'
```

where

`identifier`  
 唯一标识直播组[资源的亚马逊资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。  
ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`  
身份证示例：`sg-1AB2C3De4`

`location-configurations`  
要添加到此直播组的一组位置及其容量。有关 Amazon GameLift Streams 支持的地点的完整列表，请参阅[AWS 区域 以及 Amazon GameLift Streams 支持的直播地点](regions-quotas-rande.md)。  
容量值必须是流组流类租用值的整数倍。

------

 当您的应用程序完成向新位置的复制并且您的直播组具有可用的流容量时，您可以从新位置开始流式传输。有关直播的更多信息，请参阅[使用 Amazon Streams 开始 GameLift 直播会话](stream-sessions.md)。Amazon GameLift Streams 将开始处理您的请求。在此期间，Amazon GameLift Streams 会努力复制您的应用程序并在新的位置分配计算资源。通过单击 “复制状态” 列中的状态，可以从**流组详细信息**页面的 “**关联应用程序**” 部分查看**复制状态**。

## 移除直播群组中的位置
<a name="stream-groups-delete-locations"></a>

 要停止使用来自特定位置的计算资源，您可以将这些位置从直播组中移除。您无法移除直播组的主要位置。但是，如果您不希望在该位置使用计算资源，则可以将流容量设置为零。

**警告**  
 当您移除直播组中的某个位置时，Amazon Stre GameLift ams 会断开该位置的活动直播的连接，从而停止所有已连接的最终用户的直播。

------
#### [ Console ]

**使用 Amazon GameLift Streams 控制台从直播组中移除位置**

1. 在导航窗格中，选择**直播群组**以查看现有直播组的列表。

1. 选择要从中移除位置的直播组的名称。

1. 在**直播组详细信息**页面中，选择**编辑配置**。

1. 取消选中要删除的地点名称旁边的复选框。

1. 选择**保存**。

------
#### [ CLI ]

**先决条件**

 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。

 **要从直播组中移除位置，请使用 AWS CLI** 

 在您 AWS CLI 使用针对您的内容自定义的[RemoveStreamGroupLocations](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_RemoveStreamGroupLocations.html)命令时。

```
aws gameliftstreams remove-stream-group-locations \ 
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4
    --locations us-east-1 eu-central-1
```

where

`identifier`  
 唯一标识直播组[资源的亚马逊资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。  
ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`  
身份证示例：`sg-1AB2C3De4`

`locations`  
 要从该直播组中移除的一组位置。有关 Amazon GameLift Streams 支持的地点的完整列表，请参阅[AWS 区域 以及 Amazon GameLift Streams 支持的直播地点](regions-quotas-rande.md)。

------

## 删除直播组
<a name="stream-groups-delete"></a>

您可以删除处于任何状态的直播组。此操作将永久删除直播组并释放其计算资源。如果有直播正在处理中，则此操作会停止直播，您的最终用户将无法再查看该直播。

作为最佳实践，在删除直播组之前，请检查是否有正在处理的直播并采取措施将其停止。

------
#### [ Console ]

**使用 Amazon Streams 控制台删除 GameLift 直播组**

1.  登录 AWS 管理控制台 并打开 [Amazon GameLift Streams 控制台](https://console.aws.amazon.com/gameliftstreams/)。

1.  要查看现有直播组的列表，请在导航窗格中选择**直播组**。

1.  选择要删除的直播组的名称。

1.  在直播组详情页面上，选择**删除**。

1.  在 “**删除**” 对话框中，确认删除操作。

------
#### [ CLI ]

**先决条件**

 您必须 AWS CLI 使用您的用户凭据和您选择的凭据进行配置 AWS 区域。有关设置说明，请参阅[下载 AWS CLI](setting-up.md#setting-up-prereqs)。

 **要删除您的直播群组，请使用 AWS CLI** 

 在您 AWS CLI 使用针对您的内容自定义的[DeleteStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DeleteStreamGroup.html)命令时。

```
aws gameliftstreams delete-stream-group \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4
```

 where 

`identifier`  
 唯一标识直播组[资源的亚马逊资源名称 (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。  
ARN 示例：`arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`  
身份证示例：`sg-1AB2C3De4`

------

 Amazon GameLift Streams 开始释放计算资源并删除直播组。在此期间，直播组处于 “**删除**” 状态。Amazon Stream GameLift s 删除直播组后，您将无法再对其进行检索。

## 链接的应用程序
<a name="stream-groups-linking"></a>

 如果您想使用相同的计算资源池流化多个应用程序，则可以将多个应用程序链接到同一个流组。同样，如果您想使用不同的计算资源集对应用程序进行流式传输，则可以将一个应用程序链接到多个流组。

 有关将应用程序链接到直播组的更多信息，请参阅[多应用程序流组概述](multi-apps.md)。

## 直播群组生命周期
<a name="stream-groups-lifecycle"></a>

 直播群组的最长使用寿命为 365 天。作为最佳实践，我们建议您每 3-4 周重新创建直播组，以接收重要的服务更新和修复并确保最佳性能。重新创建直播组不会影响您上传的应用程序。

 随着直播群组年龄的增长，以下限制适用：
+ **180 天后**：您无法再使用新的应用程序关联更新直播组
+ **365 天**：直播组已过期，无法再直播会话

与直播群组关联的账户将收到两条提醒通知 AWS Health：一条在 45 天，另一条在 150 天提醒。这些通知将提醒您，应用程序关联功能将在 180 天后丢失。335天还会有最后一条通知，提醒您直播群组将在365天到期。维护警告还会显示在 AWS Health 控制面板和 Amazon Stream GameLift s 控制台的直播群组页面上。

 要查找直播组的到期日期，请在控制台上查看**直播组详细信息**页面，或使用 [GetStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html)API 响应中的`ExpiresAt`字段。

 已过期的直播组的状态为`EXPIRED`并变为只读。您无法对其进行更新或开始新的直播会话。要重新获得功能，请重新创建直播组。

## 直播群组维护
<a name="stream-groups-maintenance"></a>

 每当发布需要新的直播组才能使用的功能时，您都会在直播组的详情页面顶部看到 “需要维护” 消息，告知您该功能已过时。重新创建直播组是一个手动过程，但为了帮助您完成此操作，请使用消息中的**创建直播组**按钮开始该过程。将会为您填写某些字段。

 当流组存在时间超过 180 天时，还需要维护流组。在重新创建流组之前，您将无法再将新的应用程序与这些旧流组关联。365 天后，将无法从流组进行流式传输，也不容许对流组进行任何更改。