翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# DescribeTaskExecution
<a name="API_DescribeTaskExecution"></a>

 AWS DataSync タスクの実行に関する情報を提供します。このオペレーションを使用すると、行われているデータ転送の進行状況を監視したり、転送の結果を確認したりできます。

**注記**  
一部の `DescribeTaskExecution` レスポンス要素は、特定のタスクモードにのみ関係します。詳細については、「[Understanding task mode differences](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences)」および[「Understanding data transfer performance counters](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html)」を参照してください。

## リクエストの構文
<a name="API_DescribeTaskExecution_RequestSyntax"></a>

```
{
   "TaskExecutionArn": "string"
}
```

## リクエストパラメーター
<a name="API_DescribeTaskExecution_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) **   <a name="DataSync-DescribeTaskExecution-request-TaskExecutionArn"></a>
情報が必要なタスク実行の Amazon リソースネーム (ARN) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
必須: はい

## レスポンスの構文
<a name="API_DescribeTaskExecution_ResponseSyntax"></a>

```
{
   "BytesCompressed": number,
   "BytesTransferred": number,
   "BytesWritten": number,
   "EndTime": number,
   "EstimatedBytesToTransfer": number,
   "EstimatedFilesToDelete": number,
   "EstimatedFilesToTransfer": number,
   "EstimatedFoldersToDelete": number,
   "EstimatedFoldersToTransfer": number,
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "FilesDeleted": number,
   "FilesFailed": { 
      "Delete": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FilesListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FilesPrepared": number,
   "FilesSkipped": number,
   "FilesTransferred": number,
   "FilesVerified": number,
   "FoldersDeleted": number,
   "FoldersFailed": { 
      "Delete": number,
      "List": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FoldersListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FoldersPrepared": number,
   "FoldersSkipped": number,
   "FoldersTransferred": number,
   "FoldersVerified": number,
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "LaunchTime": number,
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "ReportResult": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "Status": "string"
   },
   "Result": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "PrepareDuration": number,
      "PrepareStatus": "string",
      "TotalDuration": number,
      "TransferDuration": number,
      "TransferStatus": "string",
      "VerifyDuration": number,
      "VerifyStatus": "string"
   },
   "StartTime": number,
   "Status": "string",
   "TaskExecutionArn": "string",
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

## レスポンス要素
<a name="API_DescribeTaskExecution_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesCompressed"></a>
圧縮が適用された後にネットワーク上で DataSync が転送した物理バイト数 (圧縮可能な場合)。データが圧縮可能でない限り、この数値は通常 [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred) よりも小さくなります。  
タイプ: Long

 ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesTransferred"></a>
圧縮前に DataSync がネットワークに送信するバイト数 (圧縮可能な場合)。ネットワーク経由で転送されるバイト数については、「[BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed)」を参照してください。  
タイプ: 長整数

 ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesWritten"></a>
DataSync が転送先の場所に実際に書き込んだ論理バイト数。  
タイプ: Long

 ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EndTime"></a>
転送タスクが終了した時刻。  
タイプ: タイムスタンプ

 ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedBytesToTransfer"></a>
DataSync が転送先の場所に書き込む論理バイト数の予定。  
タイプ: 長整数

 ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToDelete"></a>
DataSync が転送先の場所で削除する予定のファイル、オブジェクト、およびディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete) にカウントされます。
タイプ: Long

 ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToTransfer"></a>
DataSync がネットワーク経由で転送する予定のファイル、オブジェクト、およびディレクトリの数。この値は、DataSync が転送を[準備](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)している間に計算されます。  
これがどのように計算されるかは、主にタスクの[転送モード](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)の設定によって異なります。  
+ `TranserMode` が `CHANGED` に設定されている場合 - この計算は、ソースと転送先の内容の比較と、転送する必要がある差の特定に基づいて実行されます。相違点は次のとおりです。
  + ソースの場所で追加または変更されたもの。
  + 両方の場所にあり、最初の転送後に転送先で変更されたもの ([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) が `NEVER` に設定されている場合を除く)。
  +  **(基本タスクモードのみ)** DataSync が削除する予定の項目の数 ([PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles) が `REMOVE` に設定されている場合)。
+ `TranserMode` が `ALL` に設定されている場合 - 計算は DataSync がソースの場所で検出した項目のみに基づいています。
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer) にカウントされます。
タイプ: Long

 ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete"></a>
DataSync が送信先ロケーションで削除する予定のディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer"></a>
DataSync がネットワーク経由で転送することを期待するディレクトリの数。この値は、DataSync が転送するディレクトリ[を準備する](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)ときに計算されます。  
これがどのように計算されるかは、主にタスクの[転送モード](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode)の設定によって異なります。  
+ `TranserMode` が `CHANGED` に設定されている場合 - この計算は、ソースと転送先の内容の比較と、転送する必要がある差の特定に基づいて実行されます。相違点は次のとおりです。
  + ソースの場所で追加または変更されたもの。
  + 両方の場所にあり、最初の転送後に転送先で変更されたもの ([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) が `NEVER` に設定されている場合を除く)。
+ `TranserMode` が `ALL` に設定されている場合 - 計算は DataSync がソースの場所で検出した項目のみに基づいています。
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Excludes"></a>
転送中に特定のデータを除外するフィルタルールのリスト。詳細と例については、「[DataSync によって転送されるデータのフィルタリング](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。

 ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesDeleted"></a>
DataSync が転送先の場所で実際に削除したファイル、オブジェクト、およびディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted) にカウントされます。
タイプ: Long

 ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesFailed"></a>
タスクの実行中に DataSync が準備、転送、検証、削除に失敗したファイルまたはオブジェクトの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) オブジェクト

 ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesListed"></a>
DataSync がお客様の場所で見つけたファイルまたはオブジェクトの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) オブジェクト

 ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesPrepared"></a>
送信元と送信先の場所を比較した後に DataSync が転送を試みるファイルまたはオブジェクトの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
このカウンターは、[すべてのデータを転送する](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)ようにタスクを設定している場合には適用されません。この場合、DataSync は、場所間の違いを比較せずに、送信元から送信先にすべてコピーします。  
タイプ: Long

 ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesSkipped"></a>
転送中に DataSync がスキップするファイル、オブジェクト、およびディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped) にカウントされます。
タイプ: Long

 ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesTransferred"></a>
DataSync がネットワーク経由で実際に転送したファイル、オブジェクト、およびディレクトリの数。この値は、タスクの実行中に送信元から何かが読み取られ、ネットワーク経由で送信されたときに定期的に更新されます。  
DataSync が何かを転送できない場合、この値は `EstimatedFilesToTransfer` より小さくなる可能性があります。場合によっては、この値は `EstimatedFilesToTransfer` より大きくなることもあります。一部の場所タイプではこの要素は実装固有であるため、何が送信されているかを正確に把握するためのインジケータとして、あるいはタスク実行をモニタリングする目的では、これを使用しないでください。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred) にカウントされます。
タイプ: Long

 ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesVerified"></a>
転送中に DataSync が検証するファイル、オブジェクト、およびディレクトリの数。  
[転送されたデータのみを検証](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html)するようにタスクを設定すると、DataSync は状況によってはディレクトリを検証せず、また転送に失敗したファイルを検証しません。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)の場合、このカウンターにはファイルまたはオブジェクトのみが含まれます。ディレクトリは [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified) にカウントされます。
タイプ: Long

 ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersDeleted"></a>
DataSync が送信先ロケーションで実際に削除するディレクトリの数。送信元にない送信先のデータを削除するように[タスクを設定](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)しない場合、値は常に `0` です。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersFailed"></a>
タスクの実行中に DataSync がリスト、準備、転送、検証、削除に失敗したディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) オブジェクト

 ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersListed"></a>
DataSync がお客様のロケーションで見つけたディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
型: [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) オブジェクト

 ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersPrepared"></a>
送信元と送信先の場所を比較した後に DataSync が転送を試みるディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
このカウンターは、[すべてのデータを転送する](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)ようにタスクを設定している場合には適用されません。この場合、DataSync は、場所間の違いを比較せずに、送信元から送信先にすべてコピーします。  
タイプ: Long

 ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersSkipped"></a>
転送中に DataSync がスキップするディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersTransferred"></a>
DataSync がネットワーク経由で実際に転送するディレクトリの数。この値は、タスクの実行中に送信元から何かが読み取られ、ネットワーク経由で送信されたときに定期的に更新されます。  
DataSync が何かを転送できない場合、この値は `EstimatedFoldersToTransfer` より小さくなる可能性があります。場合によっては、この値は `EstimatedFoldersToTransfer` より大きくなることもあります。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersVerified"></a>
転送中に DataSync が検証するディレクトリの数。  
[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)にのみ適用されます。
タイプ: Long

 ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Includes"></a>
転送中に特定のデータを含めるフィルタルールのリスト。詳細と例については、「[DataSync によって転送されるデータのフィルタリング](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。  
タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。

 ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-LaunchTime"></a>
タスク実行が実際に開始された時刻。キューに入れられていないタスクの場合、`LaunchTime` と `StartTime` は通常同じになります。キューに入れられたタスクの場合、`LaunchTime` は通常 `StartTime` よりも後になります。これは、新しいタスクを開始する前に、以前にキューに入れられたタスクの実行を完了する必要があるためです。  
タイプ: タイムスタンプ

 ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ManifestConfig"></a>
転送するファイルまたはオブジェクトを一覧表示するマニフェストの設定。詳細については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。  
タイプ: [ManifestConfig](API_ManifestConfig.md) オブジェクト

 ** [Options](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Options"></a>
転送タスクがどのように構成されているかを示します。これらのオプションには、転送中に DataSync がファイル、オブジェクト、および関連するメタデータを処理する方法が含まれます。また、データの整合性の検証方法や、タスクの帯域幅制限の設定方法なども指定できます。  
各オプションにはデフォルト値があります。必要な場合を除き、[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) を呼び出す前にこれらのオプションを設定する必要はありません。  
これらのタスクオプションは各タスクを実行するたびにオーバーライドできます。例えば、個々の実行に合わせて `LogLevel` を調整することができます。  
タイプ: [Options](API_Options.md) オブジェクト

 ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ReportResult"></a>
DataSync が転送に関する完全な[タスクレポート](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)を生成したかどうかを示します。  
タイプ: [ReportResult](API_ReportResult.md) オブジェクト

 ** [Result](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Result"></a>
タスク実行の 結果。  
型: [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) オブジェクト

 ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-StartTime"></a>
DataSync がタスク実行を開始するためのリクエストを送信した時刻。キューに入れられていないタスクの場合、`LaunchTime` と `StartTime` は通常同じになります。キューに入れられたタスクの場合、`LaunchTime` は通常 `StartTime` よりも後になります。これは、新しいタスクを開始する前に、以前にキューに入れられたタスクの実行を完了する必要があるためです。  
タイプ: タイムスタンプ

 ** [Status](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Status"></a>
タスク実行のステータス。  
タスク実行ステータスの詳細については、「[タスクの実行ステータス](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)」を参照してください。  
タイプ: 文字列  
有効な値：`QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`

 ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskExecutionArn"></a>
ユーザーが情報を必要としたタスク実行の ARN。`TaskExecutionArn` は階層的であり、実行されたタスクの `TaskArn` を含みます。  
たとえば、ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2` でタスクを実行した ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` と `TaskExecution` の値です。  
タイプ: 文字列  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskMode"></a>
使用しているタスクモード。詳細については、「[Choosing a task mode for your data transfer](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)」を参照してください。  
型: 文字列  
有効な値：`BASIC | ENHANCED`

 ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskReportConfig"></a>
DataSync 転送に関する詳細情報を提供するタスクレポートの設定。詳細については、「[タスクレポートの作成](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。  
タイプ: [TaskReportConfig](API_TaskReportConfig.md) オブジェクト

## エラー
<a name="API_DescribeTaskExecution_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_DescribeTaskExecution_Examples"></a>

### リクエスト例
<a name="API_DescribeTaskExecution_Example_1"></a>

この例は `DescribeTaskExecution` リクエストを示しています。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1"
}
```

### 拡張モードでのタスク実行のレスポンス例 1
<a name="API_DescribeTaskExecution_Example_2"></a>

次の例では、拡張モードを使用する DataSync タスク実行について説明します。実行では、除外フィルターと包含フィルターを使用して特定のデータも転送されます。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "BASIC",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/archive-files"
    }],
    "Includes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/files"
    }],
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "EstimatedFilesToTransfer": 7,
    "EstimatedFoldersToTransfer": 2,
    "EstimatedBytesToTransfer": 30,
    "FilesTransferred": 7,
    "FoldersTransferred": 2,
    "BytesWritten": 30,
    "BytesTransferred": 30,
    "BytesCompressed": 30,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3310,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 7,
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 7,
    "FilesListed": {
        "AtSource": 7,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 2,
    "FoldersPrepared": 2,
    "FoldersListed": {
        "AtSource": 2,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
}
```

### 拡張モードでのタスク実行のレスポンス例 2
<a name="API_DescribeTaskExecution_Example_3"></a>

次の例では、拡張モードを使用する別の DataSync タスク実行について説明します。この場合、実行ではフィルターの代わりにマニフェストを使用して特定のデータが転送されます。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "TRANSFER",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [],
    "Includes": [],
    "ManifestConfig": {
        "Action": "TRANSFER",
        "Format": "CSV",
        "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess",
        "S3Bucket": "arn:aws:s3:::manifests-datasync",
        "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG",
        "Source": {
            "S3": {
                "ManifestObjectPath": "manifest-folder/manifest-versioned-files",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess",
                "S3BucketArn": "arn:aws:s3:::manifests-datasync",
                "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG"
            }
        }
    },
    "StartTime": "2024-10-16T09:29:56.757000-04:00",
    "EstimatedFilesToTransfer": 1,
    "EstimatedFoldersToTransfer": 0,
    "EstimatedBytesToTransfer": 6,
    "FilesTransferred": 1,
    "FoldersTransferred": 1,
    "BytesWritten": 6,
    "BytesTransferred": 6,
    "BytesCompressed": 6,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3089,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "Subdirectory": "reports/",
                "S3BucketArn": "arn:aws:s3:::my-task-report",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess"
            }
        },
        "OutputType": "STANDARD",
        "ReportLevel": "SUCCESSES_AND_ERRORS",
        "ObjectVersionIds": "INCLUDE"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 1,
    "ReportResult": {
        "Status": "SUCCESS"
    },
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 1,
    "FilesListed": {
        "AtSource": 1,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 0,
    "FoldersPrepared": 0,
    "FoldersListed": {
        "AtSource": 0,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
  }
```

### 基本モードでのタスク実行のレスポンス例
<a name="API_DescribeTaskExecution_Example_4"></a>

次の例では、基本モードを使用する DataSync タスク実行について説明します。

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "BytesCompressed": 3500,
    "BytesTransferred": 5000,
    "BytesWritten": 5000,
    "EstimatedBytesToTransfer": 5000,
    "EstimatedFilesToDelete": 10,
    "EstimatedFilesToTransfer": 100,
    "FilesDeleted": 10,
    "FilesSkipped": 0,
    "FilesTransferred": 100,
    "FilesVerified": 100,
    "Result": {
        "PrepareDuration": 100,
        "PrepareStatus": "SUCCESS",
        "TransferDuration": 60,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 30,
        "VerifyStatus": "SUCCESS"
    },
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "Status": "SUCCESS",
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": "1000",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role",
                "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*",
                "Subdirectory": "reports"
            }
        },
        "ObjectVersionIds": "INCLUDE",
        "OutputType": "STANDARD",
        "Overrides": {
            "Deleted": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Skipped": {
                "ReportLevel": "SUCCESSES_AND_ERRORS"
            },
            "Transferred": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Verified": {
                "ReportLevel": "ERRORS_ONLY"
            }
        },
        "ReportLevel": "ERRORS_ONLY"
    }
}
```

## 以下の資料も参照してください。
<a name="API_DescribeTaskExecution_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution)