将数据迁出亚马逊 WorkDocs

Amazon WorkDocs 提供了两种将数据迁出 WorkDocs 网站的方法。本节概述了这些方法，并提供了有关运行、故障排除和优化每种迁移方法的详细步骤的链接。

客户将有两种选择将其数据从亚马逊上移出 WorkDocs：现有的批量下载功能（方法 1）或我们新的数据迁移工具（方法 2）。以下主题说明如何使用这两种方法。

主题

方法 1：批量下载文件
方法 2：使用迁移工具

方法 1：批量下载文件

如果您想控制要迁移哪些文件，可以手动批量下载它们。此方法允许您只选择所需的文件并将其下载到其他位置，例如本地驱动器。您可以从您的 WorkDocs 网站或 Amazon D WorkDocs rive 下载文件和文件夹。

请记住以下事项：

您的网站用户可以按照下面列出的步骤下载文件。如果你愿意，你可以设置一个共享文件夹，让用户将文件移到该文件夹，然后将该文件夹下载到其他位置。您也可以将所有权转让给自己并进行下载。
要下载带评论的 Microsoft Word 文档，请参阅亚马逊 WorkDocs 用户指南中的下载带有反馈的 Word 文档。
您必须使用 Amazon WorkDocs 云端硬盘下载大于 5 GB 的文件。
当您使用 Amazon WorkDocs Drive 下载文件和文件夹时，您的目录结构、文件名和文件内容将保持不变。不保留文件所有权、权限和版本。

从网络下载文件

在以下情况下，您可以使用此方法下载文件：

您只想从网站下载部分文件。
你想下载带有注释的 Word 文档，并将这些评论留在各自的文档中。迁移工具会下载所有注释，但会将它们写入单独的 XML 文件中。然后，网站用户可能无法将评论与其 Word 文档关联起来。

从 Web 下载文件

登录亚马逊 WorkDocs。
根据需要，打开包含要下载的文件的文件夹。
选中要下载的文件旁边的复选框。

-或-

选中列表顶部的复选框以选择该文件夹中的所有文件。
打开 “操作” 菜单并选择 “下载”。 。

在 PC 上，默认情况下，下载的文件以 Downl oadsWorkDocsDownloads//文件夹名称存放。在 Macintosh 上，默认情况下，文件以硬盘驱动器名称 /Users/ 用户名/存放。WorkDocsDownloads

从 Web 下载文件夹

注意

当你下载文件夹时，你还会下载文件夹中的所有文件。如果您只想下载某个文件夹中的某些文件，请将不需要的文件移到其他位置或回收站，然后下载该文件夹。

从 Web 下载文件夹

登录亚马逊 WorkDocs
选中要下载的每个文件夹旁边的复选框。

-或-

打开文件夹，然后选中要下载的任何子文件夹旁边的复选框。
打开 “操作” 菜单并选择 “下载”。 。

在 PC 上，默认情况下，下载的文件夹以 Downl oadsWorkDocsDownloads//文件夹名称存放。在 Macintosh 上，默认情况下，文件以硬盘驱动器名称 /Users/ 用户名/存放。WorkDocsDownloads

使用 WorkDocs 云端硬盘下载文件和文件夹

注意

您必须安装 Amazon WorkDocs Drive 才能完成以下步骤。有关更多信息，请参阅《亚马逊 WorkDocs 云端硬盘用户指南》中的 “安装亚马逊 WorkDocs 云端硬盘”。

从 WorkDocs 云端硬盘下载文件和文件夹

启动 “文件资源管理器” 或 “访达”，然后打开 W: 驱动器。
选择要下载的文件夹或文件。
点击并按住（右键单击）所选项目并选择 “复制”，然后将复制的项目粘贴到新位置。

-或-

将所选项目拖到新位置。
从 Amazon WorkDocs 云端硬盘中删除原始文件。

方法 2：使用迁移工具

当您想要将所有数据 WorkDocs 迁出 WorkDocs 网站时，可以使用 Amazon 迁移工具。

迁移工具将数据从站点移动到 Amazon 简单存储服务存储桶。该工具为每个用户创建一个压缩的 ZIP 文件。压缩文件包括您 WorkDocs 站点上每个最终用户的所有文件和文件夹、版本、权限、评论和注释。

先决条件

要使用迁移工具，必须具备以下物品。

Amazon S3 存储桶。有关创建 Amazon S3 存储桶的信息，请参阅 Amazon S3 用户指南中的创建存储桶。您的存储桶必须使用相同的 IAM 账户，并且与您的 WorkDocs 网站位于同一区域。此外，您必须阻止公众访问存储桶。有关执行此操作的更多信息，请参阅 Amazon S3 用户指南中的阻止公众访问您的 Amazon S3 存储。

要授予 Amazon 上传您的文件的 WorkDocs 权限，请配置存储桶策略，如以下示例所示。该策略使用aws:SourceAccount和aws:SourceArn条件键来缩小策略的范围，这是一种安全最佳实践。
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowWorkDocsFileUpload",
            "Effect": "Allow",
            "Principal": {
                "Service": "workdocs.amazonaws.com"
            },
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::BUCKET-NAME/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "AWS-ACCOUNT-ID"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:workdocs:REGION:AWS-ACCOUNT-ID:organization/WORKDOCS-DIRECTORY-ID"
                }
            }
        }
    ]
}
```
注意
- WORKDOCS-DIRECTORY-ID 是您网站的组织 ID。 WorkDocs 这可以在 AWS WorkDocs 控制台的 “我的网站” 表中找到
- 有关配置存储桶策略的更多信息，请参阅使用 Amazon S3 控制台添加存储桶策略

IAM 策略。要在 WorkDocs 控制台上开始迁移，IAM 调用委托人的权限集必须附加以下策略：


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowStartWorkDocsMigration",
            "Effect": "Allow",
            "Action": [
                "workdocs:StartInstanceExport"
            ],
            "Resource": [
                "arn:aws:workdocs:REGION:AWS-ACCOUNT-ID:organization/WORKDOCS-DIRECTORY-ID"
            ]
        },
        {
            "Sid": "AllowDescribeWorkDocsMigrations",
            "Effect": "Allow",
            "Action": [
                "workdocs:DescribeInstanceExports",
                "workdocs:DescribeInstances"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Sid": "AllowS3Validations",
            "Effect": "Allow",
            "Action": [
                "s3:HeadBucket",                
                "s3:ListBucket",
                "s3:GetBucketPublicAccessBlock",
                "kms:ListAliases"
            ],
            "Resource": [
                "arn:aws:s3:::BUCKET-NAME"
            ]
        },
        {
            "Sid": "AllowS3ListMyBuckets",
            "Effect": "Allow",
            "Action": [
                "s3:ListAllMyBuckets"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

或者，您可以使用 AWS KMS 密钥对存储桶中的静态数据进行加密。如果您不提供密钥，则应用存储桶的标准加密设置。有关更多信息，请参阅《密AWS 钥管理服务开发人员指南》中的创建密钥。

要使用 AWS KMS 密钥，请在 IAM 策略中添加以下语句。必须使用 SYMMETRIC_DEFAULT 类型的活动密钥。
```
{
    "Sid": "AllowKMSMigration",
     "Effect": "Allow",
     "Action": [
         "kms:CreateGrant",
         "kms:DescribeKey"        
     ],
     "Resource": [   
       
         "arn:aws:kms:REGION:AWS-ACCOUNT-ID:key/KEY-RESOURCE-ID"
     ]
}
```

限制

迁移工具有以下限制：

该工具将所有用户权限、评论和注释写入单独的 CSV 文件中。您必须手动将该数据映射到相应的文件。
您只能迁移活动站点。
该工具限制每个站点每 24 小时成功迁移一次。
您不能运行同一个站点的并行迁移，但可以为不同的站点运行并行迁移。
每个压缩文件最多为 50GB。数据量超过 50GB 的用户 WorkDocs 将有多个 zip 文件导出到 Amazon S3 中。
该工具不会导出大于 50 GB 的文件。该工具会列出与 ZIP 文件具有相同前缀的 CSV 文件中所有大于 50 GB 的文件。例如，/workdocs/ site-alias /created -timestamp-UTC /skippedFiles.csv。您可以通过编程或手动方式下载列出的文件。有关以编程方式下载的信息https://docs.aws.amazon.com/workdocs/latest/developerguide/download-documents.html，请参阅《Amazon WorkDocs 开发者指南》中的。有关手动下载文件的信息，请参阅本主题前面的 “方法 1” 中的步骤。
每个用户的 zip 文件将仅包含他们拥有的文件和/或文件夹。与用户共享的任何文件和/或文件夹都将位于拥有这些文件和/或文件夹的用户的 zip 文件中。
如果中的某个文件夹为空（不包含嵌套文件/文件夹） WorkDocs，则不会将其导出。
不能保证在迁移任务启动后创建的任何数据（文件、文件夹、版本、注释、注释）都将包含在 S3 的导出数据中。
您可以将多个站点迁移到一个 Amazon S3 存储桶。您无需为每个站点创建一个存储桶。但是，您必须确保您的 IAM 和存储桶策略允许多个站点。
迁移会增加 Amazon S3 的成本，具体取决于您迁移到存储桶的数据量。有关更多信息，请参阅 Amazon S3 定价页面。

运行迁移工具

以下步骤说明了如何运行 Amazon WorkDocs 迁移工具。

迁移站点

打开亚马逊 WorkDocs 控制台，网址为 https://console.aws.amazon.com/zocalo/。
在导航窗格中，选择我的站点，然后选择要迁移的站点旁边的单选按钮。
打开操作列表并选择迁移数据。
在迁移数据站点名称页面上，输入您的 Amazon S3 存储桶的 URI。

-或-

选择 “浏览 S3”，然后按照以下步骤操作：
1. 根据需要，搜索存储桶。
2. 选择存储桶名称旁边的单选按钮，然后选择选择。
（可选）在 “通知” 下，最多输入五个电子邮件地址。该工具向每个收件人发送迁移状态电子邮件。
（可选）在 “高级设置” 下，选择 KMS 密钥来加密您存储的数据。
migrate在文本框中输入以确认迁移，然后选择开始迁移。

将出现一个指示器，显示迁移的状态。迁移时间会有所不同，具体取决于站点中的数据量。

迁移完成后：

该工具会向设置期间输入的地址发送 “成功” 电子邮件（如果有）。
你的 Amazon S3 存储桶将包含一个 /workdocs/ s ite-alias /created-timestamp-UTC/文件夹。该文件夹包含每个在网站上有数据的用户的压缩文件夹。每个压缩文件夹都包含用户的文件夹和文件，包括映射 CSV 文件的权限和注释。
如果用户在迁移之前删除了所有文件，则不会显示该用户的压缩文件夹。
版本-具有多个版本的文档具有 _ 版本 _ 创建时间戳标识符。时间戳使用纪元毫秒。例如，名为 “TestFile.txt” 且有两个版本的文档如下所示：
```
          TestFile.txt (version 2 - latest version)
          TestFile_version_1707437230000.txt
      
```

权限-以下示例显示了典型权限 CSV 文件的内容。


PathToFile,PrincipalName,PrincipalType,Role
/mydocs/Projects,user1@domain.com,USER,VIEWER
/mydocs/Personal,user2@domain.com,USER,VIEWER
/mydocs/Documentation/Onboarding_Guide.xml,user2@domain.com,USER,CONTRIBUTOR
/mydocs/Documentation/Onboarding_Guide.xml,user1@domain.com,USER,CONTRIBUTOR
/mydocs/Projects/Initiative,user2@domain.com,USER,CONTRIBUTOR
/mydocs/Notes,user2@domain.com,USER,COOWNER
/mydocs/Notes,user1@domain.com,USER,COOWNER
/mydocs/Projects/Initiative/Structures.xml,user3@domain.com,USER,COOWNER

评论-以下示例显示了典型评论 CSV 文件的内容。


PathToFile,PrincipalName,PostedTimestamp,Text
/mydocs/Documentation/Onboarding_Guide.xml,user1@domain.com,2023-12-28T20:57:40.781Z,TEST ANNOTATION 1
/mydocs/Documentation/Onboarding_Guide.xml,user2@domain.com,2023-12-28T22:18:09.812Z,TEST ANNOTATION 2
/mydocs/Documentation/Onboarding_Guide.xml,user3@domain.com,2023-12-28T22:20:04.099Z,TEST ANNOTATION 3
/mydocs/Documentation/Onboarding_Guide.xml,user1@domain.com,2023-12-28T20:56:27.390Z,TEST COMMENT 1
/mydocs/Documentation/Onboarding_Guide.xml,user2@domain.com,2023-12-28T22:17:10.348Z,TEST COMMENT 2
/mydocs/Documentation/Onboarding_Guide.xml,user3@domain.com,2023-12-28T22:19:42.821Z,TEST COMMENT 3
/mydocs/Projects/Agora/Threat_Model.xml,user1@domain.com,2023-12-28T22:21:09.930Z,TEST ANNOTATION 4
/mydocs/Projects/Agora/Threat_Model.xml,user1@domain.com,2023-12-28T20:57:04.931Z,TEST COMMENT 4

跳过的文件-以下示例显示了典型的跳过文件 CSV 文件的内容。为了提高可读性，我们缩短了 ID 并跳过了原因值。


FileOwner,PathToFile,DocumentId,VersionId,SkippedReason
user1@domain.com,/mydocs/LargeFile1.mp4,45e433b5469...,170899345...,The file is too large. Please notify the document owner...
user2@domain.com,/mydocs/LargeFile2.pdf,e87f725898c1...,170899696...,The file is too large. Please notify the document owner...

从 Amazon S3 下载迁移的数据

由于迁移会增加您的 Amazon S3 成本，因此您可以将迁移的数据从 Amazon S3 下载到其他存储解决方案。本主题介绍如何下载已迁移的数据，并提供了将数据上传到存储解决方案的建议。

注意

以下步骤说明如何一次下载一个文件或文件夹。有关下载文件的其他方式的信息，请参阅 Amazon S3 用户指南中的下载对象。

下载数据

打开 Amazon S3 控制台，网址为：https://console.aws.amazon.com/s3/。
选择目标存储桶并导航到网站别名。
选中压缩文件夹旁边的复选框。

-或-

打开压缩文件夹，然后为单个用户选中该文件或文件夹旁边的复选框。
选择下载。

存储解决方案建议

对于大型站点，我们建议使用合规的基于 Linux 的 Amazon 系统映像预置 EC2 实例，以便以编程方式从 Amazon S3 下载数据，解压缩数据，然后将其上传到存储提供商或本地磁盘。

迁移疑难解答

请尝试以下步骤以确保您的环境配置正确：

如果迁移失败，则 WorkDocs 控制台的 “迁移历史记录” 选项卡上会显示一条错误消息。查看错误消息。
检查您的亚马逊 S3 存储桶设置。
重新运行迁移。

如果问题仍然存在，请联系 AWS Support。包括位于迁移历史记录表中的 WorkDocs 站点 URL 和迁移 Job ID。

查看您的迁移历史记录

以下步骤说明如何查看您的迁移历史记录。

查看您的历史记录

打开亚马逊 WorkDocs 控制台，网址为 https://console.aws.amazon.com/zocalo/。
选择所需 WorkDocs 站点旁边的单选按钮。
打开操作列表并选择迁移数据。
在 “迁移数据” 站点名称页面上，选择 “正在进行的迁移和历史记录”。

迁移历史记录显示在 “迁移” 下。下图显示了典型的历史记录。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

什么是 Amazon WorkDocs？

先决条件