Membuat permintaan API kueri menggunakan protokol AWS JSON di Amazon SQS - Amazon Simple Queue Service
Membangun titik akhirMembuat 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 JSON di Amazon SQS

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

catatan

AWS Protokol JSON didukung untuk sebagian besar varian bahasa. Untuk daftar lengkap varian bahasa yang didukung, lihatBahasa apa yang didukung untuk protokol AWS JSON yang digunakan di Amazon APIs SQS?.

Membangun titik akhir

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

POST / HTTP/1.1
Host: sqs.us-west-2.amazonaws.com
X-Amz-Target: AmazonSQS.CreateQueue
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive 
{
    "QueueName":"MyQueue",
    "Attributes": {
        "VisibilityTimeout": "40"
    },
    "tags": {
        "QueueType": "Production"
    }
}
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 POST

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

Berikut ini adalah contoh dari header HTTP dengan X-Amz-Target set keAmazonSQS.<operationName>, dan header HTTP dengan Content-Type set keapplication/x-amz-json-1.0.

POST / HTTP/1.1
Host: sqs.<region>.<domain>
X-Amz-Target: AmazonSQS.SendMessage
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive 
{
    "QueueUrl": "https://sqs.<region>.<domain>/<awsAccountId>/<queueName>/",
    "MessageBody": "This is a test message"
}

Permintaan HTTP POST ini mengirimkan pesan ke antrian Amazon SQS.

catatan

Baik header HTTP X-Amz-Target dan Content-Type diperlukan.

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