本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 Amazon GameLift Streams 串流群組管理串流 設定 Amazon GameLift Streams 應用程式之後，您就可以管理和部署運算資源，以執行和串流您的應用程式。Amazon GameLift Streams *串流群組*代表這些運算資源的集合。您可以透過擴展串流容量來指定要支援的並行串流數量上限。 Amazon GameLift Streams 會在您建立串流群組 AWS 區域 的 中配置運算資源。您也可以將遠端位置新增至串流群組，並管理每個位置的容量。最佳實務是在地理位置接近最終使用者的位置託管串流工作階段。這有助於將延遲降至最低並改善串流品質。如需詳細資訊，請參閱 [AWS 區域 Amazon GameLift Streams 支援的 和 串流位置](regions-quotas-rande.md)。 在串流群組中，您可以指定串流群組可以串流的一或多個 Amazon GameLift Streams 應用程式。單一應用程式可以位於多個串流群組中，因此您可以設定不同的組態或運算資源類型，以串流相同的應用程式。例如，若要提供兩個用於串流應用程式的圖形品質選項，您可以使用不同的串流類別組態設定兩個串流群組，並將其連結至相同的應用程式。 相反地，單一串流群組可以有多個應用程式：*預設應用程式*，您可以在建立串流群組時加以設定，以及其他*連結的應用程式*。如需詳細資訊，請參閱 [多應用程式串流群組概觀](multi-apps.md)。 將串流群組和應用程式關聯的方式取決於您的使用案例，但關係可以是many-to-many。 串流群組應每 3-4 週重新建立一次，以取得重要的服務更新和修正。如需詳細資訊，請參閱 [串流群組生命週期](#stream-groups-lifecycle)。 ## 關於串流容量 您可以透過設定串流群組的容量或串流容量，來管理您可以同時交付給最終使用者的*串流*數量。串流容量代表串流群組可支援的並行串流工作階段數量。它會在每個位置設定。 + **永遠啟用容量：**此設定 (若不是零) 表示分配給您的最小串流容量，且絕不會釋出供服務收回。您一律需支付此基本容量層級的費用，無論已使用或閒置。 + **最大容量：**這表示服務可分配給您的最大容量。新建立的串流可能需要幾分鐘才能開始。容量會在閒置時釋出供服務收回。您須支付分配給您的容量，直到釋出為止。 + **目標閒置容量：**這是指在預期未來活動的情況下，服務預先分配並為您保留的閒置容量。這有助於隔離您的使用者，避免容量分配延遲。您須支付此刻意閒置狀態下保留的容量。 如果您在某個位置有一個最大容量設定為 100 的串流群組，這表示串流群組有足夠的資源在該位置同時串流到 100 個最終使用者。您可以隨時增加或減少每個位置的串流容量 （最高您目前的配額），以滿足使用者需求的變更。 Amazon GameLift Streams 會先嘗試使用已分配給您的閒置容量來滿足新的工作階段請求。如果這會導致閒置容量低於目標閒置容量，則會以非同步方式分配新容量。如果沒有閒置容量可用，則會暫停請求並隨需分配新容量，上限為串流群組的最大容量。如果達到上限，但仍然沒有可用的閒置容量，則工作階段請求會等待現有工作階段終止並釋出容量。 工作階段終止時，對應的容量就會標示為閒置。如果閒置容量大於目標閒置值，則多餘的容量會在短暫延遲後解除分配並退還給服務。若解除分配閒置容量會導致您的容量層級降至低於設定的最小值 (可能為零)，則服務不會解除分配該容量。 在具有多租用戶串流類別 （每個運算資源可以串流超過 1 個工作階段） 的串流群組中指定串流容量時，容量必須是租用的倍數。例如，`gen6n_high`串流類別的多租用戶為 2。這表示在串流群組中配置的每個運算資源都可以串流到 2 個用戶端。因此，您請求的容量必須是 2 的倍數。 擴展容量會反映在串流群組的總成本中。請確定您已設定帳單提醒來管理 Amazon GameLift Streams 成本。請參閱[建立帳單提醒以監控用量](pricing.md#pricing-billing-alerts)。 若要變更串流群組容量，請編輯串流群組設定，然後輸入容量設定的新值。當您變更永遠開啟的容量時，Amazon GameLift Streams 會透過佈建新資源或關閉現有資源，來調整配置的資源以符合新值。如果資源無法立即使用，則增加永遠開啟容量可能需要幾分鐘以上。減少永遠開啟容量需要幾分鐘的時間來取消佈建配置的資源。 ### 範例：串流容量組態 下列範例示範適用於不同使用案例的常見串流容量組態： 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`改用 。 ## 容量和服務配額 Amazon GameLift Streams 的使用受限於服務配額，這些配額會限制您可以為帳戶中串流設定的 GPUs （運算資源） 總數。您可以在 GameLift Streams 的服務配額主控台中檢視預設配額和配額使用率。了解這些配額如何與串流容量互動，可協助您規劃串流基礎設施並避免容量限制。 更具體地說，GPU 服務配額指定特定串流類別系列的 GPUs 數量上限，您可以在帳戶中所有串流群組的每個位置請求。例如，如果您的帳戶在 中有 5 個 `gen6n` GPUs 的限制`us-west-2`，`us-west-2`則提供所有串流群組在 中總串流容量所需的 `gen6n` GPUs 總和必須小於或等於 5。這包括永遠在線和隨需容量的 GPUs。 Amazon GameLift Streams 會根據配置的 GPU 總計來測量您的服務配額。請務必記住，某些串流類別 （例如 `gen6n_high`或 `gen6n_small`) 會在並行工作階段之間共用 GPU。其他串流類別，例如 `gen6n_ultra`和 每個並行工作階段`gen6n_ultra_win2022`使用一個完整的 GPU。因此，`gen6n_ultra`串流群組上的 10 GPUs 可以配置為 MaximumCapacity 10，`gen6n_medium`串流類別上的 MaximumCapacity 40。 ### 範例：配額如何影響容量 下列範例示範服務配額如何跨多個串流群組和位置與串流容量互動。在此範例中，假設您的帳戶具有每個位置 10 個 `gen6n` GPUs 的配額。 1. **建立單一租用戶串流群組：**您使用 中的串流類別建立`gen6n_ultra`串流群組，總容量為 5 個 （一律隨需）`us-east-2`。由於此串流類別具有 1：1 租用 （每個 GPU 1 個串流），因此您需要 5 個 GPUs 的總容量。這可讓您在 中剩餘 5 個 GPUs`us-east-2`。 1. **建立多租用戶串流群組：**您使用 中總容量為 6 的`gen6n_high`串流類別建立另一個串流群組`us-east-2`。由於此串流類別具有 1：2 租用 （每個 GPU 2 個串流），因此您只需要 3 個 GPUs，總共 6 個容量。這可讓您在 中剩餘 2 個 GPUs`us-east-2`。 1. **在其他位置新增容量：**建立這些串流群組後，您在 中剩餘 2 個 GPUs`us-east-2`，但您在 `us-west-2`或 等其他位置仍有 10 個 GPUs`eu-west-1`。您可以將這些位置新增至您先前建立的其中一個串流群組，或建立具有這些位置的新串流群組。 此範例顯示每個位置和所有串流群組都會強制執行配額，可讓您將串流容量分散到多個地理區域，同時保持在服務限制內。 **注意** 您可以選取 GameLift Streams 做為 AWS 服務，在 Service Quotas 主控台中檢視您的已套用帳戶層級或預設配額，包括這些配額的使用率。如需詳細資訊，請參閱[Amazon GameLift Streams 服務配額](quotas.md)。 ## 關於位置 位置是 Amazon GameLift Streams 配置運算資源的位置，以託管您的應用程式並串流給使用者。為了降低延遲和提高品質，您應該選擇更接近使用者的位置。根據預設，您可以從您建立串流群組 AWS 區域 的 進行串流，稱為*主要位置*。此外，串流群組可以擴展其涵蓋範圍，以從其他支援的位置串流，稱為*遠端位置*。 如需支援位置的完整清單，請參閱 [AWS 區域 和 串流位置](regions-quotas-rande.md)。 **多位置串流群組** 除了主要位置 （您建立串流群組 AWS 區域 的位置） 之外，已設定為從多個位置託管應用程式和串流工作階段的串流群組。您可以管理每個位置的容量。 ## 建立串流群組 ------ #### [ Console ] **在 Amazon GameLift Streams 主控台中建立串流群組** 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. **Description** 可供人閱讀的串流群組標籤。此值不需是唯一的。建議依照最佳實務使用有意義的串流群組描述、名稱或標籤。您隨時可編輯此欄位。 1. **Tags** (標籤) 標籤是可協助您組織 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_tw/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 應用程式資源的 Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 值或 ID。 GameLift 應用程式必須處於 `READY` 狀態。 ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6` ID 範例： `a-9ZY8X7Wv6` `stream-class` **串流類別選項** 執行和串流應用程式的運算資源類型。此選項會影響串流體驗的品質和成本。您只能為每個串流群組指定一個串流類別。選擇最適合您應用程式的類別。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/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)。 當串流群組處於**作用中**狀態時，就可以部署資源以進行串流。若要開始串流，請參閱 [使用 Amazon GameLift Streams 啟動串流工作階段](stream-sessions.md)。 ## 編輯一般設定 Amazon GameLift Streams 會在主控台的**串流群組設定下將下列設定**分組在一起：**狀態**、**串流群組 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` 可唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。 ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 範例： `sg-1AB2C3De4` `description` 可供人閱讀的串流群組標籤。此值不需是唯一的。建議依照最佳實務使用有意義的串流群組描述、名稱或標籤。您隨時可編輯此欄位。 ------ ## 編輯容量 透過調整每個位置的容量來擴展串流群組。 請參閱 [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` 可唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。 ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 範例： `sg-1AB2C3De4` `location-configurations` 此串流群組中要更新及其新容量的一組位置。容量的值必須是串流群組串流類別租用值的整數倍。 ------ 當您更新串流群組位置的容量時，Amazon GameLift Streams 會開始處理您的請求，這可能需要一些時間。在此期間，Amazon GameLift Streams 會視需要配置或釋出串流群組中的資源，以符合您設定的所需全年無休串流容量。您可以在 Amazon GameLift Streams 主控台中檢視**串流群組詳細資訊**頁面，或呼叫 [GetStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html) API，以檢視串流容量的佈建狀態。 當您的串流群組處於**作用中**狀態、有可用的串流容量，且應用程式已完成複寫至您要串流的位置時，您可以開始串流。如需詳細資訊，請參閱 [使用 Amazon GameLift Streams 啟動串流工作階段](stream-sessions.md)。 ## 容量縮減行為 當您縮減容量時，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 一次結束一個作用中工作階段。 ## 在串流群組中新增位置 ------ #### [ Console ] **使用 Amazon GameLift Streams 主控台將位置新增至串流群組** 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` 唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。 ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 範例： `sg-1AB2C3De4` `location-configurations` 要新增至此串流群組的一組位置及其容量。如需 Amazon GameLift Streams 支援的完整位置清單，請參閱 [AWS 區域 Amazon GameLift Streams 支援的 和 串流位置](regions-quotas-rande.md)。 容量的值必須是串流群組串流類別租用值的整數倍數。 ------ 當您的應用程式完成複寫至新位置 （多個） 且串流群組有可用的串流容量時，您可以從新位置開始串流 （多個）。如需串流的詳細資訊，請參閱 [使用 Amazon GameLift Streams 啟動串流工作階段](stream-sessions.md)。Amazon GameLift Streams 將開始處理您的請求。在此期間，Amazon GameLift Streams 會複寫您的應用程式，並在新位置配置運算資源。您可以按一下複寫狀態欄中的狀態，從**串流群組詳細資訊**頁面**的連結應用程式**區段檢視**複寫狀態**。 ## 移除串流群組中的位置 若要停止使用特定位置的運算資源，您可以從串流群組中移除位置。您無法移除串流群組的主要位置。不過，如果您不希望在該位置運算資源，則可以將串流容量設定為零。 **警告** 當您移除串流群組中的位置時，Amazon GameLift Streams 會中斷該位置中的作用中串流，以停止任何已連線最終使用者的串流。 ------ #### [ 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` 可唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。 ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 範例： `sg-1AB2C3De4` `locations` 要從此串流群組中移除的一組位置。如需 Amazon GameLift Streams 支援的完整位置清單，請參閱 [AWS 區域 Amazon GameLift Streams 支援的 和 串流位置](regions-quotas-rande.md)。 ------ ## 刪除串流群組 您可以刪除處於任何狀態的串流群組。此動作會永久刪除串流群組並釋出其運算資源。如果有進行中的串流，則此動作會停止它們，而且您的最終使用者無法再檢視串流。 最佳實務是，在刪除串流群組之前，請檢查進行中串流，並採取步驟來停止它們。 ------ #### [ Console ] **使用 Amazon GameLift Streams 主控台刪除串流群組** 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` 可唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。 ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4` ID 範例： `sg-1AB2C3De4` ------ Amazon GameLift Streams 會開始釋出運算資源並刪除串流群組。在此期間，串流群組處於**刪除**狀態。Amazon GameLift Streams 刪除串流群組後，您就無法再擷取它。 ## 已連結的應用程式 如果您想要使用相同的運算資源集區串流多個應用程式，則可以將多個應用程式連結至相同的串流群組。同樣地，如果您想要使用不同的運算資源集串流應用程式，則可以將應用程式連結至多個串流群組。 如需將應用程式連結至串流群組的詳細資訊，請參閱 [多應用程式串流群組概觀](multi-apps.md)。 ## 串流群組生命週期 串流群組的生命週期上限為 365 天。最佳實務是建議您每 3-4 週重新建立串流群組，以接收重要的服務更新和修正，並確保最佳效能。重新建立串流群組不會影響您上傳的應用程式。 當串流群組存留期時，適用下列限制： + **在 180 天**：您無法再使用新的應用程式關聯更新串流群組 + **在 365 天**：串流群組過期且無法再串流工作階段 與串流群組相關聯的帳戶將收到來自 的兩個提醒通知 AWS Health：一個在 45 天，另一個在 150 天。這些通知將提醒您，應用程式關聯功能將在 180 天遺失。335 天也會有一個最終通知，提醒您串流群組將在 365 天過期。維護警告也會出現在 AWS Health 儀表板和 Amazon GameLift Streams 主控台的串流群組頁面上。 若要尋找串流群組的過期日期，請在主控台上檢視**串流群組詳細資訊**頁面，或使用 [GetStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamGroup.html) API 回應中的 `ExpiresAt` 欄位。 過期的串流群組狀態為 `EXPIRED`且變成唯讀。您無法更新它或啟動新的串流工作階段。若要重新取得功能，請重新建立串流群組。 ## 串流群組維護 每當發佈需要新串流群組才能使用的功能時，您會在串流群組的詳細資訊頁面頂端看到「維護必要」訊息，通知您它已過時。重新建立串流群組是手動程序，但為了協助您執行此操作，請使用訊息中的**建立串流群組**按鈕來啟動程序。部分欄位會先就已知的資訊幫您填入。 當串流群組超過 180 天時，也需要進行串流群組維護。在重新建立這些較舊的串流群組之前，您無法再將其與新應用程式連結。365 天後，將無法從串流群組進行串流傳輸，也不允許對串流群組進行任何變更。