> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/handles/{handleId}/session)

> GET (/handles/{handleId}/session)

# GET (/handles/{handleId}/session)

指定されたハンドル識別子のセッション オブジェクトを取得します。

> **重要:**\
> このメソッドは 2015 Multiplayer で使用され、そのマルチプレイヤー バージョン以降にのみ適用されます。テンプレート コントラクト 104/105 以降で使用することを意図しており、リクエストごとに X-Xbl-Contract-Version: 104/105 以降のヘッダー要素が必要です。

* [備考](#ID4ET)
* [URI パラメーター](#ID4EDB)
* [HTTP ステータス コード](#ID4EOB)
* [リクエスト本文](#ID4EVB)
* [レスポンス本文](#ID4E6B)

## 備考

この HTTP/REST メソッドは、指定されたサービス側のセッションへのポインター (ハンドル) を使用して、サーバーからセッション オブジェクトを取得します。返されるのは、すべての属性を含むセッション オブジェクトです。このメソッドは **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync** でラップできます。

このメソッドの呼び出し元は、プレイヤーの **MultiplayerActivityDetails** オブジェクトからハンドル ID を取得します。あるいは、ユーザーがゲームの招待を受け入れた後のプロトコル アクティベーションから ID を取得します。

## URI パラメーター

\| Parameter| Type| Description|
\| --- | --- | --- | --- |
\| handleId| GUID| セッションのハンドルの一意の ID。|

## HTTP ステータス コード

サービスは MPSD に該当する HTTP ステータス コードを返します。

## リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

## レスポンス本文

レスポンス構造については「[MultiplayerSession (JSON)](https://docs.xbox.com/ja-jp/reference/live/rest/json/json-multiplayersession.md)」を参照してください。

## 関連項目

##### 親

[/handles/{handleId}/session](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession.md)


## Related topics

- [/handles/{handleId}/session](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession.md)
- [/handles/{handleId}](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleid.md)
- [GET (/handles/{handle-id})](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleidget.md)
- [PUT (/handles/{handle-id}/session)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionput.md)
- [DELETE (/handles/{handleId})](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleiddelete.md)