本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 主文件夹格式
用户文件夹的层次结构视用户启动流式传输会话的方式而定，如以下各节所述。
## 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`是使用小写的 SHA-256 哈希十六进制字符串创建的用户特定的文件夹名称，该字符串是根据传递给 CreateStreaming URL API 操作或命令的`UserId`值生成的。`create-streaming-url`有关更多信息，请参阅《*亚马逊 WorkSpaces 应用程序 API 参考》和《*AWS CLI 命令*参考*》[create-streaming-url](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-streaming-url.html)中的 [CreateStreamingURL](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStreamingURL.html)。
以下示例文件夹结构适用于在美国西部（俄勒冈）区域 (us-west-2) 中使用 API 或 AWS CLI 账户编号为 123456789012 的 `UserId` testuser@mydomain.com 访问会话：
```
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 哈希十六进制字符串创建)。要区分隶属两个不同的域的同名用户，请在发送 SAML 请求时使用 `domainname\username` 格式的 `NameID`。有关更多信息，请参阅 [亚马逊 WorkSpaces 应用程序与 SAML 2.0 集成](external-identity-providers.md)。
下面的示例文件夹结构适用于使用 SAML 联合且 `NameID` 为 SAMPLEDOMAIN\$1testuser、账户 ID 为 123456789012、区域为美国西部（俄勒冈）的会话访问：
```
appstream2-36fb080bb8-us-west-2-123456789012/user/federated/8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901
```
当 NameID 字符串的一部分或全部大写时（如示例中的域名所示），A WorkSpaces pp *SAMPLEDOMAIN* lications 会根据字符串中使用的大小写生成哈希值。使用此示例，SAMPLEDOMAIN\$1 testuser 的哈希值为 8 DD9 A642F511609454D344D53 CB861 A71190E44 FED2 B8 C507012A9901。AF9 FDE0在该用户的文件夹中，此值显示为小写，如下所示：8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901。
您可以通过网站或网上提供的开源编码库生成 `NameID` 的 SHA-256 哈希值，并据此确定特定用户的文件夹。