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

# /serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions

> /serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions

# /serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions

支援 GET 作業，以擷取具有指定範本名稱的一組工作階段範本。

<a id="ID4EO" />

## 網域

sessiondirectory.xboxlive.com

<a id="ID4ET" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| scid | GUID | 服務設定識別碼 (SCID)。工作階段識別碼的第 1 部分。 |
| keyword | string | 用來篩選結果的關鍵字，只保留以該字串識別的工作階段。 |
| xuid | GUID | 要為其擷取工作階段之使用者的 XBOX 使用者識別碼。使用者必須在工作階段中處於作用中狀態。 |
| reservations | string | 指出工作階段清單是否包含使用者尚未接受之工作階段的值。此參數只能設定為 true。此設定要求呼叫者具有工作階段的伺服器層級存取權，或呼叫者的 XUID 宣告必須符合 XBOX 使用者識別碼篩選條件。 |
| inactive | string | 指出工作階段清單是否包含使用者已接受但未在積極遊玩之工作階段的值。此參數只能設定為 true。 |
| private | string | 指出工作階段清單是否包含私人工作階段的值。此參數只能設定為 true。只有在查詢您自己的工作階段，或進行伺服器對伺服器查詢時才有效。將此參數設定為 true 時，要求呼叫者具有工作階段的伺服器層級存取權，或呼叫者的 XUID 宣告必須符合 XBOX 使用者識別碼篩選條件。 |
| visibility | string | 指出用於篩選結果之可見度狀態的列舉值。目前此參數只能設定為 Open，以包含開放的工作階段。請參閱 <b>MultiplayerSessionVisibility</b>。 |
| version | string | 正整數，指出要包含之工作階段的主要工作階段版本或更低版本。此值必須小於或等於要求的合約版本除以 100 的餘數。 |
| take | string | 正整數，指出要擷取的工作階段數目上限。 |

<a id="ID4EZD" />

## 有效的方法

[GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)](/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionsget)

  擷取工作階段範本文件。

<a id="ID4EDE" />

## 另請參閱

<a id="ID4EFE" />

##### 上層

[Session Directory URI](/zh-TW/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory)


## Related topics

- [XblMultiplayerSessionReferenceUri](/pt-BR/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md)
- [Multiplayer Session Directory overview](/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)