Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wichtig
Diese API ist veraltet und seit dem 11.1.2021 eingestellt und sollte nicht mehr verwendet werden.
Erstellt eine neue Warteschlange. Nach der Erstellung ist das Ressourcenmanifest der Warteschlange unveränderlich. Dieser Vorgang ist idempotent. Wenn der Erstellungsaufruf wiederholt wird, nachdem eine Warteschlange mit dem gleichen Namen erfolgreich erstellt wurde, wird die Fehlermeldung "409 (Konflikt)" ausgegeben.
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 |
| 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:
| Eigenschaftenname | type | Erforderlich | BESCHREIBUNG |
|---|---|---|---|
| MaxQueueSizeInMegaBytes | Ganze Zahl ohne Vorzeichen | Erforderlich | Dieser Parameter gibt die maximale Warteschlangengröße in MB an. Jeder Versuch, eine Nachricht in eine Warteschlange zu stellen, die dazu führt, dass die Warteschlange diesen Wert überschreitet, schlägt fehl. Nur Benutzerinhalt wird für diesen Wert berücksichtigt. Kann zum Erstellungszeitpunkt der Warteschlange sowie zur Laufzeit festgelegt werden: - Bereich: 1–5* 1024. - Standardwert: 1 * 1024. |
| QueueSizeinBytes | Ganze Zahl ohne Vorzeichen | Schreibgeschützt. Bei der Erstellung nicht erforderlich. | Dieser Parameter gibt die tatsächlichen Bytes im Vergleich zum Warteschlangenkontingent an, die Nachrichten in der Warteschlangen zurzeit belegen. Bereich: 0 –MaxTopicSizeinMegaBytes |
| QueueDepth | Ganze Zahl ohne Vorzeichen | Schreibgeschützt. Bei der Erstellung nicht erforderlich. | Dieser Parameter zeigt die aktuelle Anzahl der Nachrichten in der Warteschlange an. |
| DefaultMessageTimeToLive | XML-Datetime | Optional, der Standardwert lautet 14 Tage. | Wenn eine Nachricht länger als die angegebene Zeit in der Warteschlange gespeichert wurde, wird sie automatisch in die Warteschlange 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. |
| LockDuration | XML-Datetime | Optional, der Standardwert ist 30 Sekunden. | 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. |
| RequiresSession | Boolean | Optional | Diese Eigenschaft kann nur zum Erstellungszeitpunkt der Warteschlange festgelegt werden. Wenn auf truefestgelegt ist, ist die Warteschlange sitzungsfähig, und nur die SessionReceiver wird unterstützt. Sitzungsfähige Warteschlangen werden nicht über REST unterstützt.- Standardwert: False. |
| RequiresDuplicateDetection | Boolean | Optional | Diese Eigenschaft kann nur zum Erstellungszeitpunkt der Warteschlange festgelegt werden. – Standardwert für dauerhafte Warteschlange: false. |
| EnableDeadLetteringOnMessageExpiration | Boolean | Optional | Diese Eigenschaft kann nur zum Erstellungszeitpunkt der Warteschlange festgelegt werden. - Standardwert: false. Dieses Feld bestimmt, wie Service Bus eine Nachricht mit einer abgelaufenen Gültigkeitsdauer verarbeitet. Wenn true ist und eine Nachricht abläuft, verschiebt Service Bus die Nachricht aus der Warteschlange in die Unterqueue für unzustellbare Nachrichten der Warteschlange. Wenn sie false ist, wird die Nachricht endgültig aus der Warteschlange gelöscht. |
| DuplicateDetectionHistoryTimeWindow | Zeitspanne | Optional. | Eine Eigenschaft, die die Zeitspanne angibt, in der Service Bus Die Duplizierung von Nachrichten erkennt. - Bereich: 1 Sekunde bis 7 Tage. - Standard: 10 Minuten. |
| Status | String | Schreibgeschützt. Bei der Erstellung nicht erforderlich. | Folgenden Werte sind möglich:
|
Antwort
Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.
Antwortcodes
Hinweis
Wenn Sie eine Warteschlange mit einem Namen erstellen, der Sonderzeichen oder codierte Zeichen enthält (Beispiel: "test?Name=value&", die zu "test%3FName%3Dvalue%26" codiert werden), wird die Ausnahme "400 (Ungültige Anforderung)" generiert.
| Code | BESCHREIBUNG |
|---|---|
| 201 | Die Warteschlange wurde erstellt. |
| 400 | Ungültiger Anfragetext. |
| 401 | Autorisierungsfehler |
| 403 | Das Kontingent wurde überschritten, die Warteschlange wurde nicht erstellt. |
| 409 | Die angegebene Warteschlange ist bereits vorhanden (oder der angegebene Pfad ist bereits belegt). |
| 500 | Interner Fehler. |
Informationen zu status Codes finden Sie unter Status- und Fehlercodes.
Antwortheader
Keine.
Antworttext
Die Warteschlangenbeschreibung wird zurückgegeben. Einige Beschreibungseigenschaften enthalten ggf. Standardwerte, wenn sie in der PUT-Anforderung gefehlt haben.