Entiteit maken of bijwerken

Artikel
02/07/2024

Hiermee wordt een berichtenentiteit gemaakt of bijgewerkt.

Aanvraag

Methode	Aanvraag-URI	HTTP-versie
PUT	https://{serviceNamespace}.servicebus.windows.net/{Entity Path}	HTTP/1.1

Het entiteitspad kan een naam voor meerdere segmenten zijn, met segmenten gescheiden door '/'. Het volledige pad bestaat uit de naam van de entiteiten. Meerdere entiteiten kunnen dezelfde voorvoegselsegmenten delen.

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagkoptekst	Description
Autorisatie	Hiermee geeft u een SAS-token (Shared Access Signature) met 'Beheren'-rechten. Zie Service Bus-verificatie met Shared Access Signatures voor meer informatie.
Content-Type	Stel in op application/atom+xml;type=entry; charset=utf-8.
If-Match	Stel deze header in op *om de entiteit bij te werken. U moet alle gewenste eigenschapswaarden opgeven voor de bijgewerkte entiteit. Alle waarden die niet zijn opgegeven, worden ingesteld op de standaardwaarden van de service. Als deze header ontbreekt, retourneert de updateaanroep een fout die aangeeft dat deze entiteit al bestaat.

Aanvraagbody

De hoofdtekst van de aanvraag moet een geldige Atom XML-vermelding bevatten die de beschrijving insluit van de entiteit die moet worden gemaakt

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

De {description} beschrijft een wachtrij of een onderwerp voor entiteiten op het hoogste niveau, of een abonnement of regel ten opzichte van de bovenliggende entiteiten.

Een wachtrij wordt bijvoorbeeld beschreven met een QueueDescription -element. De XML-nettolading voor het maken of bijwerken van een wachtrij kan daarom de volgende vorm hebben, waarbij voor alle weggelaten eigenschappen worden uitgegaan van de standaardwaarden:

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

Zie overzicht voor meer informatie over entiteiten en hoe deze zich verhouden tot paden.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Notitie

Als u een entiteit bijwerkt met een naam die speciale of gecodeerde tekens bevat (bijvoorbeeld 'test? Name=value&"), die wordt gecodeerd naar 'test%3FName%3Dvalue%26'), wordt een (401) niet-geautoriseerde uitzondering gegenereerd.

Code	Description
201	Entiteit bijgewerkt.
400	Ongeldige aanvraagbody.
401	Autorisatiefout.
403	Quotum overschreden; entiteit niet bijgewerkt.
500	Interne fout.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Geen.

Hoofdtekst van antwoord

De beschrijving van de entiteit wordt geretourneerd. Sommige beschrijvingseigenschappen bevatten mogelijk standaardwaarden als deze ontbreken in de PUT-aanvraag.

Delen via