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