All Products
Search

This Product

    IoT Platform:Kelola titik akhir instans

    Document Center

    IoT Platform:Kelola titik akhir instans

    Last Updated:Jun 11, 2026

    Saat mengembangkan SDK perangkat, SDK Platform IoT, atau SDK AMQP, Anda harus mengonfigurasi nama domain akses sebagai titik akhir instans target. Topik ini menjelaskan cara memperoleh informasi titik akhir untuk setiap tipe instans.

    Prasyarat

    • Untuk panduan pengembangan SDK, lihat SDK sisi perangkat, SDK Platform IoT, dan Hubungkan client AMQP.

    • Untuk perbandingan tipe instans, lihat Ikhtisar instans.

      Instance

      Region

      Description

      Cara melihat

      Legacy public instance

      China (Shanghai), Jepang (Tokyo), Singapura, Jerman (Frankfurt), AS (Silicon Valley), dan AS (Virginia)

      Pada halaman Overview di konsol IoT Platform, tidak ada nilai yang ditampilkan untuk ID instans.

      Panel Development Configurations tidak tersedia di konsol IoT Platform. Untuk detail titik akhir, lihat View endpoints for legacy public instances.

      Public instance

      • Pada halaman Overview di konsol IoT Platform, nilai ditampilkan untuk ID instans, dan halaman Instance Details tersedia.

      • Public instance dibuat secara default saat Anda mengaktifkan IoT Platform.

      Panel Development Configurations tersedia di konsol. View endpoints for public and Enterprise Edition instances.

      Enterprise Edition instance

      China (Shanghai), China (Beijing), China (Shenzhen), Jepang (Tokyo), Singapura, Jerman (Frankfurt), AS (Silicon Valley), dan AS (Virginia)

    Latar belakang

    • Jenis titik akhir

      • Titik akhir dikategorikan menjadi public endpoints dan VPC endpoints. Titik akhir VPC mengurangi latensi jaringan dan biaya bandwidth publik sekaligus meningkatkan keamanan serta stabilitas koneksi.

      • Perangkat dapat terhubung ke Platform IoT melalui MQTT, CoAP, atau HTTP. Instans Edisi Perusahaan Premium juga mendukung koneksi VPC, sehingga perangkat dapat menggunakan titik akhir MQTT VPC.

      • Untuk mengakses Platform IoT dari instans ECS dalam VPC, konfigurasikan titik akhir VPC untuk langganan sisi server AMQP dan panggilan API Platform IoT.

    • Tipe instans

      • Instans Edisi Perusahaan Standar dan Premium di wilayah China (Shanghai), China (Beijing), dan China (Shenzhen) mendukung binding IP tetap ke titik akhir MQTT.

      • Instans Edisi Perusahaan Premium memerlukan pembuatan manual titik akhir MQTT khusus. Anda juga dapat menyesuaikan nomor port dan sertifikat.

    Lihat titik akhir untuk instans publik lama

    Protokol komunikasi

    Format titik akhir

    Port

    MQTT

    ${YourProductKey}.iot-as-mqtt.${YourRegionId}.aliyuncs.com

    1883 atau 443.

    Gunakan port 443 untuk MQTT over WebSocket.

    CoAP

    ${YourProductKey}.coap.cn-shanghai.link.aliyuncs.com

    • Jika Anda menggunakan Datagram Transport Layer Security (DTLS), gunakan port 5684.

    • Jika Anda menggunakan enkripsi simetris, gunakan port 5682.

    HTTP

    Unique-certificate-per-device: https://iot-as-http.${YourRegionId}.aliyuncs.com

    443.

    Pre-registration untuk unique-certificate-per-product: iot-auth.cn-shanghai.aliyuncs.com

    Penting

    Pre-registration untuk unique-certificate-per-product over HTTPS hanya didukung di wilayah China (Shanghai).

    AMQP

    ${uid}.iot-amqp.${YourRegionId}.aliyuncs.com

    • Untuk client Java, .NET, Python 2.7, Node.js, dan Go, gunakan port 5671.

    • Untuk client Python 3 dan PHP, gunakan port 61614.

    IoT Platform API

    Struktur permintaan adalah http://Endpoint/?Action=**&Parameters. Panggil operasi API.

    Tidak berlaku.

    ID²

    ${YourProductKey}.itls.${YourRegionId}.aliyuncs.com

    Hanya didukung di wilayah dan Jepang (Tokyo).

    1883.

    Ganti parameter berikut dalam URL titik akhir.

    Parameter

    Deskripsi

    ${YourProductKey}

    ProductKey produk yang berisi perangkat Anda. Masuk ke Konsol Platform IoT dan temukan ProductKey pada halaman detail perangkat.

    ${YourRegionId}

    ID wilayah tempat perangkat Anda berada. Untuk daftar ID wilayah, lihat Wilayah yang didukung.

    ${uid}

    ID akun Alibaba Cloud Anda. Masuk ke Konsol Platform IoT dan arahkan kursor ke gambar profil Anda untuk melihat account ID.

    Lihat titik akhir untuk instans publik dan Edisi Perusahaan

    1. Masuk ke Konsol Platform IoT. Di pojok kiri atas halaman, pilih wilayah tempat instans Anda berada.

    2. Pada halaman Overview, klik alias instans atau ID.

    3. Di pojok kanan atas halaman Instance Details, klik View Development Configurations.

    4. Di panel Development Configurations, klik tab protokol MQTT, CoAP, AMQP, atau lainnya untuk melihat informasi titik akhir. Klik Copy di samping nama domain untuk menyalin alamat titik akhir. Klik ikon bantuan 帮助 untuk melihat port. Untuk detail port, lihat Lihat titik akhir untuk instans publik lama.

      Penting

      • Untuk instans Edisi Perusahaan Premium, Anda harus membuat titik akhir MQTT secara manual. Buat titik akhir MQTT khusus untuk instans Edisi Perusahaan Premium.

      • Untuk koneksi perangkat melalui HTTPS, hanya metode unique-certificate-per-device dan unique-certificate-per-product berbasis pre-registration yang didukung. Metode ini menggunakan titik akhir yang berbeda:

        • Jika Anda menggunakan metode unique-certificate-per-device, titik akhir ditampilkan pada tab HTTP.

        • Metode unique-certificate-per-product berbasis pre-registration hanya didukung di wilayah China (Shanghai). Titik akhirnya adalah iot-auth.cn-shanghai.aliyuncs.com.

      • Jika Anda telah mengaktifkan otentikasi ID² untuk instans Edisi Perusahaan Anda, ID² Authentication Address pada tab Manage ID² di panel Development Configurations tidak ditampilkan. Untuk format alamat, lihat Lihat titik akhir untuk instans publik lama.

      Panel Development Configurations memiliki dua bagian: Public Endpoint dan VPC Network Endpoint. Setiap bagian berisi tab untuk protokol yang didukung (MQTT, CoAP, HTTP, AMQP). Pada tab-tab tersebut, Anda dapat menemukan alamat titik akhir, port koneksi, dan pengaturan terkait. Misalnya, tab MQTT menampilkan alamat titik akhir, port koneksi, dan status binding Fixed IP.

    Bind IP tetap ke titik akhir

    Penting

    Fitur ini hanya tersedia untuk instans Edisi Perusahaan Standar dan Premium di wilayah China (Shanghai), China (Beijing), dan China (Shenzhen).

    IP tetap memastikan resolusi DNS tetap stabil saat Platform IoT melakukan penskalaan alamat IP-nya. Jika Anda menggunakan kartu SIM IoT dengan paket data yang dibatasi ke alamat IP tertentu dan penyedia layanan Anda tidak mendukung konfigurasi nama domain, tambahkan IP tetap tersebut ke daftar izin IP penyedia layanan.

    Catatan

    Dalam beberapa kasus, seperti relokasi pusat data penyedia layanan, alamat IP dapat berubah. Jika perangkat Anda terhubung menggunakan IP tetap alih-alih titik akhir, Anda harus mendorong IP baru ke perangkat melalui perintah cloud-to-device atau pembaruan OTA. Jika tidak, perangkat tidak dapat terhubung ke Platform IoT.

    Kami merekomendasikan penggunaan titik akhir untuk koneksi perangkat. Platform IoT akan memberi tahu Anda terlebih dahulu jika terjadi perubahan alamat IP.

    Untuk bind IP tetap ke titik akhir MQTT publik suatu instans:

    • Untuk instans publik, Anda dapat menetapkan dua IP tetap untuk koneksi MQTT.

      1. Di pojok kanan atas halaman Instance Details instans publik, klik View Development Configurations.

      2. Di panel Development Configurations, pada tab MQTT, klik Set di samping Fixed IP.

      3. Pada kotak dialog yang muncul, klik OK untuk mendapatkan dua IP tetap.

      Jika IP tetap tersebut tidak lagi diperlukan untuk koneksi MQTT, klik Unbind.

    • Untuk instans Edisi Perusahaan Premium, IP tetap ditetapkan secara otomatis saat Anda membuat manual titik akhir MQTT publik. Unbinding tidak didukung.

    Buat titik akhir MQTT khusus untuk instans Edisi Perusahaan Premium

    Untuk membuat titik akhir MQTT untuk instans Edisi Perusahaan Premium:

    1. Di pojok kanan atas halaman Instance Details instans Edisi Perusahaan Premium, klik View Development Configurations.

    2. Di panel Development Configurations, pada tab MQTT, klik Create.

    3. Pada kotak dialog Create Endpoint, konfigurasikan informasi titik akhir.

      Parameter

      Deskripsi

      Custom port

      Nomor port untuk koneksi MQTT. Port default adalah 1883.

      Enable VPC

      • Yes: Mengaktifkan koneksi VPC. Konfigurasikan VPC, vSwitch Zone, vSwitch, dan security group.

        Ini membuat titik akhir MQTT publik dan VPC.

        Penting

        Untuk mengaktifkan titik akhir MQTT melalui VPC, aktifkan layanan PrivateLink. Jika PrivateLink belum diaktifkan, klik Enable untuk membuka Konsol VPC dan aktifkan.

      • No (Default): Menonaktifkan koneksi VPC.

        Ini hanya membuat titik akhir MQTT publik.

        Penting

        Jika Anda memilih No, Anda tidak dapat mengaktifkan koneksi VPC untuk titik akhir ini di kemudian hari.

      Authorization

      Jika Anda mengaktifkan koneksi VPC, berikan otorisasi.

      Klik Authorize. Sistem akan membuat role dan kebijakan otorisasi untuk mengizinkan perangkat terhubung ke Platform IoT melalui VPC. Service-linked roles.

      VPC

      Setelah Anda mengaktifkan koneksi VPC dan memberikan otorisasi, konfigurasikan parameter ini.

      Pilih VPC dan vSwitch yang sudah ada.

      Anda dapat mengklik Create VPC atau Create vSwitch untuk membuat yang baru. Buat VPC dan Buat vSwitch.

      vSwitch zone

      vSwitch

      Security group

      Setelah Anda mengaktifkan koneksi VPC dan memberikan otorisasi, konfigurasikan parameter ini.

      Pilih security group yang sudah ada.

      Anda dapat mengklik Create Security Group untuk membuat yang baru. Buat security group.

    4. Klik OK.

      Setelah titik akhir dibuat, titik akhir baru muncul di bawah MQTT Device Connection.

    Menyesuaikan sertifikat MQTT untuk instans Edisi Perusahaan Premium

    Untuk menyesuaikan sertifikat dan nama domain untuk koneksi MQTT ke instans Edisi Perusahaan Premium:

    Catatan

    Sertifikat kustom yang sama digunakan untuk titik akhir publik maupun VPC.

    1. Di pojok kanan atas halaman Instance Details instans Edisi Perusahaan Premium, klik View Development Configurations.

    2. Di panel Development Configurations, pada tab MQTT, klik Configure di bawah Custom Certificate.

    3. Pada kotak dialog Custom Certificate, untuk Custom Configuration, klik On.

      Catatan

      Jika Custom Configuration sudah diaktifkan, lewati langkah ini.

    4. Masukkan konten sertifikat dan kunci privat dalam format PEM yang diperoleh dari Otoritas Sertifikat (CA) Anda, lalu klik OK.

      Peringatan

      Memperbarui konten sertifikat atau kunci privat setelah konfigurasi awal dapat menyebabkan verifikasi sertifikat gagal, sehingga memutuskan perangkat dari Platform IoT dan mengganggu layanan. Lakukan dengan hati-hati.

      Halaman ini menampilkan nama domain kustom yang diurai dari sertifikat Anda. Gunakan nama domain ini untuk koneksi perangkat MQTT.

      Penting

      Konfigurasikan rekaman CNAME dengan penyedia domain Anda untuk mengarahkan nama domain kustom ke titik akhir MQTT default instans.