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

# Kelola titik akhir perangkat inti
<a name="manage-core-device-endpoints"></a>

Ketika Anda menggunakan penemuan cloud, Anda menyimpan titik akhir broker MQTT untuk perangkat inti di layanan cloud AWS IoT Greengrass . Perangkat klien terhubung AWS IoT Greengrass untuk mengambil titik akhir ini dan informasi lain untuk perangkat inti terkait mereka.

Untuk setiap perangkat inti, Anda dapat secara otomatis atau manual mengelola titik akhir.
+ **Mengelola titik akhir secara otomatis dengan detektor IP**

  Anda dapat menerapkan [komponen detektor IP](ip-detector-component.md) untuk secara otomatis mengelola titik akhir perangkat inti untuk Anda jika Anda memiliki pengaturan jaringan yang tidak kompleks, seperti di mana perangkat klien berada di jaringan yang sama dengan perangkat inti. Anda tidak dapat menggunakan komponen detektor IP jika perangkat inti berada di belakang router yang meneruskan port broker MQTT ke perangkat inti, misalnya.

  Komponen detektor IP juga berguna jika Anda men-deploy ke grup objek, karena ia mengelola titik akhir untuk semua perangkat inti dalam grup objek. Untuk informasi selengkapnya, lihat [Gunakan detektor IP untuk mengelola titik akhir secara otomatis](#use-ip-detector).
+ **Kelola titik akhir secara manual**

  Jika Anda tidak dapat menggunakan komponen detektor IP, Anda harus mengelola titik akhir perangkat inti secara manual. Anda dapat memperbarui titik akhir ini dengan konsol atau API. Untuk informasi selengkapnya, lihat [Kelola titik akhir secara manual](#manually-manage-endpoints).

**Topics**
+ [Gunakan detektor IP untuk mengelola titik akhir secara otomatis](#use-ip-detector)
+ [Kelola titik akhir secara manual](#manually-manage-endpoints)

## Gunakan detektor IP untuk mengelola titik akhir secara otomatis
<a name="use-ip-detector"></a>

Jika Anda memiliki pengaturan jaringan sederhana, seperti perangkat klien pada jaringan yang sama sebagai perangkat inti, Anda dapatmen-deploy [Komponen pendeteksi IP](ip-detector-component.md) untuk melakukan hal berikut:
+ Memantau informasi konektivitas jaringan lokal perangkat inti Greengrass. Informasi ini mencakup titik akhir jaringan perangkat inti dan port tempat broker MQTT beroperasi.
+ Laporkan informasi konektivitas perangkat inti ke layanan AWS IoT Greengrass cloud.

Komponen detektor IP menimpa titik akhir yang Anda tetapkan secara manual.

**penting**  
 AWS IoT Kebijakan perangkat inti harus mengizinkan `greengrass:UpdateConnectivityInfo` izin untuk menggunakan komponen detektor IP. Untuk informasi selengkapnya, lihat [AWS IoT kebijakan untuk operasi pesawat data](device-auth.md#iot-policies) dan [Konfigurasikan kebijakan AWS IoT hal](connect-client-devices.md#configure-iot-policy-requirement).

Anda dapat melakukan salah satu dari berikut ini untuk men-deploy komponen detektor IP:
+ Gunakan halaman **Konfigurasi penemuan** di konsol. Untuk informasi selengkapnya, lihat [Konfigurasikan penemuan cloud (konsol)](connect-client-devices.md#configure-cloud-discovery-console).
+ Membuat dan merevisi deployment untuk menyertakan detektor IP. Anda dapat menggunakan konsol, AWS CLI, atau AWS API untuk mengelola penerapan. Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md).

### Menyebarkan komponen detektor IP (konsol)
<a name="deploy-ip-detector-console"></a>

1. Pada menu navigasi [konsol AWS IoT Greengrass](https://console.aws.amazon.com/greengrass) tersebut, pilih **Komponen**.

1. Pada halaman **Components**, pilih tab **Public components**, lalu pilih **aws.greengrass.clientdevices.IPDetector**.

1. Pada halaman **aws.greengrass.clientdevices.IPDetector** pilih **Deploy**.

1. <a name="deploy-component-choose-deployment-step"></a>**Dari **Tambahkan ke penerapan**, pilih penerapan yang ada untuk direvisi, atau pilih untuk membuat penerapan baru, lalu pilih Berikutnya.**

1. <a name="deploy-component-choose-target-step"></a>Jika Anda memilih untuk membuat penerapan baru, pilih perangkat inti target atau grup hal untuk penerapan. Pada halaman **Tentukan target**, di bawah **target Deployment**, pilih perangkat inti atau grup benda, lalu pilih **Berikutnya**.

1. Pada halaman **Pilih komponen**, verifikasi bahwa **aws.greengrass.clientdevices.IPDetector**komponen dipilih, pilih **Berikutnya**.

1. Pada halaman **Configure components**, pilih **aws.greengrass.clientdevices.IPDetector**, lalu lakukan hal berikut:

   1. Pilih **Konfigurasi komponen**.

   1. Dalam aws.greengrass.clientdevices.IPDetector modal **Konfigurasi**, di bawah **pembaruan Konfigurasi**, di **Konfigurasi untuk digabungkan**, Anda dapat memasukkan pembaruan konfigurasi untuk mengonfigurasi komponen detektor IP. Anda dapat menentukan salah satu opsi konfigurasi berikut:
      + `defaultPort`— <a name="ip-detector-component-configuration-default-port-definition"></a>(Opsional) Port broker MQTT untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. 
      + `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama. 
      + `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis. 
      + `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan uji di mana perangkat inti dan perangkat klien berjalan pada sistem yang sama. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.
      + `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Protokol Konfigurasi Host Dinamis (DHCP) atau alamat IP yang ditetapkan secara statis. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.
      + `includeIPv4Addrs`— <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(Opsional) Default diatur ke true. Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv4 alamat yang ditemukan di perangkat inti. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.
      + `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv6 alamat yang ditemukan pada perangkat inti. Setel `includeIPv4Addrs` `false` untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

      Pembaruan konfigurasi mungkin terlihat mirip dengan contoh berikut.

      ```
      {
        "defaultPort": "8883",
        "includeIPv4LoopbackAddrs": false,
        "includeIPv4LinkLocalAddrs": false
      }
      ```

   1. Pilih **Konfirmasi** untuk menutup modal, lalu pilih **Berikutnya**.

1. <a name="deploy-component-configure-advanced-settings-step"></a>Pada halaman **Konfigurasikan pengaturan lanjutan**, simpan pengaturan konfigurasi default tersebut, dan pilih **Selanjutnya**.

1. <a name="deploy-component-review-and-deploy-step"></a>Di halaman **Tinjau**, pilih **Deploy**.

   Penyebaran dapat memakan waktu hingga satu menit untuk diselesaikan.

### Menyebarkan komponen detektor IP ()AWS CLI
<a name="deploy-ip-detector-cli"></a>

Untuk menyebarkan komponen detektor IP, buat dokumen penerapan yang disertakan `aws.greengrass.clientdevices.IPDetector` dalam `components` objek, dan tentukan pembaruan konfigurasi untuk komponen tersebut. Ikuti petunjuk [Buat deployment](create-deployments.md) untuk membuat penerapan baru atau merevisi penerapan yang ada.

Anda dapat menentukan salah satu opsi berikut untuk mengonfigurasi komponen detektor IP saat Anda membuat dokumen penerapan:
+ `defaultPort`— <a name="ip-detector-component-configuration-default-port-definition"></a>(Opsional) Port broker MQTT untuk melaporkan kapan komponen ini mendeteksi alamat IP. Anda harus menentukan parameter ini jika Anda mengonfigurasi broker MQTT untuk menggunakan port yang berbeda dari port default 8883. 
+ `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan pengujian tempat perangkat inti dan perangkat klien berjalan pada sistem yang sama. 
+ `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv4 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Dynamic Host Configuration Protocol (DHCP) atau alamat IP yang ditetapkan secara statis. 
+ `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 loopback. Ini adalah alamat IP, seperti`localhost`, di mana perangkat dapat berkomunikasi dengan dirinya sendiri. Gunakan opsi ini di lingkungan uji di mana perangkat inti dan perangkat klien berjalan pada sistem yang sama. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.
+ `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mendeteksi dan melaporkan alamat IPv6 [link-lokal](https://en.wikipedia.org/wiki/Link-local_address). Gunakan opsi ini jika jaringan perangkat inti tidak memiliki Protokol Konfigurasi Host Dinamis (DHCP) atau alamat IP yang ditetapkan secara statis. Anda harus mengatur `includeIPv4Addrs` ke `false` dan `includeIPv6Addrs` `true` untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.
+ `includeIPv4Addrs`— <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(Opsional) Default diatur ke true. Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv4 alamat yang ditemukan di perangkat inti. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.
+ `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Opsional) Anda dapat mengaktifkan opsi ini untuk mempublikasikan IPv6 alamat yang ditemukan pada perangkat inti. Setel `includeIPv4Addrs` `false` untuk menggunakan opsi ini. Anda harus memiliki detektor IP v2.2.0 atau yang lebih baru untuk menggunakan opsi ini.

Contoh berikut dokumen penyebaran sebagian menentukan untuk melaporkan port 8883 sebagai port broker MQTT.

```
{
  ...,
  "components": {
    ...,
    "aws.greengrass.clientdevices.IPDetector": {
      "componentVersion": "2.1.1",
      "configurationUpdate": {
        "merge": "{\"defaultPort\":\"8883\",}"
      }
    }
  }
}
```

## Kelola titik akhir secara manual
<a name="manually-manage-endpoints"></a>

Anda dapat secara otomatis mengelola titik akhir broker MQTT untuk perangkat inti.

Setiap titik akhir broker MQTT memiliki informasi berikut:

**Titik akhir** () `HostAddress`  
Alamat IP atau alamat DNS di mana perangkat klien dapat terhubung ke broker MQTT pada perangkat inti.

**Port** (`PortNumber`)  
Port tempat broker MQTT beroperasi pada perangkat inti.  
Anda dapat mengonfigurasi port ini pada [Komponen broker MQTT Moquette](mqtt-broker-moquette-component.md), yang defaultnya menggunakan port 8883.

**Metadata (**) `Metadata`  
Metadata tambahan yang akan diberikan ke perangkat klien yang terhubung ke titik akhir ini.

**Topics**
+ [Mengelola titik akhir (konsol)](#manually-manage-endpoints-console)
+ [Kelola titik akhir (AWS CLI)](#manually-manage-endpoints-cli)
+ [Kelola titik akhir (API)](#manually-manage-endpoints-api)

### Mengelola titik akhir (konsol)
<a name="manually-manage-endpoints-console"></a>

Anda dapat menggunakan AWS IoT Greengrass konsol untuk melihat, memperbarui, dan menghapus titik akhir untuk perangkat inti.

**Untuk mengelola titik akhir untuk perangkat inti (konsol)**

1. <a name="navigate-greengrass-console"></a>Navigasikan ke [konsol AWS IoT Greengrass](https://console.aws.amazon.com/greengrass) tersebut.

1. Pilih **Perangkat inti**.

1. Pilih perangkat inti untuk dikelola.

1. Pada halaman detail perangkat inti, pilih tab **Perangkat klien**.

1. Di **Titik akhir broker MQTT**, Anda dapat melihat titik akhir broker MQTT perangkat inti. Pilih **Kelola titik akhir**.

1. Di modal **Kelola titik akhir**, tambahkan atau hapus titik akhir broker MQTT untuk perangkat inti.

1. Pilih **Perbarui**.

### Kelola titik akhir (AWS CLI)
<a name="manually-manage-endpoints-cli"></a>

Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk mengelola titik akhir untuk perangkat inti.

**catatan**  
Karena dukungan perangkat klien di AWS IoT Greengrass V2 kompatibel dengan versi mundur AWS IoT Greengrass V1, Anda dapat menggunakan AWS IoT Greengrass V2 atau operasi AWS IoT Greengrass V1 API untuk mengelola titik akhir perangkat inti.

**Untuk mendapatkan titik akhir untuk perangkat inti (AWS CLI)**
+ Gunakan salah satu dari perintah berikut:
  + [greengrassv2: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/get-connectivity-info.html)
  + [greengrass: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html)

**Untuk memperbarui titik akhir untuk perangkat inti (AWS CLI)**
+ Gunakan salah satu dari perintah berikut:
  + [greengrassv2: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/update-connectivity-info.html)
  + [greengrass: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/update-connectivity-info.html)

### Kelola titik akhir (API)
<a name="manually-manage-endpoints-api"></a>

Anda dapat menggunakan AWS API untuk mengelola titik akhir untuk perangkat inti.

**catatan**  
Karena dukungan perangkat klien di AWS IoT Greengrass V2 kompatibel dengan versi mundur AWS IoT Greengrass V1, Anda dapat menggunakan AWS IoT Greengrass V2 atau operasi AWS IoT Greengrass V1 API untuk mengelola titik akhir perangkat inti.

**Untuk mendapatkan titik akhir untuk perangkat inti (AWS API)**
+ Gunakan salah satu dari operasi berikut:
  + [V2: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_GetConnectivityInfo.html)
  + [V1: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/getconnectivityinfo-get.html)

**Untuk memperbarui titik akhir untuk perangkat inti (AWS API)**
+ Gunakan salah satu dari operasi berikut:
  + [V2: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_UpdateConnectivityInfo.html)
  + [V1: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/updateconnectivityinfo-put.html)