> ## 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 (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

> GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

# GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})

取得工作階段物件。

> **重要：**\
> 此 URI 方法要求每個要求都必須包含 X-Xbl-Contract-Version: 104/105 或更新版本的標頭元素。

* [備註](#ID4ET)
* [URI 參數](#ID4EMB)
* [HTTP 狀態碼](#ID4EZB)
* [要求本文](#ID4E6B)
* [回應本文](#ID4EKC)

## 備註

此 HTTP/REST 方法會讀取指定名稱的工作階段文件並擷取工作階段。成功時，會傳回從伺服器取得的工作階段物件及其所有屬性。此方法可由 **Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionAsync** 包裝。GET 方法的參數直接對應於工作階段之 **MultiplayerSessionReference** 物件中指定的參數，該物件會在 **GetCurrentSessionAsync** 的 *sessionReference* 參數中傳遞。

GET 方法的網路傳輸格式如下所示。

```cpp theme={null}
GET /serviceconfigs/00000000-0000-0000-0000-000000000000/sessiontemplates/quick/sessions/00000000-0000-0000-0000-000000000001 HTTP/1.1
      Content-Type: application/json

```

## URI 參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- |
\| scid| GUID| 服務設定識別碼 (SCID)。工作階段識別碼的第 1 部分。|
\| sessionTemplateName| string| 工作階段範本目前執行個體的名稱。工作階段識別碼的第 2 部分。|
\| sessionName| GUID| 工作階段的唯一識別碼。工作階段識別碼的第 3 部分。|

## HTTP 狀態碼

服務會傳回適用於 MPSD 的 HTTP 狀態碼。

## 要求本文

此要求的本文中不會傳送任何物件。

## 回應本文

請參閱 [MultiplayerSession (JSON)](https://docs.xbox.com/zh-TW/reference/live/rest/json/json-multiplayersession.md) 中的回應結構。

## 另請參閱

##### 上層

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname.md)


## Related topics

- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname.md)
- [PUT (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameput.md)
- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/servers/{server-name}](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersservername.md)
- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnamemembersme.md)
- [DELETE (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/{index})](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersindexdelete.md)