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

# StartJob
<a name="start-job-api"></a>

`StartJob`Operasi 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 (](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84)WGS 84). **CountrySpecificAttributes**mencakup data tambahan khusus untuk setiap negara, seperti informasi rute operator, data sensus, dan pengidentifikasi pos.

Untuk informasi selengkapnya, lihat [StartJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_StartJob.html)di *Referensi API Amazon Location Service*.

Misalnya permintaan, tanggapan, dan perintah CLI untuk API ini, lihat [Cara memulai pekerjaan](https://docs.aws.amazon.com/location/latest/developerguide/starting-a-job.html).

## Kasus penggunaan
<a name="start-job-use-cases"></a>
+ **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
<a name="start-job-request-parameters"></a>

`StartJob`Permintaan 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](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) untuk setiap alamat yang divalidasi.
      + `CountrySpecificAttributes`: Termasuk data tambahan khusus untuk setiap negara, seperti informasi rute operator, data sensus, dan pengidentifikasi pos.

## Pahami responsnya
<a name="start-job-response-details"></a>

`StartJob`Tanggapan 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.