本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

主文件夹格式

用户文件夹的层次结构视用户启动流式传输会话的方式而定，如以下各节所述。

AWS 软件开发工具包和 AWS CLI

对于使用 CreateStreamingURL 或 create-streaming-url 启动的会话，用户文件夹的结构如下：

bucket-name/user/custom/user-id-SHA-256-hash/

其bucket-name中，格式如所示，user-id-SHA-256-hash是用户特定的文件夹名称，使用小写 SHA-256 哈希十六进制字符串创建，该字符串由传递给 CreateStreaming URL API 操作或命令的UserId值生成。Amazon S3 存储桶存储 create-streaming-url有关更多信息，请参阅《亚马逊 WorkSpaces 应用程序 API 参考》中的 CreateStreaming URL 和命令参考中的 create-streaming-url。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是使用从 SAML 联合请求中传递的 NameID SAML 属性值生成的小写 SHA-256 哈希十六进制字符串创建的文件夹名称。要区分隶属两个不同的域的同名用户，请在发送 SAML 请求时使用 domainname\username 格式的 NameID。有关更多信息，请参阅 亚马逊 WorkSpaces 应用程序与 SAML 2.0 集成。

下面的示例文件夹结构适用于使用 SAML 联合且 NameID 为 SAMPLEDOMAIN\testuser、账户 ID 为 123456789012、区域为美国西部（俄勒冈）的会话访问：

appstream2-36fb080bb8-us-west-2-123456789012/user/federated/8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901

当 nameID 字符串的一部分或全部大写时（如示例中的域名SAMPLEDOMAIN）， WorkSpaces 应用程序会根据字符串中使用的大小写生成哈希值。使用此示例，SAMPLEDOMAIN\testuser 的哈希值为 8DD9A642F511609454D344D53CB861A71190E44FED2B8AF9FDE0C507012A9901。在该用户的文件夹中，此值显示为小写，如下所示：8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901。

您可以通过NameID使用在线提供的网站或开源编码库生成 SHA-256 哈希值来为用户识别文件夹。