> ## 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.

# PUT (/handles/{handle-id}/session)

> PUT (/handles/{handle-id}/session)

# PUT (/handles/{handle-id}/session)

ハンドルの参照を解決して、セッションを作成または更新します。

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

* [解説](#ID4ET)
* [URI パラメーター](#ID4ECB)
* [HTTP ステータス コード](#ID4ENB)
* [リクエスト本文](#ID4EUB)
* [レスポンス本文](#ID4E6B)

## 解説

この HTTP/REST メソッドは、指定されたセッション ハンドル ID を使用して、マルチプレイヤー サービスに新規または更新済みのセッションを書き込みます。結果は、サーバーから返される新規または更新済みのセッションを表すオブジェクトです。このメソッドは **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.WriteSessionByHandleAsync** によってラップできます。

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

## URI パラメーター

\| パラメーター | 型 | 説明 |
\| --- | --- | --- | --- |
\| handleId | GUID | セッションのハンドルの一意の ID。|

## HTTP ステータス コード

サービスは、MPSD に適用される HTTP ステータス コードを返します。

## リクエスト本文

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

## レスポンス本文

レスポンスの本文にはオブジェクトを送信しません。

## 関連項目

##### 親

[/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/{handleId}/session)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsessionget.md)
- [DELETE (/handles/{handleId})](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleiddelete.md)
- [GET (/handles/{handle-id})](https://docs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleidget.md)