本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 主資料夾格式
使用者資料夾的階層取決於使用者啟動串流工作階段的方式，如下列各節所述。
## AWS SDKs和 AWS CLI
針對使用 `CreateStreamingURL` 或 `create-streaming-url` 啟動的工作階段，使用者資料夾結構如下所示：
```
bucket-name/user/custom/user-id-SHA-256-hash/
```
其中，`bucket-name` 是在 [Amazon S3 儲存貯體儲存](home-folders-s3.md)中顯示的格式，`user-id-SHA-256-hash` 則是使用從傳遞給 CreateStreamingURL API 操作或 `create-streaming-url` 命令的 `UserId` 值中所產生小寫 SHA-256 雜湊十六進位字串建立的使用者專屬資料夾名稱。如需詳細資訊，請參閱《*Amazon WorkSpaces 應用程式 API 參考*》中的 [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html)，以及《 *AWS CLI 命令參考*》中的 [create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html)。
下列範例資料夾結構適用於使用 API 或 AWS CLI `UserId` testuser@mydomain.com 的工作階段存取，帳戶 ID 123456789012 位於美國西部 （奧勒岡） 區域 (us-west-2)：
```
appstream2-36fb080bb8-us-west-2-123456789012/user/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/
```
您可以使用網站或線上提供的開放原始碼編碼程式庫，產生 `UserId` 的小寫 SHA-256 雜湊值，來識別使用者的資料夾。
## SAML 2.0
針對使用 SAML 聯合建立的工作階段，使用者資料夾的結構如下所示：
```
bucket-name/user/federated/user-id-SHA-256-hash/
```
在此案例中，`user-id-SHA-256-hash` 是使用從傳入 SAML 聯合請求的 `NameID` SAML 屬性值所產生小寫 SHA-256 雜湊十六進位字串建立的資料夾名稱。若要區別擁有相同名稱但屬於兩個不同網域的使用者，請附帶 `NameID`，以 `domainname\username` 的格式傳送 SAML 請求。如需詳細資訊，請參閱[Amazon WorkSpaces 應用程式與 SAML 2.0 整合](external-identity-providers.md)。
以下範例資料夾結構適用於使用 SAML 聯合進行的工作階段存取，其使用的 `NameID` 為 SAMPLEDOMAIN\$1testuser，帳戶 ID 123456789012，位於美國西部 (奧勒岡) 區域：
```
appstream2-36fb080bb8-us-west-2-123456789012/user/federated/8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901
```
當部分或全部 NameID 字串大寫時 （當網域名稱 *SAMPLEDOMAIN* 在範例中時），WorkSpaces 應用程式會根據字串中使用的大寫產生雜湊值。使用此範例，SAMPLEDOMAIN\$1testuser 的雜湊值為 8DD9A642F511609454D344D53CB861A71190E44FED2B8AF9FDE0C507012A9901。在該使用者的資料夾中，此值會以小寫顯示如下：8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901。
您可以使用網站或線上可取得的開放原始碼編碼程式庫，產生 `NameID` 的 SHA-256 雜湊值，來識別使用者的資料夾。