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

# /serviceconfigs/{scid}/sessions

> /serviceconfigs/{scid}/sessions

# /serviceconfigs/{scid}/sessions

支援 GET 作業，以擷取一組工作階段文件。

## 網域

sessiondirectory.xboxlive.com

## 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，以包含開放的工作階段。請參閱 **MultiplayerSessionVisibility**。 |
| version | string | 正整數，指出要包含之工作階段的主要工作階段版本 (或更低版本)。此值必須小於或等於要求的合約版本除以 100 的餘數。 |
| take | string | 正整數，指出要擷取的工作階段數目上限。 |

## 有效的方法

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

  擷取指定的工作階段資訊。

## 另請參閱

##### 上層

[工作階段目錄 URI](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/atoc-reference-sessiondirectory.md)


## Related topics

- [GET (/serviceconfigs/{scid}/sessions)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessionsget.md)
- [/serviceconfigs/{scid}/sessiontemplates](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplates.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatesget.md)
- [/serviceconfigs/{scid}/batch](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch.md)
- [/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions](https://docs.xbox.com/zh-TW/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessions.md)