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

# Mendaftarkan sumber daya sebagai instance AWS Cloud Map layanan
<a name="registering-instances"></a>

Anda dapat mendaftarkan sumber daya aplikasi Anda sebagai instance dalam AWS Cloud Map layanan. Misalnya, anggap Anda telah membuat layanan yang dipanggil `users` untuk semua sumber daya aplikasi yang mengelola data pengguna. Anda kemudian dapat mendaftarkan tabel DynamoDB yang digunakan untuk menyimpan data pengguna sebagai contoh dalam layanan ini.

**catatan**  
Fitur-fitur berikut tidak tersedia di AWS Cloud Map konsol:  
Ketika Anda mendaftar instans layanan menggunakan konsol, Anda tidak dapat membuat catatan alias yang merutekan lalu lintas ke Elastic Load Balancing (ELB). Ketika Anda mendaftar instans, Anda harus menyertakan `AWS_ALIAS_DNS_NAME` atribut. Untuk informasi selengkapnya, lihat [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) di dalam *Referensi API AWS Cloud Map *. 
Jika Anda mendaftarkan instans menggunakan layanan yang menyertakan pemeriksaan kondisi kustom, Anda tidak dapat menentukan status awal untuk pemeriksaan kondisi kustom. Secara default, status awal pemeriksaan kondisi kustom adalah **Sehat**. Jika Anda ingin status kondisi awal menjadi **Tidak sehat**, mendaftar instans pemrograman dan termasuk `AWS_INIT_HEALTH_STATUS` atribut. Untuk informasi selengkapnya, lihat [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) di dalam *Referensi API AWS Cloud Map *. 

Untuk mendaftarkan instance dalam layanan, ikuti langkah-langkah ini.

------
#### [ Konsol Manajemen AWS ]

1. Masuk ke Konsol Manajemen AWS dan buka AWS Cloud Map konsol di [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/).

1. Di panel navigasi, pilih **Namespace**.

1. Pada **Namespace** halaman, pilih namespace yang berisi layanan yang ingin Anda gunakan sebagai templat untuk mendaftar instans layanan.

1. Pada {{namespace-name}} halaman **Namespace:**, pilih layanan yang ingin Anda gunakan.

1. Pada {{service-name}} halaman **Layanan:**, pilih **Daftar instance layanan**.

1. Pada halaman **contoh layanan Register**, pilih **jenis Instance**. Bergantung pada konfigurasi penemuan instance namespace, Anda dapat memilih untuk menentukan alamat IP, ID instans Amazon EC2, atau informasi pengenal lainnya untuk sumber daya yang tidak memiliki alamat IP.
**catatan**  
Anda dapat memilih **instans EC2** hanya di ruang nama HTTP.

1. Untuk **ID contoh Layanan**, berikan pengenal yang terkait dengan instance layanan.
**catatan**  
Jika Anda ingin memperbarui instance yang ada, berikan pengenal yang terkait dengan instance yang ingin Anda perbarui. Kemudian, gunakan langkah selanjutnya untuk memperbarui nilai dan mendaftarkan ulang instance.

1. Berdasarkan pilihan **jenis Instance** Anda, lakukan langkah-langkah berikut.
**penting**  
Anda tidak dapat menggunakan `AWS_` awalan (tidak peka huruf besar/kecil) dalam kunci saat menentukan atribut kustom.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/cloud-map/latest/dg/registering-instances.html)

1. Pilih **Daftarkan instans layanan**.

------
#### [ AWS CLI ]
+ 

  Saat Anda mengirimkan `RegisterInstance` permintaan:
  + Untuk setiap catatan DNS yang Anda tentukan dalam layanan yang ditentukan oleh`ServiceId`, catatan dibuat atau diperbarui di zona yang dihosting yang terkait dengan namespace yang sesuai.
  + Jika layanan termasuk`HealthCheckConfig`, pemeriksaan kesehatan dibuat berdasarkan pengaturan dalam konfigurasi pemeriksaan kesehatan.
  + Setiap pemeriksaan kesehatan dikaitkan dengan masing-masing catatan baru atau yang diperbarui.

  Daftarkan instance layanan dengan `[register-instance](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/register-instance.html)` perintah (ganti {{red}} nilainya dengan milik Anda sendiri).

  ```
  aws servicediscovery register-instance \
      --service-id {{srv-xxxxxxxxx}} \
      --instance-id {{myservice-xx}} \
      --attributes={{AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808}}
  ```

------
#### [ AWS SDK for Python (Boto3) ]

1. Jika Anda belum `Boto3` menginstal, Anda dapat menemukan petunjuk untuk menginstal, mengkonfigurasi, dan menggunakan `Boto3` [di sini](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation).

1. Impor `Boto3` dan gunakan `servicediscovery` sebagai layanan Anda.

   ```
   import boto3
   client = boto3.client('servicediscovery')
   ```

1. 

   Saat Anda mengirimkan `RegisterInstance` permintaan:
   + Untuk setiap catatan DNS yang Anda tentukan dalam layanan yang ditentukan oleh`ServiceId`, catatan dibuat atau diperbarui di zona yang dihosting yang terkait dengan namespace yang sesuai.
   + Jika layanan termasuk`HealthCheckConfig`, pemeriksaan kesehatan dibuat berdasarkan pengaturan dalam konfigurasi pemeriksaan kesehatan.
   + Setiap pemeriksaan kesehatan dikaitkan dengan masing-masing catatan baru atau yang diperbarui.

   Daftarkan instance layanan dengan `register_instance()` (ganti {{red}} nilainya dengan milik Anda sendiri).

   ```
   response = client.register_instance(
       Attributes={
           'AWS_INSTANCE_IPV4': '172.2.1.3',
           'AWS_INSTANCE_PORT': '808',
       },
       InstanceId='{{myservice-xx}}',
       ServiceId='{{srv-xxxxxxxxx}}',
   )
   # If you want to see the response
   print(response)
   ```

   Contoh keluaran respons

   ```
   {
       'OperationId': '4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7',
       'ResponseMetadata': {
           '...': '...',
       },
   }
   ```

------