Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengirimkan Permintaan Konfigurasi di Amazon CloudSearch
**penting**
Cara termudah untuk mengirimkan permintaan konfigurasi adalah dengan menggunakan CloudSearch konsol Amazon, alat baris CloudSearch perintah Amazon, atau AWS SDK for Java JavaScript, .NET, PHP, Ruby, atau Python (Boto). Alat baris perintah dan SDKs menangani proses penandatanganan untuk Anda dan memastikan bahwa permintaan CloudSearch konfigurasi Amazon dibentuk dengan benar. Untuk informasi selengkapnya tentang AWS SDKs, lihat [AWS Software Development Kit](https://aws.amazon.com/code).
Anda mengirimkan permintaan CloudSearch konfigurasi Amazon ke CloudSearch titik akhir Amazon untuk wilayah Anda menggunakan protokol AWS Query. Untuk daftar wilayah dan titik akhir yang didukung saat ini, lihat [Wilayah dan Titik Akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloudsearch_region).
Permintaan AWS Query adalah permintaan HTTP atau HTTPS yang dikirimkan melalui HTTP GET atau POST dengan parameter Query bernama Action. Anda harus menentukan versi API di semua permintaan konfigurasi dan versi tersebut harus cocok dengan versi API yang ditentukan saat domain dibuat.
Anda harus menyertakan parameter otorisasi dan tanda tangan digital dalam setiap permintaan. Amazon CloudSearch mendukung AWS Signature Versi 4. Untuk petunjuk penandatanganan terperinci, lihat [Proses Penandatanganan V4 Tanda Tangan](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) di Referensi Umum AWS.
**catatan**
Amazon CloudSearch membatasi permintaan berlebihan ke layanan konfigurasi. Pelambatan terjadi karena *tindakan*, sehingga `DescribeDomains` permintaan yang berlebihan tidak menyebabkan Amazon CloudSearch membatasi `DescribeIndexFields` permintaan. Batas permintaan berubah berdasarkan kebutuhan layanan, tetapi memungkinkan banyak panggilan ke setiap tindakan per jam.
## Struktur Permintaan Konfigurasi
Referensi ini menunjukkan permintaan CloudSearch konfigurasi Amazon sebagai URLs, yang dapat digunakan langsung di browser. (Meskipun permintaan GET ditampilkan sebagai URLs, nilai parameter ditampilkan tanpa kode untuk membuatnya lebih mudah dibaca. Ingatlah bahwa Anda harus menyandikan URL nilai parameter saat mengirimkan permintaan.) URL berisi tiga bagian:
+ Endpoint—titik masuk layanan Web untuk ditindaklanjuti,. `cloudsearch.us-east-1.amazonaws.com`
+ Action—tindakan konfigurasi CloudSearch Amazon yang ingin Anda lakukan. Untuk daftar lengkap tindakan, lihat[Tindakan](API_Operations.md).
+ Parameter—parameter permintaan apa pun yang diperlukan untuk tindakan yang ditentukan. Setiap permintaan kueri juga harus menyertakan beberapa parameter umum untuk menangani otentikasi. Untuk informasi selengkapnya, lihat [Minta Otentikasi](#configuration-request-authentication).
Anda harus menentukan `Version` parameter di setiap permintaan CloudSearch konfigurasi Amazon. Versi Amazon CloudSearch API saat ini adalah 2013-01-01.
Misalnya, permintaan GET berikut membuat domain pencarian baru yang disebut *film*:
```
https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
3c8dcb
```
## Minta Otentikasi
Permintaan yang dikirimkan ke API Konfigurasi diautentikasi menggunakan kunci akses AWS Anda. Anda harus menyertakan parameter otorisasi dan tanda tangan digital dalam setiap permintaan. Amazon CloudSearch mendukung AWS Signature Versi 4. Untuk petunjuk penandatanganan terperinci, lihat [Proses Penandatanganan V4 Tanda Tangan](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) di Referensi Umum AWS.
**catatan**
Jika Anda baru mulai menandatangani permintaan AWS Anda sendiri, lihat bagaimana penandatanganan SDKs implementasi. Sumber untuk sebagian besar AWS SDKs tersedia di [https://github.com/aws](https://github.com/aws).
Misalnya, untuk membuat `CreateDomain` permintaan, Anda memerlukan informasi berikut:
```
Region name: us-east-1
Service name: cloudsearch
API version: 2013-01-01
Date: 2014-03-12T21:41:29.094Z
Access key: AKIAIOSFODNN7EXAMPLE
Secret key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Action: CreateDomain
Action Parameters: DomainName=movies
```
String kueri kanonik untuk `CreateDomain` permintaan terlihat seperti ini:
```
Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
```
Permintaan terakhir yang ditandatangani terlihat seperti ini:
```
https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2014-03-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
```