> ## 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 操作以检索一组具有指定模板名称的会话模板。

## 域

sessiondirectory.xboxlive.com

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| scid | GUID | 服务配置标识符 (SCID)。会话 ID 的第 1 部分。 |
| keyword | string | 用于将结果筛选为仅使用该字符串标识的会话的关键字。 |
| xuid | GUID | 要检索其会话的用户的 XBOX 用户 ID。用户必须在会话中处于活动状态。 |
| reservations | string | 指示会话列表是否包含用户尚未接受的会话的值。此参数只能设置为 true。此设置要求调用方对会话具有服务器级访问权限，或调用方的 XUID 声明与 XBOX 用户 ID 筛选器匹配。 |
| inactive | string | 指示会话列表是否包含用户已接受但未主动参与的会话的值。此参数只能设置为 true。 |
| private | string | 指示会话列表是否包含专用会话的值。此参数只能设置为 true。仅在查询您自己的会话或以服务器到服务器方式查询时有效。将此参数设置为 true 要求调用方对会话具有服务器级访问权限，或调用方的 XUID 声明与 XBOX 用户 ID 筛选器匹配。 |
| visibility | string | 指示用于筛选结果的可见性状态的枚举值。目前此参数只能设置为 Open 以包括开放会话。请参阅 **MultiplayerSessionVisibility**。 |
| version | string | 一个正整数，指示要包含的会话的主要会话版本或更低版本。该值必须小于或等于请求的协定版本对 100 取模的值。 |
| take | string | 一个正整数，指示要检索的最大会话数。 |

## 有效方法

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

  检索会话模板文档。

## 另请参阅

##### 上级

[会话目录 URI](/zh-CN/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory)


## Related topics

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