Membuat atau Memperbarui Entitas

Membuat atau memperbarui entitas olahpesan.

Minta

Metode	Meminta URI	Versi HTTP
PUT	https://{serviceNamespace}.servicebus.windows.net/{Entity Path}	HTTP/1.1

Jalur entitas dapat menjadi nama multi-segmen, dengan segmen dipisahkan oleh '/'. Keseluruhan jalur membentuk nama entitas. Beberapa entitas dapat berbagi segmen awalan yang sama.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Header Permintaan	Deskripsi
Authorization	Menentukan token Tanda Tangan Akses Bersama (SAS) dengan hak "Kelola". Lihat Autentikasi Azure Service Bus dengan Tanda Tangan Akses Bersama untuk detailnya.
Jenis-Konten	Atur ke application/atom+xml;type=entry; charset=utf-8.
If-Match	Atur header ini ke "*" untuk memperbarui entitas. Anda harus memberikan semua nilai properti yang diinginkan pada entitas yang diperbarui. Nilai apa pun yang tidak disediakan diatur ke nilai default layanan. Jika header ini hilang, panggilan pembaruan mengembalikan kesalahan yang menunjukkan bahwa entitas ini sudah ada.

Isi Permintaan

Isi permintaan harus berisi entri XML Atom yang valid yang menyematkan deskripsi entitas yang akan dibuat

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {description}  
  </content>  
</entry>  

Di mana {description} menjelaskan Antrean atau Topik untuk entitas tingkat atas, atau langganan atau aturan yang relatif terhadap entitas induknya.

Antrean, misalnya, dijelaskan dengan QueueDescription elemen . Payload XML untuk membuat atau memperbarui antrean oleh karena itu mungkin mengambil formulir berikut, di mana semua properti yang dihilangkan mengasumsikan nilai defaultnya:

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <content type="application/xml">  
    <QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
       <LockDuration>T1M</LockDuration>
    </QueueDescription>
  </content>  
</entry>  

Lihat Gambaran Umum untuk detail selengkapnya tentang entitas dan bagaimana mereka berhubungan dengan jalur.

Respons

Respons mencakup kode status HTTP dan sekumpulan header respons.

Kode Respons

Catatan

Jika Anda memperbarui entitas dengan nama yang berisi karakter khusus atau dikodekan (misalnya, "uji? Name=value&"), yang dikodekan ke "test%3FName%3Dvalue%26"), pengecualian tidak sah (401) akan dihasilkan.

Kode	Deskripsi
201	Entitas diperbarui.
400	Isi permintaan tidak valid.
401	Kegagalan otorisasi.
403	Kuota terlampaui; entitas tidak diperbarui.
500	Kesalahan internal.

Untuk informasi tentang kode status, lihat Status dan Kode Kesalahan.

Header Respons

Tidak ada.

Isi Respons

Deskripsi entitas dikembalikan. Beberapa properti deskripsi mungkin berisi nilai default jika hilang dari permintaan PUT.