Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # StartTaskExecution Memulai tugas AWS DataSync transfer. Untuk setiap tugas, Anda hanya dapat menjalankan satu eksekusi tugas pada satu waktu. Ada beberapa langkah untuk eksekusi tugas. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses). **penting** Jika Anda berencana untuk mentransfer data ke atau dari lokasi Amazon S3, tinjau [bagaimana DataSync dapat memengaruhi biaya permintaan S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) dan [halaman DataSync harga sebelum memulai](https://aws.amazon.com/datasync/pricing/). ## Sintaksis Permintaan ``` { "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "string" } } }, "OverrideOptions": { "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" }, "Tags": [ { "Key": "string", "Value": "string" } ], "TaskArn": "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" } } ``` ## Parameter Permintaan Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md). Permintaan menerima data berikut dalam format JSON. ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** Menentukan daftar aturan filter yang menentukan file mana yang akan dikecualikan dari tugas. Daftar ini berisi string filter tunggal yang terdiri dari pola untuk dikecualikan. Pola dibatasi oleh "\$1" (yaitu, pipa), misalnya, `"/folder1|/folder2"`. Tipe: Array objek [FilterRule](API_FilterRule.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item. Wajib: Tidak ** [Includes](#API_StartTaskExecution_RequestSyntax) ** Menentukan daftar aturan filter yang menentukan file mana yang akan disertakan saat menjalankan tugas. Pola harus berisi string filter tunggal yang terdiri dari pola yang akan disertakan. Pola dibatasi oleh "\$1" (yaitu, pipa), misalnya, `"/folder1|/folder2"`. Tipe: Array objek [FilterRule](API_FilterRule.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item. Wajib: Tidak ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) ** Mengkonfigurasi manifes, yang merupakan daftar file atau objek yang DataSync ingin Anda transfer. Untuk informasi selengkapnya dan contoh konfigurasi, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html). Saat menggunakan parameter ini, identitas penelepon Anda (peran yang Anda gunakan DataSync ) harus memiliki `iam:PassRole` izin. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini. Untuk menghapus konfigurasi manifes, tentukan parameter ini dengan nilai kosong. Tipe: Objek [ManifestConfig](API_ManifestConfig.md) Wajib: Tidak ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) ** 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) Wajib: Tidak ** [Tags](#API_StartTaskExecution_RequestSyntax) ** Menentukan tag yang ingin Anda terapkan ke Amazon Resource Name (ARN) yang mewakili eksekusi tugas. *Tag* adalah pasangan nilai kunci yang membantu Anda mengelola, memfilter, dan mencari sumber daya Anda DataSync . Tipe: Array objek [TagListEntry](API_TagListEntry.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item. Wajib: Tidak ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** Menentukan Nama Sumber Daya Amazon (ARN) dari tugas yang ingin Anda mulai. 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}$` Wajib: Ya ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) ** Menentukan bagaimana Anda ingin mengkonfigurasi laporan tugas, yang memberikan informasi rinci tentang DataSync transfer Anda. Untuk informasi selengkapnya, lihat [Memantau DataSync transfer Anda dengan laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html). Saat menggunakan parameter ini, identitas penelepon Anda (peran yang Anda gunakan DataSync ) harus memiliki `iam:PassRole` izin. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini. Untuk menghapus konfigurasi laporan tugas, tentukan parameter ini sebagai kosong. Tipe: Objek [TaskReportConfig](API_TaskReportConfig.md) Wajib: Tidak ## Sintaksis Respons ``` { "TaskExecutionArn": "string" } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** ARN dari eksekusi tugas yang sedang berjalan. 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}$` ## Kesalahan Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [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 berikut memulai eksekusi tugas menggunakan opsi default untuk tugas yang ditentukan. ``` { "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### Contoh Respons Contoh ini menggambarkan salah satu penggunaan. StartTaskExecution ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## 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/StartTaskExecution) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution)