AMQP 1.0 i Microsoft Azure Service Bus: begärandesvarsbaserade åtgärder
Den här artikeln definierar listan över microsoft Azure Service Bus-begärande-/svarsbaserade åtgärder. Den här informationen baseras på arbetsutkastet AMQP Management Version 1.0.
En detaljerad protokollguide för AMQP 1.0 på trådnivå som förklarar hur Service Bus implementerar och bygger på den tekniska specifikationen för OASIS AMQP finns i protokollguiden AMQP 1.0 i Azure Service Bus och Event Hubs.
Begrepp
ServiceBusReceivedMessage/ServiceBusMessage
Representerar ett meddelande i Service Bus, som mappas till ett AMQP-meddelande. Mappningen definieras i Service Bus AMQP-protokollguiden.
Koppla till entitetshanteringsnod
Alla åtgärder som beskrivs i det här dokumentet följer ett mönster för begäran/svar, är begränsade till en entitet och kräver anslutning till en entitetshanteringsnod.
Skapa länk för att skicka begäranden
Skapar en länk till hanteringsnoden för att skicka begäranden.
requestLink = session.attach(
role: SENDER,
target: { address: "<entity address>/$management" },
source: { address: ""<my request link unique address>" }
)
Skapa länk för att ta emot svar
Skapar en länk för att ta emot svar från hanteringsnoden.
responseLink = session.attach(
role: RECEIVER,
source: { address: "<entity address>/$management" }
target: { address: "<my response link unique address>" }
)
Överföra ett meddelande om begäran
Överför ett meddelande om begäran.
Ett transaktionstillstånd kan läggas till om du vill för åtgärder som stöder transaktioner.
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>
}
)
Ta emot ett svarsmeddelande
Tar emot svarsmeddelandet från svarslänken.
responseMessage = responseLink.receiveTransfer()
Svarsmeddelandet är i följande formulär:
Message(
properties: {
correlation-id: <request id>
},
application-properties: {
"statusCode" -> <status code>,
"statusDescription" -> <status description>,
},
)
Service Bus-entitetsadress
Service Bus-entiteter måste åtgärdas på följande sätt:
Entitetstyp | Adress | Exempel |
---|---|---|
kö | <queue_name> |
“myQueue” “site1/myQueue” |
Avsnitt | <topic_name> |
“myTopic” “site2/page1/myQueue” |
prenumeration | <topic_name>/Subscriptions/<subscription_name> |
“myTopic/Subscriptions/MySub” |
Meddelandeåtgärder
Förnyelselås för meddelande
Utökar låset för ett meddelande med den låsvaraktighet som angetts i kön eller prenumerationen.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:renew-lock |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
lock-tokens |
matris med uuid | Ja | Meddelandelåstoken som ska förnyas. |
Kommentar
Lås token här refererar till delivery-tag
egenskapen på det mottagna AMQP-meddelandet. Om du har fått ett uppskjutet meddelande och vill förnya låset använder du egenskapen lock-token
på meddelandet i stället för delivery-tag
.
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades. |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
Utgångsdatum | matris med tidsstämpel | Ja | Meddelandelåstoken ny förfallotid som motsvarar token för begärandelås. |
Granska meddelande
Kikar på meddelanden utan att låsa.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:peek-message |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
from-sequence-number |
lång | Ja | Sekvensnummer som du vill börja granska från. |
message-count |
heltal | Ja | Maximalt antal meddelanden att granska. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – har fler meddelanden 204: Inget innehåll – inga fler meddelanden |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
meddelanden | lista över kartor | Ja | Lista över meddelanden där varje karta representerar ett meddelande. |
Kartan som representerar ett meddelande måste innehålla följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
meddelande | matris med byte | Ja | AMQP 1.0 trådkodat meddelande. |
Schemalägg meddelande
Schemalägger meddelanden. Den här åtgärden stöder transaktioner.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:schedule-message |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
meddelanden | lista över kartor | Ja | Lista över meddelanden där varje karta representerar ett meddelande. |
Kartan som representerar ett meddelande måste innehålla följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
message-id | sträng | Ja | amqpMessage.Properties.MessageId som sträng |
sessions-ID | sträng | Nej | amqpMessage.Properties.GroupId as string |
partitionsnyckel | sträng | Nej | amqpMessage.MessageAnnotations.”x-opt-partition-key" |
via partitionsnyckel | sträng | Nej | amqpMessage.MessageAnnotations."x-opt-via-partition-key" |
meddelande | matris med byte | Ja | AMQP 1.0 trådkodat meddelande. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades. |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sekvensnummer | matris med lång | Ja | Sekvensantal schemalagda meddelanden. Sekvensnummer används för att avbryta. |
Avbryt schemalagt meddelande
Avbryter schemalagda meddelanden.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:cancel-scheduled-message |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sekvensnummer | matris med lång | Ja | Sekvensnummer för schemalagda meddelanden som ska avbrytas. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades. |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Sessionsåtgärder
Sessions förnya lås
Utökar låset för ett meddelande med den låsvaraktighet som angetts i kön eller prenumerationen.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:renew-session-lock |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sessions-ID | sträng | Ja | Sessions-ID. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – har fler meddelanden 204: Inget innehåll – inga fler meddelanden |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
upphörande | timestamp | Ja | Nytt förfallodatum. |
Granska sessionsmeddelande
Granskar sessionsmeddelanden utan att låsa.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:peek-message |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
from-sequence-number | lång | Ja | Sekvensnummer som du vill börja granska från. |
antal meddelanden | heltal | Ja | Maximalt antal meddelanden att granska. |
sessions-ID | sträng | Ja | Sessions-ID. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – har fler meddelanden 204: Inget innehåll – inga fler meddelanden |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
meddelanden | lista över kartor | Ja | Lista över meddelanden där varje karta representerar ett meddelande. |
Kartan som representerar ett meddelande måste innehålla följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
meddelande | matris med byte | Ja | AMQP 1.0 trådkodat meddelande. |
Ange sessionstillstånd
Anger tillståndet för en session.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:set-session-state |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sessions-ID | sträng | Ja | Sessions-ID. |
sessionstillstånd | matris med byte | Ja | Täckande binära data. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Hämta sessionstillstånd
Hämtar tillståndet för en session.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:get-session-state |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sessions-ID | sträng | Ja | Sessions-ID. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sessionstillstånd | matris med byte | Ja | Täckande binära data. |
Räkna upp sessioner
Räknar upp sessioner på en meddelandeentitet.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:get-message-sessions |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
last-updated-time | timestamp | Ja | Filtrera så att endast sessioner uppdateras efter en viss tid. |
hoppa över | heltal | Ja | Hoppa över ett antal sessioner. |
top | heltal | Ja | Maximalt antal sessioner. |
Kommentar
När du anger LastUpdatedTime
till DateTime.MaxValue
(i .NET) returnerar metoden Räkna upp sessioner alla sessioner oavsett om de har tillstånd eller inte. DateTime.MaxValue
i .NET kanske inte finns på andra programmeringsspråk. I sådana fall använder du en tidsstämpel som är lika 253402300800000
med millisekunder från epoken (1 januari 1970, 00:00:00 GMT), vilket motsvarar DateTime.MaxValue
i .NET.
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – har fler meddelanden 204: Inget innehåll – inga fler meddelanden |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
hoppa över | heltal | Ja | Antal överhoppade sessioner om statuskoden är 200. |
sessions-ids | strängmatris | Ja | Matris med sessions-ID:t om statuskoden är 200. |
Regelåtgärder
Lägg till en regel
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:add-rule |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
rule-name | sträng | Ja | Regelnamn, inklusive prenumerations- och ämnesnamn. |
regelbeskrivning | map | Ja | Regelbeskrivning enligt beskrivningen i nästa avsnitt. |
Regelbeskrivningskartan måste innehålla följande poster, där sql-filter och korrelationsfilter är ömsesidigt uteslutande:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sql-filter | map | Ja | sql-filter , enligt beskrivningen i nästa avsnitt. |
korrelationsfilter | map | Ja | correlation-filter , enligt beskrivningen i nästa avsnitt. |
sql-rule-action | map | Ja | sql-rule-action , enligt beskrivningen i nästa avsnitt. |
Sql-filterkartan måste innehålla följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
Uttryck | sträng | Ja | Sql-filteruttryck. |
Korrelationsfilterkartan måste innehålla minst en av följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
korrelations-ID | sträng | Nej | |
message-id | sträng | Nej | |
to | sträng | Nej | |
svara på | sträng | Nej | |
label | sträng | Nej | |
sessions-ID | sträng | Nej | |
reply-to-session-id | sträng | Nej | |
innehållstyp | sträng | Nej | |
egenskaper | map | Nej | Kartor till Service Bus ServiceBusMessage.Properties |
Kartan sql-rule-action måste innehålla följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
Uttryck | sträng | Ja | Sql-åtgärdsuttryck. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Ta bort regel
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:remove-rule |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
rule-name | sträng | Ja | Regelnamn, inklusive prenumerations- och ämnesnamn. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Hämta regler
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:enumerate-rules |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
top | heltal | Ja | Antalet regler som ska hämtas på sidan. |
hoppa över | heltal | Ja | Antalet regler som ska hoppa över. Definierar startindexet (+1) i listan över regler. |
Response
Svarsmeddelandet innehåller följande egenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades |
regler | lista över kartor | Ja | Lista över regler. Varje regel representeras av en karta. |
Varje kartpost i listan innehåller följande egenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
regelbeskrivning | beskriven objekt | Ja | com.microsoft:rule-description med AMQP-beskriven kod 0x0000013700000004 |
com.microsoft.rule-description
är en lista som beskrivs. Den har följande egenskaper:
Index | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
0 | beskriven lista | Ja | filter som anges i nästa tabell. |
1 | beskriven lista | Ja | ruleAction som anges senare i det här avsnittet. |
2 | sträng | Ja | namnet på regeln. |
3 | timestamp | Ja | Tidsstämpel. |
filter
kan vara av någon av följande typer:
Beskrivningsnamn | Beskrivningskod | Värde |
---|---|---|
com.microsoft:sql-filter:list |
0x000001370000006 | SQL-filter |
com.microsoft:correlation-filter:list |
0x000001370000009 | Korrelationsfilter |
com.microsoft:true-filter:list |
0x000001370000007 | Sant filter som representerar 1=1 |
com.microsoft:false-filter:list |
0x000001370000008 | Falskt filter som representerar 1=0 |
com.microsoft:sql-filter:list
är en lista som beskrivs, som innehåller:
Index | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
0 | sträng | Ja | Sql Filter-uttryck |
1 | heltal | Ja | alltid 20. Det här heltalet är kompatibilitetsnivån för SQL-filtret. Det anger syntaxversionen av sql-filtret. |
com.microsoft:correlation-filter:list
är en lista som beskrivs, som innehåller:
Index (om det finns) | Värdetyp | Värdeinnehåll |
---|---|---|
0 | sträng | Korrelations-ID |
1 | sträng | Meddelande-ID |
2 | sträng | To |
3 | sträng | Svara till |
4 | sträng | Etikett |
5 | sträng | Sessions-ID |
6 | sträng | Svara på sessions-ID |
7 | sträng | Innehållstyp |
8 | Mappning | Karta över programdefinierade egenskaper |
ruleAction
kan vara någon av följande typer:
Beskrivningsnamn | Beskrivningskod | Värde |
---|---|---|
com.microsoft:empty-rule-action:list |
0x0000013700000005 | Tom regelåtgärd – Ingen regelåtgärd finns |
com.microsoft:sql-rule-action:list |
0x0000013700000006 | SQL-regelåtgärd |
com.microsoft:sql-rule-action:list
är en lista som beskrivs med två element.
Index | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
0 | sträng | Ja | SQL-regelåtgärdens uttryck |
1 | heltal | Ja | alltid 20. Det här heltalet är kompatibilitetsnivån för SQL-filtret. Det anger syntaxversionen av sql-filtret. |
Uppskjutna meddelandeåtgärder
Ta emot efter sekvensnummer
Tar emot uppskjutna meddelanden efter sekvensnummer.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:receive-by-sequence-number |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
sekvensnummer | matris med lång | Ja | Sekvensnummer. |
receiver-settle-mode | ubyte | Ja | Mottagarens kvittningsläge enligt vad som anges i AMQP core v1.0. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Brödtexten för svarsmeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
meddelanden | lista över kartor | Ja | Lista över meddelanden där varje karta representerar ett meddelande. |
Kartan som representerar ett meddelande måste innehålla följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
låstoken | uuid | Ja | Lås token om receiver-settle-mode är 1. |
meddelande | matris med byte | Ja | AMQP 1.0 trådkodat meddelande. |
Uppdatera borttagningsstatus
Uppdateringar borttagningsstatus för uppskjutna meddelanden. Den här åtgärden stöder transaktioner.
Förfrågan
Begärandemeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
operation | sträng | Ja | com.microsoft:update-disposition |
com.microsoft:server-timeout |
uint | Nej | Tidsgränsen för åtgärdsservern i millisekunder. |
Brödtexten för begärandemeddelandet måste bestå av ett amqp-value-avsnitt som innehåller en karta med följande poster:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
dispositionsstatus | sträng | Ja | slutfört Övergivna pausad |
låstoken | matris med uuid | Ja | Meddelandelåstoken för att uppdatera borttagningsstatus. |
deadletter-reason | sträng | Nej | Den anges om borttagningsstatusen är inställd på pausad. |
deadletter-description | sträng | Nej | Den anges om borttagningsstatusen är inställd på pausad. |
properties-to-modify | map | Nej | Lista över egenskaper för asynkrona meddelanden i Service Bus som ska ändras. |
Response
Svarsmeddelandet måste innehålla följande programegenskaper:
Nyckel | Värdetyp | Obligatoriskt | Värdeinnehåll |
---|---|---|---|
statusCode | heltal | Ja | HTTP-svarskod [RFC2616] 200: OK – framgång, annars misslyckades |
statusDescription | sträng | Nej | Beskrivning av statusen. |
Nästa steg
Mer information om AMQP och Service Bus finns på följande länkar: