Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pelacakan kemajuan pekerjaan dan penanganan kesalahan
Pekerjaan proses massal membutuhkan waktu untuk diproses. Setiap pekerjaan diproses dalam urutan AWS IoT SiteWise menerima permintaan. Ini diproses one-at-a-time untuk setiap akun. Ketika pekerjaan selesai, antrian berikutnya secara otomatis mulai diproses. AWS IoT SiteWise menyelesaikan pekerjaan secara asinkron dan memperbarui status masing-masing saat berlangsung. Setiap pekerjaan memiliki bidang status yang berisi status sumber daya dan pesan kesalahan, jika berlaku.
Negara dapat menjadi salah satu dari nilai berikut:
+ `VALIDATING`— Memvalidasi pekerjaan termasuk format file yang dikirimkan, dan isinya.
+ `PENDING`— Pekerjaan dalam antrian. Anda dapat membatalkan pekerjaan dalam keadaan ini dari AWS IoT SiteWise konsol, tetapi semua negara bagian lain akan berlanjut hingga akhir.
+ `RUNNING`— Memproses pekerjaan. Ini membuat dan memperbarui sumber daya seperti yang didefinisikan oleh file impor, atau mengekspor sumber daya berdasarkan filter pekerjaan ekspor yang dipilih. Jika dibatalkan, sumber daya apa pun yang diimpor oleh pekerjaan ini tidak akan dihapus. Untuk informasi selengkapnya, lihat [Tinjau kemajuan dan detail pekerjaan (konsol)](review-job-progress.md#review-job-progress-console).
+ `CANCELLING`— Pekerjaan secara aktif dibatalkan.
+ `ERROR`Satu atau lebih sumber daya gagal diproses. Periksa laporan pekerjaan terperinci untuk informasi lebih lanjut. Untuk informasi selengkapnya, lihat [Periksa detail kesalahan (konsol)](inspect-errors.md#inspect-errors-console).
+ `COMPLETED`— Job selesai tanpa kesalahan.
+ `CANCELLED`— Pekerjaan dibatalkan dan tidak antri. Jika Anda membatalkan `RUNNING` pekerjaan, sumber daya yang sudah diimpor oleh pekerjaan ini pada saat pembatalan tidak dihapus. AWS IoT SiteWise
**Topics**
+ [Pelacakan kemajuan pekerjaan](review-job-progress.md)
+ [Periksa kesalahan untuk AWS IoT SiteWise](inspect-errors.md)
# Pelacakan kemajuan pekerjaan
## Tinjau kemajuan dan detail pekerjaan (konsol)
Lihat [Impor metadata (konsol)](running-bulk-operations-import.md#import-metadata-console) atau [Ekspor metadata (konsol)](running-bulk-operations-export.md#export-metadata-console) untuk memulai pekerjaan massal.
**Ikhtisar kemajuan pekerjaan di AWS IoT SiteWise konsol:**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Pilih **Operasi massal Baru** dari panel navigasi.
1. Tabel **kemajuan Jobs** di AWS IoT SiteWise konsol, menampilkan daftar pekerjaan operasi massal.
1. Kolom **tipe Job** menjelaskan apakah itu pekerjaan ekspor atau impor. Kolom **Tanggal yang diimpor** menampilkan tanggal pekerjaan dimulai.
1. Kolom **Status** menampilkan status pekerjaan. Anda dapat memilih pekerjaan untuk melihat detail tentang pekerjaan itu.
1. Pekerjaan yang dipilih menunjukkan **Sukses** setelah berhasil, atau daftar kegagalan jika pekerjaan gagal. Deskripsi kesalahan juga ditampilkan dengan setiap jenis sumber daya.
**Ikhtisar detail pekerjaan di AWS IoT SiteWise konsol:**
Tabel **kemajuan Jobs** di AWS IoT SiteWise konsol, menampilkan daftar pekerjaan operasi massal.
1. Pilih pekerjaan untuk melihat detail lebih lanjut.
1. Untuk pekerjaan **impor**, `Data source ARN` mewakili lokasi Amazon S3 dari file impor.
1. Untuk pekerjaan **ekspor**, `Data destination ARN` mewakili lokasi Amazon S3 file setelah ekspor.
1. `Status`Dan`Status reason`, memberikan rincian tambahan tentang pekerjaan saat ini. Lihat [Pelacakan kemajuan pekerjaan dan penanganan kesalahan](jobs-progress-error-handling.md) untuk detail selengkapnya.
1. `Queued position`Ini mewakili posisi pekerjaan dalam antrian proses. Pekerjaan diproses satu per satu. Posisi antrian 1, menunjukkan bahwa pekerjaan akan diproses selanjutnya.
1. Halaman detail pekerjaan juga menampilkan jumlah kemajuan pekerjaan.
1. Jenis jumlah kemajuan pekerjaan adalah:
1. `Total resources`— Menunjukkan jumlah total aset dalam proses transfer.
1. `Succeeded`— Menunjukkan jumlah aset yang berhasil ditransfer selama proses.
1. `Failed`— Menunjukkan jumlah aset yang gagal selama proses.
1. `Skipped`— Menunjukkan jumlah aset yang dilewati selama proses.
1. Status pekerjaan `PENDING` atau`VALIDATING`, menampilkan semua kemajuan pekerjaan dihitung sebagai`–`. Ini menunjukkan bahwa jumlah kemajuan pekerjaan sedang dievaluasi.
1. Status pekerjaan `RUNNING` menampilkan `Total resources` hitungan, pekerjaan yang diajukan untuk diproses. Hitungan terperinci (`Succeeded`,`Failed`, dan`Skipped`), berlaku untuk sumber daya yang diproses. Jumlah dari hitungan rinci lebih kecil dari `Total resources` hitungan, sampai status pekerjaan adalah `COMPLETED` atau. `ERROR`
1. Jika status pekerjaan adalah `COMPLETED` atau`ERROR`, `Total resources` hitungannya sama dengan jumlah hitungan rinci (`Succeeded`,`Failed`, dan`Skipped`).
1. Jika status pekerjaan adalah`ERROR`, periksa tabel **Kegagalan Job** untuk rincian tentang kesalahan dan kegagalan tertentu. Lihat [Periksa detail kesalahan (konsol)](inspect-errors.md#inspect-errors-console) untuk detail selengkapnya.
## Tinjau kemajuan dan detail pekerjaan (AWS CLI)
Setelah memulai operasi massal, Anda dapat memeriksa atau memperbarui statusnya menggunakan tindakan API berikut:
+ Untuk mengambil informasi tentang pekerjaan tertentu, gunakan tindakan [ GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)API.
**Mengambil informasi dengan `GetMetadataTransferJob` API:**
1. Buat dan jalankan pekerjaan transfer. Panggil `GetMetadataTransferJob` API.
**Example AWS CLI perintah:**
```
aws iottwinmaker get-metadata-transfer-job \
--metadata-transfer-job-id your_metadata_transfer_job_id \
--region your_region
```
1. `GetMetadataTransferJob`API mengembalikan `MetadataTransferJobProgress` objek dengan parameter berikut:
+ **SucceededCount** - Menunjukkan jumlah aset yang berhasil ditransfer dalam proses.
+ **FailedCount** - Menunjukkan jumlah aset yang gagal selama proses.
+ **SkippedCount** - Menunjukkan jumlah aset yang dilewati selama proses.
+ **TotalCount** — Menunjukkan jumlah total aset dalam proses transfer.
Parameter ini menunjukkan status kemajuan pekerjaan. Jika statusnya`RUNNING`, mereka membantu melacak jumlah sumber daya yang masih akan diproses.
Jika Anda menemukan kesalahan validasi skema, atau jika **failedCount** lebih besar dari atau sama dengan 1, status kemajuan pekerjaan berubah menjadi. `ERROR` Laporan kesalahan lengkap untuk pekerjaan tersebut ditempatkan di bucket Amazon S3 Anda. Lihat [Periksa kesalahan untuk AWS IoT SiteWise](inspect-errors.md) untuk detail selengkapnya.
+ Untuk membuat daftar pekerjaan saat ini, gunakan tindakan [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html)API.
Gunakan file JSON untuk memfilter pekerjaan yang dikembalikan berdasarkan statusnya saat ini. Lihat prosedur berikut:
1. Untuk menentukan filter yang ingin Anda gunakan, buat file JSON AWS CLI masukan. ingin menggunakan:
```
{
"sourceType": "s3",
"destinationType": "iottwinmaker",
"filters": [{
"state": "COMPLETED"
}]
}
```
Untuk daftar `state` nilai yang valid, lihat [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)di *Panduan Referensi AWS IoT TwinMaker API*.
1. Gunakan file JSON sebagai argumen dalam AWS CLI contoh perintah berikut:
```
aws iottwinmaker list-metadata-transfer-job --region your_region \
--cli-input-json file://ListMetadataTransferJobsExample.json
```
+ Untuk membatalkan pekerjaan, gunakan tindakan [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html)API. API ini membatalkan tugas transfer metadata tertentu, tanpa memengaruhi sumber daya apa pun yang sudah diekspor atau diimpor:
```
aws iottwinmaker cancel-metadata-transfer-job \
--region your_region \
--metadata-transfer-job-id job-to-cancel-id
```
# Periksa kesalahan untuk AWS IoT SiteWise
## Periksa detail kesalahan (konsol)
**Detail kesalahan di AWS IoT SiteWise konsol:**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Lihat tabel **kemajuan Pekerjaan** Konsol AWS IoT SiteWise untuk daftar pekerjaan operasi massal.
1. Pilih pekerjaan untuk melihat detail pekerjaan.
1. Jika status pekerjaan adalah `COMPLETED` atau`ERROR`, `Total resources` hitungannya sama dengan jumlah hitungan rinci (`Succeeded`,`Failed`, dan`Skipped`).
1. Jika status pekerjaan adalah`ERROR`, periksa tabel **Kegagalan Job** untuk rincian tentang kesalahan dan kegagalan tertentu.
1. Tabel **kegagalan Job** menampilkan konten dari laporan pekerjaan. `Resource type`Bidang menunjukkan lokasi kesalahan atau kegagalan, seperti berikut ini:
+ Misalnya, kesalahan validasi `Bulk operations template` di `Resource type` bidang menunjukkan bahwa templat impor dan format file skema metadata tidak cocok. Untuk informasi selengkapnya, lihat [AWS IoT SiteWise skema pekerjaan transfer metadata](bulk-operations-schema.md).
+ Gagal `Asset` di `Resource type` lapangan menunjukkan bahwa aset tidak dibuat karena konflik dengan aset lain. Lihat [Kesalahan umum](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/CommonErrors.html) untuk informasi tentang kesalahan dan konflik AWS IoT SiteWise sumber daya.
## Periksa detail kesalahan ()AWS CLI
Untuk menangani dan mendiagnosis kesalahan yang dihasilkan selama tugas transfer, lihat prosedur berikut tentang penggunaan tindakan `GetMetadataTransferJob` API:
1. Setelah membuat dan menjalankan pekerjaan transfer, hubungi [GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html):
```
aws iottwinmaker get-metadata-transfer-job \
--metadata-transfer-job-id your_metadata_transfer_job_id \
--region us-east-1
```
1. Setelah Anda melihat status pekerjaan beralih ke`COMPLETED`, Anda dapat mulai memverifikasi hasil pekerjaan.
1. Ketika Anda memanggil`GetMetadataTransferJob`, ia mengembalikan objek yang dipanggil [https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html).
MetadataTransferJobProgress Objek berisi parameter berikut:
+ **FailedCount:** Menunjukkan jumlah aset yang gagal selama proses transfer.
+ **SkippedCount:** Menunjukkan jumlah aset yang dilewati selama proses transfer.
+ **SucceededCount:** Menunjukkan jumlah aset yang berhasil selama proses transfer.
+ **TotalCount:** Menunjukkan jumlah total aset yang terlibat dalam proses transfer.
1. Selain itu, panggilan API mengembalikan elemen`reportUrl`, yang berisi URL presigned. Jika pekerjaan transfer Anda memiliki masalah yang perlu Anda selidiki lebih lanjut, kunjungi url ini.