Share via

Mengatasi Sumber Daya Layanan Antrean

  • Artikel

Layanan Antrean mengekspos sumber daya berikut melalui REST API:

  • Account. Akun penyimpanan adalah entitas yang diidentifikasi secara unik dalam sistem penyimpanan. Akun adalah namespace induk untuk layanan Antrean. Semua antrean dikaitkan dengan akun.

  • Antrian. Antrean menyimpan pesan yang dapat diambil oleh aplikasi atau layanan klien.

  • Pesan. Pesan adalah teks yang dikodekan UTF-8 yang bisa menjadi nilai elemen XML. Pesan berukuran 64 KiB.

Sintaks URI Sumber Daya

Setiap sumber daya memiliki URI dasar yang sesuai, yang mengacu pada sumber daya itu sendiri.

Untuk akun penyimpanan, URI dasar untuk operasi antrean hanya menyertakan nama akun:

https://myaccount.queue.core.windows.net

Untuk antrean, URI dasar menyertakan nama akun dan nama antrean:

https://myaccount.queue.core.windows.net/myqueue

Untuk pesan dalam antrean, URI dasar menyertakan nama akun, nama antrean, dan kumpulan pesan dalam antrean tersebut:

https://myaccount.queue.core.windows.net/myqueue/messages

Pesan individual dapat diperbarui atau dihapus dengan merujuk ke ID pesan. Perhatikan bahwa sintaks ini hanya tersedia untuk operasi Perbarui Pesan dan Hapus Pesan dan memerlukan popreceipt parameter untuk verifikasi:

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

Setiap sumber daya mungkin juga memiliki komponen, yang dinyatakan sebagai bagian dari string kueri pada URI dasar. Sintaks untuk string kueri adalah ?comp=<component_name>. Saat ini, komponen sumber daya berikut tersedia untuk sumber daya antrean, sebagai parameter pada URI.

Komponen Sumber daya yang didukung Deskripsi
list Akun Menghitung entitas di bawah sumber daya ini. Pada akun , mengembalikan daftar antrean.
metadata Antrean Mengatur atau mengembalikan properti antrean, termasuk metadata yang ditentukan pengguna.

Perhatikan bahwa semua nilai untuk parameter kueri harus dikodekan URL sebelum dikirim ke layanan penyimpanan Azure.

Operasi HTTP yang Didukung

Setiap sumber daya mendukung operasi berdasarkan kata kerja HTTP GET, PUT, HEAD, dan DELETE. Kata kerja, sintaksis, dan versi HTTP yang didukung untuk setiap operasi muncul di halaman referensi untuk setiap operasi. Untuk daftar lengkap halaman referensi operasi, lihat Queue Service REST API.

Lihat juga

Penamaan Antrean dan Metadata
Operasi pada Antrean
Operasi pada Pesan
Layanan Antrean REST API