CreateTask - AWS DataSync
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanContohLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CreateTask

Mengkonfigurasi tugas, yang menentukan di mana dan bagaimana AWS DataSync mentransfer data Anda.

Tugas mencakup lokasi sumber, lokasi tujuan, dan opsi transfer (seperti batas bandwidth, penjadwalan, dan lainnya).

penting

Jika Anda berencana untuk mentransfer data ke atau dari lokasi Amazon S3, tinjau bagaimana DataSync dapat memengaruhi biaya permintaan S3 dan halaman DataSync harga sebelum memulai.

Sintaksis Permintaan

{
   "CloudWatchLogGroupArn": "string",
   "DestinationLocationArn": "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"
   },
   "SourceLocationArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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 JSON format.

CloudWatchLogGroupArn

Menentukan Nama Sumber Daya Amazon (ARN) dari grup CloudWatch log Amazon untuk memantau tugas Anda.

Untuk informasi selengkapnya, lihat Memantau DataSync dengan Amazon CloudWatch.

Tipe: 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

DestinationLocationArn

Menentukan ARN lokasi tujuan transfer Anda.

Tipe: 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}:location/loc-[0-9a-z]{17}$

Wajib: Ya

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 yang Anda gunakan DataSync ) harus memiliki iam:PassRole izin. AWSDataSyncFullAccessKebijakan tersebut mencakup izin ini.

Tipe: Objek ManifestConfig

Wajib: Tidak

Name

Menentukan nama tugas Anda.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.

Pola: ^[a-zA-Z0-9\s+=._:@/-]+$

Wajib: Tidak

Options

Menentukan pengaturan tugas Anda, seperti melestarikan metadata file, memverifikasi integritas data, di antara opsi lainnya.

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

SourceLocationArn

Menentukan ARN lokasi sumber transfer Anda.

Tipe: 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}:location/loc-[0-9a-z]{17}$

Wajib: Ya

Tags

Menentukan tag yang ingin Anda terapkan untuk tugas Anda.

Tag adalah pasangan nilai kunci yang membantu Anda mengelola, memfilter, dan mencari sumber daya Anda DataSync .

Tipe: Array objek TagListEntry

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.

Wajib: Tidak

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 yang Anda gunakan DataSync ) harus memiliki iam:PassRole izin. AWSDataSyncFullAccessKebijakan tersebut mencakup izin ini.

Tipe: Objek TaskReportConfig

Wajib: Tidak

Sintaksis Respons

{
   "TaskArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

TaskArn

Nama Sumber Daya Amazon (ARN) dari tugas.

Tipe: 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}$

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InternalException

Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .

HTTPKode Status: 500

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

HTTPKode Status: 400

Contoh

Permintaan Sampel

Contoh berikut menciptakan tugas.

{
    "Options": {
        "Atime": "BEST_EFFORT",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "Schedule": {
        "ScheduleExpression": "0 12 ? * SUN,WED *"
    },
    "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group",
    "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50fb",
    "Name": "MyTask",
    "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0f01451b140b2af49",
    "Tags": [{
        "Key": "Name",
        "Value": "Task-1"
    }]
}

Contoh Respons

Respons berikut mencakup Amazon Resource Name (ARN) dari tugas.

{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: