Mengirimkan Permintaan Konfigurasi di Amazon CloudSearch - Amazon CloudSearch

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 untuk 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 AWSSDKs, lihat Kit Pengembangan AWS Perangkat Lunak.

Anda mengirimkan permintaan CloudSearch konfigurasi Amazon ke CloudSearch titik akhir Amazon untuk wilayah Anda menggunakan protokol AWS Kueri. Untuk daftar wilayah dan titik akhir yang didukung saat ini, lihat Wilayah dan Titik Akhir.

AWSPermintaan kueri adalah HTTP atau HTTPS permintaan yang dikirimkan melalui HTTP GET atau POST dengan parameter Query bernama Action. Anda harus menentukan API versi di semua permintaan konfigurasi dan versi tersebut harus cocok dengan API versi 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 Tanda Tangan V4 di Referensi AWS Umum.

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 sebagaiURLs, yang dapat digunakan langsung di browser. (Meskipun GET permintaan ditampilkan sebagaiURLs, nilai parameter ditampilkan tanpa kode untuk membuatnya lebih mudah dibaca. Ingatlah bahwa Anda harus URL menyandikan nilai parameter saat mengirimkan permintaan.) URLBerisi 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, lihatTindakan.

  • 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.

Anda harus menentukan Version parameter di setiap permintaan CloudSearch konfigurasi Amazon. CloudSearch APIVersi Amazon saat ini adalah 2013-01-01.

Misalnya, GET permintaan 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 Konfigurasi API diautentikasi menggunakan kunci AWS akses 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 Tanda Tangan V4 di Referensi AWS Umum.

catatan

Jika Anda baru mulai menandatangani AWS permintaan Anda sendiri, lihat bagaimana penandatanganan SDKs implementasi. Sumber untuk sebagian besar AWS SDKs tersedia di 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