Skapa eller uppdatera entitet

Artikel
08/05/2023

Skapar eller uppdaterar en meddelandeentitet.

Förfrågan

Metod	URI för förfrågan	HTTP-version
PUT	https://{serviceNamespace}.servicebus.windows.net/{Entitetssökväg}	HTTP/1.1

Entitetssökvägen kan vara ett namn för flera segment med segment avgränsade med "/". Hela sökvägen utgör namnet på entiteterna. Flera entiteter kan dela samma prefixsegment.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud	Description
Auktorisering	Anger en SAS-token (signatur för delad åtkomst) med behörigheten "Hantera". Mer information finns i Service Bus-autentisering med signaturer för delad åtkomst .
Content-Type	Ange till application/atom+xml;type=entry; charset=utf-8.
If-Match	Ställ in det här huvudet på "*" för att uppdatera entiteten. Du måste ange alla egenskapsvärden som önskas för den uppdaterade entiteten. Alla värden som inte anges är inställda på tjänstens standardvärden. Om det här huvudet saknas returnerar uppdateringsanropet ett fel som anger att den här entiteten redan finns.

Begärandetext

Begärandetexten måste innehålla en giltig Atom XML-post som bäddar in beskrivningen av den entitet som ska skapas

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

Där {description} beskrev antingen en kö eller ett ämne för entiteter på den översta nivån, eller en prenumeration eller regel i förhållande till deras överordnade entiteter.

En kö beskrivs till exempel med ett QueueDescription -element. XML-nyttolasten för att skapa eller uppdatera en kö kan därför ha följande formulär, där alla utelämnade egenskaper förutsätter sina standardvärden:

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

Mer information om entiteter och hur de relaterar till sökvägar finns i Översikt .

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Svarskoder

Anteckning

Om du uppdaterar en entitet med ett namn som innehåller särskilda eller kodade tecken (till exempel "test? Name=value&"), som kodas till "test%3FName%3Dvalue%26"), genereras ett (401) obehörigt undantag.

Kod	Description
201	Entiteten har uppdaterats.
400	Ogiltig begärandetext.
401	Auktoriseringsfel.
403	Kvoten har överskridits. entiteten har inte uppdaterats.
500	Internt fel.

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Inga.

Svarstext

Entitetsbeskrivningen returneras. Vissa beskrivningsegenskaper kan innehålla standardvärden om de saknas i PUT-begäran.

Dela via