全部产品
Search
文档中心

IoT Platform:Catatan Penggunaan

更新时间:Jun 21, 2025

Instance publik versi sebelumnya tidak lagi mendukung peningkatan spesifikasi sumber daya. Untuk mengatasi masalah ini, IoT Platform menyediakan fitur migrasi instance. Anda dapat menggunakan fitur ini untuk memigrasikan produk, perangkat, dan data penerusan pesan dari instance publik versi sebelumnya ke instance Standard Edisi Perusahaan dalam akun yang sama dan wilayah yang sama. Ini membantu mengurangi dampak migrasi serta biaya transformasi sistem. Topik ini menjelaskan cara menggunakan fitur migrasi instance dan catatan penggunaan terkait.

Batasan

null

Anda hanya dapat memigrasikan data dari instance publik versi sebelumnya ke instance Standard Edisi Perusahaan. Untuk informasi lebih lanjut, lihat Ikhtisar.

Item

Deskripsi

Batasan

Jumlah maksimum tugas distribusi dan migrasi perangkat bersamaan

Jumlah maksimum tugas distribusi dan migrasi perangkat yang dapat berjalan secara bersamaan.

null

IoT Platform memungkinkan Anda memigrasikan perangkat yang memiliki fitur distribusi perangkat diaktifkan ke instance Edisi Perusahaan. Untuk informasi lebih lanjut, lihat Distribusikan perangkat.

5

Jumlah minimum perangkat online

Jumlah minimum perangkat yang online dan terhubung ke instance Edisi Perusahaan tujuan.

Nilai item ini harus lebih besar dari jumlah perangkat yang ingin Anda migrasikan.

Instance Edisi Perusahaan tujuan

  • Produk dan perangkat yang sesuai dapat dimigrasikan hanya ke satu instance Edisi Perusahaan.

  • Produk dan perangkat yang sesuai dapat dimigrasikan hanya ke satu instance Edisi Perusahaan yang berada di wilayah yang sama dengan produk dan perangkat tersebut.

1

Jumlah maksimum perangkat

Jumlah maksimum perangkat yang dapat dimigrasikan dari sebuah produk.

null

Jika Anda ingin meningkatkan batas berdasarkan kebutuhan bisnis Anda, ajukan tiket.

500.000

Catatan Migrasi

Sebelum memigrasikan data instance publik, perhatikan hal-hal berikut untuk mengevaluasi dampak potensial migrasi pada bisnis Anda.

  • Data yang akan dimigrasikan

    Saat memigrasikan data instance publik, IoT Platform secara otomatis menyinkronkan produk, perangkat, dan data penerusan pesan dari instance publik. Tabel berikut menjelaskan data yang akan dimigrasikan.

    Item

    Data yang akan dimigrasikan

    Catatan Penggunaan

    Produk

    • Informasi produk: ProductKey, nama produk, tipe node, dan kategori.

    • Fitur: properti, layanan, acara, ekstensi model Thing Specification Language (TSL), dan model TSL draf.

    • Skrip: skrip penguraian data dan skrip penguraian data draf.

    • Anda dapat memigrasikan produk dan perangkat yang mendukung metode verifikasi sertifikat unik per perangkat dan pra-pendaftaran sertifikat unik per produk.

    • Saat Anda memigrasikan sub-perangkat, hubungan topologi antara sub-perangkat dan gateway terkait tetap tidak berubah. Setelah Anda memigrasikan sub-perangkat, sub-perangkat dapat terhubung ke IoT Platform seperti yang diharapkan. Jika Anda ingin memigrasikan gateway atau sub-perangkat yang dilampirkan, Anda harus memigrasikan gateway dan sub-perangkat ke instance Edisi Perusahaan pada saat yang sama.

    • Anda tidak dapat memigrasikan produk dan perangkat yang diotorisasi. Fitur otorisasi tidak tersedia untuk produk dan perangkat instance Edisi Perusahaan.

    • Anda tidak dapat memigrasikan produk dan perangkat yang memiliki layanan data diaktifkan.

    • Anda tidak dapat memigrasikan produk dan perangkat yang memiliki LinkVisual diaktifkan.

    • Anda tidak dapat memigrasikan produk dan perangkat yang terhubung ke Link IoT Edge dan IoT Platform for Daily Life pada saat yang sama.

    • Setelah migrasi, jenis verifikasi TSL produk tetap tidak berubah.

    • Setelah migrasi, sistem mempertahankan data asli pada instance publik versi sebelumnya. Untuk mencegah kehilangan data karena operasi tidak disengaja, kami sarankan Anda menghapus data asli setelah tugas migrasi instance selesai dan bisnis berjalan seperti yang diharapkan.

    Perangkat

    • Informasi perangkat: informasi sertifikat perangkat. Pastikan setiap sertifikat perangkat unik secara global.

    • Data perangkat: data properti, acara, dan layanan TSL.

    null

    Anda tidak dapat memigrasikan perangkat terdistribusi dari sebuah instance.

    • Fitur rekoneksi harus diaktifkan untuk perangkat yang ingin Anda migrasikan. Anda harus mengonfigurasi Link SDK terkait untuk menghubungkan perangkat ke IoT Platform dan memastikan bahwa perangkat dapat berkomunikasi dengan IoT Platform seperti yang diharapkan.

      null
      • Jika Anda menggunakan Link SDK yang disediakan oleh IoT Platform untuk mengembangkan perangkat, perangkat secara otomatis terhubung ke instance Edisi Perusahaan. Anda tidak perlu memodifikasi titik akhir perangkat. Untuk informasi lebih lanjut tentang Link SDK, lihat Koneksi perangkat menggunakan Link SDK.

      • Jika Anda tidak menggunakan Link SDK yang disediakan oleh IoT Platform, Anda harus memodifikasi titik akhir perangkat dan mengembangkan logika rekoneksi perangkat.

    • Jika perangkat terhubung ke IoT Platform selama migrasi, perangkat diputuskan secara paksa dari IoT Platform.

    • Setelah migrasi, sistem menghapus perangkat yang dimigrasikan dari instance publik versi sebelumnya. Anda tidak perlu memodifikasi Link SDK terkait. Perangkat dapat terhubung ke instance Edisi Perusahaan tujuan dan berkomunikasi dengan instance seperti yang diharapkan.

    • Hanya pengguna dalam daftar putih yang dapat memigrasikan perangkat yang diverifikasi menggunakan ID perangkat IoT. Anda dapat ajukan tiket untuk mengajukan izin daftar putih. Untuk informasi lebih lanjut tentang ID perangkat IoT, lihat Gunakan ID perangkat IoT untuk memverifikasi perangkat.

    • Saat Anda memigrasikan data TSL perangkat, perhatikan item berikut:

      • Secara default, fitur sinkronisasi data dinonaktifkan. Setelah Anda membuat tugas migrasi, aktifkan fitur sinkronisasi data. Ini memastikan bahwa bisnis Anda tidak terpengaruh selama migrasi.

      • Setelah Anda mengaktifkan fitur sinkronisasi data, sistem menyinkronkan data yang dikirimkan oleh perangkat produk yang akan dimigrasikan dari instance publik ke instance Edisi Perusahaan tujuan dalam satu menit. Sinkronisasi data efektif hingga 30 hari ke depan.

      • Anda dapat mengaktifkan atau menonaktifkan fitur sinkronisasi data untuk perangkat. Jika Anda mengaktifkan fitur sinkronisasi data, sistem secara otomatis menonaktifkan fitur tersebut 30 hari setelah Anda mengaktifkan fitur tersebut. Sebelum Anda menonaktifkan fitur sinkronisasi data, pastikan bahwa migrasi instance selesai. Ini mencegah bisnis Anda terpengaruh.

      • Sistem melakukan sinkronisasi data satu arah. Data yang dikirimkan oleh perangkat produk yang ingin Anda migrasikan hanya disinkronkan dari instance publik ke instance Edisi Perusahaan tujuan.

        Jika Anda mengembalikan perangkat dari instance Edisi Perusahaan ke instance publik saat fitur sinkronisasi data diaktifkan, data perangkat tidak dikembalikan. Jika Anda memigrasikan ulang perangkat ke instance Edisi Perusahaan, pastikan bahwa data pada Edisi Perusahaan utuh. Data pada instance publik mungkin tidak utuh.

    Penerusan Pesan

    • Langganan sisi server: konfigurasi langganan sisi server Advanced Message Queuing Protocol (AMQP) dan Message Service (MNS) serta hubungan langganan.

    • Penerusan data: aturan penerusan data yang mencakup pernyataan SQL, sumber data, tujuan data, dan skrip penguraian data. Tujuan data dapat berupa ApsaraMQ for RocketMQ, Time Series Database, ApsaraDB RDS, dan Function Compute.

    • Kelompok konsumen: informasi kelompok konsumen. Setelah migrasi, sistem membuat kelompok konsumen dan menghasilkan ID baru untuk kelompok konsumen.

    • Setelah migrasi, sistem mempertahankan data asli pada instance publik versi sebelumnya. Untuk mencegah kehilangan data karena operasi tidak disengaja, kami sarankan Anda menghapus data asli setelah tugas migrasi instance selesai dan bisnis berjalan seperti yang diharapkan.

    • Jika langganan sisi server AMQP dikonfigurasi atau data diteruskan ke kelompok konsumen AMQP, Anda harus memulai dua klien AMQP. Klien AMQP dapat secara bersamaan menerima data dari instance publik dan instance Edisi Perusahaan. Ini membantu mencegah kehilangan data.

    • Klien tidak dapat mengakses instance Edisi Perusahaan menggunakan langganan HTTP/2. Setelah tugas migrasi selesai, kami sarankan Anda mengubah langganan sisi server HTTP/2 untuk instance publik sumber menjadi langganan sisi server AMQP.

  • Fitur:

    Setelah perangkat dimigrasikan ke instance Edisi Perusahaan, konfigurasi perangkat tetap dapat digunakan seperti biasa. Jika ingin menggunakan fitur tambahan, Anda dapat mengonfigurasinya di instance Edisi Perusahaan. Untuk detail lebih lanjut tentang penggunaan fitur, lihat Catatan penggunaan fitur setelah migrasi.

  • Penagihan:

    Setelah perangkat dimigrasikan ke instance Edisi Perusahaan, Anda tidak lagi dikenakan biaya untuk item berikut: pesan, durasi koneksi, dan pembaruan over-the-air (OTA).

Sebelum Anda Memulai

Setelah membaca catatan migrasi, evaluasi dampak bisnis dan transformasi sistem sebelum memigrasikan instance. Langkah ini memastikan bahwa perangkat yang dimigrasikan dapat berkomunikasi dengan IoT Platform sesuai harapan.

Item

Evaluasi dan Pemrosesan

Referensi

Produk dan Perangkat

Periksa apakah produk dan perangkat yang ingin Anda migrasikan memenuhi persyaratan migrasi. Untuk informasi tentang catatan migrasi pada produk dan perangkat, lihat konten kolom Catatan Penggunaan di bagian Catatan Migrasi dari topik ini.

Tidak ada

Langganan Sisi Server AMQP

Periksa apakah langganan sisi server AMQP dikonfigurasi atau data diteruskan ke kelompok konsumen AMQP.

Jika langganan sisi server AMQP dikonfigurasi atau data diteruskan ke kelompok konsumen AMQP pada instance publik, Anda harus menyalin ID instance Edisi Perusahaan dan titik akhir setelah migrasi, mengonfigurasi klien AMQP baru, dan kemudian menghubungkan klien baru ke IoT Platform menggunakan SDK. Setelah migrasi bertahap selesai, Anda harus menyalin ID kelompok konsumen baru dan memulai klien AMQP baru.

Hubungkan klien AMQP ke IoT Platform

Penerusan Data

Konfigurasikan aturan penerusan data untuk instance publik.

  • Tentukan topik untuk menerima pesan ketika acara yang terkait dengan semua tugas migrasi terjadi pada instance publik dan berlangganan pesan ketika status tugas migrasi instance berubah.

  • Teruskan dan simpan data perangkat ke database Anda. Selama migrasi instance, sistem memigrasikan aturan penerusan data dan memperbarui ID instance publik sumber tempat perangkat milik ke ID instance Edisi Perusahaan tujuan di database.

Konfigurasikan aturan penerusan data

Pembaruan OTA

Periksa apakah tugas pembaruan OTA sedang berjalan pada perangkat produk yang ingin Anda migrasikan.

Jika tugas pembaruan OTA sedang berjalan, hentikan tugas pembaruan OTA. Jika Anda tidak menghentikan tugas pembaruan OTA, tugas pembaruan OTA mungkin gagal selama migrasi instance dan Anda terus dikenakan biaya untuk tugas pembaruan OTA.

Lihat status pembaruan

Panggil Operasi API IoT Platform

Periksa apakah perangkat yang dimigrasikan dikonfigurasi untuk memanggil operasi API IoT Platform.

Jika perangkat yang dimigrasikan dapat memanggil operasi API IoT Platform, Anda harus memodifikasi parameter permintaan operasi untuk menentukan ID instance Edisi Perusahaan.

Anda harus mengembangkan aplikasi atau mengonfigurasi server berdasarkan kebutuhan bisnis Anda. Sebelum Anda memanggil operasi API IoT Platform, Anda harus menanyakan semua tabel database untuk mendapatkan ID instance Edisi Perusahaan. Kemudian, atur parameter IotInstanceId ke ID instance Edisi Perusahaan dan panggil operasi API.

Untuk informasi lebih lanjut tentang cara mengonfigurasi layanan, lihat Contoh cara mengonfigurasi server yang terkait dengan migrasi instance.

Unduh SDK IoT Platform

Proses Migrasi Instance

流程图

Proses migrasi instance terdiri dari empat langkah yang ditunjukkan pada gambar di atas.

Langkah

Deskripsi

Evaluasi Bisnis

Sebelum migrasi instance, Anda harus mengevaluasi dampak bisnis. Untuk informasi lebih lanjut, lihat bagian Catatan Migrasi dari topik ini.

Transformasi Sistem

Transformasikan sistem berdasarkan hasil evaluasi bisnis. Ini membantu memastikan bahwa bisnis yang terkait dengan perangkat instance publik dan instance Edisi Perusahaan berjalan seperti yang diharapkan. Bisnis mencakup item berikut:

  • Operasi API IoT Platform: Saat Anda memanggil operasi API IoT Platform, Anda harus memodifikasi parameter permintaan untuk menentukan ID instance Edisi Perusahaan.

  • Langganan sisi server dan aturan penerusan data: Anda harus mengonfigurasi aturan penerusan data dan langganan sisi server baru untuk menerima data perangkat yang dimigrasikan.

null
  • Sebelum Anda memanggil operasi API IoT Platform, Anda harus mengonfigurasi langganan dan aturan penerusan data untuk data status migrasi instance. Dengan cara ini, Anda dapat menerima pesan ketika perangkat dimigrasikan dan memperbarui ID instance tempat perangkat milik.

  • Jika langganan sisi server AMQP dan aturan penerusan data yang dikonfigurasi lulus verifikasi setelah migrasi bertahap selesai, konfigurasikan kelompok konsumen baru dan mulai ulang klien AMQP terkait.

Untuk informasi lebih lanjut, lihat bagian Sebelum Anda Memulai dari topik ini.

Migrasikan Data Instance

Di konsol IoT Platform, buat tugas migrasi untuk memigrasikan data produk tertentu. Untuk informasi lebih lanjut, lihat bagian Prosedur Migrasi dari topik ini.

Ubah Objek Tempat Operasi API IoT Platform Berlaku

Setelah migrasi penuh selesai, periksa status bisnis Anda dan hasil migrasi. Pastikan bahwa operasi API IoT Platform yang ingin Anda panggil berlaku pada instance Edisi Perusahaan tujuan.

Kami sarankan Anda berlangganan data yang diteruskan dari perangkat yang ingin Anda migrasikan. Setelah perangkat dimigrasikan, sistem mengubah ID instance tempat perangkat milik ke ID instance Edisi Perusahaan di tabel sistem database yang sesuai. Saat Anda memanggil operasi API IoT Platform, sistem menanyakan tabel dan mendapatkan ID instance Edisi Perusahaan, mengatur parameter IotInstanceId ke ID instance Edisi Perusahaan, dan kemudian memanggil operasi.

Prosedur Migrasi

  1. Langkah 1: Buat Tugas Migrasi: Buat tugas migrasi untuk produk tertentu.

    null

    Untuk memastikan bisnis Anda tidak terpengaruh selama migrasi, aktifkan fitur sinkronisasi data setelah membuat tugas migrasi. Dengan cara ini, sistem akan menyinkronkan data yang dikirim oleh perangkat produk yang ingin dimigrasikan dari instance publik ke instance Edisi Perusahaan tujuan. Untuk informasi lebih lanjut, lihat bagian Opsional: Aktifkan Sinkronisasi Data dalam topik "Prosedur".

  2. Langkah 2: Lakukan Migrasi Bertahap: Sistem menyalin produk dan data fitur penerusan pesan secara berurutan serta memigrasikan data perangkat secara bertahap.

    null

    Jika langganan sisi server AMQP dikonfigurasi atau data diteruskan ke kelompok konsumen AMQP, Anda harus menyalin ID kelompok konsumen baru dan menghubungkan klien AMQP baru ke IoT Platform menggunakan SDK untuk menerima data setelah migrasi bertahap.

    Sebelum melakukan migrasi penuh, pastikan tugas migrasi tidak memengaruhi bisnis Anda.

  3. Langkah 3: Lakukan Migrasi Penuh: Migrasikan semua data produk dan perangkat.

    null

    Pastikan sistem telah ditransformasi dan dirilis. Misalnya, ID instance Edisi Perusahaan harus ditentukan sebagai nilai parameter permintaan operasi API IoT Platform yang ingin Anda panggil, dan ID kelompok konsumen SDK yang digunakan untuk menghubungkan klien AMQP diperbarui. Untuk informasi lebih lanjut, lihat bagian Sebelum Anda Memulai dalam topik ini.

    Setelah migrasi penuh selesai, periksa status bisnis dan hasil migrasi. Pastikan objek tempat operasi API IoT Platform yang ingin Anda panggil telah diubah menjadi instance Edisi Perusahaan.

  4. Opsional: Kembalikan Tugas Migrasi: Jika tugas migrasi gagal atau terjadi kesalahan, Anda dapat mengembalikan semua data perangkat, termasuk informasi sertifikat perangkat dan data TSL, ke instance publik. Dengan cara ini, perangkat dapat berfungsi seperti semula. Langkah ini tidak menghapus langganan sisi server dan data fitur penerusan pesan pada instance Edisi Perusahaan tujuan yang telah dimigrasikan.

Referensi

FAQ

Sebelum Migrasi

Selama Migrasi

Setelah Migrasi