View a markdown version of this page

StartJob - Amazon Location Service
Kasus penggunaanPahami permintaannyaPahami responsnya

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

StartJob

StartJobOperasi ini memulai pekerjaan pemrosesan data Lokasi Amazon yang baru. Anda menentukan jenis tindakan, masukan dan keluaran lokasi Amazon S3, serta peran eksekusi IAM yang memberikan akses layanan ke bucket Anda. Operasi mengembalikan pengenal pekerjaan, Nama Sumber Daya Amazon (ARN), dan status awal yang dapat Anda gunakan untuk memantau kemajuan pekerjaan.

Anda dapat meminta fitur tambahan menggunakan ActionOptions parameter dalam StartJob permintaan. Fitur-fitur ini memberikan opsi yang disempurnakan untuk pemrosesan dan hasil data.

Untuk ValidateAddress pekerjaan, fitur Posisi mencakup koordinat lintang dan bujur dalam format Sistem Geodetik Dunia (WGS 84). CountrySpecificAttributesmencakup data tambahan khusus untuk setiap negara, seperti informasi rute operator, data sensus, dan pengidentifikasi pos.

Untuk informasi selengkapnya, lihat StartJobdi Referensi API Amazon Location Service.

Misalnya permintaan, tanggapan, dan perintah CLI untuk API ini, lihat Cara memulai pekerjaan.

Kasus penggunaan

  • Migrasi data dan konsolidasi sistem: Bersihkan dan standarisasi volume besar data alamat saat bermigrasi antar sistem atau mengkonsolidasikan beberapa sumber data ke dalam database terpadu.

  • Persiapan kampanye pemasaran: Validasi basis data alamat pelanggan sebelum meluncurkan kampanye surat langsung untuk mengurangi biaya surat yang dikembalikan dan meningkatkan tingkat keberhasilan pengiriman.

  • Pemeliharaan dan kepatuhan basis data: Secara teratur memvalidasi basis data alamat pelanggan yang ada untuk mempertahankan standar kualitas data dan memenuhi persyaratan kepatuhan pengiriman dan logistik.

Pahami permintaannya

StartJobPermintaan memerlukan detail konfigurasi yang menentukan tindakan pekerjaan, lokasi data, dan izin. Konfigurasi ini menentukan bagaimana data Anda diproses dan di mana hasil disimpan.

Permintaan tersebut mencakup parameter berikut:

Tindakan pekerjaan dan izin

Parameter yang diperlukan yang menentukan jenis operasi dan izin akses.

  • Action: Jenis operasi yang harus dilakukan. Saat ini hanya mendukung ValidateAddress.

  • ExecutionRoleArn: Peran IAM ARN yang diasumsikan Lokasi Amazon untuk mengakses bucket Amazon S3 Anda selama eksekusi pekerjaan.

Konfigurasi masukan

Parameter yang diperlukan yang menentukan tempat membaca data input dan formatnya.

  • InputOptions: Objek yang berisi konfigurasi data masukan.

    • Location: Amazon S3 ARN atau URI tempat file input disimpan.

    • Format: Format data masukan. Saat ini hanya mendukung Parquet.

Konfigurasi keluaran

Parameter yang diperlukan yang menentukan tempat menulis hasil dan formatnya.

  • OutputOptions: Objek yang berisi konfigurasi data keluaran.

    • Location: Amazon S3 ARN atau URI tempat file output ditulis.

    • Format: Format data keluaran. Saat ini hanya mendukung Parquet.

Parameter opsional

Parameter yang menyediakan konfigurasi dan fitur pekerjaan tambahan.

  • Name: Nama pekerjaan yang dapat dibaca manusia untuk identifikasi yang lebih mudah. Harus 1-100 karakter pola [-._\w]+ pencocokan.

  • ClientToken: Token idempotensi untuk memastikan pekerjaan yang sama tidak dibuat beberapa kali. Harus 1-64 karakter pola ^[!-~]+$ pencocokan.

  • ActionOptions: Objek yang berisi fitur tambahan untuk tindakan yang ditentukan.

    • ValidateAddress: Objek yang berisi opsi khusus untuk validasi alamat.

      • AdditionalFeatures: Array nama fitur untuk disertakan dalam hasil. Nilai valid:

        • Position: Termasuk garis lintang dan bujur dalam format WGS 84 untuk setiap alamat yang divalidasi.

        • CountrySpecificAttributes: Termasuk data tambahan khusus untuk setiap negara, seperti informasi rute operator, data sensus, dan pengidentifikasi pos.

Pahami responsnya

StartJobTanggapan tersebut memberikan informasi penting untuk memantau dan mengelola pekerjaan yang baru dibuat. Gunakan nilai-nilai ini untuk melacak kemajuan pekerjaan dan mengambil hasil saat pemrosesan selesai.

Tanggapan tersebut mencakup bidang-bidang berikut:

Identifikasi Job

Pengidentifikasi unik untuk pekerjaan yang dibuat.

  • JobId: Pengidentifikasi pekerjaan unik yang digunakan untuk operasi pemantauan dan manajemen.

  • JobArn: ARN yang secara unik mengidentifikasi pekerjaan di dalamnya. AWS

Status dan waktu Job

Status awal dan stempel waktu pembuatan.

  • Status: Status pekerjaan awal. Selalu Pending untuk pekerjaan yang baru dibuat.

  • CreatedAt: Stempel waktu pembuatan Job dalam format ISO 8601.