

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

# Membuat dan menandatangani permintaan OpenSearch Layanan
<a name="managedomains-signing-service-requests"></a>

Meskipun Anda mengonfigurasi kebijakan akses berbasis sumber daya yang sepenuhnya terbuka, *semua* permintaan ke API konfigurasi OpenSearch Layanan harus ditandatangani. Jika kebijakan Anda menentukan peran IAM atau pengguna, permintaan OpenSearch APIs juga harus ditandatangani menggunakan Versi AWS Tanda Tangan 4. Metode penandatanganan berbeda dengan API:
+ Untuk melakukan panggilan ke API konfigurasi OpenSearch Layanan, kami sarankan Anda menggunakan salah satu [AWS SDKs](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html). SDKsSangat menyederhanakan proses dan dapat menghemat banyak waktu dibandingkan dengan membuat dan menandatangani permintaan Anda sendiri. Titik akhir API konfigurasi menggunakan format berikut:

  ```
  es.{{region}}.amazonaws.com/2021-01-01/
  ```

  Misalnya, permintaan berikut membuat perubahan konfigurasi ke domain `movies`, tetapi Anda harus menandatanganinya sendiri (tidak disarankan):

  ```
  POST https://es.{{us-east-1}}.amazonaws.com/2021-01-01/opensearch/domain/{{movies}}/config
  {
    "ClusterConfig": {
      "InstanceType": "c5.xlarge.search"
    }
  }
  ```

  Jika Anda menggunakan salah satu SDKs, seperti [Boto 3](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.update_domain_config), SDK secara otomatis menangani penandatanganan permintaan:

  ```
  import boto3
  
  client = boto3.client(es)
  response = client.update_domain_config(
    DomainName='{{movies}}',
    ClusterConfig={
      'InstanceType': 'c5.xlarge.search'
    }
  )
  ```

  Untuk contoh kode Java, lihat [Menggunakan AWS SDKs untuk berinteraksi dengan Amazon OpenSearch Service](configuration-samples.md).
+ Untuk melakukan panggilan ke OpenSearch APIs, Anda harus menandatangani permintaan Anda sendiri. OpenSearch APIs Gunakan format berikut:

  ```
  {{domain-id}}.{{region}}.es.amazonaws.com
  ```

  Sebagai contoh, permintaan berikut mencari indeks `movies` untuk *thor*:

  ```
  GET https://{{my-domain}}.{{us-east-1}}.es.amazonaws.com/movies/_search?q=thor
  ```

**catatan**  
Layanan mengabaikan parameter yang diteruskan URLs untuk permintaan HTTP POST yang ditandatangani dengan Signature Version 4.