Erstellen oder Aktualisieren einer Entität

  • Artikel

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.