Operasi massal dengan aset dan model

Untuk bekerja dengan sejumlah besar aset atau model aset, gunakan operasi massal untuk mengimpor dan mengekspor sumber daya secara massal ke lokasi yang berbeda. Misalnya, Anda dapat membuat file data yang mendefinisikan aset atau model aset di bucket Amazon S3, dan menggunakan impor massal untuk membuat atau memperbaruinya. AWS IoT SiteWise Atau, jika Anda memiliki sejumlah besar aset atau model aset AWS IoT SiteWise, Anda dapat mengekspornya ke Amazon S3.

catatan

Anda melakukan operasi massal AWS IoT SiteWise dengan memanggil operasi di AWS IoT TwinMaker API. Anda dapat melakukan ini tanpa menyiapkan AWS IoT TwinMaker atau membuat AWS IoT TwinMaker ruang kerja. Yang Anda butuhkan hanyalah ember Amazon S3 tempat Anda dapat menempatkan konten Anda AWS IoT SiteWise .

Topik

• Konsep dan terminologi kunci
• Fungsionalitas yang didukung
• Prasyarat operasi massal
• Menjalankan pekerjaan impor massal
• Menjalankan pekerjaan ekspor massal
• Pelacakan kemajuan pekerjaan dan penanganan kesalahan
• Impor contoh metadata
• Contoh metadata ekspor
• AWS IoT SiteWise skema pekerjaan transfer metadata

Konsep dan terminologi kunci

AWS IoT SiteWise fitur impor dan ekspor massal bergantung pada konsep dan terminologi berikut:

• Impor: Tindakan memindahkan aset atau model aset dari file di bucket Amazon S3 ke file. AWS IoT SiteWise

• Ekspor: Tindakan memindahkan aset atau model aset dari bucket Amazon S3 AWS IoT SiteWise ke bucket Amazon S3.

• Sumber: Lokasi awal dari mana Anda ingin memindahkan konten.

  Misalnya, bucket Amazon S3 adalah sumber impor, dan AWS IoT SiteWise merupakan sumber ekspor.

• Tujuan: Lokasi yang diinginkan di mana Anda ingin memindahkan konten Anda.

  Misalnya, bucket Amazon S3 adalah tujuan ekspor, dan AWS IoT SiteWise merupakan tujuan impor.

• AWS IoT SiteWise Skema: Skema ini digunakan untuk mengimpor dan mengekspor metadata dari. AWS IoT SiteWise

• Sumber daya tingkat atas: AWS IoT SiteWise Sumber daya yang dapat Anda buat atau perbarui secara individual, seperti model aset atau aset.

• Sub-sumber daya: Sumber AWS IoT SiteWise daya bersarang dalam sumber daya tingkat atas. Contohnya termasuk properti, hierarki, dan model komposit.

• Metadata: Informasi penting yang diperlukan untuk mengimpor atau mengekspor sumber daya dengan sukses. Contoh metadata adalah definisi aset dan model aset.

• metadataTransferJob: Objek yang dibuat saat Anda menjalankanCreateMetadataTransferJob.

Fungsionalitas yang didukung

Topik ini menjelaskan apa yang dapat Anda lakukan ketika Anda menjalankan operasi massal. Operasi massal mendukung fungsionalitas berikut:

• Pembuatan sumber daya tingkat atas: Saat Anda mengimpor aset atau model aset yang tidak menentukan ID, atau ID yang tidak cocok dengan ID yang sudah ada, maka ID tersebut akan dibuat sebagai sumber daya baru.

• Penggantian sumber daya tingkat atas: Ketika Anda mengimpor aset atau model aset yang ID-nya cocok dengan yang sudah ada, maka itu akan menggantikan sumber daya yang ada.

• Pembuatan, penggantian, atau penghapusan subsumber daya: Ketika impor Anda menggantikan sumber daya tingkat atas seperti aset atau model aset, definisi baru akan menggantikan semua sub-sumber daya, seperti properti, hierarki, atau model komposit.

  Misalnya, jika Anda memperbarui model aset selama impor massal, dan versi yang diperbarui mendefinisikan properti yang tidak ada pada aslinya, maka properti baru akan dibuat. Jika mendefinisikan properti yang sudah ada, maka properti yang ada akan diperbarui. Jika model aset yang diperbarui menghilangkan properti yang ada pada aslinya, maka properti tersebut akan dihapus.

• Tidak ada penghapusan sumber daya tingkat atas: Operasi massal tidak menghapus aset atau model aset. Operasi massal hanya membuat atau memperbaruinya.