AMQP 1.0 in Microsoft Azure Service Bus: bewerkingen op basis van aanvraagreacties
In dit artikel wordt de lijst met bewerkingen op basis van aanvragen/antwoorden van Microsoft Azure Service Bus gedefinieerd. Deze informatie is gebaseerd op het werkconcept amqp-beheerversie 1.0.
Zie de AMQP 1.0-protocolhandleiding op het gebied van AMQP 1.0, waarin wordt uitgelegd hoe Service Bus de technische specificatie van OASIS AMQP implementeert en bouwt, in de protocolhandleiding voor AMQP 1.0 in Azure Service Bus en Event Hubs.
Concepten
ServiceBusReceivedMessage/ServiceBusMessage
Vertegenwoordigt een bericht in Service Bus, dat is toegewezen aan een AMQP-bericht. De toewijzing wordt gedefinieerd in de Service Bus AMQP-protocolhandleiding.
Koppelen aan knooppunt voor entiteitsbeheer
Alle bewerkingen die in dit document worden beschreven, volgen een aanvraag-/antwoordpatroon, zijn gericht op een entiteit en moeten worden gekoppeld aan een knooppunt voor entiteitsbeheer.
Koppeling maken voor het verzenden van aanvragen
Hiermee maakt u een koppeling naar het beheerknooppunt voor het verzenden van aanvragen.
requestLink = session.attach(
role: SENDER,
target: { address: "<entity address>/$management" },
source: { address: ""<my request link unique address>" }
)
Koppeling maken voor het ontvangen van antwoorden
Hiermee maakt u een koppeling voor het ontvangen van antwoorden van het beheerknooppunt.
responseLink = session.attach(
role: RECEIVER,
source: { address: "<entity address>/$management" }
target: { address: "<my response link unique address>" }
)
Een aanvraagbericht overdragen
Hiermee wordt een aanvraagbericht overgedragen.
Een transactiestatus kan eventueel worden toegevoegd voor bewerkingen die transacties ondersteunen.
requestLink.sendTransfer(
Message(
properties: {
message-id: <request id>,
reply-to: "<my response link unique address>"
},
application-properties: {
"operation" -> "<operation>",
}
),
[Optional] State = transactional-state: {
txn-id: <txn-id>
}
)
Een antwoordbericht ontvangen
Ontvangt het antwoordbericht van de antwoordkoppeling.
responseMessage = responseLink.receiveTransfer()
Het antwoordbericht heeft de volgende vorm:
Message(
properties: {
correlation-id: <request id>
},
application-properties: {
"statusCode" -> <status code>,
"statusDescription" -> <status description>,
},
)
Service Bus-entiteitsadres
Service Bus-entiteiten moeten als volgt worden aangepakt:
| Entiteitstype | Adres | Opmerking |
|---|---|---|
| wachtrij | <queue_name> |
“myQueue”“site1/myQueue” |
| onderwerp | <topic_name> |
“myTopic”“site2/page1/myQueue” |
| abonnement | <topic_name>/Subscriptions/<subscription_name> |
“myTopic/Subscriptions/MySub” |
Berichtbewerkingen
Bericht vernieuwen vergrendelen
Breidt de vergrendeling van een bericht uit op de vergrendelingsduur die is ingesteld voor de wachtrij of het abonnement.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:renew-lock |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
lock-tokens |
matrix van uuid | Ja | Tokens voor berichtvergrendeling die moeten worden vernieuwd. |
Notitie
Het vergrendelingstoken verwijst hier naar de delivery-tag eigenschap in het ontvangen AMQP-bericht. Als u een uitgesteld bericht hebt ontvangen en de vergrendeling wilt verlengen, gebruikt u de eigenschap lock-token in het bericht in plaats van de delivery-tag.
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – succes, anders mislukt. |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| Verloopt | matrix van tijdstempel | Ja | Berichtvergrendelingstoken nieuwe vervaldatum die overeenkomt met de aanvraagvergrendelingstokens. |
Bericht bekijken
Hiermee worden berichten weergegeven zonder te vergrendelen.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:peek-message |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
from-sequence-number |
long | Ja | Volgnummer van waaruit u een korte weergave wilt starten. |
message-count |
int | Ja | Maximum aantal berichten dat u wilt bekijken. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – heeft meer berichten 204: Geen inhoud - geen berichten meer |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| messages | lijst met kaarten | Ja | Lijst met berichten waarin elke kaart een bericht vertegenwoordigt. |
De kaart die een bericht vertegenwoordigt, moet de volgende vermeldingen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| bericht | matrix van byte | Ja | AmQP 1.0 wire-gecodeerd bericht. |
Bericht plannen
Hiermee worden berichten gepland. Deze bewerking ondersteunt transacties.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:schedule-message |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| messages | lijst met kaarten | Ja | Lijst met berichten waarin elke kaart een bericht vertegenwoordigt. |
De kaart die een bericht vertegenwoordigt, moet de volgende vermeldingen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| message-id | tekenreeks | Ja | amqpMessage.Properties.MessageId als tekenreeks |
| sessie-id | tekenreeks | Nee | amqpMessage.Properties.GroupId as string |
| partitiesleutel | tekenreeks | Nee | amqpMessage.MessageAnnotations.”x-opt-partition-key" |
| via partitiesleutel | tekenreeks | Nee | amqpMessage.MessageAnnotations."x-opt-via-partition-key" |
| bericht | matrix van byte | Ja | AmQP 1.0 wire-gecodeerd bericht. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – succes, anders mislukt. |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| reeksnummers | matrix van lang | Ja | Volgnummer van geplande berichten. Het volgnummer wordt gebruikt om te annuleren. |
Gepland bericht annuleren
Hiermee worden geplande berichten geannuleerd.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:cancel-scheduled-message |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| reeksnummers | matrix van lang | Ja | Volg het aantal geplande berichten dat moet worden geannuleerd. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – succes, anders mislukt. |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
Sessiebewerkingen
Sessie vernieuwen vergrendelen
Breidt de vergrendeling van een bericht uit op de vergrendelingsduur die is ingesteld voor de wachtrij of het abonnement.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:renew-session-lock |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| sessie-id | tekenreeks | Ja | Sessie-id. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – heeft meer berichten 204: Geen inhoud - geen berichten meer |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| verlooptijd | timestamp | Ja | Nieuwe vervaldatum. |
Sessiebericht bekijken
Hiermee worden sessieberichten weergegeven zonder te worden vergrendeld.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:peek-message |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| from-sequence-number | long | Ja | Volgnummer van waaruit u een korte weergave wilt starten. |
| aantal berichten | int | Ja | Maximum aantal berichten dat u wilt bekijken. |
| sessie-id | tekenreeks | Ja | Sessie-id. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – heeft meer berichten 204: Geen inhoud - geen berichten meer |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| messages | lijst met kaarten | Ja | Lijst met berichten waarin elke kaart een bericht vertegenwoordigt. |
De kaart die een bericht vertegenwoordigt, moet de volgende vermeldingen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| bericht | matrix van byte | Ja | AmQP 1.0 wire-gecodeerd bericht. |
Sessiestatus instellen
Hiermee stelt u de status van een sessie in.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:set-session-state |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| sessie-id | tekenreeks | Ja | Sessie-id. |
| sessiestatus | matrix van bytes | Ja | Ondoorzichtige binaire gegevens. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – geslaagd, anders mislukt |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
Sessiestatus ophalen
Hiermee haalt u de status van een sessie op.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:get-session-state |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| sessie-id | tekenreeks | Ja | Sessie-id. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – geslaagd, anders mislukt |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| sessiestatus | matrix van bytes | Ja | Ondoorzichtige binaire gegevens. |
Sessies opsommen
Opsomming van sessies op een berichtenentiteit.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:get-message-sessions |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| laatst bijgewerkt tijdstip | timestamp | Ja | Filter om alleen sessies op te nemen die na een bepaalde tijd zijn bijgewerkt. |
| skip | int | Ja | Sla een aantal sessies over. |
| top | int | Ja | Maximum aantal sessies. |
Notitie
Wanneer u instelt LastUpdatedTime DateTime.MaxValue op (in .NET), retourneert de methode Enumerate Sessions alle sessies, ongeacht of deze status hebben of niet. DateTime.MaxValue in .NET bestaat mogelijk niet in andere programmeertalen. In dergelijke gevallen gebruikt u een tijdstempel die gelijk is aan 253402300800000 milliseconden uit het Epoch (1 januari 1970, 00:00:00 GMT), wat gelijk is aan DateTime.MaxValue in .NET.
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – heeft meer berichten 204: Geen inhoud - geen berichten meer |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| skip | int | Ja | Aantal overgeslagen sessies als de statuscode 200 is. |
| sessies-id's | matrix tekenreeksen | Ja | Matrix van sessie-id's als statuscode 200 is. |
Regelbewerkingen
Regel toevoegen
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:add-rule |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| regelnaam | tekenreeks | Ja | Regelnaam, niet inclusief abonnements- en onderwerpnamen. |
| regelbeschrijving | map | Ja | Regelbeschrijving zoals opgegeven in de volgende sectie. |
De kaart regelbeschrijving moet de volgende vermeldingen bevatten, waarbij sql-filter en correlatiefilter elkaar wederzijds uitsluiten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| sql-filter | map | Ja | sql-filter, zoals opgegeven in de volgende sectie. |
| correlatiefilter | map | Ja | correlation-filter, zoals opgegeven in de volgende sectie. |
| sql-rule-action | map | Ja | sql-rule-action, zoals opgegeven in de volgende sectie. |
De sql-filtertoewijzing moet de volgende vermeldingen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| Expressie | tekenreeks | Ja | Sql-filterexpressie. |
De correlatiefilterkaart moet ten minste één van de volgende vermeldingen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| correlatie-id | tekenreeks | Nee | |
| message-id | tekenreeks | Nee | |
| to | tekenreeks | Nee | |
| beantwoorden | tekenreeks | Nee | |
| label | tekenreeks | Nee | |
| sessie-id | tekenreeks | Nee | |
| reply-to-session-id | tekenreeks | Nee | |
| inhoudstype | tekenreeks | Nee | |
| properties | map | Nee | Kaarten naar Service Bus ServiceBusMessage.Properties |
De toewijzing van sql-rule-action moet de volgende vermeldingen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| Expressie | tekenreeks | Ja | Sql-actie-expressie. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – geslaagd, anders mislukt |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
Regel verwijderen
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:remove-rule |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| regelnaam | tekenreeks | Ja | Regelnaam, niet inclusief abonnements- en onderwerpnamen. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – geslaagd, anders mislukt |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
Regels ophalen
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:enumerate-rules |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| top | int | Ja | Het aantal regels dat moet worden opgehaald op de pagina. |
| skip | int | Ja | Het aantal regels dat moet worden overgeslagen. Definieert de beginindex (+1) in de lijst met regels. |
Respons
Het antwoordbericht bevat de volgende eigenschappen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – geslaagd, anders mislukt |
| regels | lijst met kaarten | Ja | Lijst met regels. Elke regel wordt vertegenwoordigd door een kaart. |
Elke kaartvermelding in de lijst bevat de volgende eigenschappen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| regelbeschrijving | beschreven object | Ja | com.microsoft:rule-description met door AMQP beschreven code 0x0000013700000004 |
com.microsoft.rule-description zelf is een beschreven lijst. Het heeft de volgende eigenschappen:
| Index | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| 0 | beschreven lijst | Ja | filter zoals opgegeven in de volgende tabel. |
| 1 | beschreven lijst | Ja | ruleAction zoals verderop in deze sectie is opgegeven. |
| 2 | tekenreeks | Ja | naam van de regel. |
| 3 | timestamp | Ja | tijdstempel. |
filter kan van een van de volgende typen zijn:
| Descriptornaam | Descriptorcode | Weergegeven als |
|---|---|---|
com.microsoft:sql-filter:list |
0x000001370000006 | SQL-filter |
com.microsoft:correlation-filter:list |
0x000001370000009 | Correlatiefilter |
com.microsoft:true-filter:list |
0x000001370000007 | True-filter dat 1=1 vertegenwoordigt |
com.microsoft:false-filter:list |
0x000001370000008 | Onwaarfilter dat 1=0 vertegenwoordigt |
com.microsoft:sql-filter:list is een beschreven lijst, waaronder:
| Index | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| 0 | tekenreeks | Ja | Sql-filterexpressie |
| 1 | int | Ja | altijd 20. Dit gehele getal is het compatibiliteitsniveau van het SQL-filter. Hiermee wordt de syntaxisversie van het SQL-filter aangegeven. |
com.microsoft:correlation-filter:list is een beschreven lijst, waaronder:
| Index (indien aanwezig) | Waardetype | Waarde-inhoud |
|---|---|---|
| 0 | tekenreeks | Correlatie-id |
| 1 | tekenreeks | Bericht-id |
| 2 | tekenreeks | Tot |
| 3 | tekenreeks | Antwoorden op |
| 4 | tekenreeks | Label |
| 5 | tekenreeks | Sessie-id |
| 6 | tekenreeks | Sessie-id beantwoorden |
| 7 | tekenreeks | Inhoudstype |
| 8 | Overzicht | Kaart van door de toepassing gedefinieerde eigenschappen |
ruleAction kan een van de volgende typen zijn:
| Descriptornaam | Descriptorcode | Weergegeven als |
|---|---|---|
com.microsoft:empty-rule-action:list |
0x0000013700000005 | Lege regelactie - Geen regelactie aanwezig |
com.microsoft:sql-rule-action:list |
0x0000013700000006 | SQL-regelactie |
com.microsoft:sql-rule-action:list is een beschreven lijst met twee elementen.
| Index | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| 0 | tekenreeks | Ja | Expressie van SQL-regelactie |
| 1 | int | Ja | altijd 20. Dit gehele getal is het compatibiliteitsniveau van het SQL-filter. Hiermee wordt de syntaxisversie van het SQL-filter aangegeven. |
Uitgestelde berichtbewerkingen
Ontvangen op volgnummer
Ontvangt uitgestelde berichten op volgnummer.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:receive-by-sequence-number |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| reeksnummers | matrix van lang | Ja | Volgnummers. |
| ontvanger-vereffenmodus | ubyte | Ja | Ontvanger vereffenmodus zoals opgegeven in AMQP core v1.0. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – geslaagd, anders mislukt |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
De hoofdtekst van het antwoordbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| messages | lijst met kaarten | Ja | Lijst met berichten waarin elke kaart een bericht vertegenwoordigt. |
De kaart die een bericht vertegenwoordigt, moet de volgende vermeldingen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| vergrendelingstoken | uuid | Ja | Vergrendelingstoken als receiver-settle-mode dit 1 is. |
| bericht | matrix van byte | Ja | AmQP 1.0 wire-gecodeerd bericht. |
Status van verwijdering bijwerken
Hiermee wordt de verwijderingsstatus van uitgestelde berichten bijgewerkt. Deze bewerking ondersteunt transacties.
Aanvraag
Het aanvraagbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| schakelapparatuur optimaliseren | tekenreeks | Ja | com.microsoft:update-disposition |
com.microsoft:server-timeout |
uint | Nee | Time-out van bewerkingsserver in milliseconden. |
De hoofdtekst van het aanvraagbericht moet bestaan uit een amqp-waardesectie met een kaart met de volgende vermeldingen:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| verwijderingsstatus | tekenreeks | Ja | voltooid Verlaten onderbroken |
| vergrendelingstokens | matrix van uuid | Ja | Tokens voor berichtvergrendeling om de verwijderingsstatus bij te werken. |
| deadletter-reason | tekenreeks | Nee | Deze status wordt ingesteld als de verwijderingsstatus is ingesteld op onderbroken. |
| deadletter-description | tekenreeks | Nee | Deze status wordt ingesteld als de verwijderingsstatus is ingesteld op onderbroken. |
| properties-to-modify | map | Nee | Lijst met service bus brokered berichteigenschappen die u wilt wijzigen. |
Respons
Het antwoordbericht moet de volgende toepassingseigenschappen bevatten:
| Sleutel | Waardetype | Vereist | Waarde-inhoud |
|---|---|---|---|
| statuscode | int | Ja | HTTP-antwoordcode [RFC2616] 200: OK – geslaagd, anders mislukt |
| statusDescription | tekenreeks | Nee | Beschrijving van de status. |
Volgende stappen
Ga naar de volgende koppelingen voor meer informatie over AMQP en Service Bus: