Amazon GameLift Streams ストリームグループを使用してストリーミングを管理する - Amazon GameLift Streams
ストリーム容量についてキャパシティとサービスクォータロケーションについてストリームグループを作成する全般設定の編集容量の編集キャパシティのスケールダウン動作ストリームグループにロケーションを追加するストリームグループ内の場所を削除するストリームグループを削除するリンクされたアプリケーションストリームグループのメンテナンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon GameLift Streams ストリームグループを使用してストリーミングを管理する

Amazon GameLift Streams アプリケーションをセットアップしたら、コンピューティングリソースを管理およびデプロイして、アプリケーションを実行およびストリーミングする準備が整います。Amazon GameLift Streams ストリームグループは、これらのコンピューティングリソースのコレクションを表します。ストリーム容量をスケーリングすることで、サポートする同時ストリームの最大数を指定します。

Amazon GameLift Streams は、ストリームグループを作成する にコンピューティングリソースを割り当て AWS リージョン ます。リモートロケーションをストリームグループに追加し、ロケーションあたりのキャパシティを管理することもできます。ストリームセッションは、地理的にエンドユーザーに近い場所でホストするのがベストプラクティスです。これにより、レイテンシーを最小限に抑え、ストリームの品質を向上させることができます。詳細については、「AWS リージョン Amazon GameLift Streams でサポートされている およびリモートロケーション」を参照してください。

ストリームグループでは、ストリームグループがストリーミングできる 1 つ以上の Amazon GameLift Streams アプリケーションを指定できます。1 つのアプリケーションを複数のストリームグループに含めることができるため、異なる設定またはタイプのコンピューティングリソースを設定して、同じアプリケーションをストリーミングできます。たとえば、アプリケーションをストリーミングするための 2 つのグラフィック品質のオプションを提供するには、異なるストリームクラス設定で 2 つのストリームグループを設定し、それらを同じアプリケーションにリンクできます。

逆に、1 つのストリームグループに複数のアプリケーションを含めることができます。デフォルトアプリケーションは、ストリームグループの作成時に設定でき、追加のリンクされたアプリケーションです。詳細については、「マルチアプリケーションストリームグループの概要」を参照してください。

ストリームグループとアプリケーションを関連付ける方法はユースケースによって異なりますが、関係はmany-to-manyになる可能性があります。

ストリーム容量について

ストリームグループの容量またはストリーム容量を設定することで、エンドユーザーに同時に配信できるストリームの数を管理します。ストリーム容量は、ストリームグループがサポートできる同時ストリームセッションの数を表します。各場所で設定されます。容量には、常時オン容量とオンデマンド容量の 2 種類があります。

  • 常時オン容量： 事前に割り当てられ、ストリームリクエストを遅延なく処理できるストリーミング容量。この容量は、使用中かどうかにかかわらずお支払いいただきます。ストリーミングリクエストからストリーミングセッションまでの最短時間に最適です。

  • オンデマンドキャパシティ： Amazon GameLift Streams がストリームリクエストに応答して割り当て、セッション終了時に割り当てを解除できるストリーミングキャパシティ。これにより、ストリームの開始時間が長くなる (通常は 5 分未満) というコスト管理手段が提供されます。

ある場所で常時オンの容量が 100 に設定されているストリームグループがある場合、ストリームグループには、その場所で同時に 100 人のエンドユーザーにストリーミングするのに十分なリソースがあることを意味します。ストリーム容量は、ユーザーの需要の変化に合わせて、各場所 (現在のクォータ量まで) でいつでも増減できます。

マルチテナントストリームクラス (コンピューティングリソースごとに 1 つ以上のセッションをストリーミングできます) を持つストリームグループでストリーム容量を指定する場合、容量はテナンシーの倍数である必要があります。たとえば、gen5n_highストリームクラスのマルチテナンシーは 2 です。つまり、ストリームグループに割り当てられた各コンピューティングリソースは、2 つのクライアントにストリーミングできます。したがって、リクエストする容量は 2 の倍数である必要があります。

Amazon GameLift Streams は、まず常時オンの容量を使用してストリームリクエストを実行します。常時オンの容量を最大限に活用すると、追加のリクエストを処理するためにオンデマンド容量 (設定されている場合) が自動的に割り当てられます。ストリームセッションが終了すると、オンデマンド容量は自動的に割り当て解除され、コストを削減できます。未使用のオンデマンド容量の割り当て解除には数分かかる場合があります。

容量のスケーリングは、ストリームグループの合計コストに反映されます。Amazon GameLift Streams のコストを管理するための請求アラートを設定してください。「請求アラートを作成して、使用状況をモニタリングする」を参照してください。

ストリームグループの容量を変更するには、ストリームグループ設定を編集し、常時オンまたはオンデマンド容量の新しい値を入力します。常時オンの容量を変更すると、Amazon GameLift Streams は、新しいリソースをプロビジョニングするか、既存のリソースをシャットダウンすることで、割り当てられたリソースを新しい値に合わせて調整します。リソースがすぐに利用できない場合、常時オンの容量を増やすには数分以上かかることがあります。常時オンの容量を減らすと、割り当てられたリソースのプロビジョニングが解除されるまでに数分かかります。

キャパシティとサービスクォータ

Amazon GameLift Streams の使用には、アカウントでストリーミングするために設定できる GPUs (コンピューティングリソース) の合計数を制限するサービスクォータが適用されます。これらのクォータがストリーム容量とどのように相互作用するかを理解することは、ストリーミングインフラストラクチャを計画し、容量の制限を回避するのに役立ちます。

具体的には、GPU サービスクォータは、アカウント内のすべてのストリームグループでロケーションごとにリクエストできる特定のストリームクラスファミリーの GPUs の最大数を指定します。たとえば、アカウントに 5 gen5n GPUs の制限がある場合us-west-2、すべてのストリームグループus-west-2で の合計ストリーム容量を提供するために必要な gen5n GPUs の合計は 5 以下である必要があります。これには、常時オン容量とオンデマンド容量の両方の GPUs が含まれます。

これらの GPUs によって提供される合計ストリーム容量を計算するときは、マルチテナントストリームクラスが GPU ごとに複数のセッションのストリーミングをサポートしていることに注意してください。したがって、 などのストリームグループでマルチテナントストリームクラスを使用している場合はgen5n_high、容量がクォータにどのようにカウントされるかを決定するときに、これを考慮する必要があります。gen5n_ultra や などのシングルテナントストリームクラスはgen5n_win2022、ストリームセッションごとに 1 つの GPU を専有します。

例: クォータが容量に与える影響

次の例は、サービスクォータが複数のストリームグループとロケーションでストリーム容量とやり取りする方法を示しています。この例では、アカウントの場所ごとに 10 gen5n GPUs のクォータがあるとします。

  1. シングルテナントストリームグループを作成する： で 5 つの合計容量 (常時オンとオンデマンド) を持つストリームクラスを使用してgen5n_ultraストリームグループを作成しますus-east-2。このストリームクラスには 1:1 のテナンシー (GPU ごとに 1 つのストリーム) があるため、合計容量が 5 GPUs が必要です。これにより、 に 5 つの残りの GPUsますus-east-2。

  2. マルチテナントストリームグループを作成する： 合計容量が 6 のストリームクラスを使用して別のgen5n_highストリームグループを作成しますus-east-2。このストリームクラスには 1:2 のテナンシー (GPU あたり 2 つのストリーム) があるため、必要な GPU は 3 GPUs 6 です。これにより、 に 2 つの残りの GPUsますus-east-2。

  3. 他の場所に容量を追加する： これらのストリームグループを作成した後、 に 2 つの残りの GPUs がありますがus-east-2、 us-west-2や などの他の場所では 10 GPUs を使用できますeu-west-1。これらの場所は、以前に作成したストリームグループに追加することも、これらの場所を持つ新しいストリームグループを作成することもできます。

この例では、場所ごと、およびすべてのストリームグループにクォータが適用され、サービスの制限内に留まりながら複数の地理的リージョンにストリーミング容量を分散できることを示しています。

現在のサービスクォータを表示して引き上げをリクエストするには、Service Quotas コンソールを使用します。詳細については、「Amazon GameLift Streams サービスクォータ」を参照してください。

ロケーションについて

の場所は、Amazon GameLift Streams がコンピューティングリソースを割り当ててアプリケーションをホストし、ユーザーにストリーミングする場所です。レイテンシーを短縮し、品質を向上させるには、ユーザーに近い場所を選択する必要があります。デフォルトでは、プライマリロケーションと呼ばれるストリームグループを AWS リージョン 作成した からストリーミングできます。さらに、ストリームグループは、リモートロケーションと呼ばれるサポートされている他のロケーションからストリーミングするようにカバレッジを拡張できます。

サポートされているロケーションの完全なリストについては、「」を参照してくださいAWS リージョン およびリモートロケーション。

マルチロケーションストリームグループ

プライマリロケーション (ストリームグループを作成した AWS リージョン ) に加えて、複数のロケーションからアプリケーションとストリームセッションをホストするように設定されたストリームグループ。各ロケーションの容量を管理します。

ストリームグループを作成する

Console
Amazon GameLift Streams コンソールでストリームグループを作成するには

  1. にサインイン AWS Management Console し、Amazon GameLift Streams コンソールを開きます。ストリームグループ AWS リージョン を作成する を選択します。このリージョンは、ストリームグループでストリーミングするアプリケーションのリージョンと同じである必要があります。詳細については、「 入門ガイド」の「リージョンの選択」を参照してください。 AWS Management Console

  2. 作成ワークフローを開くには、ナビゲーションペインでストリームグループを選択し、ストリームグループの作成を選択します。

  3. ストリームグループの定義で、次のように入力します。

    1. 説明

      ストリームグループの人間が読めるラベル。この値は一意である必要はありません。ベストプラクティスとして、ストリームグループにわかりやすい説明、名前、またはラベルを使用します。このフィールドはいつでも編集できます。

    2. [タグ]

      タグは、 AWS リソースの整理に役立つラベルです。詳細については、「AWS リソースのタグ付け」を参照してください。

  4. Select stream class で、ストリームグループのストリームクラスを選択します。

    1. ストリームクラスオプション

      アプリケーションを実行およびストリーミングするコンピューティングリソースのタイプ。この選択は、ストリーミングエクスペリエンスの品質とコストに影響します。ストリームグループごとに指定できるストリームクラスは 1 つだけです。アプリケーションに最適なクラスを選択します。

      ストリームクラス 説明

      gen5n_win2022

      (NVIDIA、超) 非常に複雑な 3D シーンのアプリケーションをサポートします。Microsoft Windows Server 2022 Base でアプリケーションを実行し、DirectX 12 と DirectX 11 をサポートします。Unreal Engine をバージョン 5.5、64 ビットアプリケーション、およびチート防止テクノロジーでサポートします。NVIDIA A10G Tensor GPU を使用します。

      アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 24 GB。

      テナンシー: 1 つの同時ストリームセッションをサポートします。

      gen5n_high

      (NVIDIA、高) moderate-to-highの 3D シーンの複雑さを持つアプリケーションをサポートします。NVIDIA A10G Tensor GPU を使用します。

      アプリケーションあたりのリソース: vCPUs: 4。RAM: 16 GB。VRAM: 12 GB。

      テナンシー: 最大 2 つの同時ストリームセッションをサポートします。

      gen5n_ultra

      (NVIDIA、超) 非常に複雑な 3D シーンのアプリケーションをサポートします。NVIDIA A10G Tensor GPU を使用します。

      アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 24 GB。

      テナンシー: 1 つの同時ストリームセッションをサポートします。

      gen4n_win2022

      (NVIDIA、超) 3D シーンの複雑さが高いアプリケーションをサポートします。Microsoft Windows Server 2022 Base でアプリケーションを実行し、DirectX 12 と DirectX 11 をサポートします。Unreal Engine をバージョン 5.5、64 ビットアプリケーション、およびチート防止テクノロジーでサポートします。NVIDIA T4 Tensor GPU を使用します。

      アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 16 GB。

      テナンシー: 1 つの同時ストリームセッションをサポートします。

      gen4n_high

      (NVIDIA、高) moderate-to-highの 3D シーンの複雑さを持つアプリケーションをサポートします。NVIDIA T4 Tensor GPU を使用します。

      アプリケーションあたりのリソース: vCPUs: 4。RAM: 16 GB。VRAM: 8 GB。

      テナンシー: 最大 2 つの同時ストリームセッションをサポートします。

      gen4n_ultra

      (NVIDIA、超) 3D シーンの複雑さが高いアプリケーションをサポートします。NVIDIA T4 Tensor GPU を使用します。

      アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 16 GB。

      テナンシー: 1 つの同時ストリームセッションをサポートします。

    続行するには、次へ を選択します。

  5. リンクアプリケーションで、ストリーミングするアプリケーションを選択するか、「アプリケーションなし」を選択して後で選択します。ストリームグループは、作成後に編集して、アプリケーションを追加または削除できます。Ready ステータスが で、選択したストリームクラスと互換性のあるランタイムを持つアプリケーションのみをリンクできます。デフォルトでは、これらはテーブルに表示される唯一のアプリケーションです。Ready ステータスのすべてのアプリケーションを表示するには、ドロップダウンリストから All runtimes を選択します。

    注記

    アプリケーションが表示されない場合は、現在の AWS リージョン 設定を確認してください。アプリケーションをリンクできるのは、同じリージョンにあるストリームグループのみです。

    続行するには、次へ を選択します。

  6. 「ストリーム設定を構成する」の「場所と容量」で、ストリームグループにアプリケーションをストリーミングする容量がある 1 つ以上の場所を選択します。デフォルトでは、プライマリロケーションと呼ばれるストリームグループを作成するリージョンは、既にストリームグループに追加されており、削除できません。追加する各場所の横にあるチェックボックスをオンにして、場所を追加できます。レイテンシーを短縮し、ストリーミングの品質を向上させるには、ユーザーに近い場所を選択する必要があります。

    ロケーションごとに、ストリーミング容量を指定できます。ストリーム容量は、一度にアクティブにできる同時ストリームの数を表します。各ストリームグループのロケーションごとにストリーム容量を設定します。各ロケーションには、常時オン容量とオンデマンド容量の 2 種類の容量があります。

    • 常時オン容量： 事前に割り当てられ、ストリームリクエストを遅延なく処理できるストリーミング容量。この容量は、使用中かどうかにかかわらずお支払いいただきます。ストリーミングリクエストからストリーミングセッションまでの最短時間に最適です。

    • オンデマンドキャパシティ： Amazon GameLift Streams がストリームリクエストに応答して割り当て、セッション終了時に割り当てを解除できるストリーミングキャパシティ。これにより、ストリームの開始時間が長くなる (通常は 5 分未満) というコスト管理手段が提供されます。

    いずれかの容量を調整することで、場所のユーザー需要の変化に合わせて、ストリームの合計容量をいつでも増減できます。Amazon GameLift Streams は、常時オンのキャパシティプールにアイドル状態で事前に割り当てられたリソースがあれば、それを使用してストリーミングリクエストを実行します。すべての常時オン容量が使用されている場合、Amazon GameLift Streams はオンデマンド容量で指定された最大数まで追加のコンピューティングリソースをプロビジョニングします。割り当てられた容量がスケールすると、変更はストリームグループの合計コストに反映されます。

    リンクされたアプリケーションは、有効な各場所に自動的にレプリケートされます。リモートロケーションがストリームをホストする前に、アプリケーションはリモートロケーションでのレプリケーションを終了する必要があります。レプリケーションステータスを確認するには、作成後にストリームグループを開き、リンクされたアプリケーションの表の「レプリケーションステータス」列を参照してください。現在のステータスをクリックすると、追加された各ロケーションのレプリケーションステータスが表示されます。

    注記

    アプリケーションデータは、このストリームグループのプライマリロケーションを含む、有効なすべてのロケーションに保存されます。ストリームセッションデータは、プライマリロケーションとストリーミングが発生したロケーションの両方に保存されます。

  7. 「ストリームグループの確認と作成」で、ストリームグループの設定を確認し、必要に応じて変更を加えます。すべて正しい場合は、ストリームグループの作成を選択します。

CLI

前提条件

ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。

を使用してストリームグループを作成するには AWS CLI

で、コンテンツに合わせてカスタマイズされた CreateStreamGroup コマンド AWS CLI を使用します。

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, "OnDemandCapacity": 4}]'

この場合、次のようになります。

description:

ストリームグループの人間が読めるラベル。この値は一意である必要はありません。ベストプラクティスとして、ストリームグループにわかりやすい説明、名前、またはラベルを使用します。このフィールドはいつでも編集できます。

default-application-identifier

Amazon GameLift Streams アプリケーションリソースに割り当てられた Amazon リソースネーム (ARN) 値または ID。アプリケーションは READYステータスである必要があります。

ARN の例: arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6

ID の例: a-9ZY8X7Wv6

stream-class
ストリームクラスオプション

アプリケーションを実行およびストリーミングするコンピューティングリソースのタイプ。この選択は、ストリーミングエクスペリエンスの品質とコストに影響します。ストリームグループごとに指定できるストリームクラスは 1 つだけです。アプリケーションに最適なクラスを選択します。

ストリームクラス 説明

gen5n_win2022

(NVIDIA、超) 非常に複雑な 3D シーンのアプリケーションをサポートします。Microsoft Windows Server 2022 Base でアプリケーションを実行し、DirectX 12 と DirectX 11 をサポートします。Unreal Engine をバージョン 5.5、64 ビットアプリケーション、およびチート防止テクノロジーでサポートします。NVIDIA A10G Tensor GPU を使用します。

アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 24 GB。

テナンシー: 1 つの同時ストリームセッションをサポートします。

gen5n_high

(NVIDIA、高) moderate-to-highの 3D シーンの複雑さを持つアプリケーションをサポートします。NVIDIA A10G Tensor GPU を使用します。

アプリケーションあたりのリソース: vCPUs: 4。RAM: 16 GB。VRAM: 12 GB。

テナンシー: 最大 2 つの同時ストリームセッションをサポートします。

gen5n_ultra

(NVIDIA、超) 非常に複雑な 3D シーンのアプリケーションをサポートします。NVIDIA A10G Tensor GPU を使用します。

アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 24 GB。

テナンシー: 1 つの同時ストリームセッションをサポートします。

gen4n_win2022

(NVIDIA、超) 3D シーンの複雑さが高いアプリケーションをサポートします。Microsoft Windows Server 2022 Base でアプリケーションを実行し、DirectX 12 と DirectX 11 をサポートします。Unreal Engine をバージョン 5.5、64 ビットアプリケーション、およびチート防止テクノロジーでサポートします。NVIDIA T4 Tensor GPU を使用します。

アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 16 GB。

テナンシー: 1 つの同時ストリームセッションをサポートします。

gen4n_high

(NVIDIA、高) moderate-to-highの 3D シーンの複雑さを持つアプリケーションをサポートします。NVIDIA T4 Tensor GPU を使用します。

アプリケーションあたりのリソース: vCPUs: 4。RAM: 16 GB。VRAM: 8 GB。

テナンシー: 最大 2 つの同時ストリームセッションをサポートします。

gen4n_ultra

(NVIDIA、超) 3D シーンの複雑さが高いアプリケーションをサポートします。NVIDIA T4 Tensor GPU を使用します。

アプリケーションあたりのリソース: vCPUs: 8。RAM: 32 GB。VRAM: 16 GB。

テナンシー: 1 つの同時ストリームセッションをサポートします。
location-configurations

このストリームグループに追加する一連の場所とその容量。デフォルトでは、容量が指定されていない場合、Amazon GameLift Streams は、ストリームグループが作成された場所で 1 つのストリームを開始するのに十分な常時オンストリーム容量のみを割り当てます。Amazon GameLift Streams がサポートするロケーションの完全なリストについては、「」を参照してくださいAWS リージョン Amazon GameLift Streams でサポートされている およびリモートロケーション。

容量の値は、ストリームグループのストリームクラスのテナンシー値の整数倍である必要があります。

リクエストが成功すると、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 は、未割り当てのコンピューティングリソースを検索し、新しいストリームグループのプロビジョニングを開始します。これには数分かかる場合があります。この間、新しいストリームグループは Activating ステータスになります。

アクティブまたはアクティブステータスでストリームグループの容量を調整できます。詳細については、「容量の編集」を参照してください。

ストリームグループがアクティブステータスになると、ストリーミング用のリソースをデプロイする準備が整います。ストリーミングを開始するには、「」を参照してくださいAmazon GameLift Streams でストリームセッションを開始する。

全般設定の編集

Amazon GameLift Streams は、ストリームグループ設定の下のコンソールで次の設定をグループ化します。ステータス、ストリームグループ ID、説明、ストリームグループ ARN、ストリームクラス。これらのうち、新しいストリームグループを作成せずに更新できるのは説明のみです。

Console

  1. にサインイン AWS Management Console し、Amazon GameLift Streams コンソールを開きます。

  2. ナビゲーションバーで、ストリームグループを選択して既存のストリームグループのリストを表示します。編集するストリームグループを選択します。

  3. ストリームグループの詳細ページで、設定の編集を選択します。

  4. 説明を更新するには、新しい値を入力します。

CLI

前提条件

ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。

を使用してストリームグループの説明を編集するには AWS CLI

では、コンテンツに合わせてカスタマイズされた UpdateStreamGroup コマンド AWS CLI を使用します。

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

この場合、次のようになります。

identifier

ストリームグループリソースを一意に識別する Amazon リソースネーム (ARN) または ID。

ARN の例: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4

ID の例: sg-1AB2C3De4

description

ストリームグループの人間が読めるラベル。この値は一意である必要はありません。ベストプラクティスとして、ストリームグループにわかりやすい説明、名前、またはラベルを使用します。このフィールドはいつでも編集できます。

容量の編集

各ロケーションの容量を調整して、ストリームグループをスケールします。

ストリームグループ容量クォータAmazon GameLift Streams サービスクォータの詳細については AWS アカウント、「」を参照してください。

Console

  1. にサインイン AWS Management Console し、Amazon GameLift Streams コンソールを開きます。

  2. ナビゲーションバーで、ストリームグループを選択して既存のストリームグループのリストを表示します。編集するストリームグループを選択します。

  3. ストリームグループの詳細ページで、設定の編集を選択します。

  4. 場所ごとに、テーブルの関連するセルに新しい常時オンおよびオンデマンドのストリーム容量値を入力します。容量の増減をリクエストできます。容量の値は、ストリームグループのストリームクラスのテナンシー値の整数倍である必要があります。

    常時オンの容量値をゼロに設定すると、ストリームグループはストリームにホストを割り当てません。

CLI

前提条件

ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。

を使用してストリーム容量を編集するには AWS CLI

では、コンテンツに合わせてカスタマイズされた UpdateStreamGroup コマンド AWS CLI を使用します。

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

この場合、次のようになります。

identifier

ストリームグループリソースを一意に識別する Amazon リソースネーム (ARN) または 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 コンソールでストリームグループの詳細ページを表示するか、Amazon GameLift Streams CLI get-stream-groupを使用して を呼び出します。

ストリームグループがアクティブステータスで、使用可能なストリーム容量がある場合は、ストリーミングを開始できます。詳細については、「Amazon GameLift Streams でストリームセッションを開始する」を参照してください。

キャパシティのスケールダウン動作

容量をスケールダウンすると、Amazon GameLift Streams はホストがアイドル状態になるまで待機してから解放します。ホストは 1 つまたは 2 つのセッションをサポートできるため、ホスト上のすべてのアクティブなセッションが終了した場合にのみ、ホストはアイドル状態になります。ストリームセッションは、ユーザーがセッションを終了するか、セッションがタイムアウトすると終了します。したがって、既存のセッションが最大許容期間に達すると、希望する容量に達するまでに最大 24 時間かかる場合があります。ストリームグループ内のすべてのアクティブなストリームセッションを強制終了する場合は、コンソールで、または DeleteStreamGroup API を使用してストリームグループを削除するか、TerminateStreamSession API を使用してアクティブなセッションを一度に 1 つずつ終了できます。

ストリームグループにロケーションを追加する

Console
Amazon GameLift Streams コンソールを使用してストリームグループにロケーションを追加するには

  1. ナビゲーションバーで、ストリームグループを選択して既存のストリームグループのリストを表示します。新しい場所を追加するストリームグループを選択します。

  2. ストリームグループの詳細ページで、設定の編集を選択します。

  3. このストリームグループに追加する場所 (複数可) の横にあるチェックボックスをオンにし、その容量を設定します。

  4. ストリーム容量のコストなど、選択したロケーションの概要を確認します。保存 を選択して選択を確定します。

CLI

前提条件

ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。

を使用してストリームグループにロケーションを追加するには AWS CLI

で、コンテンツに合わせてカスタマイズされた AddStreamGroupLocations コマンド AWS CLI を使用します。

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, "OnDemandCapacity": 2}]'

この場合、次のようになります。

identifier

ストリームグループリソースを一意に識別する Amazon リソースネーム (ARN) または ID。

ARN の例: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4

ID の例: sg-1AB2C3De4

location-configurations

このストリームグループに追加する一連の場所とその容量。Amazon GameLift Streams がサポートするロケーションの完全なリストについては、「」を参照してくださいAWS リージョン Amazon GameLift Streams でサポートされている およびリモートロケーション。

容量の値は、ストリームグループのストリームクラスのテナンシー値の整数倍である必要があります。

アプリケーションが新しいロケーション (複数可) へのレプリケーションを完了し、ストリームグループに使用可能なストリーム容量がある場合、新しいロケーション (複数可) からストリーミングを開始できます。ストリーミングの詳細については、「」を参照してくださいAmazon GameLift Streams でストリームセッションを開始する。Amazon GameLift Streams はリクエストの処理を開始します。これには数分かかる場合があります。この間、Amazon GameLift Streams はアプリケーションをレプリケートし、コンピューティングリソースを新しい場所に割り当てます。レプリケーションのステータス列のステータスにカーソルを合わせると、ストリームグループの詳細ページのリンクされたアプリケーションセクションからレプリケーションのステータスを表示できます。

ストリームグループ内の場所を削除する

特定の場所からコンピューティングリソースの使用を停止するには、ストリームグループ内の場所を削除できます。これにより、ストリームグループの合計ストリーム容量が減少します。ただし、残りの場所でストリーム容量を増やすことはできます。

ストリームグループのプライマリロケーションは削除できません。ただし、その場所にコンピューティングリソースが必要ない場合は、ストリーム容量をゼロに設定できます。

警告

ストリームグループ内の場所を削除すると、Amazon GameLift Streams はその場所のアクティブなストリームを切断し、接続されたエンドユーザーのストリームを停止します。

Console
Amazon GameLift Streams コンソールを使用してストリームグループからロケーションを削除するには

  1. ナビゲーションペインで、ストリームグループを選択して既存のストリームグループのリストを表示します。

  2. ロケーションを削除するストリームグループの名前を選択します。

  3. ストリームグループの詳細ページで、設定の編集を選択します。

  4. 削除する場所の名前の横にあるチェックボックスをオフにします。

  5. [保存] を選択します。

CLI

前提条件

ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。

を使用してストリームグループからロケーションを削除するには AWS CLI

では、コンテンツに合わせてカスタマイズされた RemoveStreamGroupLocations コマンド AWS CLI を使用します。

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

この場合、次のようになります。

identifier

ストリームグループリソースを一意に識別する Amazon リソースネーム (ARN) または ID。

ARN の例: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4

ID の例: sg-1AB2C3De4

locations

このストリームグループから削除する一連の場所。Amazon GameLift Streams がサポートするロケーションの完全なリストについては、「」を参照してくださいAWS リージョン Amazon GameLift Streams でサポートされている およびリモートロケーション。

ストリームグループを削除する

任意のステータスのストリームグループを削除できます。このアクションは、ストリームグループを完全に削除し、そのコンピューティングリソースを解放します。進行中のストリームがある場合、このアクションはストリームを停止し、エンドユーザーはストリームを表示できなくなります。

ベストプラクティスとして、ストリームグループを削除する前に、進行中のストリームをチェックし、それらを停止するステップを実行します。

Console
Amazon GameLift Streams コンソールを使用してストリームグループを削除するには

  1. にサインイン AWS Management Console し、Amazon GameLift Streams コンソールを開きます。

  2. 既存のストリームグループのリストを表示するには、ナビゲーションペインでストリームグループを選択します。

  3. 削除するストリームグループの名前を選択します。

  4. ストリームグループの詳細ページで、削除を選択します。

  5. 削除ダイアログボックスで、削除アクションを確認します。

CLI

前提条件

ユーザー認証情報と選択した AWS CLI を使用して を設定する必要があります AWS リージョン。セットアップ手順については、「」を参照してくださいのダウンロード AWS CLI。

を使用してストリームグループを削除するには AWS CLI

では、コンテンツに合わせてカスタマイズされた DeleteStreamGroup コマンド AWS CLI を使用します。

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

この場合、次のようになります。

identifier

ストリームグループリソースを一意に識別する Amazon リソースネーム (ARN) または ID。

ARN の例: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4

ID の例: sg-1AB2C3De4

Amazon GameLift Streams は、コンピューティングリソースの解放とストリームグループの削除を開始します。この間、ストリームグループは削除ステータスになります。Amazon GameLift Streams がストリームグループを削除すると、そのグループを取得できなくなります。

リンクされたアプリケーション

同じコンピューティングリソースのプールを使用して複数のアプリケーションをストリーミングする場合は、複数のアプリケーションを同じストリームグループにリンクできます。同様に、異なるコンピューティングリソースのセットを使用してアプリケーションをストリーミングする場合は、アプリケーションを複数のストリームグループにリンクできます。

アプリケーションをストリームグループにリンクする方法の詳細については、「」を参照してくださいマルチアプリケーションストリームグループの概要。

ストリームグループのメンテナンス

ストリームグループが新しいサービスの更新と修正を受け取るには、ストリームグループを再作成する必要があります。ベストプラクティスとして、3～4 週間ごとにストリームグループを再作成することをお勧めします。ストリームグループを置き換えても、アップロードされたアプリケーションには影響しません。

新しいストリームグループで使用する必要がある機能がリリースされるたびに、ストリームグループの詳細ページの上部に「メンテナンスが必要」というメッセージが表示され、古いことが通知されます。ストリームグループの再作成は手動プロセスですが、これを行うには、メッセージのストリームグループの作成ボタンを使用してプロセスを開始します。一部のフィールドは自動的に入力されます。

ストリームグループのメンテナンスは、ストリームグループが 180 日以上経過している場合にも必要です。新しいアプリケーションをこれらの古いストリームグループにリンクすることは、再作成されるまでできなくなります。