Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
UpdateTask
Memperbarui konfigurasi tugas, yang menentukan di mana dan bagaimana AWS DataSync mentransfer data Anda.
Sintaksis Permintaan
{
"CloudWatchLogGroupArn": "string",
"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"
}
}
},
"Name": "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"
},
"Schedule": {
"ScheduleExpression": "string",
"Status": "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.
Permintaan menerima data berikut dalam format JSON.
- CloudWatchLogGroupArn
-
Menentukan Nama Sumber Daya Amazon (ARN) dari grup log CloudWatch Amazon untuk memantau tugas Anda.
Untuk informasi selengkapnya, lihat Memantau DataSync dengan Amazon CloudWatch.
Jenis: String
Batasan Panjang: Panjang maksimum 562.
Pola:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$Wajib: Tidak
- Excludes
-
Menentukan mengecualikan filter yang menentukan file, objek, dan folder di lokasi sumber Anda yang tidak DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat Menentukan DataSync transfer apa yang menggunakan filter.
Tipe: Array objek FilterRule
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.
Wajib: Tidak
- Includes
-
Menentukan termasuk filter menentukan file, objek, dan folder di lokasi sumber Anda yang DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat Menentukan DataSync transfer apa yang menggunakan filter.
Tipe: Array objek FilterRule
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.
Wajib: Tidak
- ManifestConfig
-
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.
Saat menggunakan parameter ini, identitas penelepon Anda (peran IAM yang Anda gunakan DataSync ) harus memiliki izin.
iam:PassRoleAWSDataSyncFullAccessKebijakan tersebut mencakup izin ini.Untuk menghapus konfigurasi manifes, tentukan parameter ini sebagai kosong.
Tipe: Objek ManifestConfig
Wajib: Tidak
- Name
-
Menentukan nama tugas Anda.
Jenis: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.
Pola:
^[a-zA-Z0-9\s+=._:@/-]+$Wajib: Tidak
- Options
-
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.
Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin
LogLevelmenyesuaikan eksekusi individual.Tipe: Objek Options
Wajib: Tidak
- Schedule
-
Menentukan jadwal untuk ketika Anda ingin tugas Anda untuk menjalankan. Untuk informasi selengkapnya, lihat Menjadwalkan tugas Anda.
Tipe: Objek TaskSchedule
Wajib: Tidak
- TaskArn
-
Menentukan ARN dari tugas yang ingin Anda perbarui.
Jenis: String
Batasan Panjang: Panjang maksimum 128.
Pola:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}$Wajib: Ya
- TaskReportConfig
-
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.
Saat menggunakan parameter ini, identitas penelepon Anda (peran IAM yang Anda gunakan DataSync ) harus memiliki izin.
iam:PassRoleAWSDataSyncFullAccessKebijakan tersebut mencakup izin ini.Untuk menghapus konfigurasi laporan tugas, tentukan parameter ini sebagai kosong.
Tipe: Objek TaskReportConfig
Wajib: Tidak
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- 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
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
