Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# DescribeTaskExecution
Memberikan informasi tentang pelaksanaan AWS DataSync tugas Anda. Anda dapat menggunakan operasi ini untuk membantu memantau kemajuan transfer data yang sedang berlangsung atau memeriksa hasil transfer.
**catatan**
Beberapa elemen `DescribeTaskExecution` respons hanya relevan dengan mode tugas tertentu. Untuk selengkapnya, lihat [Memahami perbedaan mode tugas](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) dan [Memahami penghitung kinerja transfer data](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html).
## Sintaksis Permintaan
```
{
"TaskExecutionArn": "string"
}
```
## Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).
Permintaan menerima data berikut dalam format JSON.
** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) **
Menentukan Nama Sumber Daya Amazon (ARN) dari eksekusi tugas yang Anda inginkan informasi tentang.
Tipe: String
Batasan Panjang: Panjang maksimum 128.
Pola: `^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}$`
Diperlukan: Ya
## Sintaksis Respons
```
{
"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"
}
}
```
## Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah byte fisik yang DataSync ditransfer melalui jaringan setelah kompresi (jika kompresi dimungkinkan). Jumlah ini biasanya kurang dari [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)kecuali data tidak dapat dimampatkan.
Tipe: Long
** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah byte yang DataSync dikirim ke jaringan sebelum kompresi (jika kompresi dimungkinkan). Untuk jumlah byte yang ditransfer melalui jaringan, lihat [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed).
Tipe: Long
** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah byte logis yang DataSync benar-benar menulis ke lokasi tujuan.
Tipe: Long
** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **
Waktu tugas transfer berakhir.
Tipe: Timestamp
** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah byte logis yang DataSync mengharapkan untuk menulis ke lokasi tujuan.
Tipe: Long
** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file, objek, dan direktori yang DataSync diharapkan untuk dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete)
Tipe: Long
** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file, objek, dan direktori yang DataSync diharapkan untuk ditransfer melalui jaringan. Nilai ini dihitung saat DataSync [menyiapkan](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) transfer.
Bagaimana ini dihitung terutama tergantung pada konfigurasi [mode transfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) tugas Anda:
+ Jika `TranserMode` diatur ke `CHANGED` - Perhitungan didasarkan pada membandingkan konten lokasi sumber dan tujuan dan menentukan perbedaan yang perlu ditransfer. Perbedaannya dapat mencakup:
+ Apa pun yang ditambahkan atau dimodifikasi di lokasi sumber.
+ Apa pun yang ada di kedua lokasi dan dimodifikasi di tujuan setelah transfer awal (kecuali [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)diatur ke`NEVER`).
+ **(Hanya mode tugas dasar)** Jumlah item yang DataSync diharapkan untuk dihapus (jika [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)diatur ke`REMOVE`).
+ Jika `TranserMode` diatur ke `ALL` - Perhitungan hanya didasarkan pada item yang DataSync ditemukan di lokasi sumber.
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer)
Tipe: Long
** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync diharapkan untuk dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long
** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync mengharapkan untuk mentransfer melalui jaringan. Nilai ini dihitung sebagai DataSync [mempersiapkan](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) direktori untuk ditransfer.
Bagaimana ini dihitung terutama tergantung pada konfigurasi [mode transfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) tugas Anda:
+ Jika `TranserMode` diatur ke `CHANGED` - Perhitungan didasarkan pada membandingkan konten lokasi sumber dan tujuan dan menentukan perbedaan yang perlu ditransfer. Perbedaannya dapat mencakup:
+ Apa pun yang ditambahkan atau dimodifikasi di lokasi sumber.
+ Apa pun yang ada di kedua lokasi dan dimodifikasi di tujuan setelah transfer awal (kecuali [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)diatur ke`NEVER`).
+ Jika `TranserMode` diatur ke `ALL` - Perhitungan hanya didasarkan pada item yang DataSync ditemukan di lokasi sumber.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long
** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) **
Daftar aturan filter yang mengecualikan data tertentu selama transfer Anda. Untuk informasi dan contoh selengkapnya, lihat [Memfilter data yang ditransfer oleh DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).
Tipe: Array objek [FilterRule](API_FilterRule.md)
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.
** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file, objek, dan direktori yang DataSync benar-benar dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted)
Tipe: Long
** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file atau objek yang DataSync gagal untuk mempersiapkan, mentransfer, memverifikasi, dan menghapus selama pelaksanaan tugas Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md)
** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file atau objek yang DataSync ditemukan di lokasi Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md)
** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file atau objek yang DataSync akan mencoba mentransfer setelah membandingkan lokasi sumber dan tujuan Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Penghitung ini tidak berlaku jika Anda mengonfigurasi tugas Anda untuk [mentransfer semua data](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Dalam skenario itu DataSync , salin semuanya dari sumber ke tujuan tanpa membandingkan perbedaan antar lokasi.
Tipe: Long
** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file, objek, dan direktori yang DataSync dilewati selama transfer Anda.
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped)
Tipe: Long
** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file, objek, dan direktori yang DataSync benar-benar ditransfer melalui jaringan. Nilai ini diperbarui secara berkala selama eksekusi tugas Anda ketika sesuatu dibaca dari sumber dan dikirim melalui jaringan.
Jika DataSync gagal mentransfer sesuatu, nilai ini bisa kurang dari`EstimatedFilesToTransfer`. Dalam beberapa kasus, nilai ini juga bisa lebih besar dari`EstimatedFilesToTransfer`. Elemen ini khusus implementasi untuk beberapa jenis lokasi, jadi jangan gunakan sebagai indikasi yang tepat tentang apa yang ditransfer atau untuk memantau eksekusi tugas Anda.
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred)
Tipe: Long
** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah file, objek, dan direktori yang DataSync memverifikasi selama transfer Anda.
Ketika Anda mengonfigurasi tugas Anda untuk [memverifikasi hanya data yang ditransfer](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html), DataSync tidak memverifikasi direktori dalam beberapa situasi atau file yang gagal ditransfer.
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified)
Tipe: Long
** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync benar-benar dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long
** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync gagal untuk daftar, mempersiapkan, mentransfer, memverifikasi, dan menghapus selama pelaksanaan tugas Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md)
** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync ditemukan di lokasi Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md)
** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync akan mencoba mentransfer setelah membandingkan lokasi sumber dan tujuan Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Penghitung ini tidak berlaku jika Anda mengonfigurasi tugas Anda untuk [mentransfer semua data](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Dalam skenario itu DataSync , salin semuanya dari sumber ke tujuan tanpa membandingkan perbedaan antar lokasi.
Tipe: Long
** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync melompati selama transfer Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long
** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync benar-benar mentransfer melalui jaringan. Nilai ini diperbarui secara berkala selama eksekusi tugas Anda ketika sesuatu dibaca dari sumber dan dikirim melalui jaringan.
Jika DataSync gagal mentransfer sesuatu, nilai ini bisa kurang dari`EstimatedFoldersToTransfer`. Dalam beberapa kasus, nilai ini juga bisa lebih besar dari`EstimatedFoldersToTransfer`.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long
** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **
Jumlah direktori yang DataSync memverifikasi selama transfer Anda.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long
** [Includes](#API_DescribeTaskExecution_ResponseSyntax) **
Daftar aturan filter yang menyertakan data spesifik selama transfer Anda. Untuk informasi dan contoh selengkapnya, lihat [Memfilter data yang ditransfer oleh DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).
Tipe: Array objek [FilterRule](API_FilterRule.md)
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.
** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) **
Waktu pelaksanaan tugas benar-benar dimulai. Untuk tugas non-antrian, `LaunchTime` dan `StartTime` biasanya sama. Untuk tugas antrian, `LaunchTime` biasanya lebih lambat dari `StartTime` karena tugas antrian sebelumnya harus selesai berjalan sebelum tugas yang lebih baru dapat dimulai.
Tipe: Timestamp
** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) **
Konfigurasi manifes yang mencantumkan file atau objek yang akan ditransfer. Untuk informasi selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).
Tipe: Objek [ManifestConfig](API_ManifestConfig.md)
** [Options](#API_DescribeTaskExecution_ResponseSyntax) **
Menunjukkan bagaimana tugas transfer Anda dikonfigurasi. Opsi ini mencakup cara DataSync menangani file, objek, dan metadata terkait selama transfer Anda. Anda juga dapat menentukan cara memverifikasi integritas data, menetapkan batas bandwidth untuk tugas Anda, di antara opsi lainnya.
Setiap opsi memiliki nilai default. Kecuali Anda perlu, Anda tidak perlu mengonfigurasi opsi apa pun sebelum menelepon [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).
Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin `LogLevel` menyesuaikan eksekusi individual.
Tipe: Objek [Options](API_Options.md)
** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) **
Menunjukkan apakah DataSync menghasilkan [laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) lengkap untuk transfer Anda.
Tipe: Objek [ReportResult](API_ReportResult.md)
** [Result](#API_DescribeTaskExecution_ResponseSyntax) **
Hasil eksekusi tugas.
Tipe: Objek [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md)
** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) **
Waktu yang DataSync mengirimkan permintaan untuk memulai eksekusi tugas. Untuk tugas non-antrian, `LaunchTime` dan `StartTime` biasanya sama. Untuk tugas antrian, `LaunchTime` biasanya lebih lambat dari `StartTime` karena tugas antrian sebelumnya harus selesai berjalan sebelum tugas yang lebih baru dapat dimulai.
Tipe: Timestamp
** [Status](#API_DescribeTaskExecution_ResponseSyntax) **
Status tugas.
Untuk informasi rinci tentang status eksekusi tugas, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).
Tipe: String
Nilai yang Valid: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`
** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) **
ARN dari eksekusi tugas yang Anda inginkan informasi tentang. `TaskExecutionArn`bersifat hierarkis dan termasuk `TaskArn` untuk tugas yang dieksekusi.
Misalnya, nilai `TaskExecution` dengan ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` mengeksekusi tugas dengan ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`.
Tipe: String
Batasan Panjang: Panjang maksimum 128.
Pola: `^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) **
Mode tugas yang Anda gunakan. Untuk informasi selengkapnya, lihat [Memilih mode tugas untuk transfer data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: String
Nilai yang Valid: `BASIC | ENHANCED`
** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) **
Konfigurasi laporan tugas Anda, yang memberikan informasi terperinci tentang DataSync transfer Anda. Untuk informasi selengkapnya, lihat [Membuat laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).
Tipe: Objek [TaskReportConfig](API_TaskReportConfig.md)
## Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).
** InternalException **
Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .
Kode Status HTTP: 500
** InvalidRequestException **
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.
Kode Status HTTP: 400
## Contoh
### Permintaan Sampel
Contoh ini menggambarkan `DescribeTaskExecution` permintaan.
```
{
"TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1"
}
```
### Sample Response 1 untuk eksekusi tugas mode Enhanced
Contoh berikut menjelaskan eksekusi DataSync tugas yang menggunakan mode Enhanced. Eksekusi juga mentransfer data tertentu dengan menggunakan exclude dan include filter.
```
{
"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
}
}
```
### Sample Response 2 untuk eksekusi tugas mode Enhanced
Contoh berikut menjelaskan eksekusi DataSync tugas lain yang menggunakan mode Enhanced. Dalam situasi ini, eksekusi mentransfer data tertentu dengan menggunakan manifes alih-alih filter.
```
{
"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
}
}
```
### Contoh Respons untuk eksekusi tugas mode Dasar
Contoh berikut menjelaskan eksekusi DataSync tugas yang menggunakan mode Dasar.
```
{
"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"
}
}
```
## Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+ [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para 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 untuk 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)