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

Router langganan warisan

Router langganan warisan (aws.greengrass.LegacySubscriptionRouter) mengelola langganan pada perangkat inti Greengrass. Langganan adalah fitur dari V1 AWS IoT Greengrass yang menentukan topik yang dapat digunakan Lambda fungsi untuk olah pesan MQTT pada perangkat inti. Untuk informasi selengkapnya, lihat Langganan terkelola dalam alur kerja olahpesan MQTT di Panduan Developer V1 AWS IoT Greengrass.

Anda dapat menggunakan komponen ini untuk mengaktifkan langganan untuk komponen konektor dan komponen fungsi Lambda yang menggunakan SDK Inti AWS IoT Greengrass.

Versi

Komponen ini memiliki versi berikut:

Tipe

Komponen ini adalah komponen generik (aws.greengrass.generic). Inti Greengrass menjalankan skrip siklus hidup komponen.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

Komponen ini hanya dapat diinstal pada perangkat inti Linux.

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

Dependensi

Saat Anda men-deploy komponen, AWS IoT Greengrass juga men-deploy versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

2.1.11

Tabel berikut mencantumkan dependensi untuk versi 2.1.11 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.13.0	Lunak

2.1.10

Tabel berikut mencantumkan dependensi untuk versi 2.1.10 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.12.0	Lunak

2.1.9

Tabel berikut mencantumkan dependensi untuk versi 2.1.9 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.11.0	Lunak

2.1.8

Tabel berikut mencantumkan dependensi untuk versi 2.1.8 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.10.0	Lunak

2.1.7

Tabel berikut mencantumkan dependensi untuk versi 2.1.7 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.9.0	Lunak

2.1.6

Tabel berikut mencantumkan dependensi untuk versi 2.1.6 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.8.0	Lunak

2.1.5

Tabel berikut mencantumkan dependensi untuk versi 2.1.5 dari komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.7.0	Lunak

2.1.4

Tabel berikut mencantumkan dependensi untuk versi 2.1.4 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.6.0	Lunak

2.1.3

Tabel berikut mencantumkan dependensi untuk versi 2.1.3 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.5.0	Lunak

2.1.2

Tabel berikut mencantumkan dependensi untuk versi 2.1.2 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.4.0	Lunak

2.1.1

Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.3.0	Lunak

2.1.0

Tabel berikut mencantumkan dependensi untuk versi 2.1.0 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.0 <2.2.0	Lunak

2.0.3

Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini.

Dependensi	Versi yang kompatibel	Jenis dependensi
Inti Greengrass	>=2.0.3 <2.1.0	Lunak

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

v2.1.x

subscriptions

(Opsional) Langganan yang akan diaktifkan pada perangkat inti. Ini adalah objek, di mana setiap kunci adalah ID unik, dan setiap nilai adalah objek yang mendefinisikan langganan untuk konektor itu. Anda harus mengonfigurasi langganan ketika Anda men-deploy komponen konektor V1 atau fungsi Lambda yang menggunakan SDK Inti AWS IoT Greengrass.

Setiap objek langganan berisi informasi berikut.

id

ID unik langganan ini. ID ini harus sesuai dengan kunci untuk objek langganan ini.

source

Fungsi Lambda yang menggunakan SDK Inti AWS IoT Greengrass untuk mempublikasikan pesan MQTT pada topik yang Anda tentukan di subject. Tentukan satu dari yang berikut ini:

• Nama komponen fungsi Lambda pada perangkat inti. Tentukan nama komponen dengan prefiks component:, seperti component:com.example.HelloWorldLambda.

• Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti.

  penting

  Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut.

  Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti $LATEST.

Untuk menggunakan langganan untuk komponen konektor V1, tentukan nama komponen atau ARN dari komponen konektor fungsi Lambda.

subject

Topik MQTT atau filter topik di mana sumber dan target dapat mempublikasikan dan menerima pesan. Nilai ini mendukung wildcard topik + dan #.

target

Target yang menerima pesan MQTT pada topik yang Anda tentukan di subject. Langganan menentukan bahwa fungsi source menerbitkan pesan MQTT ke AWS IoT Core atau ke fungsi Lambda pada perangkat inti. Tentukan satu dari yang berikut ini:

• cloud. Fungsi source menerbitkan pesan MQTT untuk AWS IoT Core.

• Nama komponen fungsi Lambda pada perangkat inti. Tentukan nama komponen dengan prefiks component:, seperti component:com.example.HelloWorldLambda.

• Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti.

  penting

  Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut.

  Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti $LATEST.

Default: Tidak ada langganan

contoh Contoh pembaruan konfigurasi (mendefinisikan langganan AWS IoT Core)

Contoh berikut menetapkan bahwa komponen fungsi Lambda com.example.HelloWorldLambda menerbitkan pesan MQTT untuk AWS IoT Core pada topik hello/world.

{
  "subscriptions": {
    "Greengrass_HelloWorld_to_cloud": {
      "id": "Greengrass_HelloWorld_to_cloud",
      "source": "component:com.example.HelloWorldLambda",
      "subject": "hello/world",
      "target": "cloud"
    }
  }
}

contoh Contoh pembaruan konfigurasi (mendefinisikan langganan ke fungsi Lambda)

Contoh berikut menetapkan bahwa komponen fungsi Lambda com.example.HelloWorldLambda menerbitkan pesan MQTT untuk komponen fungsi Lambda com.example.MessageRelay pada topik hello/world.

{
  "subscriptions": {
    "Greengrass_HelloWorld_to_MessageRelay": {
      "id": "Greengrass_HelloWorld_to_MessageRelay",
      "source": "component:com.example.HelloWorldLambda",
      "subject": "hello/world",
      "target": "component:com.example.MessageRelay"
    }
  }
}

v2.0.x

subscriptions

(Opsional) Langganan yang akan diaktifkan pada perangkat inti. Ini adalah objek, di mana setiap kunci adalah ID unik, dan setiap nilai adalah objek yang mendefinisikan langganan untuk konektor itu. Anda harus mengonfigurasi langganan ketika Anda men-deploy komponen konektor V1 atau fungsi Lambda yang menggunakan SDK Inti AWS IoT Greengrass.

Setiap objek langganan berisi informasi berikut.

id

ID unik langganan ini. ID ini harus sesuai dengan kunci untuk objek langganan ini.

source

Fungsi Lambda yang menggunakan SDK Inti AWS IoT Greengrass untuk mempublikasikan pesan MQTT pada topik yang Anda tentukan di subject. Tentukan hal berikut:

• Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti.

  penting

  Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut.

  Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti $LATEST.

Untuk menggunakan langganan untuk komponen konektor V1, tentukan ARN dari komponen konektor fungsi Lambda.

subject

Topik MQTT atau filter topik di mana sumber dan target dapat mempublikasikan dan menerima pesan. Nilai ini mendukung wildcard topik + dan #.

target

Target yang menerima pesan MQTT pada topik yang Anda tentukan di subject. Langganan menentukan bahwa fungsi source menerbitkan pesan MQTT ke AWS IoT Core atau ke fungsi Lambda pada perangkat inti. Tentukan satu dari yang berikut ini:

• cloud. Fungsi source menerbitkan pesan MQTT untuk AWS IoT Core.

• Amazon Resource Name (ARN) dari fungsi Lambda pada perangkat inti.

  penting

  Jika versi fungsi Lambda berubah, Anda harus mengonfigurasi langganan dengan versi baru fungsi. Jika tidak, komponen ini tidak akan mengarahkan pesan hingga versi itu cocok dengan langganan tersebut.

  Anda harus menentukan Nama Sumber Daya Amazon (ARN) yang menyertakan versi fungsi yang akan diimpor. Anda tidak dapat menggunakan alias versi seperti $LATEST.

Default: Tidak ada langganan

contoh Contoh pembaruan konfigurasi (mendefinisikan langganan AWS IoT Core)

Contoh berikut menetapkan bahwa fungsi Greengrass_HelloWorld menerbitkan pesan MQTT ke AWS IoT Core pada topik hello/world.

"subscriptions": {
  "Greengrass_HelloWorld_to_cloud": {
    "id": "Greengrass_HelloWorld_to_cloud",
    "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
    "subject": "hello/world",
    "target": "cloud"
  }
}

contoh Contoh pembaruan konfigurasi (mendefinisikan langganan ke fungsi Lambda)

Contoh berikut menetapkan bahwa fungsi Greengrass_HelloWorld menerbitkan pesan MQTT ke Greengrass_MessageRelay pada topik hello/world.

"subscriptions": {
  "Greengrass_HelloWorld_to_MessageRelay": {
    "id": "Greengrass_HelloWorld_to_MessageRelay",
    "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
    "subject": "hello/world",
    "target": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_MessageRelay:5"
  }
}

Berkas log lokal

Komponen ini tidak mengeluarkan log.

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.