Erstellen oder Aktualisieren einer Entität

Artikel
02/03/2024

Erstellt oder aktualisiert eine Messagingentität.

Anforderung

Methode	Anforderungs-URI	HTTP-Version
PUT	https://{Dienstnamespace}.servicebus.windows.net/{Entitätspfad}	HTTP/1.1

Der Entitätspfad kann ein Name mit mehreren Segmenten sein, wobei Segmente durch "/" getrennt sind. Die Gesamtheit des Pfads besteht aus dem Namen der Entitäten. Mehrere Entitäten können dieselben Präfixsegmente verwenden.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
Authorization	Gibt ein SAS-Token (Shared Access Signature) mit Den Berechtigungen "Verwalten" an. Weitere Informationen finden Sie unter Service Bus-Authentifizierung mit Shared Access Signatures .
Content-Type	Wird auf application/atom+xml;type=entry;charset=utf-8 festgelegt.
If-Match	Legen Sie diesen Header auf "*" fest, um die Entität zu aktualisieren. Sie müssen alle Eigenschaftswerte angeben, die in der aktualisierten Entität gewünscht sind. Alle nicht angegebenen Werte werden auf die Standardwerte des Diensts festgelegt. Wenn dieser Header fehlt, gibt der Aktualisierungsaufruf einen Fehler zurück, der besagt, dass diese Entität bereits vorhanden ist.

Anforderungstext

Der Text der Anforderung muss einen gültigen Atom-XML-Eintrag enthalten, der die Beschreibung der Entität einbettet, die erstellt werden soll.

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

Dabei beschrieb {description} entweder eine Warteschlange oder ein Thema für Entitäten der obersten Ebene oder ein Abonnement oder eine Regel relativ zu ihren übergeordneten Entitäten.

Eine Warteschlange für instance wird mit einem QueueDescription -Element beschrieben. Die XML-Nutzlast zum Erstellen oder Aktualisieren einer Warteschlange kann daher die folgende Form annehmen, wobei alle nicht angegebenen Eigenschaften ihre Standardwerte annehmen:

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

Weitere Informationen zu Entitäten und deren Beziehung zu Pfaden finden Sie in der Übersicht.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Hinweis

Wenn Sie eine Entität mit einem Namen aktualisieren, der sonder- oder codierte Zeichen enthält (z. B. "Test? Name=Wert&"), der zu "test%3FName%3Dvalue%26" codiert wird, wird eine (401) nicht autorisierte Ausnahme generiert.

Code	BESCHREIBUNG
201	Die Entität wurde aktualisiert.
400	Ungültiger Anfragetext.
401	Autorisierungsfehler
403	Das Kontingent wurde überschritten, die Entität wurde nicht aktualisiert.
500	Interner Fehler.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Keine.

Antworttext

Die Entitätsbeschreibung wird zurückgegeben. Einige Beschreibungseigenschaften enthalten ggf. Standardwerte, wenn sie in der PUT-Anforderung gefehlt haben.

Freigeben über