Vytvoření nebo aktualizace entity

Vytvoří nebo aktualizuje entitu zasílání zpráv.

Žádost

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
PUT	https://{serviceNamespace}.servicebus.windows.net/{Cesta k entitě}	HTTP/1.1

Cesta k entitě může být název pro více segmentů s segmenty oddělenými "/". Celý název cesty tvoří názvy entit. Více entit může sdílet stejné segmenty předpony.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku	Description
Autorizace	Určuje token sdíleného přístupového podpisu (SAS) s právy spravovat. Podrobnosti najdete v tématu Ověřování služby Service Bus se sdílenými přístupovými podpisy .
Typ obsahu	Nastavte na application/atom+xml;type=entry; charset=utf-8.
If-Match	Pokud chcete aktualizovat entitu, nastavte tuto hlavičku na *. Musíte zadat všechny hodnoty vlastností, které jsou požadované pro aktualizovanou entitu. Všechny nezadáné hodnoty se nastaví na výchozí hodnoty služby. Pokud tato hlavička chybí, volání aktualizace vrátí chybu označující, že tato entita již existuje.

Text požadavku

Text požadavku musí obsahovat platnou položku Atom XML, která vkládá popis entity, která se má vytvořit.

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

Přičemž {description} popisuje buď frontu nebo téma pro entity nejvyšší úrovně, nebo odběr nebo pravidlo relativní k nadřazeným entitám.

Například fronta je popsána s prvkem QueueDescription . Datová část XML pro vytvoření nebo aktualizaci fronty proto může mít následující podobu, přičemž všechny vynechané vlastnosti přebírají výchozí hodnoty:

<?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>  

Další podrobnosti o entitách a jejich vztahu k cestám najdete v přehledu .

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Kódy odpovědí

Poznámka

Pokud aktualizujete entitu názvem obsahujícím speciální nebo zakódované znaky (například test? Name=value&"), který se zakóduje do "test%3FName%3Dvalue%26"), vygeneruje se (401) neautorizovaná výjimka.

Kód	Description
201	Entita se aktualizovala.
400	Neplatný text požadavku.
401	Autorizace se nezdařila.
403	Překročení kvóty; entita se neaktualizovala.
500	Vnitřní chyba.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Žádné

Text odpovědi

Vrátí se popis entity. Některé vlastnosti popisu můžou obsahovat výchozí hodnoty, pokud v požadavku PUT chyběly.