Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Belangrijk
Deze API is verouderd en buiten gebruik gesteld vanaf 11-2021 en mag niet meer worden gebruikt.
Updates de beschrijving van de wachtrij en verzendt de status van de updates naar de FE/BE om de bijbehorende DATABASE-vermeldingen bij te werken.
Aanvraag
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| PUT | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Naamruimten/{Naamruimte}/Wachtrijen/{Wachtrijpad} | HTTP/1.1 |
Aanvraagheaders
In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.
| Aanvraagkoptekst | Description |
|---|---|
| Content-Type | application/xml;type=entry; charset=utf-8 |
| If-Match | * |
| x-ms-version | 2012-03-01 |
Voor de aanvraag is ook een clientcertificaat vereist. Dit certificaat moet overeenkomen met het certificaat dat u hebt geüpload voor dat specifieke abonnement.
Aanvraagbody
In de volgende tabel worden de belangrijkste elementen van de aanvraagbody beschreven. Dit zijn de enige eigenschappen die u kunt bijwerken. De hoofdtekst moet de volledige beschrijving van de wachtrij bevatten, zelfs als u slechts één eigenschap wijzigt. De aanbevolen stroom is als volgt:
Beschrijving van wachtrij ophalen.
Werk de vereiste elementen bij.
Geef de bijgewerkte beschrijving door.
| Eigenschapsnaam | Type | Description |
|---|---|---|
| authorizationRules | AuthorizationRule[] | Een matrix met autorisatieregels. |
| autoDeleteOnIdle | Tekenreeks | Hiermee wordt aangegeven of een entiteit automatisch moet worden verwijderd wanneer deze een bepaalde tijd niet actief is. |
| deadLetteringOnMessageExpiration | Booleaans | Alleen instelbaar tijdens het maken van de wachtrij. - Standaardinstelling: Onwaar. Dit veld bepaalt hoe Service Bus een bericht met een verlopen TTL verwerkt. Als waar is en een bericht verloopt, verplaatst Service Bus het bericht van de wachtrij naar de wachtrij in de wachtrij met onbestelbare berichten. Als het onwaar is, wordt het bericht definitief verwijderd uit de wachtrij. |
| defaultMessageTtl | XML-datum/tijd | Als een bericht langer dan de opgegeven tijd in de wachtrij is opgeslagen, wordt het bericht automatisch verplaatst naar de wachtrij met onbestelbare berichten of verwijderd, afhankelijk van het feit of het bericht is ingeschakeld. Deze waarde wordt overschreven door een TTL die is opgegeven in het bericht als de TTL van het bericht kleiner is dan de TTL die is ingesteld voor de wachtrij. Deze waarde is onveranderbaar nadat de wachtrij is gemaakt: - Bereik: 1 seconde – 14 dagen. - Standaard: 14 dagen. |
| duplicateDetectionHistoryTimeWindow | Tijdsspanne | Een eigenschap die de periode aangeeft waarin Service Bus berichtduplicatie detecteert. - Bereik: 1 seconde–7 dagen. - Standaard: 10 minuten. |
| enableBatchedOperations | Booleaans | Geef aan of u batchbewerkingen wilt inschakelen of niet. |
| forwardDeadLetteredMessagesTo | Tekenreeks | Geef op waar u berichten met onbestelbare berichten wilt doorsturen. |
| doorsturen naar | Tekenreeks | Geef op waar u de berichten wilt doorsturen. |
| lockDuration | XML-datum/tijd | Deze instelling bepaalt de hoeveelheid tijd in seconden waarvoor een bericht moet worden vergrendeld voor verwerking door een ontvanger. Na deze periode wordt het bericht ontgrendeld en beschikbaar voor gebruik door de volgende ontvanger. Alleen instelbaar op het moment dat de wachtrij wordt gemaakt: - Bereik: 0-5 min. 0 betekent dat het bericht niet is vergrendeld. - Standaard: 30 seconden. |
| maxDeliveryCount | Geheel getal zonder teken | Het maximum aantal keren dat Service Bus probeert een bericht af te leveren voordat een onbestelbare brief wordt verzonden of verwijderd. De standaardwaarde is 10. |
| maxSizeInMegabytes | Geheel getal zonder teken | De maximale grootte in megabytes. |
| status | EntityStatus | Status van de entiteit. |
| userMetadata | Tekenreeks | Metagegevens van gebruikers. |
Deze eigenschappen kunnen niet worden bijgewerkt: requireSession, requiresDuplicateDetection, enablePartitioningen name.
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Antwoordcodes
Notitie
Als u een wachtrij maakt 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 |
|---|---|
| 200 | De beschrijving van de wachtrij is bijgewerkt. |
| 401 | Autorisatiefout. |
| 404 | De entiteit bestaat niet onder deze naamruimte. |
| 500 | Interne fout. |
Zie Status- en foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Geen.
Hoofdtekst van antwoord
Geen.