Letakkan Pesan

Operasi ini Put Message menambahkan pesan baru ke bagian belakang antrean pesan. Batas waktu visibilitas juga dapat ditentukan untuk membuat pesan tidak terlihat hingga batas waktu visibilitas berakhir. Pesan harus dalam format yang dapat disertakan dalam permintaan XML dengan pengodean UTF-8. Pesan yang dikodekan dapat berukuran hingga 64 kibibyte (KiB) untuk versi 2011-08-18 dan yang lebih baru, atau 8 KiB untuk versi sebelumnya.

Permohonan

Anda dapat membuat permintaan Put Message sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS. Ganti akun saya dengan nama akun penyimpanan Anda, dan myqueue dengan nama antrean Anda:

Metode	Memohon URI	Versi HTTP
`POST`	`https://myaccount.queue.core.windows.net/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>`	HTTP/1.1

Permintaan layanan penyimpanan yang ditimulasi

Saat Anda membuat permintaan terhadap layanan penyimpanan yang diemulasi, tentukan nama host emulator dan port penyimpanan Antrean sebagai 127.0.0.1:10001, diikuti dengan nama akun penyimpanan yang diemulasi:

Metode	Memohon URI	Versi HTTP
`POST`	`http://127.0.0.1:10001/devstoreaccount1/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>`	HTTP/1.1

Untuk informasi selengkapnya, lihat Menggunakan emulator Azurite untuk pengembangan Azure Storage lokal.

URI Parameter

Anda dapat menentukan parameter berikut pada URI permintaan:

Pengaturan	Deskripsi
`visibilitytimeout=<int=seconds>`	Fakultatif. Menentukan nilai batas waktu visibilitas baru, dalam detik, relatif terhadap waktu server. Jika ditentukan, permintaan harus dibuat dengan menggunakan `x-ms-version` 18-08-2011 atau yang lebih baru. Jika tidak ditentukan, nilai defaultnya adalah 0. Nilai baru harus lebih besar dari atau sama dengan 0, dan tidak boleh lebih besar dari 7 hari. Batas waktu visibilitas pesan tidak dapat diatur ke nilai yang lebih lambat dari tanggal kedaluwarsa. Atur `visibilitytimeout` ke nilai yang lebih kecil dari nilai waktu untuk hidup.
`messagettl=<int-seconds>`	Fakultatif. Menentukan interval waktu hidup untuk pesan, dalam hitungan detik. Dalam versi yang lebih awal dari 29-07-2017, waktu hidup maksimum yang diizinkan adalah 7 hari. Untuk versi 2017-07-29 dan yang lebih baru, waktu hidup maksimum dapat berupa angka positif apa pun, dan `-1`, yang menunjukkan bahwa pesan tidak kedaluwarsa. Jika parameter ini dihilangkan, waktu hidup default adalah 7 hari.
`timeout`	Fakultatif. Parameter `timeout` dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi layanan Antrean.

Tajuk permintaan

Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:

Tajuk permintaan	Deskripsi
`Authorization`	Dibutuhkan. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
`Date` `or x-ms-date`	Dibutuhkan. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
`x-ms-version`	Fakultatif. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan Versi untuk layanan Azure Storage.
`x-ms-client-request-id`	Fakultatif. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB) yang dicatat dalam log saat pengelogan dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server.

Isi dari permintaan

Isi permintaan berisi data pesan dalam format XML berikut. Perhatikan bahwa konten pesan harus dalam format yang dapat dikodekan dengan UTF-8.

<QueueMessage>  
    <MessageText>message-content</MessageText>  
</QueueMessage>

Permohonan sampel

Request:  
POST https://myaccount.queue.core.windows.net/messages?visibilitytimeout=30&timeout=30 HTTP/1.1  
  
Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Tue, 30 Aug 2011 01:03:21 GMT  
Authorization: SharedKey myaccount:sr8rIheJmCd6npMSx7DfAY3L//V3uWvSXOzUBCV9wnk=  
Content-Length: 100  
  
Body:  
<QueueMessage>  
<MessageText>PHNhbXBsZT5zYW1wbGUgbWVzc2FnZTwvc2FtcGxlPg==</MessageText>  
</QueueMessage>

Jawaban

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode status

Operasi yang berhasil mengembalikan kode status 201 (Dibuat).

Untuk informasi selengkapnya tentang kode status, lihat Status dan kode kesalahan.

Tajuk respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1 .

Tajuk permintaan	Deskripsi
`x-ms-request-id`	Mengidentifikasi permintaan yang dibuat secara unik, dan Anda dapat menggunakannya untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API.
`x-ms-version`	Menunjukkan versi layanan Antrean yang digunakan untuk menjalankan permintaan. Header ini dikembalikan untuk permintaan yang dibuat terhadap versi 2009-09-19 dan yang lebih baru.
`Date`	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan, yang menunjukkan waktu ketika respons dimulai.
`x-ms-client-request-id`	Header ini dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai header `x-ms-client-request-id` jika ada dalam permintaan dan nilai berisi tidak lebih dari 1.024 karakter ASCII yang terlihat. Jika header `x-ms-client-request-id` tidak ada dalam permintaan, header tersebut tidak akan ada dalam respons.

Badan respons

Pada versi 2016-05-31, respons untuk operasi berisi Put Message info pesan di isi respons. Format XML dari isi yang dikembalikan dijelaskan di sini.

Elemen adalah MessageID nilai GUID yang mengidentifikasi pesan dalam antrean. Nilai ini ditetapkan ke pesan oleh Penyimpanan Antrean dan buram bagi klien. Nilai ini dapat digunakan bersama dengan nilai elemen PopReceipt untuk menghapus atau memperbarui pesan dari antrean. Nilai PopReceipt juga buram bagi klien, dan diperlukan saat Anda menggunakan API Hapus Pesan atau Perbarui Pesan.

Elemen InsertionTime, ExpirationTime, dan TimeNextVisible direpresentasikan sebagai nilai UTC dan diformat seperti yang dijelaskan dalam RFC 1123.

<QueueMessagesList>
    <QueueMessage>
      <MessageId>string-message-id</MessageId>
      <InsertionTime>insertion-time</InsertionTime>
      <ExpirationTime>expiration-time</ExpirationTime>
      <PopReceipt>opaque-string-receipt-data</PopReceipt>
      <TimeNextVisible>time-next-visible</TimeNextVisible>
    </QueueMessage>
</QueueMessagesList>

Contoh tanggapan

Response Status:
HTTP/1.1 200 OK
Response headers:
Transfer-Encoding: chunked
Content-Type: application/xml
x-ms-version: 2016-05-31
Date: Fri, 09 Oct 2016 21:04:30 GMT
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

Response Body:

<?xml version="1.0" encoding="utf-8"?>
<QueueMessagesList>
  <QueueMessage>
    <MessageId>5974b586-0df3-4e2d-ad0c-18e3892bfca2</MessageId>
    <InsertionTime>Fri, 09 Oct 2016 21:04:30 GMT</InsertionTime>
    <ExpirationTime>Fri, 16 Oct 2016 21:04:30 GMT</ExpirationTime>
    <PopReceipt>YzQ4Yzg1MDItYTc0Ny00OWNjLTkxYTUtZGM0MDFiZDAwYzEw</PopReceipt>
    <TimeNextVisible>Fri, 09 Oct 2016 23:29:20 GMT</TimeNextVisible>
   </QueueMessage>
</QueueMessagesList>

Otorisasi

Operasi ini dapat dilakukan oleh pemilik akun dan oleh siapa saja yang memiliki tanda tangan akses bersama dengan izin untuk melakukan operasi ini.

Komentar

Batas waktu visibilitas opsional menentukan waktu pesan tidak terlihat. Setelah batas waktu berakhir, pesan akan terlihat. Jika Anda tidak menentukan batas waktu visibilitas, nilai default 0 akan digunakan.

Waktu hidup pesan opsional menentukan berapa lama pesan tetap berada dalam antrean. Pesan dihapus dari antrean saat periode waktu hidup berakhir.

Pesan harus dalam format yang dapat disertakan dalam permintaan XML dengan pengodean UTF-8. Untuk menyertakan markup dalam pesan, konten pesan harus dikodekan Base64. Setiap markup XML dalam pesan yang tidak dikodekan akan menyebabkan pesan menjadi tidak valid. Jika karakter yang tidak valid (misalnya 0x1F) disertakan dalam pesan, meskipun XML-escaped, pembacaan pesan berikutnya tidak akan berhasil.

Jika pesan terlalu besar, layanan mengembalikan kode status 400 (Permintaan Buruk).

Lihat juga

Mengotorisasi permintaan ke Azure Storage
Status dan kode galat
Kode kesalahan layanan antrean

Last updated on 2025-06-18