Membuat permintaan API kueri menggunakan protokol AWS kueri di Amazon SQS - Amazon Simple Queue Service
Membangun titik akhirMembuat permintaan GETMembuat permintaan POST

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

Membuat permintaan API kueri menggunakan protokol AWS kueri di Amazon SQS

Topik ini menjelaskan cara membuat endpoint Amazon SQS, membuat permintaan GET dan POST, dan menafsirkan tanggapan.

Membangun titik akhir

Agar dapat bekerja dengan antrian Amazon SQS, Anda harus membuat titik akhir. Untuk informasi tentang titik akhir Amazon SQS, lihat halaman berikut di: Referensi Umum Amazon Web

Setiap titik akhir Amazon SQS bersifat independen. Misalnya, jika dua antrian diberi nama MyQueuedan satu memiliki titik akhir sqs.us-east-2.amazonaws.com sementara yang lain memiliki titik akhirsqs.eu-west-2.amazonaws.com, kedua antrian tidak berbagi data apa pun satu sama lain.

Berikut ini adalah contoh dari endpoint yang membuat permintaan untuk membuat antrian. 

https://sqs.eu-west-2.amazonaws.com/   
?Action=CreateQueue
&DefaultVisibilityTimeout=40
&QueueName=MyQueue
&Version=2012-11-05
&AUTHPARAMS
catatan

Nama antrian dan antrian peka huruf URLs besar/kecil.

Struktur AUTHPARAMS tergantung pada tanda tangan permintaan API. Untuk informasi selengkapnya, lihat Menandatangani Permintaan AWS API di Referensi Umum Amazon Web Services.

Membuat permintaan GET

Permintaan Amazon SQS GET disusun sebagai URL yang terdiri dari berikut ini:

  • Endpoint — Sumber daya tempat permintaan bertindak (nama antrian dan URL), misalnya: https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue

  • Tindakan — Tindakan yang ingin Anda lakukan di titik akhir. Tanda tanya (?) memisahkan titik akhir dari tindakan, misalnya: ?Action=SendMessage&MessageBody=Your%20Message%20Text

  • Parameter — Parameter permintaan apa pun. Setiap parameter dipisahkan oleh ampersand (&), misalnya: &Version=2012-11-05&AUTHPARAMS

Berikut ini adalah contoh permintaan GET yang mengirim pesan ke antrian Amazon SQS.

https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue
?Action=SendMessage&MessageBody=Your%20message%20text
&Version=2012-11-05
&AUTHPARAMS
catatan

Nama antrian dan antrian peka huruf URLs besar/kecil.

Karena permintaan GET adalah URLs, Anda harus mengkodekan URL semua nilai parameter. Karena spasi tidak diizinkan masuk URLs, setiap spasi dikodekan URL sebagai. %20 Contoh lainnya tidak dikodekan URL untuk membuatnya lebih mudah dibaca.

Membuat permintaan POST

Permintaan Amazon SQS POST mengirimkan parameter kueri sebagai formulir di badan permintaan HTTP.

Berikut ini adalah contoh header HTTP dengan Content-Type set keapplication/x-www-form-urlencoded.

POST /123456789012/MyQueue HTTP/1.1
Host: sqs.us-east-2.amazonaws.com
Content-Type: application/x-www-form-urlencoded

Header diikuti oleh permintaan form-urlencoded GET yang mengirim pesan ke antrian Amazon SQS. Setiap parameter dipisahkan oleh ampersand ()&.

Action=SendMessage
&MessageBody=Your+Message+Text
&Expires=2020-10-15T12%3A00%3A00Z
&Version=2012-11-05
&AUTHPARAMS
catatan

Hanya header Content-Type HTTP yang diperlukan. Sama seperti untuk permintaan GET. AUTHPARAMS

Klien HTTP Anda mungkin menambahkan item lain ke permintaan HTTP, sesuai dengan versi HTTP klien.