建立 DataSync 任務報告 - AWS DataSync
先決條件建立僅限摘要的任務報告建立標準任務報告

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立 DataSync 任務報告

AWS DataSync 任務報告只能是任務執行的摘要，或一組有關 DataSync 嘗試傳輸、略過、驗證和刪除內容的詳細報告。

先決條件

您必須先執行下列動作，才能建立任務報告。

為您的任務報告建立 S3 儲存貯體

如果您還沒有 SS33 儲存貯體。 DataSync 報告存放在 S3 Standard 儲存類別中。

對於此儲存貯體，我們建議執行下列動作：

  • 如果您打算將資料傳輸到 S3 儲存貯體，如果您停用保留已刪除的檔案選項，請不要將相同的儲存貯體用於任務報告。否則，DataSync 會在每次執行任務時刪除任何先前的任務報告，因為這些報告不存在於您的來源位置。

  • 若要避免複雜的存取許可設定，請確定您的任務報告儲存貯體與 DataSync 傳輸任務位於相同的 AWS 帳戶 和 區域。

允許 DataSync 將任務報告上傳到您的 S3 儲存貯體

您必須設定允許 DataSync 將任務報告上傳至 S3 儲存貯體的 AWS Identity and Access Management (IAM) 角色。

在 DataSync 主控台中，您可以建立 IAM 角色，在大多數情況下會自動包含將任務報告上傳至儲存貯體的許可。請注意，從最低權限的角度來看，此自動產生的角色可能不符合您的需求。如果您的儲存貯體使用客戶受管 AWS Key Management Service (AWS KMS) 金鑰 (SSE-KMS) 加密，則此角色也無法運作。在這些情況下，只要角色至少執行下列動作，您就可以手動建立角色：

  • 防止角色信任實體中的跨服務混淆代理人問題。

    下列完整範例示範如何使用 aws:SourceArn和 aws:SourceAccount全域條件內容索引鍵，以防止 DataSync 的混淆代理人問題。

    JSON
    {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "datasync.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                "aws:SourceAccount": "123456789012"
                },
                "ArnLike": {
                "aws:SourceArn": "arn:aws:datasync:us-east-1:123456789012:*"
                }
            }
        }
    ]
}

  • 允許 DataSync 將任務報告上傳到您的 S3 儲存貯體。

    下列範例透過僅針對儲存貯體中的特定字首 (reports/) 包含 s3:PutObject動作來執行此操作。

    JSON
    {
        "Version":"2012-10-17",		 	 	 
        "Statement": [{
            "Action": [
                "s3:PutObject"
            ],
            "Effect": "Allow",
            "Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*"
        }]
}

  • 如果您的 S3 儲存貯體使用客戶受管 SSE-KMS 金鑰加密，金鑰的政策必須包含 DataSync 用來存取儲存貯體的 IAM 角色。

    如需詳細資訊，請參閱使用伺服器端加密存取 S3 儲存貯體。

建立僅限摘要的任務報告

您只能在建立 DataSync 任務、啟動任務或更新任務時，設定包含摘要的任務報告。

下列步驟說明如何在建立任務時設定僅限摘要任務報告。

  1. 在 https：//https://console.aws.amazon.com/datasync/ 開啟 AWS DataSync 主控台。

  2. 在左側導覽窗格中，展開資料傳輸，然後選擇任務，然後選擇建立任務。

  3. 設定任務的來源和目的地位置。

    如需詳細資訊，請參閱哪裡可以使用 傳輸資料 AWS DataSync？

  4. 向下捲動至任務報告區段。針對報告類型，選擇僅摘要。

  5. 針對報告的 S3 儲存貯體，選擇您希望 DataSync 上傳任務報告的 S3 儲存貯體。

    提示

    如果您打算將資料傳輸到 S3 儲存貯體，如果您停用保留已刪除的檔案選項，請不要將相同的儲存貯體用於任務報告。否則，DataSync 會在每次執行任務時刪除任何先前的任務報告，因為這些報告不存在於您的來源位置。

  6. 針對資料夾，在 DataSync 將報告上傳至 S3 儲存貯體時，輸入要用於任務報告的字首 （例如 reports/)。

    請務必在字首結尾包含適當的分隔符號字元。此字元通常是正斜線 (/)。如需詳細資訊，請參閱《Amazon S3 使用者指南》中的使用字首組織物件。

  7. 針對 IAM role (IAM 角色)，執行以下其中一項作業：

    • 選擇自動產生，讓 DataSync 自動建立具有存取 S3 儲存貯體所需許可的 IAM 角色。

      如果 DataSync 先前為此 S3 儲存貯體建立 IAM 角色，預設會選擇該角色。

    • 選擇您建立的自訂 IAM 角色。

      在某些情況下，您可能需要自行建立角色。如需詳細資訊，請參閱允許 DataSync 將任務報告上傳到您的 S3 儲存貯體。

      重要

      如果您的 S3 儲存貯體使用客戶管理的 SSE-KMS 金鑰加密，金鑰的政策必須包含 DataSync 用來存取儲存貯體的 IAM 角色。

      如需詳細資訊，請參閱使用伺服器端加密存取 S3 儲存貯體。

  8. 完成建立任務，然後啟動任務以開始傳輸資料。

傳輸完成時，您可以檢視任務報告。

  1. 複製下列 create-task AWS Command Line Interface (AWS CLI) 命令：

    aws datasync create-task \
  --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
  --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
  --task-report-config '{
    "Destination":{
      "S3":{
        "Subdirectory":"reports/",
        "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket",
        "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role"
        }
    },
    "OutputType":"SUMMARY_ONLY"  
  }'

  2. 針對 --source-location-arn 參數，指定傳輸中來源位置的 Amazon Resource Name (ARN)。us-east-1 以適當的 取代 AWS 區域，123456789012以適當的 AWS 帳戶 數字取代 ，並以適當的來源位置 ID 取代 12345678abcdefgh 。

  3. 針對 --destination-location-arn 參數，指定傳輸中目的地位置的 ARN。us-east-1 以適當的 取代 AWS 區域，123456789012以適當的 AWS 帳戶 數字取代 ，並以適當的目的地位置 ID 取代 abcdefgh12345678 。

  4. 針對 --task-report-config 參數，請執行下列動作：

    • Subdirectory – reports/將 取代為 S3 儲存貯體中您希望 DataSync 上傳任務報告的字首。

      請務必在字首結尾包含適當的分隔符號字元。此字元通常是正斜線 (/)。如需詳細資訊，請參閱《Amazon S3 使用者指南》中的使用字首組織物件。

    • S3BucketArn – 指定您要上傳任務報告的 S3 儲存貯體 ARN。

      提示

      如果您打算將資料傳輸到 S3 儲存貯體，如果您停用保留已刪除的檔案選項，請不要將相同的儲存貯體用於任務報告。否則，DataSync 會在每次執行任務時刪除任何先前的任務報告，因為這些報告不存在於您的來源位置。

    • BucketAccessRoleArn – 指定允許 DataSync 將任務報告上傳至 S3 儲存貯體的 IAM 角色。

      如需詳細資訊，請參閱允許 DataSync 將任務報告上傳到您的 S3 儲存貯體。

      重要

      如果您的 S3 儲存貯體使用客戶管理的 SSE-KMS 金鑰加密，金鑰的政策必須包含 DataSync 用來存取儲存貯體的 IAM 角色。

      如需詳細資訊，請參閱使用伺服器端加密存取 S3 儲存貯體。

    • OutputType – 指定 SUMMARY_ONLY。

      如需詳細資訊，請參閱僅摘要任務報告。

  5. 執行 create-task命令來建立您的任務。

    您會收到如下所示的回應，顯示您所建立任務的 ARN。您需要此 ARN 才能執行 start-task-execution命令。

    {
    "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}

  6. 複製下列start-task-execution命令。

    aws datasync-task-report start-task-execution \
  --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh

  7. 針對 --task-arn 參數，指定您要啟動之任務的 ARN。使用您從執行 create-task命令收到的 ARN。

  8. 執行 start-task-execution 命令。

傳輸完成時，您可以檢視任務報告。

建立標準任務報告

您可以在建立 DataSync 任務、啟動任務或更新任務時設定標準任務報告。

下列步驟說明如何在建立任務時設定標準任務報告。

  1. 在 https：//https://console.aws.amazon.com/datasync/ 開啟 AWS DataSync 主控台。

  2. 在左側導覽窗格中，展開資料傳輸，然後選擇任務，然後選擇建立任務。

  3. 設定任務的來源和目的地位置。

    如需詳細資訊，請參閱哪裡可以使用 傳輸資料 AWS DataSync？

  4. 向下捲動至任務報告區段。針對報告類型，選擇標準報告。

  5. 針對報告層級，選擇下列其中一項：

    • 僅限錯誤 – 您的任務報告僅包含 DataSync 嘗試傳輸、略過、驗證和刪除的問題。

    • 成功和錯誤 – 您的任務報告包含 DataSync 成功傳輸、略過、驗證和刪除的內容，以及未成功傳輸的內容。

    • 自訂 – 可讓您選擇是否只看到錯誤，或是任務報告特定方面的成功和錯誤。

      例如，您可以為傳輸的檔案清單選擇成功和錯誤，但錯誤僅適用於報告的其餘部分。

  6. 如果您要轉移到使用物件版本控制的 S3 儲存貯體，如果您希望報告包含每個傳輸物件的新版本，請保持選取包含 Amazon S3 物件版本。

  7. 針對報告的 S3 儲存貯體，選擇您希望 DataSync 上傳任務報告的 S3 儲存貯體。

    提示

    如果您打算將資料傳輸到 S3 儲存貯體，如果您停用保留已刪除的檔案選項，請不要將相同的儲存貯體用於任務報告。否則，DataSync 會在每次執行任務時刪除任何先前的任務報告，因為這些報告不存在於您的來源位置。

  8. 針對資料夾，在 DataSync 將報告上傳至 S3 儲存貯體時，輸入要用於任務報告的字首 （例如 reports/)。請務必在字首結尾包含適當的分隔符號字元。此字元通常是正斜線 (/)。如需詳細資訊，請參閱《Amazon S3 使用者指南》中的使用字首組織物件。

  9. 針對 IAM role (IAM 角色)，執行以下其中一項作業：

    • 選擇自動產生，讓 DataSync 自動建立具有存取 S3 儲存貯體所需許可的 IAM 角色。

      如果 DataSync 先前為此 S3 儲存貯體建立 IAM 角色，預設會選擇該角色。

    • 選擇您建立的自訂 IAM 角色。

      在某些情況下，您可能需要自行建立角色。如需詳細資訊，請參閱允許 DataSync 將任務報告上傳到您的 S3 儲存貯體。

      重要

      如果您的 S3 儲存貯體使用客戶管理的 SSE-KMS 金鑰加密，金鑰的政策必須包含 DataSync 用來存取儲存貯體的 IAM 角色。

      如需詳細資訊，請參閱使用伺服器端加密存取 S3 儲存貯體。

  10. 完成建立任務並啟動任務，以開始傳輸資料。

傳輸完成時，您可以檢視任務報告。

  1. 複製下列create-task命令：

    aws datasync create-task \
  --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
  --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
  --task-report-config '{
    "Destination":{
      "S3":{
        "Subdirectory":"reports/",
        "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket",
        "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role"
        }
    },
    "OutputType":"STANDARD",
    "ReportLevel":"level-of-detail",
    "ObjectVersionIds":"include-or-not"    
  }'

  2. 針對 --source-location-arn 參數，指定傳輸中來源位置的 ARN。us-east-1 以適當的 取代 AWS 區域，123456789012以適當的 AWS 帳戶 數字取代 ，並以適當的來源位置 ID 取代 12345678abcdefgh 。

  3. 針對 --destination-location-arn 參數，指定傳輸中目的地位置的 ARN。us-east-1 以適當的 取代 AWS 區域，123456789012以適當的 AWS 帳戶 數字取代 ，並以適當的目的地位置 ID 取代 abcdefgh12345678 。

  4. 針對 --task-report-config 參數，請執行下列動作：

    • Subdirectory – reports/將 取代為 S3 儲存貯體中您希望 DataSync 上傳任務報告的字首。請務必在字首結尾包含適當的分隔符號字元。此字元通常是正斜線 (/)。如需詳細資訊，請參閱《Amazon S3 使用者指南》中的使用字首組織物件。

    • S3BucketArn – 指定您要上傳任務報告的 S3 儲存貯體 ARN。

      提示

      如果您打算將資料傳輸到 S3 儲存貯體，如果您停用保留已刪除的檔案選項，請不要將相同的儲存貯體用於任務報告。否則，DataSync 會在每次執行任務時刪除任何先前的任務報告，因為這些報告不存在於您的來源位置。

    • BucketAccessRoleArn – 指定允許 DataSync 將任務報告上傳至 S3 儲存貯體的 IAM 角色。

      如需詳細資訊，請參閱允許 DataSync 將任務報告上傳到您的 S3 儲存貯體。

      重要

      如果您的 S3 儲存貯體使用客戶管理的 SSE-KMS 金鑰加密，金鑰的政策必須包含 DataSync 用來存取儲存貯體的 IAM 角色。

      如需詳細資訊，請參閱使用伺服器端加密存取 S3 儲存貯體。

    • OutputType – 指定STANDARD報告。

      如需詳細資訊，請參閱任務報告的標準任務報告類型。

    • （選用） ReportLevel – 在SUCCESSES_AND_ERRORS報告中指定您想要 ERRORS_ONLY（預設值） 還是 。

    • （選用） ObjectVersionIds – 如果您要轉移到使用物件版本控制的 S3 儲存貯體，請指定NONE您是否不想在報告中包含每個已傳輸物件的新版本。

      根據預設，此選項設定為 INCLUDE。

    • （選用） Overrides – 自訂報告ReportLevel特定層面的 。

      例如，您可能想要查看 ，SUCCESSES_AND_ERRORS以取得 DataSync 在目的地位置刪除的項目清單，但您想要ERRORS_ONLY其他項目。在此範例中，您會將下列Overrides選項新增至 --task-report-config 參數：

      "Overrides":{
  "Deleted":{
    "ReportLevel":"SUCCESSES_AND_ERRORS"
  }
}

      如果您不使用 Overrides，則整個報告會使用ReportLevel您指定的 。

  5. 執行 create-task命令來建立您的任務。

    您會收到如下所示的回應，顯示您所建立任務的 ARN。您需要此 ARN 才能執行 start-task-execution命令。

    {
    "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}

  6. 複製下列start-task-execution命令。

    aws datasync-task-report start-task-execution \
  --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh

  7. 針對 --task-arn 參數，指定您正在執行之任務的 ARN。使用您從執行 create-task命令收到的 ARN。

  8. 執行 start-task-execution 命令。

傳輸完成時，您可以檢視任務報告。