Aktualisieren einer Warteschlange

Wichtig

Diese API ist veraltet und wurde am 11.01.2021 eingestellt und sollte nicht mehr verwendet werden.

Updates die Warteschlangenbeschreibung und sendet die Updates status an die FE/BE, um die entsprechenden Datenbankeinträge zu aktualisieren.

Anforderung

Methode	Anforderungs-URI	HTTP-Version
PUT	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Warteschlangenpfad}	HTTP/1.1

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
Content-Type	application/xml;type=entry;charset=utf-8
If-Match	*
x-ms-version	2012-03-01

Die Anforderung erfordert auch ein Clientzertifikat. Dieses Zertifikat muss mit dem Zertifikat übereinstimmen, das Sie für dieses bestimmte Abonnement hochgeladen haben.

Anforderungstext

In der folgenden Tabelle werden die Schlüsselelemente des Anforderungstexts beschrieben. Hierbei handelt es sich um die einzigen Eigenschaften, die aktualisiert werden können. Der Text muss die vollständige Warteschlangenbeschreibung enthalten, auch wenn Sie nur eine Eigenschaft ändern. Der empfohlene Ablauf ist wie folgt:

Rufen Sie eine Warteschlangenbeschreibung ab.
Aktualisieren der erforderliche Elemente.
Übergeben der aktualisierten Beschreibung.

Eigenschaftenname	type	BESCHREIBUNG

authorizationRules	AuthorizationRule[]	Ein Array von Autorisierungsregeln.
autoDeleteOnIdle	String	Gibt an, ob eine Entität automatisch gelöscht werden soll, wenn sie sich für einen bestimmten Zeitraum im Leerlauf befindet.
deadLetteringOnMessageExpiration	Boolean	Diese Eigenschaft kann nur zum Erstellungszeitpunkt der Warteschlange festgelegt werden. – Standard: False. Dieses Feld steuert, wie Service Bus eine Nachricht mit einer abgelaufenen Gültigkeitsdauer behandelt. Wenn true und eine Nachricht abläuft, verschiebt Service Bus die Nachricht aus der Warteschlange in die Unterwarteschlange für unzustellbare Nachrichten. Bei false wird die Nachricht dauerhaft aus der Warteschlange gelöscht.
defaultMessageTtl	XML-Datetime	Wenn eine Nachricht länger als die angegebene Zeit in der Warteschlange gespeichert wurde, wird sie basierend darauf, ob unzustellbare Nachrichten aktiviert sind, automatisch in die Warteschlange für unzustellbare Nachrichten verschoben oder gelöscht. Dieser Wert wird von einem für die Nachricht angegebenen TTL-Wert überschrieben, wenn der Nachrichten-TTL kleiner als der für die Warteschlange festgelegte TTL-Wert ist. Dieser Wert ist nach dem Erstellen der Warteschlange nicht mehr änderbar: - Bereich: 1 Sekunde – 14 Tage. - Standard: 14 Tage.
duplicateDetectionHistoryTimeWindow	Zeitspanne	Eine -Eigenschaft, die die Zeitspanne angibt, in der Service Bus die Meldungsduplizierung erkennt. - Bereich: 1 Sekunde bis 7 Tage. - Standard: 10 Minuten.
enableBatchedOperations	Boolean	Geben Sie an, ob Batchvorgänge aktiviert werden sollen.
forwardDeadLetteredMessagesTo	String	Geben Sie an, wohin die Nachrichten mit unzustellbaren Nachrichten weitergeleitet werden sollen.
forwardTo	String	Geben Sie an, wo die Nachrichten weitergeleitet werden sollen.
lockDuration	XML-Datetime	Diese Einstellung bestimmt die Zeitdauer in Sekunden, die eine Nachricht für die Verarbeitung durch einen Empfänger gesperrt sein sollte. Nach Ablauf dieses Zeitraums wird die Nachricht entsperrt und ist für die Verarbeitung durch den nächsten Empfänger verfügbar. Diese Eigenschaft kann nur zum Erstellungszeitpunkt der Warteschlange festgelegt werden: - Bereich: 0–5 min. 0 bedeutet, dass die Nachricht nicht gesperrt ist. - Standard: 30 Sekunden.
maxDeliveryCount	Ganze Zahl ohne Vorzeichen	Die maximale Anzahl von Versuchen von Service Bus, eine Nachricht zu übermitteln, bevor unzustellbare Nachrichten gesendet oder verworfen werden. Der Standardwert ist 10.
maxSizeInMegabytes	Ganze Zahl ohne Vorzeichen	Die maximale Größe in Megabytes.
status	EntityStatus	Status der Entität.
UserMetadata	String	Benutzermetadaten.

Diese Eigenschaften können nicht aktualisiert werden: requireSession, requiresDuplicateDetection, enablePartitioningund name.

Antwort

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

Antwortcodes

Hinweis

Wenn Sie eine Warteschlange mit einem Namen erstellen, die spezielle oder codierte Zeichen enthält (z. B. "Test? Name=value&", der zu "test%3FName%3Dvalue%26" codiert wird, wird eine (401) Nicht autorisierte Ausnahme generiert.

Code	BESCHREIBUNG
200	Die Warteschlangenbeschreibung wurde erfolgreich aktualisiert.
401	Autorisierungsfehler
404	Die Entität ist unter diesem Namespace nicht vorhanden.
500	Interner Fehler.

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

Antwortheader

Keine.

Antworttext