

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

# マルチアプリケーションストリームグループの概要
<a name="multi-apps"></a>

*マルチアプリケーションストリームグループは*、複数のアプリケーションにリンクされたストリームグループです。これにより、単一のストリームグループで同じコンピューティングリソースのセットを使用して、複数のアプリケーションをストリーミングできます。

マルチアプリケーションストリームグループの一般的なユースケースは、ゲームのさまざまなバージョンをリリースすることです。たとえば、ストリームグループを作成し、デフォルトのアプリケーションをゲームの元のバージョンに設定するとします。次に、ゲームの他のバージョンを含む追加のアプリケーションを作成し、ストリームグループにリンクするとします。これらのアプリケーションは同じストリームグループに関連付けられているため、これらのゲームをすべてストリーミングするには、1 セットのコンピューティングリソースまたはストリーム容量を管理するだけで済みます。つまり、エンドユーザーストリームのアプリケーションに関係なく、アプリケーションは、このストリームグループが割り当てたのと同じセットのコンピューティングリソースで実行されます。

 その他の実際の例を以下に示します。
+ さまざまなストリーミング層を顧客に提供するゲームストリーミングプラットフォーム。
+ ゲームの複数のバージョンをテストしている品質保証チーム。
+ 複数のアプリケーションに単一のストリームグループを使用することで、ストリーム容量管理を簡素化します。
+ 一連のアプリケーションが同じストリーム容量のプールからストリーミングできるようにするには。

## 制限事項と要件
<a name="multi-apps-limitations"></a>

アプリケーションを関連付けることができるのは、互換性のあるランタイム環境とストリームクラスを持つストリームグループのみです。詳細については、[ストリームクラス](configuration-options.md#configuration-options-stream-classes) を参照してください。

アプリケーションとストリームグループには、次の関連付け制限が適用されます。これらの制限は、すべてのお客様の サービス内で修正されます。


| 名前 | デフォルト | 引き上げ可能 | 説明 | 
| --- | --- | --- | --- | 
| ストリームグループ内のアプリケーション | 250 | いいえ | ストリームグループに関連付けることができる Amazon GameLift Streams アプリケーションの最大数。 | 
| アプリケーションあたりのストリームグループの関連付け | 100 | いいえ | Amazon GameLift Streams アプリケーションに関連付けることができるストリームグループの最大数。 | 

## デフォルトアプリケーションについて
<a name="multi-apps-about-linking"></a>

各ストリームグループには*デフォルトアプリケーション*が 1 つあり、これが最初にストリームグループに追加されるアプリケーションです。デフォルトアプリケーションは、常時稼働しているすべてのコンピューティングリソースに自動的に事前にキャッシュされるため、ストリームの起動時のアプリケーションのロード時間を短縮できます。Amazon GameLift Streams サービスは、最適化プロセス中に他のリンクされたアプリケーションもキャッシュできます。

デフォルトアプリケーションおよびその他のリンクされたアプリケーションの特徴:
+ デフォルトのアプリケーションは、ストリームの起動中のアプリケーションのロード時間を短縮するために、事前にキャッシュされています (常時オン容量などの事前に割り当てられたコンピューティングリソース上）。
+ デフォルトのアプリケーションは変更できます。ストリームグループでデフォルトアプリケーションを切り替える場合、新しいデフォルトアプリケーションがすべての場所で事前キャッシュされるまでに最大数時間かかることがあります。
+ ストリームグループからストリーミングを開始する前に、少なくとも 1 つのリンクされたアプリケーションが必要です。リンクされた最初のアプリケーションは自動的にデフォルトのアプリケーションになります。
+ ストリームグループのデフォルトアプリケーションのリンクを解除すると、Amazon GameLift Streams は、関連付けられた残りのアプリケーションがあれば、自動的に新しいデフォルトアプリケーションを選択します。
+ 同じアプリケーションを複数のストリームグループのデフォルトアプリケーションにすることができます。
+ リンクされたアプリケーションのセットは、ストリームグループが 180 日経過するまで変更可能です。実際には、これは、ストリームグループが 180 日経過するまでアプリケーションをリンクおよびリンク解除できることを意味します。その後、ストリームグループの残りのライフサイクルを通じてのみ、ストリームグループからアプリケーションのリンクを解除できます。

## デフォルトのアプリケーションを変更する
<a name="multi-apps-change-default"></a>

最初のアプリケーションをストリームグループにリンクすると、自動的にデフォルトのアプリケーションになり、キャッシュ前の利点が得られます。デフォルトのアプリケーションはいつでも変更でき、これらの利点を別のアプリケーションに与えることができます。

**注記**  
ストリームグループでデフォルトアプリケーションを切り替える場合、新しいデフォルトアプリケーションがすべての場所で事前キャッシュされるまでに最大数時間かかることがあります。

------
#### [ 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**

で、コンテンツに合わせてカスタマイズされた [UpdateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html) コマンド AWS CLI を使用します。デフォルトにするアプリケーションは、既にストリームグループに関連付けられている必要があります。

```
aws gameliftstreams update-stream-group \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --default-application-identifier a-9ZY8X7Wv6
```

各一般項の意味は次のとおりです。
+ `identifier`:

  デフォルトにするアプリケーションがあるストリームグループ。

  この値は、ストリームグループ[リソースを一意に識別する Amazon リソースネーム (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`
+ `default-application-identifier`:

  このストリームグループでデフォルトにするアプリケーション。

  この値は、アプリケーション[リソースを一意に識別する Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) または ID です。

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

  ID の例: `a-9ZY8X7Wv6`

------

## アプリケーションをリンクする
<a name="multi-apps-link"></a>

アプリケーションをストリームグループにリンクまたは関連付けると、ストリームグループはアプリケーションをストリーミングできます。ストリームグループの最初のアプリケーションである場合、自動的に*デフォルトのアプリケーション*になります。180 日が経過するまで、追加のアプリケーションをストリームグループにリンクおよびリンク解除できます。その後、グループの残りのライフサイクルを通じてのみ、ストリームグループからアプリケーションのリンクを解除できます。

**重要**  
 180 日以上経過したストリームグループにアプリケーションをリンクすることはできません。異なるアプリケーションをストリームグループに関連付けるには、まず再作成する必要があります。ストリームグループを再作成する方法については、「」を参照してください[ストリームグループのメンテナンス](stream-groups.md#stream-groups-maintenance)。

 アプリケーションをリンクする前に、ストリームグループが**アクティブ**ステータスであることを確認します。

------
#### [ 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**

 では、コンテンツに合わせてカスタマイズされた [AssociateApplications](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_AssociateApplications.html) コマンド AWS CLI を使用します。

```
aws gameliftstreams associate-applications \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --application-identifiers a-9ZY8X7Wv6 a-1Z78C7Wv6
```

各一般項の意味は次のとおりです。
+ `identifier`:

  これらのアプリケーションをリンクするストリームグループ。

  この値は、ストリームグループ[リソースを一意に識別する Amazon リソースネーム (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`
+ `application-identifiers`:

  このストリームグループにリンクする一連のアプリケーション。

  この値は、アプリケーション[リソースを一意に識別する Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) または ID です。

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

  ID の例: `a-9ZY8X7Wv6`

------

## アプリケーションのリンクを解除する
<a name="multi-apps-unlink"></a>

 ストリームグループからアプリケーションのリンクを解除または関連付けを解除すると、そのストリームグループに割り当てられたコンピューティングリソースを使用してこのアプリケーションをストリーミングできなくなります。処理中のストリームは終了するまで継続されるため、エンドユーザーのストリームの中断を回避できます。Amazon GameLift Streams は、このストリームグループを使用して新しいストリームを開始しません。リンク解除アクションは、ストリームグループのストリーム容量には影響しません。

 ストリームグループのデフォルトアプリケーションのリンクを解除すると、Amazon GameLift Streams は、関連付けられた残りのアプリケーションがあれば、自動的に新しいデフォルトアプリケーションを選択します。

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

**Amazon GameLift Streams コンソールを使用してリンクを解除するには**

1. にサインイン AWS マネジメントコンソール し、[Amazon GameLift Streams コンソール](https://console.aws.amazon.com/gameliftstreams/)を開きます。

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

1. ストリームグループを選択して詳細を表示します。

1.  **リンクされたアプリケーションで**、リンクを解除するアプリケーション (複数可) を選択します。**アプリケーションのリンク解除**を選択します。

1.  **Unlink applications** ダイアログで、Unlink アクションを確認し、**Unlink** を選択します。

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

**前提条件**

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

**を使用してアプリケーションのリンクを解除するには (複数可) AWS CLI**

 では、コンテンツに合わせてカスタマイズされた [DisassociateApplications](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DisassociateApplications.html) コマンド AWS CLI を使用します。

```
aws gameliftstreams disassociate-applications \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --application-identifiers a-9ZY8X7Wv6 a-1Z78C7Wv6
```

各一般項の意味は次のとおりです。
+ `identifier`:

  これらのアプリケーションのリンクを解除するストリームグループ。

  この値は、ストリームグループ[リソースを一意に識別する Amazon リソースネーム (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`
+ `application-identifiers`:

  このストリームグループからリンクを解除する一連のアプリケーション。

  この値は、アプリケーション[リソースを一意に識別する Amazon リソースネーム (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) または ID です。

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

  ID の例: `a-9ZY8X7Wv6`

------